|On this page|
USD allows primitives to have variants: separate named groups of properties you can switch between. This is often used to switch between different geometry representations of a prim. For example, a Lamp prim might contain variants representing different sizes and styles of lamp, allowing the layout artist to choose one appropriate to the scene.
The node provides some convenient tools to manage variants:
Show all the geometry variants on a prim side-by-side in the viewer.
Set the active variant in different variant sets on the selected prim(s).
Duplicate the variant geometry from the selected prim(s) into new prims.
Set up an Explore Variants node
Now you can follow the steps below to use the node to show, set, or duplicate variants.
Display available variants on a prim or prims in the viewer
Set the active variants in different variant sets on a prim or prims
Duplicate variant geometry into new prims
If you only want to display certain variant sets, or certain variants, you can enter names/patterns in the Variant Set Filter and Variant Filter parameters.
Tips and notes
USD prims can have multiple variant sets containing different variants. For example, you could have a
modelvariant set with different geometry, and a
paintvariant set with different paint jobs. This node shows the variants in all variant sets across all selected prims.
When this node is active in the viewer (select the node and press Enter in the viewer to switch to the Handles tool), you can press to open a context menu that lets you switch between the modes.
A space-separated list of prims to visualize, set the variant on, or copy variants from, depending on the Mode.
When Mode is Duplicate Variants, this is the destination path under which the node creates duplicated prims.
Creates new primitives of the selected variants with the specified variant and variant set, under the Destination Prim.
Displays all available variants under the specified primitives.
Sets the variant and variant set for the specified primitives.
Creates the duplicated variants, centered at the world origin.
Creates/displays the variants in a vertical grid, along the XY plane with 1 row per primitive, with its bottom left corner at the world origin.
Side by Side (XZ)
Creates/displays the variants in a horizontal grid, along the XZ plane with 1 row per primitive, with its bottom left corner at the world origin.
Adds spacing between variants created/displayed in a grid.
When enabled, uses each variants bounds to avoid overlaps when created/displayed in a grid.
Space out the variants visually using their actual pivot points.
Space out the variants based on the centroids of the models.
Space out the variants based on their bottoms (minimum Y coordinate)
Select the variants to duplicate or set, from the variants created in Explore Variants mode.
When setting variants, if multiple variants are selected for a single primitive, the last selected variant will be used.