ジャンプ先: 概要. 戻り値. キーワード. フラグ. Python 例.
freezeOptions([displayLayers=boolean], [downstream=string], [explicitPropagation=boolean], [invisible=boolean], [referencedNodes=boolean], [runtimePropagation=boolean], [upstream=string])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
freezeOptions は、取り消し不可能、照会可能、および編集不可能です。
このコマンドは、ノードがフリーズ状態の場合に伝搬と認識を処理するために評価マネージャが使用するオプションへのアクセスを提供します。利用可能な各種のオプションについては、それぞれのフラグを参照してください。これらの値は、すべてのユーザ プリファレンスとして格納され、セッション間で維持されます。
| string | 下流または上流のフラグを照会する場合は、オプションの現在の値 |
| boolean | displayLayers、invisible、referencedNodes、explicitPropagation、または runtimePropagaton フラグを照会する場合は、オプションの現在の値 |
| boolean | 作成モードでは、すべてのオプションが正常に設定された場合に True を返します |
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
evaluation, manager, DG, runtime, freeze
displayLayers, downstream, explicitPropagation, invisible, referencedNodes, runtimePropagation, upstream
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
displayLayers(dl)
|
boolean
|
 
|
|
このオプションを有効にすると、有効で非表示の表示レイヤにあるすべてのノードはフリーズ状態とみなされ、それに従ってフリーズ状態が伝搬されます。
|
|
downstream(dn)
|
string
|
|
|
現在フリーズ状態のノードの下流にフリーズ状態を伝搬する方法を制御します。有効な値は、伝播しない場合は「none」、すべての上流ノードがフリーズ状態の場合にのみ下流に伝播する場合は「safe」、すべての上流ノードがフリーズ状態の場合に下流に伝播する場合は「force」です。
|
|
explicitPropagation(ep)
|
boolean
|
|
|
オンにすると、現在有効になっている評価グラフのオプションで指定されているとおりにフリーズ状態を関連ノードにインテリジェントに伝播するための評価グラフを構築する際に、追加のパスを実行します。「runtimePropagation」も参照してください。このオプションは、フリーズ状態のより完全な伝播を実行しますが、評価グラフの再計算に余分な時間がかかります。
|
|
invisible(inv)
|
boolean
|
|
|
このオプションを有効にすると、直接または非表示の親ノードを介して非表示になっているすべてのノードがフリーズ状態とみなされ、それに従ってフリーズ状態が伝搬されます。
|
|
referencedNodes(rn)
|
boolean
|
|
|
このオプションを有効にすると、フリーズ状態のリファレンス ノードから参照されるすべてのノードはフリーズ状態とみなされ、それに従ってフリーズ状態が伝搬されます。
|
|
runtimePropagation(rt)
|
boolean
|
|
|
オンにすると、評価グラフの実行中にフリーズ状態が伝搬されます。「explicitPropagation」も参照してください。このオプションにより、フリーズ状態のノードの評価をスケジュールできますが、フリーズ状態のノードが検出されると、現在有効なオプションのセットに基づいて評価が削減されます。これは下流方向でのみ機能します。
|
|
upstream(up)
|
string
|
|
|
現在フリーズ状態のノードの上流にフリーズ状態を伝搬する方法を制御します。有効な値は、伝播しない場合は「none」、すべての下流ノードがフリーズ状態の場合にのみ上流に伝播する場合は「safe」、すべての下流ノードがフリーズ状態の場合に上流に伝播する場合は「force」です。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
import maya.cmds as cmds
# Print the current display layer freeze option
print 'Display layer freeze option is {}'.format( cmds.freezeOptions( query=True, displayLayers=True ) )
# Toggle the display layer freeze option on
cmds.freezeOptions( displayLayers=True )
# Return: True #
# Set downstream propagation to safe mode
cmds.freezeOptions( downstream='safe' )
# Return: True #