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