PrevKey

Description

Moves the current time to the previous key frame for the specified animated parameters.

Scripting Syntax

PrevKey( [InputObjs], [Time], [Tolerance], [Layer] )

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

Move to the key before this frame.

Default Value: Current frame

Tolerance

Double

Frame tolerance

Default Value: Nearest 0.5 frame (-1)

Possible Values:

• >0: Get key at Frame - Tolerance

• 0: Key must be exactly at frame

• -1: Nearest 0.5 frame

Layer

Integer

Animation layer

Default Value: Current animation layer (-1)

Return Value

Returns the frame number of the previous key frame as a Double. If there is no key then the following is returned: -1.#INF for C++, "-1.#INF" for VBScript and Number.NEGATIVE_INFINITY for JScript.

Examples

VBScript Example

' create a null with some animation
set o = getprim("null")
Translate o, -10, 5, 0, siRelative, siView, siObj, siXYZ
savekey o & "/kine.local.pos", 1
Translate o, 10, -5, 0, siRelative, siView, siObj, siXYZ
savekey o & "/kine.local.pos", 50
Translate o, 10, 5, 0, siRelative, siView, siObj, siXYZ
savekey o & "/kine.local.pos", 75


' Process all the keys prior to the current frame
LastFrame
PrevKeys ( o & "/kine.local.pos" )

sub PrevKeys (params)
   frame = PrevKey( params )
   do while frame <> "-1.#INF"
       LogMessage "There is a key at frame " & frame
       frame = PrevKey( params )
   loop
end sub 
'INFO : "There is a key at frame 75"
'INFO : "There is a key at frame 50"
'INFO : "There is a key at frame 1"

See Also

AddFCurve

RemoveAnimation

RemoveAllAnimation

SaveKey

RemoveKey

NextKey

FirstKey

LastKey

FCurve.Keys

 

 

 

Autodesk Softimage v7.5