vArrayRotateValues
Cycle the elements of a vArray by N positions — the sequencer shift node for looping patterns and staggered animation offsets.
vArrayRotateValues shifts all elements in a vArray forward or backward by a set number of positions, wrapping values that fall off one end back to the other. It is the primary tool for creating cyclic sequences and stagger offsets across point arrays.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| Rotate Amount | Integer | 1 | Number of positions to shift the array elements. Positive shifts forward, negative shifts backward. Range: –100 to 100. |
| Pass Thru: 0 or 1 | Checkbox | 0 | When enabled, bypasses the rotation and passes the input array through unchanged. Use during development to toggle the effect. |
| Show Input | Checkbox | 0 | Reveals the Array A connection port on the node in the Fusion node graph. |
| Array A | Float | — | The vArray whose element order will be circularly shifted. |
Read the full description
vArrayRotateValues performs a circular shift on the element order of a vArray. Elements shifted off the end of the array wrap around to the beginning, preserving the total element count. This is fundamentally different from 3D rotation — it is a data sequencing operation, not a spatial transform.
Rotate Amount accepts positive values (shift forward) and negative values (shift backward), and its range of –100 to 100 covers most practical use cases. Animating this parameter over time creates a continuous cycling effect through the array — valuable for sequencing lights in a ring, cycling colour maps, or producing offset wave propagation across a point cloud.
Pass Thru mode bypasses the shift entirely, outputting the array unchanged. This is useful during node graph development when you want to temporarily disable the rotation without disconnecting or deleting the node. Pair vArrayRotateValues with vArrayWave to create directional wave patterns that travel through a point array over time.
Example Connections
- Cycling ring sequence
- Stagger before wave
vArrayPointsOnCircle.Output -> vArrayRotateValues.ArrayA
vArrayRotateValues.Output -> vArrayCameraProjection.ArrayA
vArrayCameraProjection.Output -> vArrayShapeRender.ArrayPoint
vArrayPointsOnGrid.Output -> vArrayRotateValues.ArrayA
vArrayRotateValues.Output -> vArrayWave.ArrayA
vArrayWave.Output -> vArrayCameraProjection.ArrayA