connectionInfo

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

概要

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

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

戻り値

関連項目

フラグ

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

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

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");
}