移動先: 概要 戻り値 キーワード 関連項目 フラグ Python の例

概要

listConnections([connections=boolean], [destination=boolean], [exactType=boolean], [plugs=boolean], [shapes=boolean], [skipConversionNodes=boolean], [source=boolean], [type=string])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

listConnections は「元に戻す」が不可能「照会」が不可能「編集」が不可能です。

特定のオブジェクトにコネクトされている、指定したタイプのすべてのアトリビュートやオブジェクトのリストを返します。 オブジェクトを指定しない場合、選択したノードのコネクションがリスト表示されます。

戻り値

string[]コネクション プラグ/ノードのリスト

キーワード

connection, dg, dependency, graph, plug, connect

関連項目

connectAttr, connectionInfo, disconnectAttr, getAttr, isConnected, listAttr, setAttr

フラグ

connections, destination, exactType, plugs, shapes, skipConversionNodes, source, type
ロング ネーム(ショート ネーム) 引数型 プロパティ
source(s) boolean create
特定のオブジェクトへのコネクションの「ソース」側にあるアトリビュートやオブジェクトを返します。デフォルトは true です。
destination(d) boolean create
特定のオブジェクトへのコネクションの「目的」側にあるアトリビュートやオブジェクトを返します。デフォルトは true です。
plugs(p) boolean create
true の場合、コネクトされたアトリビュート名を返します。false の場合、コネクトされたオブジェクト名のみを返します。デフォルトは false です。
connections(c) boolean create
true の場合、コネクションに関連する両アトリビュートを返します。指定したオブジェクトのアトリビュートを先に返します。デフォルトは false です。
shapes(sh) boolean create
シェイプを「選択」した場合、トランスフォームの代わりにシェイプ名を返します。デフォルトは false です。
type(t) string create
指定した場合、指定したタイプのオブジェクトのみが考慮されます。
exactType(et) boolean create
true に設定した場合、-t/type はこのタイプのノードのみを考慮します。それ以外の場合は、派生タイプも考慮に入れられます。
skipConversionNodes(scn) boolean create
true の場合、単位変換ノードをスキップし、反対側の変換ノードにコネクトされたノードを返します。デフォルトは false です。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python の例

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 )