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.
| Input | Accepts | Description |
|---|
| 0 | Fibres, Particles and Meshes | The objects to place the instances on. |
| 1 | Any object, including feathers | The objects to instance. The node produces nothing without one. |
Parameters
| Parameter | Description |
|---|
| Instance To | Elements (the default) places one instance on each element, such as each fibre. Points places an instance on every incoming point. |
| Alignment | The direction to align each instance to, as a vector or an expression. Defaults to $N. |
| Alignment Variation | Adds random variation to the alignment. |
| Offset | An offset for each instance. For example, $N * 0.1 moves every instance 0.1 units away from the surface. |
| Scale | The scale of each instance, which can be an expression such as noise($id * 10). |
| Scale Variation | Randomizes the scale. |
| Twist | Twists each instance around its alignment axis. |
| Twist Variation | Randomizes the twist of each instance. |
| Up Vector | The up vector used to orient the instances. |
| Axis Of Alignment | Which axis of the instanced object (X, Y or Z) is aligned to the Alignment vector. |
Objects
| Parameter | Description |
|---|
| Source Objects | Which 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 Expression | With 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 Attributes | A space-separated list of attributes to inherit from the geometry the instances are placed on. |
| Deform | When 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 As | As 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
| Parameter | Description |
|---|
| Point Selection | An expression that selects the points to place instances on. A point is used when the result is 1. |
| Element Point Index | The point along each element where the instance is placed. |
Local Variables
You can use these variables in the Instance node's expressions.
| Variable | Description |
|---|
instanceNum | The index of the current instance. |
instanceCount | The number of instances. |
vertexNum | The index of the current instance's vertex within its element. |
vertexCount | The number of vertices in the element. |