pasteKey

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

概要

pasteKey( [objects] , [animLayer=string], [animation=string], [attribute=string], [clipboard=string], [connect=boolean], [copies=uint], [float=floatrange], [floatOffset=float], [includeUpperBound=boolean], [index=uint], [matchByName=boolean], [option=string], [time=timerange], [timeOffset=time], [valueOffset=float])

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

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

次のような操作が有効です。

• 1 つのアトリビュート対 1 つ以上のアトリビュート(クリップボードのアニメーションがすべての対象アトリビュートにペーストされる)
• 1 つのアトリビュート対 1 つ以上のオブジェクト(アトリビュート名が一致する場合に、クリップボードのアニメーションが対象オブジェクトにペーストされる)
• 多数のアトリビュート対 1 つまたは複数のオブジェクト
• アトリビュート名が一致した場合、クリップボードのアニメーションがターゲットに貼り付けられます

TbaseKeySetCmd.h

指定したオブジェクトのアトリビュートにクリップボードのキーセットがペーストされる方法は、指定した「-option」によって決まります。以下のオプションについては、それぞれ例を用いて説明します。すべての説明では、クリップボードのキーセットに 20 フレームのアニメーションを含むカーブ セグメントが存在すると仮定します(カーブ セグメントをクリップボードに保存するには、cutKey コマンドか copyKey コマンドを使用します)。ペースト先のアニメーション カーブは、対象カーブと呼びます。

• pasteKey -time 5 -option insert
  1. ターゲット カーブのタイム 5 以降に存在するすべてのキーフレームを右方向へ 20 フレームシフトします(20 フレームのクリップボードのセグメント用に空きを作る)。
  [2]:20 フレームのクリップボードのセグメントがタイム 5 からペーストされます。
• pasteKey -time "5:25" -option replace
  1. 5～25 のターゲット カーブのキーが除去されます。
  [2]:20 フレームのクリップボードのカーブがタイム 5 からペーストされます。
• pasteKey -option replaceCompletely
  1. 対象カーブのすべてのキーが除去されます。
  [2]:クリップボードのカーブのオリジナル キーフレーム時間を保ちながら、20 フレームのクリップボードのカーブがペーストされます。
• pasteKey -time 5 -option merge
  1. クリップボードのカーブ セグメントは全体で 20 あるフレーム レンジのタイム 5 から始まりフレーム 25 までペーストされます。
  [2]:ターゲット カーブのキーフレームは、クリップボード カーブのキーフレームと同じタイムの場合、書き換えられます。それ以外の場合、ペースト前に 5:25 の範囲に存在したキーはすべてそのまま残ります。
• pasteKey -time "3:10" -option scaleInsert
  1. ターゲット カーブのタイム 3 以降に存在するすべてのキーフレームを右方向へ 7 フレームシフトします(ペーストのために範囲 3:10 がクリアされます)
  2.クリップボードのカーブ セグメントが、指定したタイム レンジに適合するようにスケールされ(クリップボードの 20 フレームが 7 フレームに合うようにスケールされ)、3 から 10 までにペーストされます。
• pasteKey -time "3:10" -option scaleReplace
  1. 3 から 10 の範囲で、対象カーブの既存キーフレームが除去されます。
  [2]:クリップボードのカーブ セグメントが、指定したタイム レンジに適合するようにスケールされ(クリップボードの 20 フレームが 7 フレームに合うようにスケールされ)、3 から 10 までにペーストされます。
• pasteKey -time "3:10" -option scaleMerge
  1. クリップボードのカーブ セグメントが、指定した時間に適合するようにスケールされます(クリップボードの 20 フレームが、7 フレームに合うようにスケールされます)。
  [2]:クリップボードのカーブのキーと同時にターゲット カーブにキーが存在する場合は、上書きされます。その他の場合、3 から 10 の範囲に存在する対象カーブのキーフレームは、ペースト前の状態のままです。
• pasteKey -time "3:10" -option fitInsert
  1. ターゲット カーブのタイム 3 以降に存在するすべてのキーフレームを右方向へ 7 フレーム シフトします(ペーストのために範囲 3:10 がクリアされます)
  2.クリップボードのカーブ セグメントの最初の 7 フレームが、3 から 10 の範囲にペーストされます。
• pasteKey -time "3:10" -option fitReplace
  1. 3 から 10 の範囲で、対象カーブの既存フレームが除去されます。
  [2]:クリップボードのカーブ セグメントの最初の 7 フレームが、3 から 10 の範囲にペーストされます。
• pasteKey -time "3:10" -option fitMerge
  1. クリップボードのカーブ セグメントの最初の 7 フレームが、3 から 10 の範囲にペーストされます。
  [2]:クリップボードのカーブのキーと同時にターゲット カーブにキーが存在する場合は、上書きされます。その他の場合、3 から 10 の範囲に存在する対象カーブのキーフレームは、ペースト前の状態のままです。

戻り値

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

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
attribute(at)	string
選択するアトリビュートのリストです。 照会モードでは、このフラグに値が必要になります。
option(o)	string
有効な値は、「insert」、「replace」、「replaceCompletely」、「merge」、「scaleInsert」、「scaleReplace」、「scaleMerge」、「fitInsert」、「fitReplace」、「fitMerge」です。既定のペースト オプションは、「insert」です。
clipboard(cb)	string
アニメーションのペースト元になるクリップボードを指定します。有効なクリップボードは「api」と「anim」です。既定のクリップボードは「anim」です。
connect(c)	boolean
true に設定すると、ペースト時にソース カーブがペースト先カーブの値に接続されます。(これには、クリップボードのカーブがその値だけシフトし、ペースト先カーブに接続するという効果があります。)false に設定すると、ソース カーブのオリジナル キーフレーム値が保持されます。既定は false です。
copies(cp)	uint
ソース カーブをペーストする回数。
timeOffset(to)	time
ペーストされたキーをオフセットする時間(時間入力アニメーション カーブのみ)。
floatOffset(fo)	float
ペーストされたキーをオフセットする時間(時間入力アニメーション カーブ以外)。
valueOffset(vo)	float
ペーストされたキーをオフセットする値。
index(index)	uint
アニメーション カーブ上のキーのインデックス 照会モードでは、このフラグに値が必要になります。
time(t)	timerange
時間ベースのアニメーション カーブ上のキー(またはキー レンジ)を固有に表す時間です。有効な timeRange は、単一の値(-t 10)、または上下限をコロンで区切った文字列(-t "10:20")です。 照会モードでは、このフラグに値が必要になります。
float(f)	floatrange
時間ベースの animCurve上の時間ベースでないキー(またはキー レンジ)を固有に表す値です。有効な floatRange は、単一の値(-f 10)、または上下限をコロンで区切った文字列(-f "10:20")です。 照会モードでは、このフラグに値が必要になります。
includeUpperBound(iub)	boolean
-t/time または -f/float フラグがキーの範囲を表す場合に、範囲の上限のキーをキーセットに含めるかどうかを定義します。既定値: true。このフラグは、-t/time フラグの引数が上下限が指定したタイム レンジである場合に限り有効です（「pasteKey」コマンドでこのフラグを使用するときに「replace」、「fitReplace」、「scaleReplace」などのオプションを指定すると、このフラグは、置き換えられるターゲット カーブの時間範囲のみを参照します。このフラグは、クリップボードからペーストされたカーブには影響しません）。
animation(an)	string
このコマンドが、自身が影響を与えるアニメーションを取得する場所です。有効な値は「objects」、「keys」、「keysOrObjects」で、既定は「keysOrObjects」です(詳細については、説明を参照してください)。
matchByName(mn)	boolean
true の場合は、ノード名およびアトリビュート名がクリップボード内の対応する項目と厳密に一致するシーン内の項目にのみ貼り付けます。階層情報は使用されません。既定は false です。この場合、階層による通常の照合が実行されます。
animLayer(al)	string
貼り付けるキーが指定したアニメーション レイヤ上のカーブに貼り付けられるよう指定します。指定したオブジェクトまたはアトリビュートに対してそのレイヤが存在しない場合、キーは貼り付けられません。

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

Python 例

import maya.cmds as cmds

# Paste keyframes onto nurbsSphere1's translateX attribute at time 10
#
cmds.pasteKey( 'nurbsSphere1', time=(10,10), attribute='translateX' )
# Paste to all active objects, preserving the timing from the clipboard.
#
cmds.pasteKey()