Method

This node clones 3D objects in a regular 3D grid arrangement, using the shape of a 3D object to define the region of space that is filled. The resolution of the grid is defined by the Num Voxels X/Y/Z parameters. A 3D object node must be connected to the Source Objects input to define the voxelised shape the clones are arranged in for this node to be operational. The connected node must be either a 3D Object, a 3D Shape or a Text node. The object must be active in the scene by being connected to a valid path to the root node.

If Scale Clones By Voxel Size is selected the clones are automatically scaled so that a unit cube would fit a single voxel cell. If Rotate Clones By Normals is selected the clones are orientated so that they face along the normal direction of the closest point on the mesh to each voxel.

Example
Example Nodegraph

Transform

Name Description
Position X Move its position along the x-axis in local space.
Position Y Move its position along the y-axis in local space.
Position Z Move its position along the z-axis in local space.
Rotation Heading Rotate the object about the x-axis.
Rotation Pitch Rotate the object about the y-axis.
Rotation Bank Rotate the object about the z-axis.
Scale X Scale along the x-axis.
Scale Y Scale along the y-axis.
Scale Z Scale along the z-axis.

Inherit Transform Channels

Toggle which transform channels should be inherited. By default, all are on.

Attributes

Name Description
Num Voxels X / Y / Z Voxel size along the X, Y, and Z axes.
Node Spawn Mode Change the order in which the cloned objects are assigned to individual clone instances.
  • All, All of the connected objects are rendered for every clone.
  • Iterate, The objects are rendered sequentially by clone. For example, the first clone renders the first object, the second clone renders the second object and so on.
  • Random, The objects are rendered randomly by clone, and are generated at random points from the clone system.
Rotate Clone by Normals Rotate clones to match the normals of the volume.
Scale Clones By Voxel Size Scales the cloned objects to match the voxel sizes.
Clone Scale Scale the size of all the clones.
Rotation Stiffness How much clones resist rotating.
Scale Stiffness How much clones resist rotating.

Inputs

Name Description Typical Node Input
Source Objects Source Object from which all the clones will be generated.. 3D Object
Effectors Manipulates the clones after they are spawned. Plain Effector
Transform Modifier Links all transform properties to the input node. Null
Target Node Always faces the x-axis towards the inputs anchor point. Null
Local Transform Override Override the transformation values of the node, relative to its parent. Null

Outputs

Nodes that are to be cloned by a Cloner should be connected to the output of this node. 3D Objects, 3D Shapes, and Image Planes may be connected, as well as other Cloners.