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 の範囲に存在する対象カーブのキーフレームは、ペースト前の状態のままです。

戻り値

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

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
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(index)	uint
アニメーション カーブ上のキーのインデックス 照会モードでは、このフラグに値が必要になります。
matchByName(mn)	boolean
true の場合は、ノード名およびアトリビュート名がクリップボード内の対応する項目と厳密に一致するシーン内の項目にのみ貼り付けます。階層情報は使用されません。既定は false です。この場合、階層による通常の照合が実行されます。
option(o)	string
有効な値は、「insert」、「replace」、「replaceCompletely」、「merge」、「scaleInsert」、「scaleReplace」、「scaleMerge」、「fitInsert」、「fitReplace」、「fitMerge」です。既定のペースト オプションは、「insert」です。
time(t)	timerange
時間ベースのアニメーション カーブ上のキー(またはキー レンジ)を固有に表す時間です。有効な timeRange は、単一の値(-t 10)、または上下限をコロンで区切った文字列(-t "10:20")です。 照会モードでは、このフラグに値が必要になります。
timeOffset(to)	time
ペーストされたキーをオフセットする時間(時間入力アニメーション カーブのみ)。
valueOffset(vo)	float
ペーストされたキーをオフセットする値。

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

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()