ジャンプ先: 概要. 戻り値. キーワード. フラグ. MEL 例.

概要

freezeOptions [-displayLayers boolean] [-downstream string] [-explicitPropagation boolean] [-invisible boolean] [-referencedNodes boolean] [-runtimePropagation boolean] [-upstream string]

freezeOptions は、取り消し不可能、照会可能、および編集不可能です。

このコマンドは、ノードがフリーズ状態の場合に伝搬と認識を処理するために評価マネージャが使用するオプションへのアクセスを提供します。利用可能な各種のオプションについては、それぞれのフラグを参照してください。これらの値は、すべてのユーザ プリファレンスとして格納され、セッション間で維持されます。

戻り値

string下流または上流のフラグを照会する場合は、オプションの現在の値
booleandisplayLayers、invisible、referencedNodes、explicitPropagation、または runtimePropagaton フラグを照会する場合は、オプションの現在の値
boolean作成モードでは、すべてのオプションが正常に設定された場合に True を返します

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

キーワード

evaluation, manager, DG, runtime, freeze

フラグ

displayLayers, downstream, explicitPropagation, invisible, referencedNodes, runtimePropagation, upstream
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-displayLayers(-dl) boolean createquery
このオプションを有効にすると、有効で非表示の表示レイヤにあるすべてのノードはフリーズ状態とみなされ、それに従ってフリーズ状態が伝搬されます。
-downstream(-dn) string createquery
現在フリーズ状態のノードの下流にフリーズ状態を伝搬する方法を制御します。有効な値は、伝播しない場合は「none」、すべての上流ノードがフリーズ状態の場合にのみ下流に伝播する場合は「safe」、すべての上流ノードがフリーズ状態の場合に下流に伝播する場合は「force」です。
-explicitPropagation(-ep) boolean createquery
オンにすると、現在有効になっている評価グラフのオプションで指定されているとおりにフリーズ状態を関連ノードにインテリジェントに伝播するための評価グラフを構築する際に、追加のパスを実行します。「runtimePropagation」も参照してください。このオプションは、フリーズ状態のより完全な伝播を実行しますが、評価グラフの再計算に余分な時間がかかります。
-invisible(-inv) boolean createquery
このオプションを有効にすると、直接または非表示の親ノードを介して非表示になっているすべてのノードがフリーズ状態とみなされ、それに従ってフリーズ状態が伝搬されます。
-referencedNodes(-rn) boolean createquery
このオプションを有効にすると、フリーズ状態のリファレンス ノードから参照されるすべてのノードはフリーズ状態とみなされ、それに従ってフリーズ状態が伝搬されます。
-runtimePropagation(-rt) boolean createquery
オンにすると、評価グラフの実行中にフリーズ状態が伝搬されます。「explicitPropagation」も参照してください。このオプションにより、フリーズ状態のノードの評価をスケジュールできますが、フリーズ状態のノードが検出されると、現在有効なオプションのセットに基づいて評価が削減されます。これは下流方向でのみ機能します。
-upstream(-up) string createquery
現在フリーズ状態のノードの上流にフリーズ状態を伝搬する方法を制御します。有効な値は、伝播しない場合は「none」、すべての下流ノードがフリーズ状態の場合にのみ上流に伝播する場合は「safe」、すべての下流ノードがフリーズ状態の場合に上流に伝播する場合は「force」です。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例


// Print the current display layer freeze option
int $dlOption = `freezeOptions -q -displayLayers`;
print "Display layer freeze option is " + $dlOption + "\n";

// Toggle the display layer freeze option on
cmds.freezeOptions( displayLayers=True )
// Return: 1 //

# Set downstream propagation to safe mode
cmds.freezeOptions( downstream='safe' )
// Return: 1 //