pasteKey

移動先: 概要 戻り値 関連項目 フラグ MEL の例

概要

pasteKey [-animation string] [-attribute string] [-clipboard string] [-connect boolean] [-copies uint] [-float floatrange] [-floatOffset float] [-includeUpperBound boolean] [-index uint] [-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: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(-in)	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」です（詳細については、説明を参照してください）。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

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;