> modifiers

Randomize

modifiers/randomize·v1.5.1

IN:1 OUT:1

SUMMARY

The Randomize adds randomness to instance transforms including position, rotation, and scale. Each randomization parameter can be controlled independently with custom seed values, min/max ranges, and step increments.

You can also randomize the color attribute and custom float attributes. The existing falloff attribute, if enabled, will affect the amount of randomness applied, enabling spatially varying random effects.

PARAMETERS

PAGERandomize

Group	Group	If there are input groups, specifying a group name in this field will cause this POP to act only upon the group specified.
Local Space	Localspace	When on, the effect is applied in local space. When off, world space is used.
Do Falloff	Dofalloff	Weight the effect on each point by the Falloff Attribute.
Falloff Attribute	Falloffattr	The point attribute, 0 to 1, that weights the effect.

PAGEPosition

Randomize Position	Posrand	Enable randomizing the position.
Seed	Posseed	Numerical value that initializes the position randomization.
[+]Min Value	Posminval	Sets the minimum random offset for each axis.
[+]Max Value	Posmaxval	Sets the maximum random offset for each axis.
Step	Posstep	Snaps the random offsets to multiples of this step. 0 keeps them continuous.

PAGERotation

Randomize Orientation	Rotrand	Enable randomizing the orientation.
[+]Rotate Mode	Rotmode	Determines whether the rotation is added to or replaces the existing rotation.
Seed	Rotseed	Numerical value that initializes the random rotation.
[+]Min Value	Rotminval	Sets the minimum random rotation for each axis. Angles are given in degrees.
[+]Max Value	Rotmaxval	Sets the maximum random rotation for each axis. Angles are given in degrees.
Rotation Multiplier	Rotmult	Scales the random angles.
Step	Rotstep	Snaps the random angles to multiples of this step, in degrees. 0 keeps them continuous.
[+]Rotate Order	Rord	Sets the order of the random rotations.

PAGEScale

Randomize Scale	Scalerand	Enable randomizing the scale in each axis.
Seed	Scaleseed	Numerical value that initializes the per-axis scale randomization.
[+]Min Value	Scaleminval	Sets the minimum random scale for each axis.
[+]Max Value	Scalemaxval	Sets the maximum random scale for each axis.
Step	Scalestep	Snaps the random scale to multiples of this step. 0 keeps it continuous.
Randomize Uniform Scale	Uniscalerand	Enable randomizing the scale uniformly on all axes.
Seed	Uniscaleseed	Numerical value that initializes the randomization of the uniform scale.
Min Value	Uniscaleminval	Sets the minimum random uniform scale.
Max Value	Uniscalemaxval	Sets the maximum random uniform scale.
Step	Uniscalestep	Snaps the random uniform scale to multiples of this step. 0 keeps it continuous.
[+]Scale Mode	Scalemode	Determines whether the scale multiplies or replaces the existing scale.

PAGEColor

Randomize Color	Colorrand	Enable randomizing the color.
[+]Color Mode	Colormode	Determines how the random color combines with the incoming color: Set, Add or Multiply.
Seed	Colorseed	Numerical value that initializes the randomization.
Map from Low	Fromlow	Sets the low end of the input range of the remap.
Map from High	Fromhigh	Sets the high end of the input range of the remap.
Map to Low	Tolow	Sets the low end of the output range of the remap.
Map to High	Tohigh	Sets the high end of the output range of the remap.
Color Ramp	Colorramp	Map the random value through a color ramp.
Open Color Ramp Editor	Opencolorrampeditor	Open the color ramp editor.
Reset Color Ramp	Resetcolorramp	Resets the color ramp.
Custom Color TOP	Customcolortop	Reference to a TOP used as the color ramp. It overrides the ramp editor.

PAGEOther

Randomize Other	Otherrand	Enable randomizing a custom float attribute.
Attribute (Float)	Attr	The float attribute to randomize.
Seed	Otherseed	Numerical value that initializes the randomization.
Min Value	Otherminval	Sets the minimum random attribute value.
Max Value	Othermaxval	Sets the maximum random attribute value.
Step	Otherstep	Snaps the random value to multiples of this step. 0 keeps it continuous.
[+]Combine Operation	Combineop	Specify how to combine the random value with the attribute value.
Swap Operation Order	Swaporder	Swaps the order of the operands. A operation B is changed to B operation A.

PAGECommon

Bypass	Bypass	Pass through the first input to the output unchanged.
Free Extra GPU Memory	Freeextragpumem	Free memory that has accumulated when output memory has grown and shrunk.
Render Primitives	Renderprimitives	Whether to render the full POPX geometry. When off, only point instances are drawn.
Convert to Point Primitives	Converttoptprim	Enable converting points to point primitives when Render Primitives is off.
SRT / RST	Srtrst	Sets the transform order, SRT or RST, used when the points are rendered as TouchDesigner instances.

ATTRIBUTES

IORead

Pivot	point vec3	Instance pivot (passed through; used for the pivot-corrected translation).
popxFalloff	point float	Falloff attribute controlling where and how strongly the effect is applied (default popxFalloff; set by Falloff Attribute).

IOModified

P	point vec3	Instance position. A random offset (Position section) is added, scaled by the falloff.
Orient	point vec4	Instance orientation. A random euler rotation (Rotation section, in degrees with Multiplier and Step) is added onto or replaces the base, scaled by the falloff.
Scale	point vec3	Instance scale. Random per-axis scale and uniform scale (Scale section) multiply onto or replace the base, scaled by the falloff.
PointScale	point float	Uniform per-instance scale; reset to 1 when random scale is folded into the transform.
Color	point vec4	Instance color. A per-channel random RGB (Color section), optionally remapped through the color ramp, is combined with the existing color (Set/Add/Multiply) and scaled by the falloff.
Transform	point mat3	Per-instance 3x3 transform, rebuilt from the randomized position, rotation, and scale.

IOCreated

FullTransform

point mat4

Per-instance 4x4 transform with pivot-corrected translation; the matrix used for instancing.

INPUTS

Input 0 POP - POPX/POP Geometry

OUTPUTS

Output 0 POP - POPX/POP Geometry