FloatCurve

Show Deprecated

An instance representing a 1D float curve encoded via a sorted list of FloatCurveKeys. The shape of the interpolation curve between two keys is determined by the FloatCurveKey.Interpolation type.

Summary

Properties

  • Read Only
    Not Replicated
    Read Parallel

    Number of keys in the float curve.

Methods

Properties

Length

Read Only
Not Replicated
Read Parallel

Number of keys in the float curve.

Methods

GetKeyAtIndex

Returns a copy of a key at a given index.

Parameters

index: number

Returns

GetKeyIndicesAtTime

The first item in the returned array is the index of the last key with time less than or equal to time (or the lesser of either 1 or the curve length if no key was found). The second item in the returned array is the index of the first key with time greater than or equal to time (or the curve length if no key was found satisfying the inequality).

Parameters

time: number

Returns

GetKeys

Returns a copy of all the keys in the FloatCurve as a Lua array of FloatCurveKeys.


Returns

GetValueAtTime

Samples the float curve at a given time passed as argument.

Parameters

time: number

Time at which to sample the curve.


Returns

Value of the curve at the requested time.

InsertKey

Adds the key passed as an argument to this curve. If a key at the same time is found, it will be replaced. In the returned array, the first value is true if a key was added or false if a previous key was replaced; the second value is the index at which the marker was added.

Parameters


Returns

(see description) .

RemoveKeyAtIndex

Removes a given number (count) of keys starting from the startingIndex index and returns the number of keys that were removed.

Parameters

startingIndex: number

Starting index from which to remove keys.

count: number

Number of keys to remove.

Default Value: 1

Returns

Number of keys removed.

SetKeys

Resets this curve's keys using the FloatCurveKey array passed as an argument. Keys in the keys array are sorted in ascending time order before insertion, and keys at duplicated times are removed in a stable manner.

Returns the number of keys actually inserted. Keys previously stored in this curve are removed before the keys passed as arguments are added.

Parameters

keys: Array

Array of FloatCurveKeys.


Returns

Number of keys inserted.

Events