Go to: Synopsis. Return value. Keywords. Related. Flags. MEL examples.
listConnections [-connections boolean] [-destination boolean] [-exactType boolean] [-plugs boolean] [-shapes boolean] [-skipConversionNodes boolean] [-source boolean] [-type string]
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, plugs, shapes, skipConversionNodes, source, type
| Long name (short name) |
argument types |
Properties |
-source(-s)
|
boolean
|
|
|
Give the attributes/objects that are on the "source" side of
connection to the given object. Default true.
|
|
-destination(-d)
|
boolean
|
|
|
Give the attributes/objects that are on the "destination" side of
connection to the given object. Default true.
|
|
-plugs(-p)
|
boolean
|
|
|
If true, return the connected attribute names; if false, return the
connected object names only. Default false;
|
|
-connections(-c)
|
boolean
|
|
|
If true, return both attributes involved in the connection. The one
on the specified object is given first. Default false.
|
|
-shapes(-sh)
|
boolean
|
|
|
Actually return the shape name instead of the transform when the
shape is "selected". Default false.
|
|
-type(-t)
|
string
|
|
|
If specified, only take objects of a specified type.
|
|
-exactType(-et)
|
boolean
|
|
|
When set to true, -t/type only considers node of this exact
type. Otherwise, derived types are also taken into account.
|
|
-skipConversionNodes(-scn)
|
boolean
|
|
|
If true, skip over unit conversion nodes and return the
node connected to the conversion node on the other side. Default false.
|
|
|
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
|
sphere -ch on -n BALL;
setKeyframe;
// List all connections to BALL
string $list[] = `listConnections BALL`;
// List only incoming connections from BALL.tx
listConnections -d off -s on BALL.tx;
// List connections from BALL to nodes of type 'transform'
listConnections -t transform;
// List connections on BALL, ignoring unit conversion nodes
listConnections -scn on BALL;