Spread Out Points
Updated: 12 Feb 2025
Spread out the vertices of the parent mesh
Spread Out Points
Method #
This node separates the vertices of the parent mesh by attempting to push each vertex away from the other vertices using the distance specified by the Separation Distance. This may require a number of processing iterations to achieve the desired results, and can be computationally expensive, balancing the processing iterations for fewer iterations may be used if an inexact result is acceptable.
Parameters
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
Parameter Details Position X
The objects position along the local x-axis.
Position Y
The objects position along the local y-axis.
Position Z
The objects position along the local z-axis.
Rotation Heading
The objects rotation around the local y-axis.
Rotation Pitch
The objects rotation around the local x-axis.
Rotation Bank
The objects rotation around the local z-axis.
Scale X
The objects scale along the local x-axis.
Scale Y
The objects scale along the local y-axis.
Scale Z
The objects scale along the local z-axis.
Control the inheritance of the transforms from the parent.
Parameter Details Position
Toggle inheritance of the Position from the parent.
Rotation
Toggle inheritance of the Rotation from the parent.
Scale
Toggle inheritance of the Scale from the parent.
World Position Only
Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties.
Inherit Time
Toggle inheritance of time from the parent.
These properties control the core behaviours of the node.
Parameter Details Apply Mode
Choose whether the deformer applies to the individual vertices or the mesh chunks.
- Vertices : The mesh deformations are applied to the mesh vertices.
- Chunks : The mesh deformations are applied to the separated mesh pieces.
Transform Space
Choose which transform space the deformer uses for deformation. Does not affect falloffs.
- Local : Deformations are calculated in the Local Space of the object, so transformations of the parent mesh will not affect the deformation.
- World : Deformations are calculated in the World Space of the scene, so transformations of the parent mesh will apply the deformer differently depending on the mesh position.
Blend Amount
Global override for how much the deformer affects the mesh.
Time Mode
How the deformer updates with relation to the timecode.
- Locked To Timecode : The deformer deformations are locked to the timecode and the same time will always yield the same deformations.
- Running / Looping : The deformer deformations are disconnected from the timecode and will run seamlessly at the end of the composition.
Iterations
The number of processing iterations. the more iterations, the longer the processing time.
Separation Distance
The target separation distance.
These properties control where the deformer affects the geometry.
Parameter Details Enabled
Enable falloff from the position of the deformer.
Shape
Select which shape to use to draw falloff from.
- Sphere : Falloff is drawn outward from a central point, forming a spherical falloff.
- Cylinder : Falloff is drawn outward from a line, forming a cylindrical falloff.
- Plane : Falloff is drawn outward from a plane.
Shape Orientation
Along which axis the shape should be drawn.
Outer Range
The outer range from which the falloff is calculated from.
Inner Range
The inner range from which the falloff is calculated from.
Curve Power
How quickly the falloff drops to 0 at the outer falloff.
Invert
Invert the direction of the falloff.
Inputs
These properties control the 3D transforms of the node. Transforms will generally be inherited by child nodes, although they can be ignored through the Inherit Transform Channels attributes.
| Parameter | Details |
|---|---|
| Position X | The objects position along the local x-axis. |
| Position Y | The objects position along the local y-axis. |
| Position Z | The objects position along the local z-axis. |
| Rotation Heading | The objects rotation around the local y-axis. |
| Rotation Pitch | The objects rotation around the local x-axis. |
| Rotation Bank | The objects rotation around the local z-axis. |
| Scale X | The objects scale along the local x-axis. |
| Scale Y | The objects scale along the local y-axis. |
| Scale Z | The objects scale along the local z-axis. |
Control the inheritance of the transforms from the parent.
| Parameter | Details |
|---|---|
| Position | Toggle inheritance of the Position from the parent. |
| Rotation | Toggle inheritance of the Rotation from the parent. |
| Scale | Toggle inheritance of the Scale from the parent. |
| World Position Only | Inherit the world position from the parent only, rotation and scale will be ignored. Overrides above properties. |
| Inherit Time | Toggle inheritance of time from the parent. |
These properties control the core behaviours of the node.
| Parameter | Details |
|---|---|
| Apply Mode |
Choose whether the deformer applies to the individual vertices or the mesh chunks.
|
| Transform Space |
Choose which transform space the deformer uses for deformation. Does not affect falloffs.
|
| Blend Amount | Global override for how much the deformer affects the mesh. |
| Time Mode |
How the deformer updates with relation to the timecode.
|
| Iterations | The number of processing iterations. the more iterations, the longer the processing time. |
| Separation Distance | The target separation distance. |
These properties control where the deformer affects the geometry.
| Parameter | Details |
|---|---|
| Enabled | Enable falloff from the position of the deformer. |
| Shape |
Select which shape to use to draw falloff from.
|
| Shape Orientation | Along which axis the shape should be drawn. |
| Outer Range | The outer range from which the falloff is calculated from. |
| Inner Range | The inner range from which the falloff is calculated from. |
| Curve Power | How quickly the falloff drops to 0 at the outer falloff. |
| Invert | Invert the direction of the falloff. |
| Name | Description | Typical Input |
|---|---|---|
| Falloff Node | Use an input node to control the transformation values of the falloff. | Null |
| Generated Weightmap | Add a weightmap to vary the strength of the deformer across the surface. | Generate Weightmap |
| Transform Modifiers | Apply the transforms of another node to this node. | Null |
| Target Node | Modifiy the rotations of the node to always direct the z axis towards the input. | Null |
| Local Transform Override | Apply the transforms of another node to this node, relative to its parent. | Null |