User Interface#

Warning

The Maya Legacy Connector is no longer supported. All users should move to Maya Native.

Signing-In#

Once the plug-in is installed, users must sign into an Omniverse server. Users can do so from two places in the Maya plug-in:

Connections are made to Omniverse via the connection dialog.

Users can take 2 routs to the connection window. 1. From the Omniverse Main Menu drop-down users can go directly to the connect menu. 2. From the Omniverse Shelf you can quickly get to the connect menu.

Menu Items	Action
Username	Your Omniverse Username
Server Information	The address to your Omniverse Nucleus

Note

The server address field will store and auto-populate known recent servers.

After the NVIDIA Omniverse™ Maya Connector Plug-In has been loaded and signed in to, users can now Live Sync, Open Omniverse Nucleus / Local USD files, and Export USD files to your Omniverse Nucleus.

Main Menu#

The Omniverse menu grants access to all the needed features of Omniverse Interaction.

Menu Items	Action
Connectivity	There are several connectivity options: Connect: Launches Sign-In dialog to connect user to Omniverse Disconnect: Breaks your connection with an Omniverse server
Export	Export All: Exports all exportable objects in the scene
Save USD	Saves the changes from the current Maya scene to the currently open USD file.
USD	Sub menu for USD file operations
Create Variant	Sets up a USD model variant
Settings	Settings related to the Omniverse Plugin
Help Menu	Grants access to Help Items

USD Menu#

Menu Items	Action
Open Recent	Lists recently opened USD assets
Open USD	Launches a File dialog that allows the user to navigate the contents of Omniverse and open USD files. Opens a USD file, clears the current Maya scene, loads the USD asset, and syncs.
Import USD	Imports USD Files from a Local/Network Drive Location. This collects materials to the location of the current USD file.
Connect USD	Connects an existing Native Maya file to an existing USD file on Omniverse. This allows a user to initiate a live connection without reexporting the USD.
Close USD	Closes the USD file and resets the Maya file to a new blank scene.

Help Menu#

Ref#	Menu Items	Action
1	Maya Plug-In Documentation	Opens the doc for the Maya plug-in
2	Get Support	Link to user forums and Omniverse Support
3	Release Notes	Link to release notes
4	About	Informs user of the version specific information of Maya Omniverse plug-in

USD Export File Browser#

Exporting files from Maya is done through the Export File Dialog.

Ref#	Menu Items	Definition
1	Navigation	There are several navigation options: Breadcrumbs: Displays the path to the current directory or file the user has selected. Users can select any part of the existing path Add Folder: Adds a new folder in your current directory Search Bar: Contextual search for files that applies to the file hierarchy adn the content body.
2	File Hierarchy	Directory/File list
3	Content Body	File and directory list for the selected directory in the file hierarchy
4	Export Options	Export Options can be configured here. See below for various options.
5	File information	There are several file options: File Name: The name you want the file to be. File Type: Lists available export types. (See Note Below) Export: Exports with chosen settings. Cancel: Cancels the Export

Note

You can export to USDA (Ascii) format by hard typing the extension .usda on export if exporting to a local drive (not an omniverse server).

USD Export Options#

Export Options	Definition
Export Type Dropdown	Selects the asset Prop: Standard Static Asset Prop Animation Clip: Simple translational Animations (.anim.usd) Skeletal Mesh: A mesh containing skinning information and joints. (.skel.usd) Skeletal Animation: A mesh containing joint animation and skin clusters. (.skelanim.usd) Animated Point Cache: Animated “point clouds” (.cache.usd)
Export Options	Selects what to export: All: Exports everything in the scene Select: Exports everything selected in the current scene Sets: Select sets in Maya can be used as an export selection type Default Prim: Sets the Default Prim of the exported USD, defaults to “World” Export Visible Only: Exports only visible nodes in combination with the current export selection You can also configure your export with the following values:
Use Animation	Enabled: Will export animation from timeline Start Frame: First frame to be exported End Frame: Last frame to include in the export Step: Allows skipping of frames, use 1 for all frames
Include Instances	Export instances. A parent xform will be inserted as needed to conform with USD.
Include MDL	Will include all MDLs referenced in the file Default: Uses global core material path and copies custom materials to user defined directory. Include Dependencies: Copies all referenced materials to user defined directory. USD Preview Surface: Will generate a USD Preview Surface and bake textures for export.
Include Cameras	Exports cameras in the scene.
Include Lights	Exports supported lights. see note below.
Nurbs Curves as USD Basis	Converts Nurbs curves to USD basis curves.
Include Hair Groom	Exports Xgen Grooms to USD - Xgen Hair Wrap Type - Xgen Hair UV Interp Type
Name Space Handling	Options for how to handle Maya name spaces when exporting to USD
Up Axis	Allows control over facing direction.
Batch Export	Will export each first level node as a unique USD file. Exported files will be re-composed into a new by either a Payload or Reference.
Move to Origin	When exporting an asset individually or in batch mode, exports the asset from origin.
Also Save Maya	Stores a copy of the Maya file on the Omniverse Nucleus

Processing Options	Definition
Pre Export Script MEL	Runs any scripted functions on scene prior to export.
Post Export Script MEL	Runs any scripted functions on scene after to export.

Additional Exported Files

Lists all associated/dependant files included in the export

Checkpoint

Creates a checkpoint and optional description. (For compatible servers only)

Exporting With Maya#

image.png

Open and Import USD Browsers#

With the open and import USD functions, you can open USD content directly in Maya.

The import USD function allows users to import USD and merge it with the currently opened USD file.

Options#

To quickly get to a file, paste an Omniverse URL into the filename field and press the Enter or Open button.

../_images/connect_maya_import-usd_dialogue.png

Ref #	Option	Result
1	Open Materials	Check to import materials. If Unchecked Materials will be ignored.
2	Prefer Material Type	Choose the render context for loading and displaying Materials in Maya: MDL: Imported materials will display using MDL. Preview Surface: Imported materials will display using USD Preview Surfaces.
3	Import Lights As	Choose how lights should be imported: Maya: Imported Lights will be converted to Maya Standard Lights. Arnold: Imported Lights will be converted to Maya Arnold Lights.
4	Object Name Collision	Choose what to do if there are naming conflicts with Imported Objects: Overwrite: Replace the existing object if in conflict. Skip: Keep the original and discard imported objects if name conflict exists. Modify: Adjusts names of imported object to avoid name conflicts. This option is only shown in Import dialog, not Open.
5	Material Name Collision	Choose what to do if there are naming conflicts with Imported Objects: Overwrite: Replace existing materials if in conflict. Skip: Keep the original and discard imported materials if in conflict. Modify: Adjusts names of imported materials to avoid name conflict. This option is only shown in Import dialog, not Open.

Omniverse Shelf#

Added in 100.1

The Omniverse Shelf allows connectivity and quick access to important Omniverse Functions.

../_images/connect_maya_omniverse-panel_main.png

Option	Result
Connect to Omniverse	Connects to an Omniverse Nucleus: Add Connection: Allows Additional Omniverse Servers to be added to your server connection list. Disconnect All: Disconnects Maya from all connected Nucleus servers.
Open USD	Opens a USD file locally or on a Nucleus
Save USD	Saves the current USD file.
Import USD	Imports a USD file into your current project.
Export USD	Exports current project file as a USD: Export All: Exports current project file as a USD. Export Selected: Exports the current selection of assets as a USD.
Share USD	Copies the location of the USD Files, if on nucleus, this link is shareable with other permitted nucleus users.
Live Sync	Enables real-time “live” editing: Live Sync All: Enables real-time “live” editing. Live Sync Excluding Materials: Enables real-time “live” editing but DOES NOT update materials. Link Maya to USD file: Links the currently opened scene with a USD file. Refer to Using the Connect USD tool in Maya (Video) for more information.
Create Variants	Creates a USD Variant container. Refer to USD Variants in Maya for details.
Plugin Settings	Opens the Omniverse Plugin Settings Panel. Refer to USD Variants in Maya for details.
Help	Links to this documentation.
About	Version and Technical Information about the Plugin.

Note

Connect, Export and Live Sync have additional options are in the right click menu.

Omniverse Settings#

The Omniverse Settings Panel allows access to some optional settings and features.

General Settings#

Option	Result
Auto Sign In on Startup	Signs into previous omniverse connection automatically
Echo Feedback	Messages and alerts from a nucleus server will be reported in the script editor.
Object Export Path	Folder Name / Relative Path Option to allow customization of output organization. Used when exporting assets with the option “split into multiple files”.
Native Light Conversion Scale	Allows Native Maya light power to be adjusted upon conversion.
Arnold Light Conversion Scale	Allows Arnold Light power to be adjusted upon conversion.
Destination MDL path	If un-altered (blank by default) the Destination path will always be the location of the exported USD file. You can however “hard-code” a common directory where you want ALL exported USD’s to store their MDLs.
Material Template Search Paths:	If you or your organization have created specialized BASE MDLs, you can select their paths here.
Material Collection Search Paths:	If you or your organization has created Variants based on BASE MDLs you can select their locations here.

Live Settings#

Note

For more information on Live Workflows visit. https://docs.omniverse.nvidia.com/prod_extensions/prod_extensions/ext_live.html

Option	Result
Selection Mode	Defines the set of objects that are Live-Update connected
Live Transform Edits	If enabled, transform changes are Live updated
Live Material Edits	If enabled, material edits/assignments are Live updated
Live Camera Edits	If enabled, Camera transforms and parameters are Live updated
Live Light Edits	If enabled, Light transforms and parameters are Live updated
Live Timeline Edits	If enabled, scrubbing the timeline in 3dsMax will send the current frame as the USD file during Live update
Live Modeling	If enabled, modeling changes will be sent during Live Update