移動先: 概要 戻り値 フラグ MEL の例

概要

listRelatives [-allDescendents] [-allParents] [-children] [-fullPath] [-noIntermediate] [-parent] [-path] [-shapes] [-type string] [objects]

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

DAG オブジェクトの親と子がリストされます。-c/children フラグ、-ad/allDescendents フラグ、-s/shapes フラグ、-p/parent フラグ、-ap/allParents フラグを同時に指定することはできません。1 つのコマンドでは、このうち 1 つのみを使用できます。

ワールドのすぐ下でオブジェクトの親をリストすると、このコマンドは空の親リストを返します。シェイプのすぐ下でオブジェクト（アンダーワールド オブジェクト）の親をリストすると、親のリストに含まれるシェイプ ノードが返されます。オブジェクトのコンポーネントの親をリストすると、そのオブジェクトが返されます。

子をリストする場合、シェイプ ノードでは、子のリストでアンダーワールド オブジェクトが返されます。オブジェクトのコンポーネントの子をリストしても、何も返されません。

-ni/noIntermediate フラグは -s/shapes フラグとともに動作します。 このフラグを使用すると、派生するものの中間シェイプが無視されます。

戻り値

string[]

フラグ

allDescendents, allParents, children, fullPath, noIntermediate, parent, path, shapes, type
ロング ネーム（ショート ネーム） 引数型 プロパティ
-children(-c) create
DAG ノードのすべての子がリストされます（デフォルト）。
-allDescendents(-ad) create
DAG ノードのすべての子や孫などが返されます。派生するものがインスタンス化されている場合、その派生するものは、返されるリストに 1 回だけ現れます。 子の前に孫がリストされることに注意してください。
-shapes(-s) create
トランスフォームではなく、シェイプ ノードである、DAG ノードのすべての子がリストされます。
-parent(-p) create
DAG ノードの親が返されます。
-allParents(-ap) create
DAG ノードのすべての親が返されます。通常の場合、このコマンドは、オブジェクトの最初のインスタンスに対応する親のみを返します。
-path(-pa) create
別のコマンドに渡すことができる、適切なオブジェクト名が返されます。
-fullPath(-f) create
オブジェクト名ではなくフル パス名が返されます。
-noIntermediate(-ni) create
中間オブジェクトは返されません。
-type(-typ) string createmultiuse
指定したタイプに関連するものすべてがリストされます。
: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : 1 つのコマンドで複数回使用可能なフラグ

MEL の例

// create an object and an instance for queries
sphere -n "nexus";
instance -n "ball";

// List the name of the shape below the transform node.
// (The result of the command is shown)
string $shapes[] = `listRelatives -s -path "nexus"`;
// Result: nexus|nexusShape //

// list all parents of shape
listRelatives -allParents $shapes[0];
// Result: nexus ball //