FCurve.RemoveKey

導入

v3.0

詳細

指定されたフレームのキーを削除します。

注:F カーブがロックされている場合は、'Access Denied'(E_ACCESSDENIED)エラーが発生します。キーロックは、OverrideKeyLock 引数を使用して上書きできます。

C#構文

FCurve.RemoveKey( Object in_Frame, Double in_Tolerance, Boolean in_OverrideKeyLock );

スクリプト構文

FCurve.RemoveKey( [Frame], [Tolerance], [OverrideKeyLock] );

パラメータ

パラメータ タイプ 説明
Frame Variant(有効なキー時間) キーを削除する時間(フレーム)

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

Tolerance Double キーの許容範囲

デフォルト値: -1

指定可能な値:

説明:

>0 Frame ‐ Tolerance と Frame + Tolerance のキーを合わせます。
0 キーは正確にフレームの位置にある必要があります
-1 最も近い 0.5 フレーム
OverrideKeyLock Boolean FCurveKey.Locked 値を上書きして、強制的にキーを削除します。

デフォルト値: False

JScript の例

/*

	This JScript example illustrates how to remove keys from an fcurve. The resample 

	method is used to create the initial keys then the RemoveKey method is used to 

	remove every other key 

*/

// 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 

// Create a key on each frame

fc.Resample();

// Remove every other key

var startframe = fc.GetKeyFrame(0)

var endframe = fc.GetKeyFrame( fc.GetNumKeys()-1 );

// Start editing the fcurve

fc.BeginEdit();

for ( i=startframe; i<=endframe; i+=2 )

{

	fc.RemoveKey(i);

}

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

// the undo/redo stack

fc.EndEdit();

関連項目

FCurve.AddKey FCurve.RemoveKeyAtIndex FCurve.RemoveKeysAtIndex FCurve.RemoveKeys