pymel.core.system.exportEdits¶

exportEdits(*args, **kwargs)¶

Use this command to export edits made in the scene to a 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 that 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 exported file. The query mode will return the list of nodes that will be considered for inclusion in the exported file based on the specified flags.

Flags:

Long Name / Short Name		Argument Types	Properties
editCommand / ec		unicode
	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, setAttr, lockand unlock. In some contexts, this flag may be specified more than once to specify multiple edit types to consider.
excludeHierarchy / ehr		bool
	By default, all DAG parents and DAG history are written to the export file. To prevent any DAG relations not otherwise connected to the target nodes to be included, specify the -excludeHierarchy flag.
excludeNode / en		unicode
	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, the DAG path can be specified to uniquely identify the node.
exportSelected / exs		bool
	The selected nodes and their connections to each other will be exported. Additionally, any dangling connections to non-exported nodes will be exported. Default nodes are ignored and never exported. Note that when using the exportSelected flag, only selected nodes are exported, and -include/-exclude flags such as -includeHierarchy are ignored.
force / f		bool
	Force the export action to take place. This flag is required to overwrite an existing file.
includeAnimation / ian		bool
	Additionally include animation nodes and animation helper nodes associated with the target nodes being exported.
includeConstraints / ic		bool
	Additionally include constraint-related nodes associated with the target nodes being exported.
includeDeformers / idf		bool
	Additionally include deformer networks associated with the target nodes being exported.
includeNetwork / inw		bool
	Additionally include the network of nodes connected to the target nodes being exported.
includeNode / includeNode		unicode
	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, the DAG path can be specified to uniquely identify the node.
includeSetAttrs / isa		bool
	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.
includeSetDrivenKeys / sdk		bool
	Additionally include setDrivenKey-related nodes associated with the target nodes being exported.
includeShaders / ish		bool
	Additionally include shaders associated with the target nodes being exported.
onReferenceNode / orn		unicode
	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 exportEditscommand. Flag can have multiple arguments, passed either as a tuple or a list.
selected / sel		bool
	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 that are used (such as includeAnimation, includeNetwork and so on).
type / typ		unicode
	Set the type of the exported file. Valid values are editMAor editMB. Note that this command respects the global defaultExtensionssetting for file naming that is controlled with the file command defaultExtensions option. See the file command for more information.

Derived from mel command maya.cmds.exportEdits

Example:

import pymel.core as pm

# query nodes to be exported, target is selected nodes, include related shaders
nodeList = pm.exportEdits(query=1,selected=1,includeShaders=1)
# exported selected nodes and related animation nodes to file
pm.exportEdits("myExportFile.ma",type='editMA',selected=1,includeShaders=1)
# Result: C:/Documents and Settings/user/My Documents/maya/projects/default/scenes/myExportFile.editMA