Go to: Synopsis. Return value. Keywords.
Related. Flags.
Python examples.
exportEdits([editCommand=string], [excludeHierarchy=boolean],
[excludeNode=string],
[exportSelected=boolean],
[force=boolean], [includeAnimation=boolean],
[includeDeformers=boolean],
[includeNetwork=boolean],
[includeNode=string],
[includeSetAttrs=boolean],
[includeShaders=boolean],
[onReferenceNode=string],
[selected=boolean], [type=string])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
exportEdits is NOT undoable, queryable, and NOT
editable.
Use this command to export edits made in the scene to a separate
file. The exported file can be subsequently imported to another
scene. Edits may include: nodes, connections and reference edits
such as value changes. The nodes that are included in the exported
file will be based on the options used. At least one option flag
which describes the set of target nodes to include in the exported
file must be specified (e.g. 'selected', 'onReferenceNode'). Use
the inclusion flags ('includeAnimation', 'includeShaders',
'includeNetwork') to specify which additional related nodes will be
added to the export list. In export mode, when the command
completes successfully, the name of the exported file will be
returned. In query mode, this command will return information about
the contents of the export file. No file export is performed in
query mode. Currently query mode will return the list of nodes that
will be considered for inclusion in the exported file based on the
combination of options specified
string[] |
For query execution. |
In query mode, return type is based on queried flag.
reference, export, node, import
file, referenceEdit, referenceQuery
editCommand, excludeHierarchy, excludeNode, exportSelected, force, includeAnimation, includeDeformers, includeNetwork, includeNode, includeSetAttrs, includeShaders, onReferenceNode, selected, type
Long name (short name) |
Argument types |
Properties |
force(f) |
boolean |
|
|
Force the export action to take place. This flag is required to
overwrite an existing file. |
|
selected(sel) |
boolean |
|
|
Export will operate on the list of nodes currently selected.
This flag differs from the exportSelected flag in that the selected
nodes are not exported, only the edits on them, and any nodes found
via the include flags the are used (such as includeAnimation,
includeNetwork and so on). |
|
exportSelected(exs) |
boolean |
|
|
The selected nodes and their connections to each other will be
exported. Additionally, any dangling connections to non-exported
nodes will be exported. Any default nodes (the internal nodes that
Maya creates on startup) that are selected are skipped. |
|
includeAnimation(ian) |
boolean |
|
|
Additionally includes animation nodes and animation helper
nodes associated with the target nodes being exported. |
|
includeNetwork(inw) |
boolean |
|
|
Additionally includes the network of nodes connected to the
target nodes being exported. |
|
includeShaders(ish) |
boolean |
|
|
Additionally include shaders associated with the target nodes
being exported. |
|
excludeHierarchy(ehr) |
boolean |
|
|
By default exporting passes all DAG parents and DAG history to
the export file. To prevent any DAG relations not otherwise
connected to the target nodes to be output, specify the
-excludeHierarchy flag. |
|
includeDeformers(idf) |
boolean |
|
|
Additionally include deformer networks associated with the
target nodes being exported. |
|
includeNode(includeNode) |
string |
|
|
Additionally include the named node in the list of nodes being
exported. In the case where more than one Maya node has the same
name, you can specify the DAG path to uniquely identify the
node. |
|
excludeNode(en) |
string |
|
|
Prevent the node from being included in the list of nodes being
exported. This flag is useful to exclude specific scene nodes that
might otherwise be exported. In the case where more than one Maya
node has the same name, you can specify the DAG path to uniquely
identify the node. |
|
type(typ) |
string |
|
|
Set the type of the exported file. Valid values are "editMA" or
"editMB". Note that this command respects the global
"defaultExtensions" setting for file naming that is controlled with
the file command defaultExtensions option. See the file command for
more information. |
|
includeSetAttrs(isa) |
boolean |
|
|
When using the -selected/-sel flag, if any of the selected
nodes are referenced, also include/exclude any setAttr edits on
those nodes. If used with the -onReferenceNode/-orn flag,
include/exclude any setAttr edits on the reference. |
|
editCommand(ec) |
string |
|
|
This is a secondary flag used to indicate which type of
reference edits should be considered by the command. If this flag
is not specified all edit types will be included. This flag
requires a string parameter. Valid values are: "addAttr",
"connectAttr", "deleteAttr", "disconnectAttr", "parent", and
"setAttr". In some contexts, this flag may be specified more than
once to specify multiple edit types to consider. |
|
onReferenceNode(orn) |
string |
|
|
This is a secondary flag used to indicate that only those edits
which are stored on the indicated reference node should be
considered. This flag only supports multiple uses when specified
with the "exportEdits" command. |
|
Flag can appear in Create mode of
command |
Flag can appear in Edit mode of command |
Flag can appear in Query mode of command |
Flag can have multiple arguments, passed
either as a tuple or a list. |
import maya.cmds as cmds
# query nodes to be exported, target is selected nodes, include related shaders
nodeList = cmds.exportEdits(query=1,selected=1,includeShaders=1)
# exported selected nodes and related animation nodes to file
cmds.exportEdits("myExportFile.ma",type='editMA',selected=1,includeShaders=1)
# Result: C:/Documents and Settings/user/My Documents/maya/projects/default/scenes/myExportFile.editMA