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

概要

snapshot( [objects] , [constructionHistory=boolean], [endTime=time], [increment=time], [motionTrail=boolean], [name=string], [startTime=time], [update=string])

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

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

このコマンドは、コマンド フラグで指定した時間に評価される一連のサーフェス、または指定した時間のオブジェクトのピボット ポイントの軌道を表示するモーション軌道のいずれかを作成するために使用します。

constructionHistory フラグが true の場合、オリジナル シェイプのアニメーションまたはコンストラクション ヒストリが変更されると、出力シェイプまたはモーション軌道が再度更新されます。コンストラクション ヒストリを使用する場合に forceUpdate フラグを false に設定すると、スナップショットをいつ再計算するかを制御でき、通常は、パフォーマンスが向上します。

戻り値

string[]作成または編集されたノードの名前: transform-name [snapshot-node-name]

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

フラグ

constructionHistory, endTime, increment, motionTrail, name, startTime, update
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
constructionHistory(ch) boolean createquery
オリジナル ジオメトリに加えられた変更で更新します。
endTime(et) time createqueryedit
ターゲット ジオメトリのコピーを停止する時間です。既定: 10.0
increment(i) time createqueryedit
各コピー間の時間の増分です。既定: 1.0
motionTrail(mt) boolean create
一連のサーフェスではなく、指定したタイム ステップでオブジェクトのピボット ポイントの位置を表示するモーション軌道を作成します。既定は false です。
name(n) string createqueryedit
スナップショット ノードの名前です。照会すると、このフラグは string を返します。
startTime(st) time createqueryedit
ターゲット ジオメトリのコピーを開始する時間です。既定: 1.0
update(u) string createqueryedit
このフラグは、スナップショットがコンストラクションヒストリを持つ場合のみに使用できます。このフラグは、スナップショット ノードの更新値を設定します。更新値は、スナップショットを要求に応じて更新するか(最も効率的)、キーフレームが変更されたときに更新するか(効率的)、またはヒストリが変更されたときに常に更新するか(最も非効率的)を制御します。有効な値は、「demand」、「animCurve」、「always」です。既定: always

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

Python 例

import maya.cmds as cmds

# animate a sphere
cmds.sphere(n='sphere1')
cmds.currentTime('0')
cmds.setKeyframe('.t')
cmds.currentTime('30')
cmds.move(10,0,1)
cmds.setKeyframe('.t')

# Evaluate and display "sphere1" as it appears
# at times 0, 10, 20, and 30.  Modifications to sphere1
# will update the copies.
#
cmds.snapshot( 'sphere1', constructionHistory=True, startTime=0, endTime=30, increment=10 )

# Evaluate and display "sphere1" as it appears
# at times 0, 10, 20, and 30.  Further modifications to sphere1
# should have no affect on the copies since constructionHistory is off.
#
cmds.snapshot( 'sphere1', constructionHistory=False, startTime=0, endTime=30, increment=10 )