FCurve.AddKey

FCurve.AddKey

導入

v3.0

詳細

指定されたフレームにキーを追加し、新しいキーのインデックスを戻します。このメソッドを実行すると、F カーブのすべてのシェイプが変わります。シェイプを変えずに既存のプロファイルに沿ってキーを追加したい場合は、代わりに FCurve.InsertKeyAtFrame メソッドを使用してください。

注:F カーブがロックされている場合は、'Access Denied'(E_ACCESSDENIED)エラーが発生します。

トレランス引数は、特定範囲内のすべてのキーをマージする場合に使用できます。範囲は Frame - Tolerance および Frame + Tolerance で定義されます。マージされたキーは、この範囲内の近似キーのコンストレイントを継承します。

C#構文

Int32 FCurve.AddKey( Object in_Frame, Object in_Value, Double in_Tolerance, Boolean in_Overwrite );

スクリプト構文

oLong = FCurve.AddKey( [Frame], [Value], [Tolerance], [Overwrite] );

戻り値

Long

パラメータ

パラメータ タイプ 説明
Frame Variant キーを追加する時間(フレーム)

デフォルト値:現在の時間

Value Variant キーの値

標準F カーブおよびロー F カーブの場合は double 値(VT_R8)を使用します。

整数F カーブの場合は LONG 値(VT_I4)、ブールF カーブの場合は variant bool値(VT_BOOL、VARIANT_TRUE、VARIANT_FALSE)を使用します。

デフォルト値:指定されたフレームの既存のカーブの値

Tolerance Double キーの許容範囲

デフォルト値: -1

指定可能な値:

説明:

>0 Frame ‐ Tolerance と Frame + Tolerance のキーを合わせます。
0 キーは正確にフレームの位置にある必要があります
-1 最も近い 0.5 フレーム
Overwrite Boolean 既存のキーを上書きします。ロック状態のキーを上書きします。

デフォルト値: False

JScript の例

/*

	This example illustrates how to add keys to an fcurve and how to use

	the editing recording feature so that only one undo event is put onto the

	undo/redo stack.

*/

// Create a null

Application.NewScene( "", false );

var nullobj = ActiveSceneRoot.AddNull();

// Create an fcurve on the posx parameter from the null

var fc = nullobj.posx.AddFCurve();

// Define the number of keys

var nbkeys = 100 ;

// Start editing the fcurve

fc.BeginEdit();

// Add keys to the fcurve

for ( i=0; i<nbkeys; i++ )

{

	val = (Math.sin( 1/(i+1) ) * 10);

	fc.AddKey( i, val );

}

// End editing the fcurve and put the undo event onto

// the undo/redo stack

fc.EndEdit();

関連項目

FCurve.InsertKeyAtFrame FCurveKey.Locked FCurve.Resample FCurve.RemoveKey