Assign reference edits to an offline file

You can assign the edits contained in a reference edits file (.editMA or .editMB) to referenced objects by referencing or importing the edits into your scene. Reference edit files are created using the Export to Offline File command. See Export reference edits to an offline file.

Maya assigns edits by matching each nodename.attribute in the edit file to the file it’s being applied to. For example, you can export a reference edit for pSphere1.translateX in the scene sphere.ma. This edit is saved in the reference file as <main>:pSphere1.translateX. You can then assign this edit to the scene ball.ma so that ball:pSphere1.translateX is edited.

Note

Dangling connections (connections to non-exported nodes) and reference edits are saved to the edit file with a placeholder namespace. When applying these edits, Maya replaces the placeholder with the namespace of the reference that the file is being applied to, or ":" for imports into the main scene.

Assigning edits to a referenced file

To apply offline edits to a referenced object

Access the Assign Offline File Options window by doing one of the following:
- In the Outliner, -click the referenced file to which you want to apply reference edits and select Assign Offline File > from the menu that appears.
- In the Reference Editor (File > Reference Editor), select the referenced file to which you want to apply the edits and select File > Assign Offline File> .
The Assign Offline File Options window appears.
Select Edit > Reset Settings.
Set Apply via to Reference if you want the edits to remain in their own file. Otherwise, set it to Import if you want the edits to be saved to the main scene.
Click Assign Offline File.
A file browser appears.
Navigate to the folder containing the edit file and select it.
Valid edit files appear with the extension .editMA or .editMB.
Click Assign Offline File.
The edits are applied to the referenced file.

If you chose to apply the edits via reference, the offline edits file appears in the Reference Editor at the bottom of the list of references. A reference node for your edits file also appears in the Outliner.

If you cannot see reference nodes in the Outliner, ensure that Reference Nodes is on in the Outliner Display menu.

Like other referenced nodes, you can load and unload the reference edits file to view the scene with and without the reference edits.

If you chose to apply the edits via import, the offline edits are baked into your scene. No entry for them appears in the Reference Editor, but you can remove them in the Reference Edits window. See Remove reference edits.

If you make further changes to edited attributes in the main scene and then unload and reload the reference edits from the Outliner Reference menus or the Reference Editor, Maya restores the original values of those edited attributes.

Assigning edits to the main scene

You can also assign an reference edits file to an object in the main scene.

To assign offline edits to an object in the main scene

Access the Assign Offline File Options window by doing one of the following:
- In the Outliner, -click the referenced file to which you want to apply reference edits and select Assign Offline File > from the menu that appears.
- In the Reference Editor (File > Reference Editor), select the referenced file to which you want to apply the edits and select File > Assign Offline File> .
The Assign Offline File Options window appears.
In the General Options section, set Apply via toReference.
Turn on Assign offline edits to main scene if you want to apply the edits to the main scene, while maintaining a reference to those edits as well. Otherwise, turn this option off to keep only a reference to the edits.
Click Assign Offline File.
The File Browser appears.
Navigate to the folder containing the edit file and select it.
Valid edit files appear with the extension .editMA or .editMB.
Click Assign Offline File.
The edits are applied to the main scene. If you check the Reference Editor, you can the referenced edits file.

In either scenario, you can also import edits such that no reference entry is created for those edits.

To assign edits to the main scene via import

Access the Assign Offline File Options window by doing one of the following:
- In the Outliner, -click the referenced file to which you want to apply reference edits and select Assign Offline File > from the menu that appears.
- In the Reference Editor (File > Reference Editor), select the referenced file to which you want to apply the edits and select File > Assign Offline File> .
The Assign Offline File Options window appears.
Select Edit > Reset Settings.
In the General Options section, set Apply via to Import.
Click Assign Offline File.
A file browser appears.
Navigate to the folder containing the edit file and select it.
Click Assign Offline File.
The edits are applied to the main scene. Unlike edits applied via reference, no entry for the edits appear in the Reference Editor and thus those edits cannot be muted or undone.

Remapping namespaces

Depending on the way your project is setup and the location of your files, Maya may require you to remap namespaces in order to assign edits properly.

To remap a namespace

Assign an offline file with a non-matching namespace.
The Remap Missing Namespace window appears.

The left side of this window shows you the automatic remapping that will take place. The right side shows you the namespaces which have no corresponding mapping.

In general, <root> refers to the root namespace and <main> refers to the current workspace.
Choose a namespace on the right side and click Map to map it to a specific namespace in your scene. Otherwise, click Skip to place that namespace in the current namespace.