This page provides information on the USD import and export workflows in V-Ray for Maya.

Starting with V-Ray 6, update 2 the default USD translator becomes Hydra compatible. 


Import Workflow


USD files can be loaded in Maya and rendered with V-Ray using the MayaUSD plugin with mayaUsdProxy nodes.

We recommend following a standard workflow with MayaUSD when rendering with V-Ray. See the video for more.

  • In Maya, go to Create > Universal Scene Description (USD) > Stage From File...
  • Locate the desired USD file in the directory window.
  • Click on Create.

<iframe width="560" height="315" src="https://www.youtube.com/embed/3P8iUmzk2f0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>



Importing V-Ray materials using USD files


The standard workflow imports V-Ray materials as Maya materials.

  • V-Ray materials that are exported as USD files can be imported into Maya as native V-Ray materials using the mayaUSDImport command.
mayaUSDImport -file "/path/to/file.usd" -primPath "/" -shadingMode "vray" "none"

  • Alternatively, there is an interface menu equivalent to the mayaUSDImport command. To import a USD file with native V-Ray materials, go to File > Import. In the pop-up menu, set the File Type to USD Import. Set the Plug-in Configuration to V-Ray.


 



Importing V-Ray Physical Cameras using USD files

USD files can be used to import V-Ray Physical Cameras and all their attributes using the mayaUSDImport command. 

mayaUSDImport -file"/path/to/file.usd" -primPath "/"

If you are using a zip-installed V-Ray 5, update 2, for Maya or newer, make sure to set up the PXR_PLUGINPATH_NAME environment variable. Otherwise, exporting and importing V-Ray Physical Cameras is impossible. For more information on setting up environment variables, please visit the Installation from zip page.



Export Workflow


  • In the File > Export All Options window, set the File Type to USD Export and choose whether the materials are exported as USD Preview Surface or as V-Ray materials. You can export all materials in the scene as one or multiple types of networks.

    • Alternatively, you can use the V-Ray menu's Export Materials to USD option. For more information, please visit the Export Materials to USD page.

Exporting lights to USD does not require the V-Ray Material Exporter to be selected in the Export to USD menu.

Disable the Merge Transform and Shape Nodes option from the Advanced rollout for a cleaner hierarchy and export. If you are using a version of V-Ray for Maya prior to 6.20.01, the Merge Transform and Shape Nodes option needs to be disabled to correctly export VRaySubdivisions.

When exporting objects with applied V-Ray Displacement, the displacement is exported along with the shaders. In this case, make sure the V-Ray materials option is enabled.

When exporting objects with an applied Subdivision attribute, the subdivision is exported separately from the shaders. In this case, enabling the V-Ray materials option is not mandatory, as it will not affect the export of the subdivision surface.

When exporting objects with applied Subdivision attribute and V-Ray Displacement, the subdivision and displacement are exported along with the shaders. In this case, make sure the V-Ray materials option is enabled.



Working with Multiple UVs

Starting with V-Ray 6, update 2 the default USD translator is Hydra compatible.

Export and import of multiple UVs is supported under the following condition: digits are forbidden as first characters in the name of the UVset.

To ensure proper workflow with UV sets the export Plug-in configuration should be set to V-Ray. Otherwise, they are exported with Maya's convention.

Should unexpected errors occur using older assets, it is recommended to re-export the UVset.