Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.
listConnections([connections=boolean], [destination=boolean], [exactType=boolean], [fullNodeName=boolean], [plugs=boolean], [shapes=boolean], [skipConversionNodes=boolean], [source=boolean], [type=string])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
listConnections is NOT undoable, NOT queryable, and NOT editable.
This command returns a list of all attributes/objects of
a specified type that are connected to the given object(s).
If no objects are specified then the command lists the connections
on selected nodes.
string[] | List of connection plugs/nodes |
connection, dg, dependency, graph, plug, connect
connectAttr, connectionInfo, disconnectAttr, getAttr, isConnected, listAttr, setAttr
connections, destination, exactType, fullNodeName, plugs, shapes, skipConversionNodes, source, type
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
cmds.sphere( ch=True, n='BALL' )
cmds.setKeyframe()
# List all connections to BALL
list = cmds.listConnections('BALL')
# List only incoming connections from BALL.tx
cmds.listConnections( 'BALL.tx', d=False, s=True )
# List connections from BALL to nodes of type 'transform'
cmds.listConnections( t='transform' )
# List connections on BALL, ignoring unit conversion nodes
cmds.listConnections( 'BALL', scn=True )