Distributes points into structures like rows, columns, step effects, etc. One of these nodes is created by default when you first create a MASH network.
- Number of Points
- Determines the number of points (which the Instancer then places object instances on) to create.
- Arrangement
-
Determines the method of distribution. Options include:
- Linear: Distributes points along a line.
- Radial: Distributes points around the circumference of a circle, or in a spiral / helix.
- Spherical: Distributes points randomly on the surface of an imaginary sphere. Auto-animates.
- Mesh: Distributes points along or within a polygon mesh.
- inPositionPP: Uses particle positions from nParticles / SOuP to determine distribution.
- Grid: Distributes points into a 2D or 3D matrix.
- Initial State: Allows you place points at the same position/rotation/scale as manually specified transforms.
Linear Settings
- Distance X, Distance Y, Distance Z
- Controls the spacing between points in each of the three axes.
- Scale X, Scale Y, Scale Z
- Controls the scale of all object instances.
- Rotate X, Rotate Y, Rotate Z
- Controls the rotation of all object instances.
- Offset
- Adds an incrementing offset value to the three transforms per object.
Radial Settings
- Radius
- Determines the radius around the center on which to distribute the points.
- Angle (degrees)
- Determines the angle around the center (in degrees) to distribute the points.
- Z Offset
- Determines the length along which to distribute the points in the Z axis. Lower values result in a circular distribution, while larger values result in a helix.
- Radial Axis
- Determines the axis on which the insances are laid out
- Calculate Rotation
- Automatically rotates to face down the circumference of the circle.
- Ignore Ramps
- Allows you to mute the effect of any of the ramps in the Ramps section.
Grid Settings
- Distance X, Distance Y, Distance Z
- Controls the spacing between points in each of the three axes.
- Grid X, Grid Y, Grid Z
- Controls the number of columns and rows in the grid.
Spherical Settings
- Angle X (degrees), Angle Y (degrees)
- Determines the angle around the center (in degrees) in each axis to distribute the points.
- Radius
- Determines the radius around the center on which to distribute the points.
- Animation Speed
- Changes the speed at which the points move around the sphere within an Animation Time range.
- Animation Time
- Moves the points around the sphere according to the Animation Speed.
- Ignore Ramps
- Allows you to mute the effect of any of the ramps in the Ramps section.
Mesh Settings
- Method
-
When Arrangement is set to Mesh, this attribute determines the method of distribution along the connected mesh. Options include:
- Scatter: Distributes points randomly on the surface of the mesh.
- Vertex: Distributes points on the mesh's vertices.
- Random Vertex: Distributes points on random vertices.
- Face Centre: Distributes points at the center of faces.
- Random Face Centre: Distributes points at the center of random faces.
- Voxel: Fills the connected mesh with points.
- Vertex Selection Set: Distributes points on components belonging to a connected selection set.
- Edge: Distributes points along the center of mesh edges.
- Random Edge: Distributes points along the center of random edges.
- Push along normal
- Move the points along the normals of the connected mesh.
- Up Vector
- Specify the up facing direction of each object instance.
- Input Mesh
- Displays the current mesh being used as input. You can middle-drag a mesh into this field or right-click to connect the selected mesh. If a mesh is already connected, you can also right-click to remove or show it in the Outliner.
- Selection Set
- Displays the current vertex selection set being used as input. You can middle-drag a mesh into this field or right-click to connect the selected selection set. If a selection set is already connected, you can also right-click to remove or show it in the Outliner. Only functional when Method is set to Vertex Selection Set.
- Calculate Rotation
- Automatically rotates points according to the normals of the mesh.
- Flood Mesh
- Automatically fills the mesh with instances of the object, overriding the Number of Points.
- Ignore Ramps
- Allows you to mute the effect of any of the ramps in the Ramps section.
- Scatter uses Face Area
- When enabled, points are scattered based on the individual area of each face. Typically results in a more even distribution when Method is set to Scatter.
Face/Edge Settings
These options are available when Method is set to Face Centre, Random Face Centre, Edge, or Random Edge.
- Enable Scaling
- Instances will be scaled according to the area of the face on which they are placed.
- Scale Multiplier
- Applies a multiplier to the Use Face Scale setting.
- Edge Alignment
- Determines which part of an edge to align to when Method is set to Edge or Random Edge.
Voxel Settings
These options are available when Method is set to Voxel.
- Voxel Size
- Specifies the size of the voxels in which to place the points. A smaller voxel size results in more points but slower calculations.
- Border Size
- Specifies the size of the border around the object in which voxels are not generated.
- Pattern Offset
- Offsets alternating rows / columns of voxels in the specified axis.
- Voxel Container
- Displays the current voxel bounding box if one exists.
- Create Container
- Creates a voxel bounding box, allowing you to animate your mesh moving through a space while still filled with voxels.
Initial State
These options are available when Method is set to Initial State.
- Initial Transforms
- Displays a list of transforms currently determining the initial state of the MASH points. Points are distributed by ID in order from the top of the list to the bottom and loop if there are more points than transforms. You can middle-drag a transform into this field or right-click to add the selected transform. You can also select any transform in the list and right-click to remove it or show it in the Outliner.
Note: If you do not specify custom transforms then the transforms of the objects being instanced are automatically used.
Strength
- Strength
- Fades the node's effect for all the points at the same time.
- Random Strength
- Smoothly fades the node's effect on all the points in a random order.
- Step Strength
- Turns the node's effect off one point at a time.
- Strength Map
- Determines the input file (2D texture, animated texture, etc) that controls the shape of this node's effect.
- Map Projection Axis
- Determines the axis along which the Strength Map is projected.
- Map Helper
- Displays the object being used to interactively place the
Strength Map in the scene. You can right-click the field to create a new helper object (a plane) if none exists. You can also middle-drag a mesh into this field or right-click to connect a selected mesh. If a mesh is already connected, you can also right-click to break its connection or show it in the Outliner.
Note: For the best results, assign the same texture to both the Strength Map and the Map Helper (this automatically happens when creating a new helper object).
- Random Seed
- Allows you to adjust the randomization of object arrangement.
Ramps
- Bias Ramp
- Controls the weighting of the node's translation effect on points over distance from the center.
- Rotation Ramp
- Controls the weighting of the node's translation effect on points over distance from the center.
- Scale Ramp
- Controls the weighting of the node's scale effect on points over distance from the center.