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

概要

connectionInfo( string , [destinationFromSource=boolean], [getExactDestination=boolean], [getExactSource=boolean], [getLockedAncestor=boolean], [isDestination=boolean], [isExactDestination=boolean], [isExactSource=boolean], [isLocked=boolean], [isSource=boolean], [sourceFromDestination=boolean])

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

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

connectionInfo コマンドは、コネクション元とコネクション先の情報を得るために使用します。isConnected コマンドとは異なり、このコマンドではコネクション一端のみが必要です。

戻り値

boolean使用しているフラグによって、プロパティを問い合わせる場合。
stringプラグ名を問い合わせる場合。
string[]プラグのリストを問い合わせる場合。

関連項目

connectAttr, isConnected, listConnections

フラグ

destinationFromSource, getExactDestination, getExactSource, getLockedAncestor, isDestination, isExactDestination, isExactSource, isLocked, isSource, sourceFromDestination
ロング ネーム（ショート ネーム） 引数型 プロパティ
isSource(isSource) boolean create
プラグ（またはその先祖）がコネクション元であれば true、そうでなければ false を返します。
isDestination(id) boolean create
プラグ（またはその先祖）がコネクション先であれば true、そうでなければ false を返します。
isExactSource(ies) boolean create
プラグがコネクション元自身であれば true、そうでなければ false を返します。
isExactDestination(ied) boolean create
プラグがコネクションのコネクション先自身であれば true、そうでなければ false を返します。
getExactSource(ges) boolean create
プラグあるいはその先祖がコネクション元であれば、ソース自身のプラグ名を返します（該当するコネクションがない場合は、空文字列を返します）。
getExactDestination(ged) boolean create
プラグあるいはその先祖が接続先であれば、接続先自身のプラグ名を返します（該当するコネクションがない場合は、空文字列を返します）。
destinationFromSource(dfs) boolean create
指定したプラグ（あるいはその先祖）がソースであれば、このフラグはこのソースからコネクトされているコネクション先のリストを返します（文字配列、なければ空の配列）。
sourceFromDestination(sfd) boolean create
指定したプラグ（あるいはその先祖）がコネクション先であれば、このフラグはコネクションのソースを返します（文字列、なければ空）。
isLocked(il) boolean create
このプラグ（あるいはその先祖）がロックされていたら、true を返します。
getLockedAncestor(gla) boolean create
指定したプラグがロックされていたら、その名前が返されます。そのプラグの先祖がロックされていたら、その名前が返されます。複数の先祖がロックされていたら、一番近いものの名前だけが返されます。このプラグ、あるいは先祖がロックされていなかったら、空の文字列が返されます。
: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python の例

import maya.cmds as cmds

#    Create a sphere and a cone and make the Z translation of the cone
#    be dependent on the X translation of the sphere.
#
cone = cmds.cone()
sphere = cmds.sphere()
sphereTx = '%s.tx' % sphere[0]
coneTz = '%s.tz' % cone[0]
cmds.connectAttr(sphereTx, coneTz)

#    Verify the connection and print out the source plug.
#
if cmds.connectionInfo( coneTz, isDestination=True):
  print( 'Source: %s' % cmds.connectionInfo(coneTz,sourceFromDestination=True) )

#    Verify the connection and print out the destination plug.
#
if cmds.connectionInfo( sphereTx, isSource=True):
  destinations = cmds.connectionInfo(sphereTx, destinationFromSource=True)
  for destination in destinations:
    print destination