Go to: Synopsis. Return value. Keywords. Related. Flags. MEL examples.
nodeCast [-copyDynamicAttrs boolean] [-disableAPICallbacks boolean] [-disableScriptJobCallbacks boolean] [-disconnectUnmatchedAttrs boolean] [-force boolean] [-swapNames boolean] [-swapValues boolean] stringstring
nodeCast is undoable, NOT queryable, and NOT editable.
Given two nodes, a source node of type A and a target node of type B,
where type A is either type B or a sub-type of B, this command will replace the
target node with the source node. That is, all node connections, DAG hierarchy
and attribute values on the target node will be removed from the target node
and placed on the source node. This operation will fail if either object is
referenced, locked or if the nodes do not share a common sub-type.
This operation is atomic. If the given parameters fail, then the source and
target nodes will remain in their initial state prior to execution of the
command.
IMPORTANT: the command will currently ignore instance connections and
instance objects. It will also ignore reference nodes.
| int | 0 for success, 1 for failure. |
node, swap, cast
createNode, nodeType
copyDynamicAttrs, disableAPICallbacks, disableScriptJobCallbacks, disconnectUnmatchedAttrs, force, swapNames, swapValues
| Long name (short name) |
Argument types |
Properties |
-copyDynamicAttrs(-cda)
|
boolean
|
|
|
If the target node contains any dynamic attributes that are not defined on the
source node, then create identical dynamic attricutes on the source node and copy
the values and connections from the target node into them.
|
|
-disableAPICallbacks(-dsa)
|
boolean
|
|
|
|
-disableScriptJobCallbacks(-dsj)
|
boolean
|
|
|
|
-disconnectUnmatchedAttrs(-dua)
|
boolean
|
|
|
If the node that is being swapped out has any connections that do not exist
on the target node, then indicate if the connection should be disconnected.
By default these connections are not removed because they cannot be restored
if the target node is swapped back with the source node.
|
|
-force(-f)
|
boolean
|
|
|
Forces the command to do the node cast operation even if the nodes do
not share a common base object. When this flag is specified the command
will try to do the best possible attribute matching when swapping the
command. It is not recommended to use the '-swapValues/sv' flag with
this flag.
|
|
-swapNames(-sn)
|
boolean
|
|
|
Swap the names of the nodes. By default names are not swapped.
|
|
-swapValues(-sv)
|
boolean
|
|
|
Indicates if the commands should exchange attributes on the common attributes
between the two nodes. For example, if the nodes are the same base type
as a transform node, then rotate, scale, translate values would be copied
over.
|
|
|
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.
|
// Create two transform nodes and make a connection between them.
//
string $tr1 = `createNode transform`;
string $tr2 = `createNode transform`;
connectAttr -f ($tr1 + ".t") ($tr2 + ".t");
connectAttr -f ($tr2 + ".r") ($tr1 + ".r");
// We want to swap $tr1 out. Create a new node $swapNode that will
// replace $tr1. To prove that this is working, we will add a new
// dynamic attribute to $tr1 and connect it to the middle man.
// If nodeCast cannot find the corresponding attribute on the
// node to be swaped, it will either ignore the connection or
// disconnect the connection based on user input.
//
string $theT = $tr1;
select -r $theT;
addAttr -ln "unmatched" -at "long";
string $middle_man = `createNode transform`;
connectAttr ($theT + ".unmatched") ($middle_man + ".tx");
$swapNode = `createNode transform`;
nodeCast -disconnectUnmatchedAttrs true $theT $swapNode;