PasteKeys

詳細

指定された時間範囲(StartFrame から EndFrame)で、FCurveKey をバッファから 1 つまたは複数の FCurve に貼り付けます。 F カーブキーは、CutKeys コマンドまたは CopyKeys コマンドを使用して、バッファに配置されます。

ヒント: 貼り付け先の各 F カーブを指定するには、InputObjs 引数で操作するパラメータを識別します。

PasteKeys は、DopeSheet の貼り付けアクションと同等のコマンドであり、DopeSheet の動作をエミュレートする場合に使用する必要があります。

注: このコマンドは、出力引数を使用します。C# および一部のスクリプト言語(JScript、PerlScript、Python など)は、リファレンスによって渡される引数をサポートしていません。このため、状況に応じた適切な回避策を実行する必要があります。

スクリプト言語の場合、このコマンドは出力引数を取得するために使用できる ISIVTCollection を戻します。

C# の場合は、XSIApplication.ExecuteCommand メソッドを使用してこのコマンドを呼び出すことができます。ExecuteCommand は、出力引数を C# の System.Object (出力引数の Array を含む)にパック化します(詳細については、「C# からのコマンドの呼び出し」を参照)。

スクリプト構文

PasteKeys( [InputObjs], [StartFrame], [EndFrame], [Ripple], [Merge], [Type], [Offset], [Relative], [LeftContinuity], [RightContinuity] );

パラメータ

パラメータ タイプ 説明
InputObjs 文字列 アニメート可能なパラメータのリスト (例: cone*/kine.local.pos)。このパラメータは、Type パラメータを使用して、使用するパラメータを以下の方法で決定します。

- Type == siInputParameters の場合、InputObjs は入力そのものとして使用されます(指定されたリストまたは選択したオブジェクトのアニメート可能なパラメータから)。

- Type == siAnimatedParameters の場合、InputObjs は、アニメート可能なパラメータそれぞれが影響を受けるオブジェクトのリストであると予測されます。

- Type == siAllAnimatedParameters の場合、InputObjs の値は無視され、代わりにコマンドがシーン全体のすべてのオブジェクトにあるすべてのアニメートされたパラメータを使用します。

デフォルト値: このパラメータの値を指定しない場合、オブジェクト リストは Type 引数によって示されるスコープに対して選択されたオブジェクトまたはパラメータを使用します。

StartFrame Double フレーム間隔の下限値

デフォルト値: 1

EndFrame Double フレーム間隔の上限値

デフォルト値: 100

Ripple(リプル) Boolean キーをリプルするフラグ

デフォルト値: True

Merge Boolean 貼り付ける際に、キーをマージするのか入れ替えるのかを指定するフラグ(デフォルト設定ではマージします)。

デフォルト値: True

Type siParameterScope 操作のパラメータ範囲

デフォルト値: siInputParameters

Offset Double ペーストされるフレーム間隔の下限値からのオフセット(新しい上限値)。
Relative Boolean 開始フレームを基準にキー値を貼り付けるかどうかを指定するフラグ。

デフォルト値: False

LeftContinuity Integer このパラメータは、最初に貼り付けられるキー値を決定する方法を制御します。

デフォルト値: 0

指定可能な値:

説明:

0 キー値を使用
1 F カーブ値を使用
2 F カーブおよび貼り付けられたキー値の平均を使用
RightContinuity Integer このパラメータは、最後に貼り付けられるキー値を決定する方法を制御します。

デフォルト値: 0

指定可能な値:

説明:

0 キー値を使用
1 F カーブ値を使用
2 F カーブおよび貼り付けられたキー値の平均を使用

関連項目

SelectKeysInTimespan DeselectAllKeys CopyKeys CutKeys DeleteKeys