ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. Python 例.
dgdirty([allPlugs=boolean], [clean=boolean], [list=string], [propagation=boolean], [verbose=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
dgdirty は、取り消し不可能、照会不可能、および編集不可能です。
dgdirty コマンドは、ノードまたはプラグ上でディペンデンシー グラフのダーティ メッセージを強制するために使用します。評価の問題を検索するデバッグに使用します。ノードを指定しないと、現在のセレクション リストが使用されます。list フラグが指定されていると、現在ダーティとしてマークされているプラグ、データ、接続のリストを返します。このオプションを all フラグと一緒に使用するとリストが長くなる可能性があるため、注意してください。
| string[] | プラグ リスト モードでは、ダーティ/クリーンなプラグのリストです。 |
| string[] | データ リスト モードでは、ダーティ/クリーンなデータを持つプラグのリストです。 |
| string[] | 接続リスト モードでは、ダーティ/クリーンな接続プラグのペアです。 |
| int | 通常モードでは、送信されたダーティ/クリーンなメッセージの数です。 |
dg, dependency, graph, dirty, plug, state
dbpeek, dgInfo, dgeval
allPlugs, clean, list, propagation, verbose
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
allPlugs(a)
|
boolean
|
|
|
選択したオブジェクトや指定したオブジェクトは無視され、すべてのプラグがダーティ(またはクリーン)になります。
|
|
clean(c)
|
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
|
|
|
このフラグが設定されている場合、グラフをフローするというダーティなメッセージの機能が有効なままになります。設定されていない場合は、ダーティな状態が設定され、以降のメッセージ伝達がブロックされます。
|
|
verbose(v)
|
boolean
|
|
|
ダーティに設定されているすべてのプラグが標準出力にプリントされます。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# Set everything in the entire scene dirty
#
cmds.dgdirty(a=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='d' )
# 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='c' )
# Result: [myNode.ty] #