SaveActionKey

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

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