3D Instantiate

Create a clone of an object in a 3D Scene.

The clone can be linked to an animation in which case the animation track will be cloned as well.

All materials & skeletons applied to the nodes and objects cloned will be duplicated.

The clone can be automatically deleted when the animation ends, in which case every material, animation, skeleton that is no longer used will also be deleted.

Properties

• Scene 3d name : Name of the 3d scene where the object to clone is present
  Default : empty

• Node 3d name : Name of the node to clone
  Default : empty

• Suffix : Suffix to be added to the end of the name of the clones
  Default : empty

• Animation 3d name : Name of the animation track to clone along with the node
  Default : empty

• Marker : Mark the clone with a text
  Default : empty
  This marker will be output by the node on the Marker Deleted pin when the clone is deleted automatically if the Auto Delete After End Animation option is enabled.

• Force enable root Node : Toggle to force the cloned node to be enabled
  Default : ON
  This is useful to create clones that appear but keep the original node hidden from view (e.g. disabled).

• Auto Start Animation : Toggle to automatically play the animation when the clone appears
  Default : OFF

• Auto Delete After End Animation : Toggle to automatically delete the node and all associated assets after the end of the animation track
  Default : OFF
  This option is available only if the Auto Start Animation is enabled

• Debug Console Enable : Toggle to display in the Console panel information on cloning times
  Default : OFF

• Add suffix to Tag : Toggle to also add the suffix to the Tag set in the Editor panel when the node/instances are selected in the 3D Scenes panel
  Default : OFF

• Disable UI update : Toggle to disable the refresh of the 3D Scenes panel with the elements cloned.
  Default : OFF
  This can improve performance in a show where many clones are created simultaneously.

Inputs

Outputs

Example

In this example:

• Scene 3d name : 3D
• Node 3d name : Dodecahedron
• Suffx : – clone
• Animation 3d name : Animation
• Force enable root Node : ON
• Auto Start Animation : ON
• Auto Delete After End Animation : ON
  

Alternative

It is also possible to drag & drop a (3D scene) node directly in the Graph Editor to create an Instantiate node in the graph.

Notes on Instantiating

If the animation (the one to clone) track is already and playing when it is cloned, and if the instantiation is done with the option Auto Start Animation disabled, then the cloned animation will also be playing when cloned and it will loop indefinitely even if the Auto Delete After End Animation option is enabled.

Furthermore, if the instance is cloned in this state, it will not be targeted by the designer.deleteAllRunningInstance() function.