`selector_instance`

Selects one of several geometries or instance shapes to instantiate, based on a per-point property or an array of IDs. The output can be connected into a set_instance_geometry or set_instance_shape node.

You can also daisy-chain several selector_instance nodes together, for example, to select between pine and leafy trees based on one criterion and then select specific versions of each type based on another criterion.

Inputs

`instance_shapes`

One or more objects or arrays of objects to be instanced. These can be ordinary geometric objects, or instance shapes such as the outputs of nodes like selector_instance, geo_instance, or render_archive_instance.

`selector_property`

The name of a long property of a points object that specifies which instance shape to instantiate per point, where 0 is the first element of the instance_shapes array, 1 is the second, and so on.

`wrap_out_of_range`

Wraps instance ID values that exceed the size of the array of instance shapes.

`preview_geometry`

An optional geometric object to be used for previewing in the viewports, but not rendering. If an object is connected here, it overrides any preview geometry already set for objects that are connected to instance_shapes by a geo_instance or similar node.

`name`

An optional identifier.

`transform`

A transform matrix to apply to the instanced geometry.

Outputs