pymel.core.general.connectAttr

static general.connectAttr(source, destination, **kwargs)

Connect the attributes of two dependency nodes and return the names of the two connected attributes. The connected attributes must be be of compatible types. First argument is the source attribute, second one is the destination. Refer to dependency node documentation.

Maya Bug Fix:
  • even with the ‘force’ flag enabled, the command would raise an error if the connection already existed.
Flags:
Long name (short name) Argument Types Properties
force (f) bool ../../../_images/create.gif
 
Forces the connection. If the destination is already connected, the old connection is broken and the new one made.
lock (l) bool ../../../_images/create.gif
 

If the argument is true, the destination attribute is locked after making the connection. If the argument is false, the connection is unlocked before making the connection.

nextAvailable (na) bool ../../../_images/create.gif
 

If the destination multi-attribute has set the indexMatters to be false with this flag specified, a connection is made to the next available index. No index need be specified.

referenceDest (rd) unicode ../../../_images/create.gif
 

This flag is used for file io only. The flag indicates that the connection replaces a connection made in a referenced file, and the flag argument indicates the original destination from the referenced file. This flag is used so that if the reference file is modified, maya can still attempt to make the appropriate connections in the main scene to the referenced object. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.connectAttr

Example:

import pymel.core as pm

pm.createNode( 'transform', n='firstGuy' )
# Result: nt.Transform(u'firstGuy') #
pm.createNode( 'transform', n='secondGuy' )
# Result: nt.Transform(u'secondGuy') #

# Connect the translation of two nodes together
pm.connectAttr( 'firstGuy.t', 'secondGuy.translate' )

# Connect the rotation of one node to the override colour
# of a second node.
pm.connectAttr( 'firstGuy.rotate', 'secondGuy.overrideColor' )

Previous topic

pymel.core.general.condition

Next topic

pymel.core.general.connectionInfo

Core

Core Modules

Other Modules

This Page