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

概要

cacheFileMerge([endTime=time], [geometry=boolean], [startTime=time])

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

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

選択または指定したキャッシュが正常にマージできる場合、新しいキャッシュの開始/終了フレーム、そしてファイルにデータを書き込むことができない、マージ済みキャッシュ内の任意のギャップの開始/終了フレームの順に返します。照会モードでは、指定したキャッシュ ファイル ノードに接続されたジオメトリの名前を返します。

戻り値

float[]マージしたキャッシュの開始時間と終了時間、続いて任意のギャップの開始/終了
string[]照会モードで指定したキャッシュに接続されたジオメトリの名前

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

キーワード

cache, file, merge, disk

フラグ

endTime, geometry, startTime
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
endTime(et) time create
マージ範囲の終了フレームを指定します。指定しない場合、マージするキャッシュの時間から範囲を計算します。
geometry(g) boolean query
指定したキャッシュ ファイルに接続されたジオメトリ ノードを検索するために使用する照会専用フラグです。
startTime(st) time create
マージ範囲の開始フレームを指定します。指定しない場合、マージするキャッシュの時間から範囲を計算します。

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

Python 例

import maya.cmds as cmds

# Find associated geometry nodes
#
geom = cmds.cacheFileMerge('cache1', 'cache2' ,query=True, geometry=True)

# Validate merging of caches and find out start/end times.
# This will give a warning if there is a gap letting you know that
# simulation data will fill the gap.
#
startEndTimes = cmds.cacheFileMerge('cache1', 'cache2')
# Result: { 0, 20, 5, 10 }

start = startEndTimes[0]
end = startEndTimes[1]
gapStart = startEndTimes[2]
gapEnd = startEndTimes[3]

# Create a new merged cache, using simulation data to fill in
# any gaps between cache1 and cache2.
#
cacheFiles = cmds.cacheFile(fileName='mergedCache', startTime=start, endTime=end, points=geom[0])
switch = maya.mel.eval('createHistorySwitch("pPlaneShape1", false)');
cmds.cacheFile( attachFile=True, f=cacheFiles[0], ia='%s.inp[0]' % switch)
cmds.setAttr( '%s.playFromCache' % switch, 1 )

# Alternatively, can use append to make sure that we interpolate
# for the frames in the gap between cache1 and cache2.
#
cacheFiles = cmds.cacheFile(fileName='mergedCache', startTime=start, endTime=gapStart, points=geom[0])
switch = maya.mel.eval('createHistorySwitch("pPlane1", false)');
cmds.cacheFile( attachFile=True, f=cacheFiles[0], ia='%s.inp[0]' % switch)
cmds.setAttr( '%s.playFromCache' % switch, 1 )
cmds.cacheFile( replaceCachedFrame=True, startTime=gapEnd, endTime=end, points=geom[0] )