When you have unsaved USD edits on multiple layers in a stage or muliple stages, you can perform batch save operations. Anytime you have unsaved USD edits within your Maya scene file and you choose to save, there are 3 options for saving USD data.
To save USD data in Maya, select File > Save Scene or File > Save Scene As. A modal apears when you have unsaved USD layers with the following options:
Save the Maya scene file and USD files (recommended): Select this option to save your Maya scene file (.ma, .mb) and your USD files (.usd, .usda, .usdc) to disk respectively.
Save all edits including USD, to the Maya scene file: Select this option to save your current Maya session with in-memory USD edits into a Maya scene file on disk (.ma, .mb). This option serializes your USD edits into your Maya scene file. When you open Maya again, your in-memory USD edits will persist as unsaved data. Important: per layer, any data exceeding the limit of 2GB will not be saved. This option is not recommended as data loss can occur.
Save the Maya scene file only (USD edits will not be saved): Select this option to ignore all USD edits and save only your Maya scene file (.ma, .mb).
If you have unsaved edits on multiple stages, and select the recommended option to save the Maya Scene file and your USD files, you will recieve the following dialog (or a portion of it - depending on if your layers are existing or new):
Element | Description | |
---|---|---|
A | Anonymous Layer(s) Save | This section of the Save Stage Dialog appears when you have edits to anonymous or newly created layers. |
1 | Convert All to Relative Paths | (Recommended) Click to save all of your anonymous USD layers as relative paths. See save as relative. |
2 | Anonymous Layer Save Path | Click the folder icon to choose the location or navigate to a directory for saving your anonymous layer to disk. |
3 | Relative to ... | Enable to activate relative pathing based on the specified label. Decendants will always be pathed relative to their parent layer. See save as relative. |
4 | Anonymous Layer File Name | Anonymous layers have not been saved to disk so Maya will autopopulate a file name for you for the save operation. |
5 | Tooltip | Hover over any layer to see the resolved path for that layer. |
B | Existing Layer(s) Save | This section of the Save Stage Dialog appears when you have unsaved edits to existing (ie. file-backed) layers. This section exists as a confirmation of the layers being overwritten with edits. |
5 | Tooltip | Hover over any layer to see where it is used. This is helpful if the layer is shared between multiple stages or to identify the single stage it is sourced from. |
When you are ready to proceed with saving, choose Save Stage or select Cancel to stop the save operation for your USD data.
Further Saving
To perform more granular saves, use the USD Layer Editor to save within each of your individual stages or USD layer files. See Save Edits in the USD Layer Editor.