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

概要

cacheFileCombine [-cacheIndex] [-channelName string] [-connectCache string] [-keepWeights] [-layerNode] [-nextAvailable] [-object string] [-objectIndex int]

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

指定したオブジェクトに対して複数の cacheFiles を結合、レイヤまたはブレンドするために使用できる cacheBlend ノードを作成します。

戻り値

string作成されたキャッシュ レイヤ ノードの名前

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

キーワード

cache, file, disk, blend

フラグ

cacheIndex, channelName, connectCache, keepWeights, layerNode, nextAvailable, object, objectIndex
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-cacheIndex(-ci) query
connectCache フラグで指定したキャッシュに関連するインデックスを返す照会モード専用フラグです。
-channelName(-cnm) string editmultiuse
connectCache フラグと一緒に使用して、接続されるチャネルを示します。指定しないと、ファイル内の最初のチャネルが使用されます。
-connectCache(-cc) string queryedit
指定した cacheBlend ノード上の次に使用可能なインデックスに接続される cacheFile ノードを指定する編集フラグです。照会フラグとしては、指定した cacheBlend ノードまでの cacheFiles を含む文字配列を返します。

照会モードでは、このフラグは値を受け入れることができます。

-keepWeights(-kw) edit
これは connectCache フラグとの組み合わせでのみ使用するフラグです。既定では、connectCache フラグは新たに追加された cacheWeight 以外のすべてのウェイトを 0 に設定し、新しいキャッシュを完全にコントロールできるようにします。このフラグはその動作を無効にし、すべての既存のブレンド ウェイトが保持されるようにします。
-layerNode(-ln) query
選択したオブジェクト上にある既存の cacheBlends の文字配列を返す照会フラグです。cacheBlends が見つからない場合は、空の文字配列を返します。
-nextAvailable(-na) query
選択した cacheBlend ノード上の次に使用可能なインデックスを返す照会フラグです。
-object(-obj) string query
このフラグは objectIndex フラグと組み合わせて使用します。照会するインデックスを持つオブジェクトを指定するために使用します。

照会モードでは、このフラグに値が必要になります。

-objectIndex(-oi) int queryedit
編集モードでは、connectCache フラグと一緒に使用して、接続される objectIndex を示します。照会モードでは、オブジェクト フラグで指定したオブジェクトに関連するインデックスを返します。

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

MEL 例


// Create a cacheBlend node so that additional caches can be added to
// the shape. This will attach the existing cacheFile on the shape
// to the new cacheBlend node.
//
select -r cachedShape;
string $newBlend[] = `cacheFileCombine`;

// attach an additional cacheFile to the cacheBlend node
//
cacheFileCombine -e -cc cacheFile2 $newBlend[0];

// query the index of the newly connected cache
//
cacheFileCombine -cc cacheFile2 -q -cacheIndex $newBlend[0];

// When more than one object is driven by the caches connected
// to the cacheBlend node, the -channelName and -objectIndex flags can be
// used to control which is connected.
//
// Query the objectIndex for the armShape geometry driven by cacheBlend3:
//
string $index = `cacheFileCombine -object armShape -q -objectIndex cacheBlend3`;

// Connect another cache up to drive the armShape
//
cacheFileCombine -channelName "myChannel" -objectIndex $index -e -cc cacheFile2 cacheBlend3;