ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
listHistory(
objects
, [allConnections=boolean], [allFuture=boolean], [allGraphs=boolean], [breadthFirst=boolean], [fastIteration=boolean], [future=boolean], [futureLocalAttr=boolean], [futureWorldAttr=boolean], [groupLevels=boolean], [historyAttr=boolean], [interestLevel=int], [leaf=boolean], [levels=uint], [pruneDagObjects=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
listHistory は、取り消し可能、照会可能、および編集不可能です。
指定したノードからグラフ内を前後に移動し、コマンドが通過するコンストラクション ヒストリがあるすべてのノードを返します。コンストラクション ヒストリは、クリエータとして定義されているノードの特定アトリビュートへの接続、および NURBS カーブ ノードのカーブなど、ノードのメイン データの結果から構成されます。例えば、NURBS カーブ ノードのカーブなど。
特定プラグでヒストリ 接続の情報を調べるには、「listConnections」コマンドを最初に使用してヒストリの始まる場所を検索し、次に作成されたノードでこのコマンドを使用します。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
listConnections, listRelatives
allConnections, allFuture, allGraphs, breadthFirst, fastIteration, future, futureLocalAttr, futureWorldAttr, groupLevels, historyAttr, interestLevel, leaf, levels, pruneDagObjects
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
|
allConnections(ac)
|
boolean
|
|
|
指定した場合、ヒストリまたはフューチャを検索する移動は、ノードの移動を依存したプラグインのみに制限しません。したがって、あらゆる上流ノード(または f/future のすべての下流ノード)に到達します。
|
|
allFuture(af)
|
boolean
|
|
|
フューチャがリストされる場合は、そのすべてがリストされます。そうでなければ、シェイプがその出力ジオメトリ データを表すアトリビュートを持ち、プラグが接続されている場合は、接続から下流のフューチャ ヒストリのみがリストされます。
|
|
allGraphs(ag)
|
boolean
|
|
|
|
breadthFirst(bf)
|
boolean
|
|
|
幅優先移動では、最初の移動で最も近いノードが返されます。深さ優先移動では、ノードからパス全体がたどられ、ノードからその他のパスに戻ります。既定は深さ優先です。
|
|
fastIteration(fi)
|
boolean
|
|
|
このフラグを指定すると、さらにスケーラブルなパフォーマンスをする高速な反復モードが使用可能になります。特に、多数の接続を持つノードが移動している場合に有効です。ただし、アトリビュート間の依存関係が推移している場合などでは、若干異なる結果になることがあります(アトリビュート A が B の影響を受け、B が C の影響を受けている場合でも、A が C の影響を直接受けているわけではありません)。
|
|
future(f)
|
boolean
|
|
|
|
futureLocalAttr(fl)
|
boolean
|
|
|
このフラグによって、シェイプ ノード上でローカル空間の将来に関連するアトリビュートの照会が可能になります。
|
|
futureWorldAttr(fw)
|
boolean
|
|
|
このフラグによって、シェイプ ノード上でワールド空間の将来に関連するアトリビュートの照会が可能になります。
|
|
groupLevels(gl)
|
boolean
|
|
|
ノード名がレベルにしたがってグループ化されます。> 1 が先頭で、後はそれにグループ化されます。
|
|
historyAttr(ha)
|
boolean
|
|
|
このフラグによって、シェイプ ノード上でヒストリを接続しているアトリビュートの照会が可能になります。
|
|
interestLevel(il)
|
int
|
|
|
このフラグを設定すると、historicallyInteresting アトリビュート値がこの値以上であるノードのみがリストされます。historicallyInteresting アトリビュートは、プログラマ以外の人にとって重要でないノードで 0 になります。TD では 1、ユーザでは 2 です。
|
|
leaf(lf)
|
boolean
|
|
|
トランスフォームを選択した場合は、リーフ シェイプのヒストリが表示されます。既定は true です。
|
|
levels(lv)
|
uint
|
|
|
移動するレベル。レベル数を 0 に設定すると、すべてのレベルに移動します。すべてのレベルが既定です。
|
|
pruneDagObjects(pdo)
|
boolean
|
|
|
このフラグを設定すると、DAG オブジェクトで切り取られます。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
cmds.curve( d=3, p=[(-3, 0, 0),(-1, 0, 6),(6, 0, 8),(8, 0, 2)], k=[0,0,0,1,1,1], n="snake" )
cmds.instance( n="rattler" )
cmds.revolve( 'rattler', ch=True, n="charmer" )
cmds.revolve( 'snake', ch=True, n="medusa" )
cmds.listHistory()
# Result:[u'medusaShape', u'revolve2', u'snake|curveShape1'] #
cmds.listHistory( 'charmer' )
# Result:[u'charmerShape', u'revolve1', u'rattler|curveShape1'] #
cmds.listHistory( 'medusa', lv=1 )
# Result:[u'medusaShape', u'revolve2'] #
cmds.listHistory( 'medusa', future=True )
# Result:[u'medusaShape', u'initialShadingGroup'] #
# If you just list the curve's future you get both directions
cmds.listHistory( 'curveShape1', future=True )
# Result:[u'snake|curveShape1', u'revolve2', u'medusaShape', u'revolve1', u'charmerShape'] #
# To follow only one history you'll need to follow the path you
# want first, then add the node you started at if so desired since
# it will not be included (here snake|curveShape1 won't list).
# List the future of the first curve
hist = cmds.listConnections('curveShape1.ws[0]',c=1)
cmds.listHistory( hist[1], future=True )
# Result:[u'revolve2', u'medusaShape'] #
# List the future of the second curve
hist = cmds.listConnections('curveShape1.ws[1]',c=1)
cmds.listHistory( hist[1], future=True )
# Result:[u'revolve1', u'charmerShape'] #
cmds.listHistory( leaf=0 )
# Result:[u'medusa'] #