FCurve.Resample

Introduced

v3.0

Description

Resamples the fcurve, adding keys from startframe to endframe at the interval defined by the step.

A valid range is defined as:

startframe < endframe and step < 0.25 * ( endframe - startframe )

Note: If the fcurve is locked or if any keys in the interval are locked then the method raises an 'Access Denied' (E_ACCESSDENIED) error.

You can override the key locks by using the OverrideKeyLock argument.

Scripting Syntax

FCurve.Resample( [StartFrame], [EndFrame], [Step], [KeepExistingKeys], [OverrideKeyLock] );

Parameters

Parameter Type Description
StartFrame Variant The time in frames at which to start resampling.

Default Value: The first key frame on the fcurve or, if there are no keys, the playcontrol In frame value.

EndFrame Variant The time in frames at which to end resampling.

Default Value: The last key frame or, if there are no keys, the playcontrol Out frame value.

Step Double The interval in frames between each key.

Default Value: 1

KeepExistingKeys Boolean Do not remove keys in resampled range.

Default Value: false

OverrideKeyLock Boolean Override the FCurveKey.Locked value for existing keys in range and remove these keys if the KeepExistingKeys argument is set to false.

Default Value: false

Examples

JScript Example

/*
        This JScript examples illustrates how to the FCurve.Resample method
        to add a predetermined number of keys to an fcurve.
*/
// 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 a number of keys
var nbkeys = 100;
var arraysize = nbkeys * 2;
var keys = new Array( 2 * nbkeys );
var i = 0, offset = -50;
// Generate some key data with a random distribution
for ( i=0; i<arraysize; i+=2 )
{
        v = Math.round( offset + Math.random() * 100 );
        keys[i] = v;
        keys[i+1] = v;
}
keys.sort();
for ( i=0; i<arraysize; i+=2 )
{
        keys[i+1] = Math.cos( (i+1) / 10 ) * 100;
}
// Set the keys onto the fcurve
fc.SetKeys( keys );
// Add the same keys to posy for comparision
nullobj.posy.AddFCurve().SetKeys( keys );
var empty;
// Resample the entire fcurve on posx and disregard the
// existing keys
fc.Resample( empty, empty, 5 );
LogMessage( "original curve : " + nullobj.posy.Source.GetNumKeys() 
        + " resampled curve : " + nullobj.posx.Source.GetNumKeys() );
// The resampling method can also be used to add keys 
// to a empty fcurve
nullobj.posz.AddFCurve().Resample( -50,50 );
// Outputs:
//INFO : original curve : 64 resampled curve : 21

See Also

FCurve.AddKey FCurve.RemoveKeys FCurve.GetNumKeys FCurve.Smooth FCurve.Fit