SnowyPlover

Reference / Effect

Animate Objects On Curves

Nickname RandObjsTab SnowyPlover › 03 Effect

Randomly distributes indexed objects along each input curve branch, treating each branch as one continuous path system.Creates placement references for downstr eam object instancing by generating planes and object type indices.

Animate Objects On Curves: Randomly distributes indexed objects along each input curve branch, treating each branch as one continuous path system.Creates placement references for downstr eam object instancing by generating planes and object type indices.Animate Objects On Curvescurves (*C) Curve · tree Input curves as a tree. Each branch is treated as one continuous path system.curvesobjectLengths (*L) Number · list Length of each object type. Example: [4.5, 6.0].objectLengthsratios (*R) Integer · list Relative occurrence ratio for each object type. Must match Object Lengths count.ratiosdensity (D) Integer · item default 1 Maximum number of ratio-cycles to attempt per branch.densitysafeDistance (S) Number · item default 0.0 Minimum spacing between neighboring objects.safeDistancejitter (J) Number · item default 0.0 Randomness factor for redistributing leftover gap lengths. Usually between 0 and 1.jitterseed (S) Integer · item default 1 Random seed for reproducible results.seedanimate (*A) Boolean · item default false If true, placement positions are shifted along each branch to simulate movement.animatet Number · item default 0.0 Normalized animation phase from 0 to 1.tspeed (S) Number · item default 1.0 Movement speed multiplier. Higher values produce larger travel distance for the same t. Mostly ranges from -10.0 to 10.0Negative values reverse the directionspeedreverseDirection (R) Boolean · item default false Reverse the direction of the movement.reverseDirectionlocations (P) Plane · tree Placement planes for objects.locationsobjectIndices (I) Integer · tree Index of the chosen object type for each placement.objectIndices

Inputs

NameTypeDefaultDescription
curves *CCurve treeInput curves as a tree. Each branch is treated as one continuous path system.
objectLengths *LNumber listLength of each object type. Example: [4.5, 6.0].
ratios *RInteger listRelative occurrence ratio for each object type. Must match Object Lengths count.
density DInteger1Maximum number of ratio-cycles to attempt per branch.
safeDistance SNumber0.0Minimum spacing between neighboring objects.
jitter JNumber0.0Randomness factor for redistributing leftover gap lengths. Usually between 0 and 1.
seed SInteger1Random seed for reproducible results.
animate *ABooleanfalseIf true, placement positions are shifted along each branch to simulate movement.
tNumber0.0Normalized animation phase from 0 to 1.
speed SNumber1.0Movement speed multiplier. Higher values produce larger travel distance for the same t. Mostly ranges from -10.0 to 10.0Negative values reverse the direction
reverseDirection RBooleanfalseReverse the direction of the movement.

Outputs

NameTypeDescription
locations PPlane treePlacement planes for objects.
objectIndices IInteger treeIndex of the chosen object type for each placement.