Use the Instantiator node to replicate the appearance of a 3D node, or a tree of 3D nodes, that the Instantiator node targets.

Instantiator node contains a reference to a target node or a tree of nodes. When Kanzi renders the Instantiator node, the Instantiator node copies the appearance of the node that it targets. This means that all changes to the target node are always reflected in the Instantiator node. For example, you can use the Instantiator node to create a reflection.

Each Instantiator node has a unique transformation, so you can use more than one Instantiator node to target the same node. You cannot override other properties in the Instantiator node, so all instances are identical. However, each instantiator node is rendered separately. For example, this enables lights to differently affect Instantiator nodes in different positions.

To create truly unique instances of a node, convert that node to a prefab, and create instances of that prefab.

Note that Instantiator nodes affect only rendering. Because the layout size of an Instantiator node is 0, you cannot use Instantiator nodes in layouts.

To create a reflection using an Instantiator node.

Inherits properties and message types from Instantiator3DMetadata.

Instantiator3D.Instantiator3D:create(name) ¶

Creates an Instantiator node.

Parameters

name

(string)

The name of the Instantiator node.

Return Values

(Instantiator3D)

The created Instantiator node.