USD for Maya v0.21.0 Release Notes
USD version 0.21.0 is a release compatible with Maya 2023.3. Visit the official Autodesk MayaUSD GitHub repository to obtain this version or any subsequent releases.
Highlights
This build is compiled with USD 21.11 and Materialx 1.38.5. This release installer includes the following improvements:
Updates/enhancements on Display Layer support:
- Implement display layer’s bbox mode for instanced geometry
- Implement display layer’s visibility for instanced geometry
- Update render when color prefs change
Support:
- Support added for exporting Parent Offset Matrix
- Assignment of Materials to multiple Objects
- Allow custom UI hooks for MayaUsd ProxyShape
- WorldSpace flag support for exporting to USD
- Fix export behaviour when subDivScheme is “None”
- Handle rename and reparent in the orphaned nodes manager
- Allow the creation of prims in weaker layers
What's Fixed
Fixed Issues from GitHub |
[Github #2052] Cannot create a prim on a sibling layer MAYA-126141 |
General Fixed Issues |
Unable to switch variants when Session Layer is targeted MAYA-125991 |
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.