移動先: 概要 戻り値 関連項目 フラグ 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 は「元に戻す」が可能、「照会」が可能、「編集」が可能です。

クリップボードから別のオブジェクトかカーブにカーブ セグメント階層をペーストします。コピーかカットを行ったカーブ セグメントのオブジェクト階層が、ペースト先のオブジェクト階層と一致しない場合、pasteKey は階層内で一致する部分をペーストします。1 つのオブジェクトのアニメーションがクリップボード上にある場合は、それぞれの対象オブジェクトにペーストされます。 複数のオブジェクトのアニメーションがクリップボード上にある場合は、どのアニメーションがどのオブジェクトにペーストされるかがセレクション リストの順序で決まります。

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

TbaseKeySetCmd.h

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

戻り値

int貼り付けられたカーブの数

戻り値の型は照会モードでは照会フラグが基になります。

関連項目

copyKey, cutKey, findKeyframe, keyTangent, keyframe, keyframeOutliner, keyframeStats, scaleKey, setInfinity, snapKey

フラグ

animation, attribute, clipboard, connect, copies, float, floatOffset, includeUpperBound, index, option, time, timeOffset, valueOffset
ロング ネーム(ショート ネーム) 引数型 プロパティ
-attribute(-at) string createmultiuse
選択するアトリビュートのリストです。

このフラグは照会モードでは値が必要になります。

-option(-o) string create
有効な値は、「insert」、「replace」、「replaceCompletely」、「merge」、「scaleInsert」、「scaleReplace」、「scaleMerge」、「fitInsert」、「fitReplace」、「fitMerge」です。デフォルトのペースト オプションは、「insert」です。
-clipboard(-cb) string create
アニメーションのペースト元になるクリップボードを指定します。 有効なクリップボードは「api」と「anim」です。デフォルトのクリップボードは「anim」です。
-connect(-c) boolean create
true に設定すると、ペースト時にソース カーブがペースト先カーブの値にコネクトされます。 (これには、クリップボードのカーブがその値だけシフトし、ペースト先カーブにコネクトするという効果があります。) false に設定すると、ソース カーブのオリジナル キーフレーム値が保持されます。デフォルトは false です。
-copies(-cp) uint create
ソース カーブをペーストする回数。
-timeOffset(-to) time create
ペーストされたキーをオフセットする時間(時間入力アニメーション カーブのみ)。
-floatOffset(-fo) float create
ペーストされたキーをオフセットする時間(時間入力アニメーション カーブ以外)。
-valueOffset(-vo) float create
ペーストされたキーをオフセットする値。
-index(-in) uint create
アニメーション カーブ上のキーのインデックス

このフラグは照会モードでは値が必要になります。

-time(-t) timerange create
時間ベースのアニメーション カーブ上の キー(またはキー レンジ)を固有に表す時間です。有効な timeRange は、単一の値(-t 10)、または上下限をコロンで区切った文字列(-t "10:20")です。

このフラグは照会モードでは値が必要になります。

-float(-f) floatrange create
時間ベースの animCurve上の時間ベースでないキー(またはキー レンジ)を固有に表す値です。有効な floatRange は、単一の値(-f 10)、または上下限をコロンで区切った文字列(-f "10:20")です。

このフラグは照会モードでは値が必要になります。

-includeUpperBound(-iub) boolean create
-t/time または -f/float フラグがキーの範囲を表す場合に、範囲の上限のキーをキーセットに含めるかどうかを定義します。 デフォルト値: true。 このフラグは、-t/time フラグの引数が上下限が指定したタイム レンジである場合に限り有効です(「pasteKey」コマンドでこのフラグを使用するときに「replace」、「fitReplace」、「scaleReplace」などのオプションを指定すると、このフラグは、置き換えられるターゲット カーブの時間範囲のみを参照します。このフラグは、クリップボードからペーストされたカーブには影響しません)。
-animation(-an) string create
このコマンドが、自身が影響を与えるアニメーションを取得する場所です。有効な値は「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;