Variant Helper#

The Variant Helper is a scripted point helper that helps create simple geometry variants. The Variant Helper is supported by Live mode - which will synchronize the current active variant.

The Variant Helper is available in the Create Panel: Create Panel > Helpers > NVIDIA Omniverse

Note

The Variant Helper is expected to be at scene root level. Nested Variant Helpers are not supported.

Using Variants#

USD Variants

Variant Options

Utility

Picked Variant

The top control is a label that provides the user the current variant marked as the selected variant.

Variant List


  • Objects in List

Lists all variants that are to be exported with the USD.
  • Selection

The selected variant and its children are made visible.
  • Double Click on selections

Makes that selection your current picked variant and adjusts the label as such.

Add +

Adds selected object to the variants list.

Remove -

Removes the selected item from the variants list. The item below replaces the removed variant as your selection.

Display Controls


  • Display All

Displays all variants for the Max user.

Creating Variants#

To create a USD Variant in 3ds Max, use the Omniverse USD Variants Helper.

Setup#

  1. In a new scene, create 3 objects (Sphere, Cube, Cone).

  2. Center them on the world origin (0,0,0)

Creating Omniverse Variant Helpers#

  1. Select the OmniVariants helper. Create Panel > Helpers (tab) > |omni| (Drop Down Menu)

  2. Click and drag in the viewport to create an OmniVariants helper.

Adding Variants to the Helper#

  1. With the Variant Helper selected, switch over to the Modify Tab.

  2. In the modifier stack, you should see OmniVariants. Select it.

  3. When selected, the Modifier should display the USD Variants Panel below the Modifier List.

  4. In the USD Variants panel, select the + below the list.

  5. In the Hierarchy/Layer panel, select the Sphere you created in Setup.

  6. In the USD Variants panel, select the + again.

  7. In the Hierarchy/Layer panel, select the Cube you created in Setup.

  8. In the USD Variants panel, select the + again.

  9. In the Hierarchy/Layer panel, select the Cone you created in Setup.

  10. Your Variants List should now contain all 3 objects.

Displaying Variants#

  1. In the USD Variants Panel, select and de-select the Show all check box.

  2. Select a variant in the list to display just the variant of your choosing.

Export Behavior#

When exporting a Prop with variants, the items listed by variants and their children should not be considered as objects themselves because they are part of an object with variants.