Variant Editor
The Variant Editor provides an interface for adding, removing, and modifying variants in USD.
Enabling the Extension
In any supported Kit based App, the Variant Editor can be installed and enabled via the Extension Manager.
Simply search for Variant Editor
, then install and enable the extension.
Once enabled, the Variant Presenter can be accessed the following ways:
Selecting
Tools > Variants > Variant Editor
.The “Edit Variant” button in the Variants section of the Property Panel.
The “Edit Variant” button in the Variant Presenter.
Right-clicking a prim in the stage or viewport and selecting
Add > Add Variant
.Right-clicking on an asset in the content browser and selected
Create Variant Set
.
Variant Editor Window
The Variant Set Prim Location can be set using the field at the top of the window. The Variant Set List
on the left side of the window can then be used to manage variant sets on the Variant Set Prim. When a variant is selected from a variant set, the Prim List
on the right side of the window will provide access to the properties being set by that variant.
Feature |
Result |
---|---|
Variant Set Prim Location |
Sets the target prim on which variant sets will be edited. |
Note
The Variant Set Prim Location field defaults to the prim that was selected when the editor was opened. If no prim was selected, it instead defaults to the stage root.
Variant Set List
The list on the left side of the main window displays all variant sets on the Variant Set Prim. From this interface, variant sets and variants can be created and selected.
Selecting a variant from a variant set will make it the current variant for that set. That variant can then be edited from the Prim List
on the right side of the main window.
Feature |
Result |
---|---|
Add Variant Set |
Adds a new variant set to the target prim. |
Remove Variant Set |
Removes the variant set and all child variants. |
Add Variant |
Adds a new variant to the variant set. |
Remove Variant |
Removes the variant from the variant set. |
Right-clicking a variant set will provide the following options:
Option |
Result |
---|---|
Remove |
Removes the selected variant set and all child variants. |
Rename |
Provides a text field to rename the selected variant set. |
Clear Variant Selection |
Clears any selection for the selected variant set. |
Right-clicking a variant within a variant set will provide the following options:
Option |
Result |
---|---|
Remove |
Removes the selected variant from the parent variant set. |
Rename |
Provides a text field to rename the selected variant. |
Duplicate |
Creates a copy of the selected variant within the parent variant set. |
Clear Selection |
Clears any selection for the parent variant set. |
Prim List
The Prim List on the right side of the main window displays any prims being accessed by the variant currently selected in the Variant Set List
.
From this interface, prims can be added to or removed from this variant. The properties of such prims can then be added, removed, and modified as needed. Prim properties being set by the variant are listed beneath their parent prim.
Feature |
Result |
---|---|
Add Prim |
Adds the target prim picked from the stage to the Prim List. |
Remove Prim |
Pressing the red ‘X’ in the top right corner of a target prim removes it and any of its properties from the current variant. |
Add Property |
Add a property from a list of valid properties for the target prim. |
Remove Property |
Pressing the grey ‘X’ on the right side of a property removes that property from the current variant. |
Property Watcher |
Watches a property to determine opinion hierarchy and, if pressed, clears local opinions. |
Right-clicking a target prim will provide the following option:
Option |
Result |
---|---|
Remove Prim |
Removes the prim and any of its properties from the current variant. |
Right-clicking a property will provide the following option:
Option |
Result |
---|---|
Remove Property |
Removes the property from the current variant. |
Features Supported
Works with all prim types, including instanceable, referenced, and payloads (see limitations below.)
Limitations
Variants contained within a reference or payload must be edited from the source file.
Variants are subject to USD scene composition standards and as such, variant opinions can be overridden by local or inherited opinions.
Variant Editor does not currently support Undo/Redo operations.
The order of list items cannot be changed.
Only variants in the current authoring layer can be modified in the Variant Editor.