Skip to main content

Instance

Instance

The Instance node places copies of an object across a surface or along fibres: for example, feathers over a bird, scales over a creature, or leaves and pebbles over the ground. It copies the objects connected to its second input (meshes, fibres or feathers) onto each point or element (such as each fibre) of the objects connected to its first input, and its settings vary the size, angle and choice of object for each copy. See Feathers for a complete example.

Inputs​

InputAcceptsDescription
0Fibres, Particles and MeshesThe objects to place the instances on.
1Any object, including feathersThe objects to instance. The node produces nothing without one.

Parameters​

ParameterDescription
Instance ToElements (the default) places one instance on each element, such as each fibre. Points places an instance on every incoming point.
AlignmentThe direction to align each instance to, as a vector or an expression. Defaults to $N.
Alignment VariationAdds random variation to the alignment.
OffsetAn offset for each instance. For example, $N * 0.1 moves every instance 0.1 units away from the surface.
ScaleThe scale of each instance, which can be an expression such as noise($id * 10).
Scale VariationRandomizes the scale.
TwistTwists each instance around its alignment axis.
Twist VariationRandomizes the twist of each instance.
Up VectorThe up vector used to orient the instances.
Axis Of AlignmentWhich axis of the instanced object (X, Y or Z) is aligned to the Alignment vector.

Objects​

ParameterDescription
Source ObjectsWhich objects to use when the second input has more than one: First (the default) uses only the first object, All instances every object, Expression picks an object with the Object Expression, and Cycle cycles through the objects in turn.
Object ExpressionWith Expression, an expression that returns the index of the object to use for each instance, from 0 to the number of objects minus 1. Ignored for the other Source Objects options.
Inherit AttributesA space-separated list of attributes to inherit from the geometry the instances are placed on.
DeformWhen on, the instances deform to follow the shape of the fibres they're placed on. This needs fibres as the first input. Deformed instances are always generated as copies.
Generate AsAs Input (the default) creates a new copy of the geometry for each instance. As Instances (if supported) uses the renderer's own instancing, where it can. Feathers are always generated as copies.

Selection​

ParameterDescription
Point SelectionAn expression that selects the points to place instances on. A point is used when the result is 1.
Element Point IndexThe point along each element where the instance is placed.

Local Variables​

You can use these variables in the Instance node's expressions.

VariableDescription
instanceNumThe index of the current instance.
instanceCountThe number of instances.
vertexNumThe index of the current instance's vertex within its element.
vertexCountThe number of vertices in the element.