|On this page|
This node is part of the network created by the Component Builder tool. The component builder network gives you a framework in LOPs to create a Component model (usually a prop, such as a chair or tree) and export it to USD for re-use.
The default network created by the Component Builder tool does not include this node. If you want the component to have geometry variants, you can insert this node between the initial Component Geometry node and the Component Material node. This node has a multi-input, which lets you wire in multiple Component Geometry nodes, each representing a variant. This node also provides a number mode, which allows you to generate geometry variants procedurally.
By default the name of each input’s geometry variant is set on the corresponding Component Geometry node using the Advanced ▸ Geo Variant Name parameter. The default uses the name of the node as the variant name.
See how to use the component builder tool for more information.
Currently the component builder network does not support multiple instances of this node connected to the same Component Output.
@GEOVARIANTINDEXcontext option represents each input or variant number, starting from 0.
Add Variant blocks can be used as inputs to this node, to generate additional variant sets.
The Number mode is equivalent to putting this node inside of a For Each block. This new mode is necessary because using a For Each block is no longer possible, due to some internal changes made to this node.
The name of the geometry variant set.
Whether the variants should come from each connected input, or have a specified number generated from the first input. When the source mode is set to number, the first input is cooked N times.
Variant Name Source
Whether the variant name should come from the connected Component Geometry LOPs, or be set using an expression on this node. You should generally leave this set to Component Geometry Inputs.
Variant Name Prefix
An optional prefix added to each input’s variant name.
The name for each variant. '@index' is replaced with the variant index number. If '@input' is missing, the variant number will automatically be added to the end of the variant name.
This parameter can be enable to specify the current working variant. This selection is a temporary variant choice, and is not used by the Component Output. By default, the last input is set as the current variant.