pasteKey

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

概要

pasteKey [-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] [objects]

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:10" -option replace
  1. 5～10 のターゲット カーブのキーが除去されます。
  2. 20 フレームのクリップボードのカーブがタイム 5 からペーストされます。 クリップボードのカーブにキーが存在する場合は、フレーム 11～25 のキーがオーバーライドされます。
• 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 の範囲に存在する対象カーブのキーフレームは、ペースト前の状態のままです。

戻り値

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

関連

フラグ

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

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

MEL 例

// Paste keyframes onto nurbsSphere1's translateX attribute at time 10
//
pasteKey -time 10 -attribute translateX nurbsSphere1;

// Paste to all active objects, preserving the timing from the clipboard.
//
pasteKey;