Long name (short name) |
Argument types |
Properties |
-filename(-f) |
|
|
|
Returns string. A main flag used to query the filename
associated with the target reference. |
|
-shortName(-shn) |
|
|
|
This flag modifies the '-f/-filename' flag to indicate that the
file name returned will be the short name (i.e. just a file name
without any directory paths). If this flag is not present, the full
name and directory path will be returned. |
|
-unresolvedName(-un) |
|
|
|
This flag modifies the '-f/-filename' flag to indicate that the
file name returned will be unresolved (i.e. it will be the path
originally specified when the file was loaded into Maya; this path
may contain environment variables and may not exist on disk). If
this flag is not present, the resolved name will be returned. |
|
-withoutCopyNumber(-wcn) |
|
|
|
This flag modifies the '-f/-filename' flag to indicate that the
file name returned will not have a copy number (e.g. '{1}')
appended to the end. If this flag is not present, the file name
returned may have a copy number appended to the end. |
|
-dagPath(-dp) |
|
|
|
This flag modifies the '-n/-nodes' flag to indicate that the
names of any dag objects returned will include as much of the dag
path as is necessary to make the names unique. If this flag is not
present, the names returned will not include any dag paths. |
|
-isNodeReferenced(-inr) |
|
|
|
Returns boolean. A main flag used to determine whether or not
the target node comes from a referenced file. true if the target
node comes from a referenced file, false if not. |
|
-referenceNode(-rfn) |
|
|
|
Returns string. A main flag used to query the reference node
associated with the target reference. |
|
-nodes(-n) |
|
|
|
Returns string array. A main flag used to query the contents of
the target reference. |
|
-parent(-p) |
|
|
|
This flag modifies the '-rfn/-referenceNode' and '-f/-filename'
flags to indicate the the parent of the target reference will be
returned. |
|
-topReference(-tr) |
|
|
|
This flag modifies the '-rfn/-referenceNode' flag to indicate
the top level ancestral reference of the target reference will be
returned. |
|
-editStrings(-es) |
|
|
|
Returns string array. A main flag used to query the edits that
have been applied to the target. The edit will be returned as a
valid MEL command. A valid target is either a reference node, a
reference file, or a referenced node. If a referenced node is
specified, only those edits which affect that node will be
returned. If a reference file or reference node is specified any
edit which affects a node in that reference will be returned. If no
target is specified all edits are returned. This command can be
used on both loaded and unloaded references. By default it will
return all the edits, formatted as MEL commands, which apply to the
target. This flag cannot be used with either the '-en/-editNodes'
or '-ea/-editAttrs' flags. |
|
-editNodes(-en) |
|
|
|
Returns string array. A main flag used to query the edits that
have been applied to the target. Only the names of the nodes
involved in the reference edit will be returned. If an edit
involves multiple nodes (e.g. "connectAttr" edits) the nodes will
be returned as separate, consecutive entries in the string array. A
valid target is either a reference node, a reference file, or a
referenced node. If a referenced node is specified, only those
edits which affect that node will be returned. If a reference file
or reference node is specified any edit which affects a node in
that reference will be returned. If no target is specified all
edits are returned. This command can be used on both loaded and
unloaded references. By default it will return all the edits,
formatted as MEL commands, which apply to the target. This flag can
be used in combination with the '-ea/-editAttrs' flag to indicate
that the names of both the involved nodes and attributes will be
returned in the format 'node.attribute'. |
|
-editAttrs(-ea) |
|
|
|
Returns string array. A main flag used to query the edits that
have been applied to the target. Only the names of the attributes
involved in the reference edit will be returned. If an edit
involves multiple attributes (e.g. "connectAttr" edits) the nodes
will be returned as separate, consecutive entries in the string
array. A valid target is either a reference node, a reference file,
or a referenced node. If a referenced node is specified, only those
edits which affect that node will be returned. If a reference file
or reference node is specified any edit which affects a node in
that reference will be returned. If no target is specified all
edits are returned. This command can be used on both loaded and
unloaded references. By default it will return all the edits,
formatted as MEL commands, which apply to the target. This flag can
be used in combination with the '-ea/-editAttrs' flag to indicate
that the names of both the involved nodes and attributes will be
returned in the format 'node.attribute'. |
|
-failedEdits(-fld) |
boolean |
|
|
This is a secondary flag used to indicate whether or not failed
edits should be acted on (e.g. queried, removed, etc...). A failed
edit is an edit which could not be successfully applied the last
time its reference was loaded. An edit can fail for a variety of
reasons (e.g. the referenced node to which it applies was removed
from the referenced file). By default failed edits will not be
acted on. |
|
-successfulEdits(-scs) |
boolean |
|
|
This is a secondary flag used to indicate whether or not
successful edits should be acted on (e.g. queried, removed,
etc...). A successful edit is any edit which was successfully
applied the last time its reference was loaded. By default
successful edits will be acted on. |
|
-showDagPath(-sdp) |
boolean |
|
|
Shows/hides the full dag path for edits. If false only displays
the node-name of reference edits. Must be used with the -editNodes,
-editStrings or -editAttrs flag. |
|
-showNamespace(-sns) |
boolean |
|
|
Shows/hides the namespaces on nodes in the reference edits.
Must be used with the -editNodes, -editStrings or -editAttrs
flag |
|
-liveEdits(-le) |
|
|
|
Specifies that the edits should be returned based on the live
edits database. Only valid when used in conjunction with the
editStrings flag. |
|
-child(-ch) |
|
|
|
This flag modifies the '-rfn/-referenceNode' and '-f/-filename'
flags to indicate the the children of the target reference will be
returned. Returns a string array. |
|
-isLoaded(-il) |
|
|
|
Returns a boolean indicating whether the specified reference
node or file name refers to a loaded or unloaded reference. |
|
-isExportEdits(-iee) |
|
|
|
Returns a boolean indicating whether the specified reference
node or file name is an edits file (created with the Export Edits
feature) |
|
-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. |
|