ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. Python 例.
dgdirty([allPlugs=boolean], [clean=boolean], [implicit=boolean], [list=string], [propagation=boolean], [showTiming=boolean], [verbose=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
dgdirty は、取り消し不可能、照会可能、および編集不可能です。
dgdirty コマンドは、ノードまたはプラグ上でディペンデンシー グラフのダーティ メッセージを強制するために使用します。評価の問題を検索するデバッグに使用します。ノードを指定しないと、現在のセレクション リストが使用されます。list フラグを使用すると、現在ダーティとマークされているデータのリストが返されます(clean フラグも使用した場合は、クリーンなデータも返されます)。返される値は、クリーン/ダーティな接続の両端にある、それ自身がダーティ/クリーンなプラグの名前です。ノード上のクリーン/ダーティなデータの場所を表すこともあります。このオプションを all フラグと一緒に使用するとリストが長くなる可能性があるため、注意してください。
| string[] | プラグ リスト モードでは、ダーティ/クリーンなプラグのリストです。 |
| string[] | データ リスト モードでは、ダーティ/クリーンなデータを持つプラグのリストです。 |
| string[] | 接続リスト モードでは、ダーティ/クリーンな接続プラグのペアです。 |
| int | 通常モードでは、送信されたダーティ/クリーンなメッセージの数です。 |
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
dg, dependency, graph, dirty, plug, state
dbpeek, dgInfo, dgeval
allPlugs, clean, implicit, list, propagation, showTiming, verbose
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
allPlugs(a)
|
boolean
|
 
|
|
選択したオブジェクトや指定したオブジェクトは無視され、すべてのプラグがダーティ(またはクリーン)になります。
|
|
clean(c)
|
boolean
|
|
|
このフラグが設定されると、アトリビュートがクリーンになります。設定しない場合、アトリビュートはダーティに設定されます。
|
|
implicit(i)
|
boolean
|
|
|
このフラグが設定されている場合は、暗黙のノードまたは既定のノードも処理できます。このフラグが設定されていない場合は、効率化のためにこれらのノードはスキップされます。
|
|
list(l)
|
string
|
|
|
このフラグが指定されていると、ダーティ/クリーンなメッセージを送信する代わりに現在ダーティ/クリーンなオブジェクトのリストが返されます。返される値をガイドして絞り込むには allPlugs および clean フラグを使用します。フラグの値は、何がレポートされるかを示します。
- 「data」または「d」 = ダーティ/クリーンなデータを持つプラグを表示する
- 「plug」または「p」 = ダーティ/クリーンな状態のプラグを表示する
- 「connection」または「c」 = ダーティ/クリーンな状態の接続を持つプラグを表示する
このフラグを照会すると、このフラグの有効値をすべて特定できます。既に設定された値を指定してこのフラグを照会すると、この値の意味に関する説明を表示できます。
「p」および「c」モードは、接続を持つプラグ、または非標準の状態情報を持つプラグに限定されます。その他のアトリビュートには、データはありますが、チェックする状態情報がありません。配列アトリビュートの場合は、現在設定されている値を持つ子のみが考慮されます。使用可能な子のリストを更新するための評価は試行されません。たとえば、トランスフォーム T1、シェイプ S1 の DAG の場合、インスタンス化されたアトリビュート S1.wm[0] がレポートされます。スクリプトで 2 番目のインスタンス T2->S1 を作成し、すぐにプラグを再びリストしてから評価を行うと、引き続き S1.wm[0] のみが表示されます。新しい S1.wm[1] は、評価によって作成されるまではレポートされません。評価は通常、リフレッシュ、特定の getAttr コマンド、またはエディタの更新によって行われます。リストは、選択したノードのみに対応します。ダーティなメッセージが送信される場合とは異なり、下流には伝わりません。
|
|
propagation(p)
|
boolean
|
|
|
このフラグが設定されている場合、グラフをフローするというダーティなメッセージの機能が有効なままになります。
|
|
showTiming(st)
|
boolean
|
|
|
このフラグを使用すると、ダーティなメッセージの伝播に要する時間が表示されます。
|
|
verbose(v)
|
boolean
|
|
|
ダーティに設定されているすべてのプラグが標準出力にプリントされます。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# Set everything in the entire scene dirty
#
cmds.dgdirty(allPlugs=True);
# Result: 123 #
# Set all connected plugs dirty on "myNode"
# 5 plugs were set dirty
#
cmds.dgdirty( 'myNode' )
# Result: 5 #
# Set all connected plugs dirty on "locator1"
# 0 plugs were connected so no dirty message was sent
#
cmds.dgdirty( 'locator1' )
# Result: 0 #
# Set myNode.tx dirty
cmds.select( 'myNode.tx' )
cmds.dgdirty()
# Result: 1 #
# Show the dirty elements in the node
cmds.dgdirty( list='data' )
# Result: [myNode.tx] #
# Show plugs with dirty state, if any
cmds.dgdirty( list='plug' )
# Result: [myNode.tx, myNode.ty] #
# Show plugs with dirty connections, if any
cmds.dgdirty( list='connection' )
# Result: [myNode.ty] #
# Show the types of list parameters available
cmds.dgdirty( query=True, list=True )
# Result: ['d/data', 'p/plug', 'c/connection']
# Show the types of list parameters available with timing
cmds.dgdirty( query=True, list=True, showTiming=True )
# Messages took 8 microseconds to process.
# Result: ['d/data', 'p/plug', 'c/connection']