Documentation / Node reference / geo nodes
geo/Instance
Draws the geometry on input 0 once per point of input 1, on the GPU.
Copy
Each object on input 0 receives the per-instance attributes read at draw time: INSTANCE_P (the point positions of input 1) and INSTANCE_Q (a quaternion built from the point normals, identity when input 1 carries none). The geometry itself is untouched, so one draw call covers every copy. This only shows up on screen once the MATERIAL reads those attributes, which is why creating this node from the tab menu also seeds a mat/MeshBuilder holding a code/Instance node, plus the geo/Material pointing at it. Use geo/Copy instead when each copy must differ in geometry, or be modified afterwards.
Parameters
| Name | Type | What it does |
|---|---|---|
| group | String | Restrict instancing to an object group on input 0. Empty instances every object; objects outside the group pass through untouched. |
| copyAttributes | AttributeNames | Point attributes of input 1 to carry over as per-instance attributes, so the material can shade each copy differently (a per-point color or scale). |
See also
- geo/Copy
- mat/MeshBuilder
- code/Instance
This page is generated from the engine, so it describes the release you can download. The same text is in the editor's Help panel next to the node itself.