cacheFileCombine

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

概要

cacheFileCombine([cacheIndex=boolean], [channelName=string], [connectCache=string], [keepWeights=boolean], [layerNode=boolean], [nextAvailable=boolean], [object=string], [objectIndex=int])

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

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

戻り値

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

キーワード

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
cacheIndex(ci)	boolean
connectCache フラグで指定したキャッシュに関連するインデックスを返す照会モード専用フラグです。
channelName(cnm)	string
connectCache フラグと一緒に使用して、接続されるチャネルを示します。指定しないと、ファイル内の最初のチャネルが使用されます。
connectCache(cc)	string
指定した cacheBlend ノード上の次に使用可能なインデックスに接続される cacheFile ノードを指定する編集フラグです。照会フラグとしては、指定した cacheBlend ノードまでの cacheFiles を含む文字配列を返します。 照会モードでは、このフラグは値を受け入れることができます。
keepWeights(kw)	boolean
これは connectCache フラグとの組み合わせでのみ使用するフラグです。既定では、connectCache フラグは新たに追加された cacheWeight 以外のすべてのウェイトを 0 に設定し、新しいキャッシュを完全にコントロールできるようにします。このフラグはその動作を無効にし、すべての既存のブレンド ウェイトが保持されるようにします。
layerNode(ln)	boolean
選択したオブジェクト上にある既存の cacheBlends の文字配列を返す照会フラグです。cacheBlends が見つからない場合は、空の文字配列を返します。
nextAvailable(na)	boolean
選択した cacheBlend ノード上の次に使用可能なインデックスを返す照会フラグです。
object(obj)	string
このフラグは objectIndex フラグと組み合わせて使用します。照会するインデックスを持つオブジェクトを指定するために使用します。 照会モードでは、このフラグに値が必要になります。
objectIndex(oi)	int
編集モードでは、connectCache フラグと一緒に使用して、接続される objectIndex を示します。照会モードでは、オブジェクト フラグで指定したオブジェクトに関連するインデックスを返します。

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

Python 例

import maya.cmds as cmds

# 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.
#
cmds.select( 'cachedShape', r=True )
newBlend = cmds.cacheFileCombine()

# attach an additional cacheFile to the cacheBlend node
#
cmds.cacheFileCombine( newBlend[0], e=True, cc='cacheFile2' )

# query the index of the newly connected cache
#
cmds.cacheFileCombine( newBlend[0], cc='cacheFile2', query=True, cacheIndex=True )

# 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:
#
index = cmds.cacheFileCombine('cacheBlend3' ,object='armShape', query=True, objectIndex=True)

# Connect another cache up to drive the armShape
#
cmds.cacheFileCombine( 'cacheBlend3', channelName='myChannel', objectIndex=index, e=True, cc='cacheFile2' )