S

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 [in/out]	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: • >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

Autodesk Softimage v7.5