connectionInfo

ジャンプ先: 概要. 戻り値. 関連. フラグ. MEL 例.

概要

connectionInfo [-destinationFromSource] [-getExactDestination] [-getExactSource] [-getLockedAncestor] [-isDestination] [-isExactDestination] [-isExactSource] [-isLocked] [-isSource] [-sourceFromDestination] string

connectionInfo は、取り消し可能、照会不可能、および編集不可能です。

戻り値

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-destinationFromSource(-dfs)
指定したプラグ(あるいはその先祖)がソースであれば、このフラグはこのソースから接続されている接続先のリストを返します(文字配列、なければ空の配列)。
-getExactDestination(-ged)
プラグあるいはその先祖が接続先であれば、接続先自身のプラグ名を返します(該当する接続がない場合は、空文字列を返します)。
-getExactSource(-ges)
プラグあるいはその先祖が接続元であれば、ソース自身のプラグ名を返します(該当する接続がない場合は、空文字列を返します)。
-getLockedAncestor(-gla)
指定したプラグがロックされていたら、その名前が返されます。そのプラグの先祖がロックされていたら、その名前が返されます。複数の先祖がロックされていたら、一番近いものの名前だけが返されます。このプラグ、あるいは先祖がロックされていなかったら、空の文字列が返されます。
-isDestination(-id)
プラグ(またはその先祖)が接続先であれば true、そうでなければ false を返します。
-isExactDestination(-ied)
プラグが接続の接続先自身であれば true、そうでなければ false を返します。
-isExactSource(-ies)
プラグが接続元自身であれば true、そうでなければ false を返します。
-isLocked(-il)
このプラグ(あるいはその先祖)がロックされていたら、true を返します。
-isSource(-is)
プラグ(またはその先祖)が接続元であれば true、そうでなければ false を返します。
-sourceFromDestination(-sfd)
指定したプラグ(あるいはその先祖)が接続先であれば、このフラグは接続のソースを返します(文字列、なければ空)。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

//    Create a sphere and a cone and make the Z translation of the cone
//    be dependent on the X translation of the sphere.
//
string $cone[] = `cone`;
string $sphere[] = `sphere`;
connectAttr ($sphere[0] + ".tx") ($cone[0] + ".tz");

//    Verify the connection and print out the source plug.
//
if (`connectionInfo -isDestination ($cone[0] + ".tz")`) {
    print ("Source: "
        + `connectionInfo -sourceFromDestination ($cone[0] + ".tz")`
        + "\n");
}

//    Verify the connection and print out the destination plug.
//
if (`connectionInfo -isSource ($sphere[0] + ".tx")`) {
    string $destinations[];
    $destinations = `connectionInfo -destinationFromSource ($sphere[0] + ".tx")`;
    print ("Destination: ");
    for ($destination in $destinations) {
        print ($destination + " ");
    }
    print ("\n");
}