Work with instances in Bifrost-USD

Use a define_usd_point_instancer node to to create USD instances based on a Bifrost points object. The instance prototypes can come from Bifrost instances or from USD prims.

1. Right-click on the prim_definitions port of an add_to_stage node or on the children port of a prim definition node, and choose Create Node > Usd::PointInstancer::define_usd_point_instancer (or Usd::Prim::define_usd_point_instancer in earlier versions).

2. Connect a Bifrost points object, such as the output of a scatter_points node, to the points input of the define_usd_point_instancer node.

   If the points object defines Bifrost instances, such as the output of a create_instances node, the instance geometries and selection options are used automatically. However, note that the preview_mode of create_instances is set to PreviewGeometry by default — make sure to set it to InstanceGeometry if you want to output the final geometry.

3. If you want to use instance prototypes defined in USD, right-click on the prototype_definitions port of the define_usd_point_instancer node, select an option from the Create Node menu, and then set the new prim definition's parameters and connections as desired.

   Repeat to add as many instances prototypes as desired. Make sure to give each prim definition a unique path.

4. Use the Selection options to control how the prototypes are instanced on the points.