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

概要

listRelatives( [objects] , [allDescendents=boolean], [allParents=boolean], [children=boolean], [fullPath=boolean], [noIntermediate=boolean], [parent=boolean], [path=boolean], [shapes=boolean], [type=string])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

Python 例

import maya.cmds as cmds

# create an object and an instance for queries
cmds.sphere( n='nexus' )
cmds.instance( n='ball' )

# List the name of the shape below the transform node.
shapes = cmds.listRelatives('nexus')

# list all parents of shape
# (The result of the command is shown)
cmds.listRelatives( shapes[0], allParents=True )
# Result:[u'nexus', u'ball'] #