Introduced
5.0
Description
Saves key frames on the marked keyable parameters at a given frame. 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.
Note: This command is very similiar to SaveKeyOnKeyable with the only difference being the input objects and the list of parameters on which the keys are saved.
Scripting Syntax
SaveKeyOnMarkedKeyable( [InputObjs], [Time], [Value], [Tolerance], [Layer], [ModifiedOnly], [AutokeyScope] )
Parameters
|
Parameter |
Type |
Description |
|
InputObjs |
Object name (anything selectable) Default Value: Currently selected objects |
|
|
Time [in/out] |
Number |
Key frames are set at this frame. Default Value: Key frame |
|
Value |
Number |
Key frame values Default Value: Parameter values at current frame |
|
Tolerance |
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 frame • -1: Nearest 0.5 frame |
|
|
Layer |
Animation layer to set keys on Default Value: Current animation layer (-1) |
|
|
ModifiedOnly |
If true keys will only be set for parameters that have been modified at the current frame Default Value: False |
|
|
AutokeyScope |
Specifies whether keys will be set on all parameters or only those with existing fcurves or keys. Default Value: All specified parameters (0) Possible Values: • 0: Key all specified parameters • 1: Only key parameters that have an existing key at the given time • 2: Only key parameters that have an existing fcurve |
Examples
VBScript Example
CreatePrim "Grid", "MeshSurface"
Translate , -7.01063515498729, 5.25147709343595, -0.525147709343595, siRelative, siView, siObj, siXYZ
'Saves a key on all the marked keyable parameters on the currently selected object(s) at the current frame.
SaveKeyOnKeyableSee Also
Autodesk Softimage v7.5