Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.
copyAttr([attribute=string], [containerParentChild=boolean], [inConnections=boolean], [keepSourceConnections=boolean], [outConnections=boolean], [renameTargetContainer=boolean], [values=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
copyAttr is undoable, queryable, and editable.
Given two nodes, transfer the connections and/or the values from the first
node to the second for all attributes whose names and data types match. When
values are transferred, they are transferred directly. They are not mapped or
modified in any way. The transferAttributes command can be used to transfer
and remap some mesh attributes.
The attributes flag can be used to specify a list of attributes to be
processed. If the attributes flag is unused, all attributes will be
processed. For dynamic attributes, the values and/or connections will only
be transferred if the attributes names on both nodes match.
This command does not support geometry shape nodes such as meshes, subds and
nurbs. This command does not support transfer of multi-attribute values such
as weight arrays.
In query mode, return type is based on queried flag.
node, connection, container, copy
container, listAttr, transferAttributes
attribute, containerParentChild, inConnections, keepSourceConnections, outConnections, renameTargetContainer, values
| Long name (short name) |
Argument types |
Properties |
inConnections(ic)
|
boolean
|
|
|
Indicates that incoming connections should be transferred.
|
|
outConnections(oc)
|
boolean
|
|
|
Indicates that outgoing connections should be transferred.
|
|
values(v)
|
boolean
|
|
|
Indicates that values should be transferred.
|
|
attribute(at)
|
string
|
|
|
The name of the attribute(s) for which connections and/or values will be
transferred. If no attributes are specified, then all attributes will be
transferred.
|
|
keepSourceConnections(ksc)
|
boolean
|
|
|
For use with the outConnections flag only. Indicates that the connections should be maintained on the first node, in addition to making them to the second node. If outConnections is used and keepSourceConnections is not used, the out connections on the source node will be broken and made to the target node.
|
|
renameTargetContainer(rtc)
|
boolean
|
|
|
For use when copying from one container to another only. This option will
rename the target container to the name of the original container, and
rename the original container to its old name + "Orig". You would want to
use this option if your original container was referenced and edited,
and you want those edits from the main scene to now apply to the
new container.
|
|
containerParentChild(cpc)
|
boolean
|
|
|
For use when copying from one container to another only. This option indicates
that the published parent and/or child relationships on the original container
should be transferred to the target container if the published names match.
|
|
|
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
# transfer input connections and values from locator1 to locator2
#
cmds.copyAttr('locator1','locator2',inConnections=True,values=True)
# transfer only the translateX and translateY values
#
cmds.copyAttr('locator1','locator2',values=True,attribute=['tx','translateY'])