FCurve.GetKey

導入

v3.0

詳細

指定されたフレームにおけるキーを戻します。キーが存在しない場合は、E_FAIL エラーが発生します。

スクリプト 構文

oReturn = FCurve.GetKey( Frame, [Tolerance] );

戻り値

FCurveKey

パラメータ

パラメータ タイプ 詳細
Frame Variant キーを検索する時間(フレーム)
許容範囲 Double キーの許容範囲

デフォルト値: -1

指定可能な値:

説明:

>0 Frame ‐ ToleranceとFrame + Tolerance のキーを合わせます。
0 キーは正確にフレームの位置にある必要があります
-1 最も近い0.5フレーム

JScript の例

/*
        This JScript example illustrates how to add keys to an fcurve and
        then how to access the key using its frame number.
*/
// Create a null
Application.NewScene( null, 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
var key, val, frame;
for ( frame=1; frame<=nbkeys; frame++ )
{
        val = ( Math.sin( 1/(frame) ) * 10 ) 
        fc.AddKey( frame, val );
        // Get key using frame
        key = fc.GetKey( frame );
        // Lock key
        key.Locked = true;
}
// End editing the fcurve and put the undo event onto 
// the undo/redo stack
fc.EndEdit();

関連項目

FCurve.KeyExists FCurve.Keys FCurve.GetKeyAtIndex FCurve.GetKeyFrame FCurve.GetKeyValue FCurve.GetKeyIndex