Share

USD for Maya v0.20.0 Release Notes

USD version 0.20.0 is a feature release compatible with Maya 2023.3. Visit the official Autodesk MayaUSD GitHub repository to obtain this version or any subsequent releases.

Highlights

This release installer includes the following improvements:

Updates/enhancements on Display Layer support:

  • Corrected handling of Display List vs Variants
  • Correct texture/wireframe/bbox display when prims in a display layer

Support:

  • Update to MaterialX 1.38.5
  • General stability, bug and UI fixes

What's Fixed

Fixed Issues from GitHub
[Github 1817] Conflict checking when stripping namespaces and specifying roots MAYA-115170
[GitHub 2196] Build script is making an assumption on the generator when one isn't supplied MAYA-122322
[Github 2093] UFE: printing rename command with UFE strings returns "none" MAYA-124571
[Github 2365] Chaser factory context GetDagToUsdMap() raises error MAYA-125142
General Fixed Issues
Renaming: renaming a USD object to its own name will cause a new increment to be added MAYA-124971
Crash on Cache to USD with animated rigs MAYA-125835
Crash when 'Edit As Maya Data' a MayaRef prim after caching MAYA-125786
Duplicate as USD Data timeline options don't show what is currently applied MAYA-124951
Edit as Maya on a Material prim gives a warning and nothing happens MAYA-123848
Editing a USD reference as Maya data will reset the timeline to 0 - 100 MAYA-124106

Known Limitations

The following list of limitations remains in flux as development is ongoing.

USD stage creation workflow limitations

See Create a USD stage for more information

  • Switching selected object variant can cause sync issues.

USD import and export workflow limitations

See USD import options and USD export options for more information

  • The round-trip workflow is currently lossy (ie. contains a loss of information from compression).
  • Mesh component level control is currently unsupported.
  • Vertex/Edge Component tags are currently unsupported.

USD materials workflow limitations

See USD import options for more information

  • Duplicate Shader Nodes in the Materials dropdown of the USD File Type Specific Options Menu: Loading the latest MayaUSD plug-in will provide the UsdPreviewSurface shader node. Loading a previous version of the plug-in will provide a pxrUsdPreviewSurface shader node. While both materials can import and export intrinsically to USD, loading both plugins into the same file will provide both nodes and create backward compatibility issues. The two nodes will correctly export to UsdPreviewSurface, but importing the scene back into Maya will choose the first registered node (ie. selection is dependent on plug-in load order).
    • Workaround: Have only one of the two aforementioned plug-ins loaded in Maya or ensure the first loaded plug-in is the preferred selection.
  • USD core rendering backend HydraGL(Storm) is not fully supported in Maya (switching to Hydra render delegate from VP2 on a Maya scene can cause Maya to crash)
    • Workaround: To ensure Maya's native VP2 render delegate can support the materials of a file, verify that the file's meta data inputs are importing correctly in Maya by using USD View. Generally, to achieve similar material results to an original file, convert to the original materials used on import.

Push/Pull workflow limitations

See edit as Maya data for more information

  • USD data is unaware of Maya data inside in the mixed-data model:
    • When Maya data is inside a USD hierarchy, its visibility isn't inherited from its USD ancestors.
    • When Maya data is inside a USD hierarchy, reframing the Viewport on its USD ancestors will not include Maya data. Transforms can misconfigure when animating pulled USD data.
    • Unloading Payloads to an ancestor of a pulled node breaks the pulled state.
  • When pulled Maya data is orphaned, the orphaned objects can still appear/ be visible in the Viewport.
  • Edit as Maya is unavailable on material prims. A warning is provided.

Maya reference limitations

See add a Maya reference for more information

  • When a USD object is in a pulled state, a mixed-data model will be active, where the pulled object will be Maya data, yet still inside of the proxyShape node or prim. When in this state, current limitations bar selection, hierarchy and other general expected behavious. For example, if you select the USD parent node of a pulled object, the Maya data nested inside will not be a part of that selection, which will not allow operations such as hiding objects etc.
  • The ‘Maya Auto Edit’ attribute on a MayaReference prim is currently not functional.
  • Editing a Maya reference as Maya data can cause targets to switch while caching to USD.

Display Layer limitations

See work with prims as display layers for more information

  • Display Layer visibility works with all instanced geometry except for point instancers. The visibility toggle is unsupported for point instancers.
  • Importing Maya files containing stages and display layers into Maya is not supported. Display Layer assignments will break during the import process.

Was this information helpful?