Go to: Synopsis. Return value. Flags. MEL examples.
attrCompatibility [-addAttr] [-clear] [-dumpTable] [-enable boolean] [-nodeRename string] [-removeAttr] [-renameAttr string] [-type string] [-version string]
[string [string]]
attrCompatibility is undoable, NOT queryable, and NOT editable.
This command is used to handle compatibility issues between file format
versions by providing a mechanism to describe differences between two
versions. Only plugin writers should have the potential need to use this
command.
The first optional command argument argument is a node name and the
second optional command argument is an attribute name.
Warning: Only use this command to describe changes in names or
attributes of nodes that you have written as plugins. Do
not use this command to change information about builtin dependency
graph nodes.
None
addAttr, clear, dumpTable, enable, nodeRename, removeAttr, renameAttr, type, version
| Long name (short name) |
Argument types |
Properties |
-addAttr(-a)
|
|
|
|
Add the given attribute to the named node.
|
|
-clear(-clr)
|
|
|
|
Clear out the compatibility table.
This is only used internally for debugging purposes.
|
|
-dumpTable(-dmp)
|
|
|
|
Dump the current contents of the compatibility table.
This is only used internally for debugging purposes.
|
|
-enable(-e)
|
boolean
|
|
|
Enable or disable the compatibility table.
This is only used internally for debugging purposes.
|
|
-nodeRename(-nr)
|
string
|
|
|
Replace all uses of the node type 'nodeName' with given string.
|
|
-renameAttr(-r)
|
string
|
|
|
Rename the given attribute name of the given node with the
given string.
|
|
-removeAttr(-rm)
|
|
|
|
Remove the given attribute from the named node.
|
|
-type(-typ)
|
string
|
|
|
Change the type of the given attribute to the given type.
|
|
-version(-v)
|
string
|
|
|
Set the version target for subsequent commands to the given
string.
|
|
|
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 be used more than once in a command.
|
// Rename '.x' attributes in old files to '.tx' for all nodes
// of type 'transform'
//
attrCompatibility -r tx transform x;
// Rename the old 'group' node to the new 'transform' node
//
attrCompatibility -nr transform group;
// This will cause all subsequent attrCompatibility calls to translate
// files from older versions to version 1.0.
//
attrCompatibility -v "1.0";