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

概要

freeze([allNodes=boolean], [displayLayers=boolean], [downstream=boolean], [forceDownstream=boolean], [frozen=boolean], [invisible=boolean], [noFreeze=boolean], [unfreeze=boolean], [upstream=boolean])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

ノードがフリーズされていると、変更時に入力は要求されません。ノードはフリーズ解除されるまでフリーズ時に存在した入力値を使用します。ノードをフリーズするには、ノードの「frozen」アトリビュートを True に設定して直接フリーズするか、または「frozenAffected」拡張子アトリビュートを設定して間接的にフリーズする 2 つの方法があります。このコマンドにより、さまざまな条件に基づいてノードをフリーズできます。コマンドがフリーズまたはフリーズ解除の対象を決定する際に使用する基準のタイプのフラグを参照してください。選択されたノードは直接フリーズされます。直接フリーズされたノードの影響を受けるノードは、引数設定を考慮に入れると、間接的にフリーズされると言えます。frozen アトリビュート、可視性、またはレイヤ表示モードに入力接続がある場合は、ノードをフリーズ解除できないか、または再生時に表示できないため、フリーズ状態は伝播されません。照会モードでは、このコマンドは、それぞれのフリーズ状態が設定されているノードを検索します(frozen、frozenAffected、またはどちらも設定されていない)。

戻り値

string[]照会モードで、現在フリーズまたはフリーズ解除されているノードのリストです。リストは、フリーズ状態が設定(設定解除)されたノード、FrozenAffected 状態が設定(設定解除)されたノード、および選択された残りのノードの 3 つの部分が空の文字列で区切られています。
string[]フリーズ状態がコマンドによって設定されたノードのリストです。リストは、フリーズ状態が設定されたノードおよび FrozenAffected 状態が設定されたノードの 2 つの部分が空の文字列で区切られています。

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

キーワード

evaluation, manager, DG, runtime

フラグ

allNodes, displayLayers, downstream, forceDownstream, frozen, invisible, noFreeze, unfreeze, upstream
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
allNodes(all) boolean createquery
操作に使用するノードを選択します。設定されていない場合は、セレクション リストが使用されます。何も選択されていない場合は、シーン内のすべてのノードが使用されます。このフラグは、照会モードで使用してシーン内でフリーズされているノードを検索できます。作成モードでフィルタ(displayLayers、非表示、またはフリーズ)とともに使用して、シーン内のノードの特定のサブセットをターゲットにすることもできます。
displayLayers(dl) boolean createquery
このフラグを有効にすると、リスト内の処理対象の表示レイヤがウォークされます。ディスプレイ レイヤの可視性コントロールがオフで、接続されていない場合は、制御対象のすべてのノードが処理リストに追加されます。注: さらに詳しく説明すると、アニメートされた可視状態または有効状態は一致として扱われます。スタティック アニメーションは確認されません。
downstream(dn) boolean createquery
このフラグを有効にすると、選択したノードから下流へのフリーズ状態の伝播が試みられます。たとえば、スケルトン リグによって制御されているメッシュ シェイプの変形などです。
forceDownstream(fd) boolean createquery
このフラグを有効にすると、選択したノードから下流へのフリーズ状態の伝播が試みられます。たとえば、スケルトン リグによって制御されているメッシュ シェイプの変形などです。下流のフラグとは異なり、このフラグを使用すると、他のフリーズ解除された入力がある場合にも、下流のノードがフリーズされます。
frozen(f) boolean createquery
このフラグを有効にすると、処理されるノードはフィルタリングで除外され、frozen アトリビュートが既に設定されているノードのみが含まれます。それ以外の場合は、フリーズ状態が伝搬される前に処理されるすべてのノードに frozen アトリビュートが設定されます。このフラグを使用するのは、ノードが既にフリーズされ、コマンドを使用してグラフ経由でフリーズ状態を伝播するときのみです。
invisible(i) boolean createquery
このフラグを有効にすると、リスト内で処理する非表示ノードがウォークされます。visibility アトリビュートが接続されていない場合は、DAG 階層でその下位のすべてのノードが処理リストに追加されます。注: さらに詳しく説明すると、アニメートされた可視性状態は一致として扱われます。スタティック アニメーションは確認されません。
noFreeze(n) boolean createquery
このフラグは、実際にフリーズせずにフリーズされるノードをプレビューします。
unfreeze(uf) boolean createquery
このフラグを有効にすると、処理されるノードのフリーズ状態はオンではなくオフになります。変更するノードを決定する場合は、同じフィルタ処理と伝搬処理がすべて実行されます。照会モードでは、このフラグは既にフリーズされたノードを返す代わりにフリーズ解除されたノードを返します。
upstream(up) boolean createquery
このフラグを有効にすると、選択したノードから上流へのフリーズ状態の伝播が試みられます。たとえば、フリーズされたトランスフォームに流入するパラメータ カーブなどがあります。この伝播には、フリーズされたノードが引き続き使用している上流ノードがフリーズ解除された状態で維持されるように、ヒューリスティックが適用されます。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds


import maya.cmds as cmds

# Set all selected nodes to be frozen
cmds.freeze()
# Result: ['node1', 'node2', 'node3']

# Set all nodes in the scene to be unfrozen
cmds.freeze( all=True, unfreeze=True )
# Result: ['node1', 'node2', 'node3', 'nodeAlreadyFrozen']