SaveActionKey

Description

Saves a key frame into an action. There must be only one action item active at the specified (global) time, and that item must correspond to an fcurve. The tolerance argument can be used to merge all keys within a certain range. The range is defined as Frame - Tolerance and Frame + Tolerance. The merged key will inherit the constraints of the nearest key within this range.

Scripting Syntax

SaveActionKey( [InputObjs], [Time], [Value], [Tolerance] );

Parameters

Parameter Type Description
InputObjs String List of animatable parameters (for example "cone*/kine.local.pos").

Default Value: Currently selected and marked parameters

Time Number Frame at which to save the key.

Default Value: Current frame

Value Number Key value.

Default Value: Parameter value at the current frame

Tolerance Double Frame tolerance

Default Value: Nearest 0.5 frame (-1)

Possible Values:

Description:

>0 Merge all keys between Frame - Tolerance and Frame + Tolerance
0 Key must be exactly at time
-1 Nearest 0.5 frame

Examples

VBScript Example

CreatePrim "Grid", "NurbsSurface"

SaveKey "grid.kine.local.posx", 5, 0

SaveKey "grid.kine.local.posx", 30, 5

StoreAction , "/kine.local.pos", 2, "testStoredAction"

AddClip "Scene_Root", "testStoredAction", , , 10

SaveActionKey "grid.kine.local.posx", 20, -2.5

See Also

SaveKey AddFCurve RemoveAnimation RemoveAllAnimation RemoveKey PrevKey FirstKey LastKey