Reference / Effect
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.
Inputs
| Name | Type | Default | Description |
|---|---|---|---|
| curves *C | Curve tree | Input curves as a tree. Each branch is treated as one continuous path system. | |
| objectLengths *L | Number list | Length of each object type. Example: [4.5, 6.0]. | |
| ratios *R | Integer list | Relative occurrence ratio for each object type. Must match Object Lengths count. | |
| density D | Integer | 1 | Maximum number of ratio-cycles to attempt per branch. |
| safeDistance S | Number | 0.0 | Minimum spacing between neighboring objects. |
| jitter J | Number | 0.0 | Randomness factor for redistributing leftover gap lengths. Usually between 0 and 1. |
| seed S | Integer | 1 | Random seed for reproducible results. |
| animate *A | Boolean | false | If true, placement positions are shifted along each branch to simulate movement. |
| t | Number | 0.0 | Normalized animation phase from 0 to 1. |
| speed S | Number | 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 direction |
| reverseDirection R | Boolean | false | Reverse the direction of the movement. |
Outputs
| Name | Type | Description |
|---|---|---|
| locations P | Plane tree | Placement planes for objects. |
| objectIndices I | Integer tree | Index of the chosen object type for each placement. |