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

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 //