SelectKeysInTimespan
 
 
 

SelectKeysInTimespan

Introduced

v6.0

Description

Manipulates the key selection for all keys in the timespan (from StartFrame to EndFrame) on each of the curves from the input list according to the specified selection mode. The selection mode defines how to manipulate the current key selection: that is, whether to reset, append, toggle, or remove keys from the selection (use the DeselectAllKeys command to clear the selection).

Tip: You specify each fcurve to paste onto by identifying the parameter it drives in the InputObjs argument.

Note: Key selection is used and shown in the DopeSheet.

Scripting Syntax

SelectKeysInTimespan( [InputObjs], Mode, [StartFrame], [EndFrame], [Type] );

Parameters

Parameter Type Description
InputObjs String List of animatable parameters (for example "cone*/kine.local.pos"). This parameter uses the Type parameter to interpret which parameters to use in this way:

- If Type == siInputParameters then InputObjs is used exactly as input (either from the specified list or the animatable parameters on the selected objects).

- If Type == siAnimatedParameters then InputObjs is expected to be a list of objects on which each animatable parameter will be affected.

- If Type == siAllAnimatedParameters then the value of InputObjs is ignored and instead the command uses all animated parameters on all objects in the entire scene.

Default Value: If no value is specified for this parameter, the Object List will use the selected objects or parameters respecting the scope indicated by the Type argument.

Mode siFCurveKeySelectionMode Mode of key selection to perform.

Default Value: siSetKeySelection

StartFrame Double Start frame of the range of keys to change selection on.

Leave both Start and End blank for all keys.

Value range -Inf, +Inf
EndFrame Double End frame of the range of keys to change selection on.

Leave both Start and End blank for all keys.

Value range -Inf, +Inf
Type siParameterScope Parameter scope of the operation

Default Value: siInputParameters

Examples

VBScript Example

'
' This example demonstrates how to use the SelectKeysInTimespan command by creating
' a simple null, animating it and then selecting some of its keys.  If you want to 
' use the DopeSheet to view keys selected via SelectKeysInTimespan, make sure you
' comment out the last line of the example (DeselectAllKeys).
'
' Create a null and animate it
NewScene, False
GetPrim "Null"
Translate , -6.53833089859819, 3.35653805660097, -0.335653805660097, siRelative, siView, siObj, siXYZ, , , , , , , , , , 0
SaveKey "null.kine.local.posx,null.kine.local.posy,null.kine.local.posz", 1
SetValue "PlayControl.Key", 25
SetValue "PlayControl.Current", 25
Translate , 13.2015980564052, 0.828774828790348, -8.28774828790347E-02, siRelative, siView, siObj, siXYZ, , , , , , , , , , 0
SaveKey "null.kine.local.posx,null.kine.local.posy,null.kine.local.posz", 25
SetValue "PlayControl.Key", 50
SetValue "PlayControl.Current", 50
Translate , -12.2437534024705, -6.75451485464142, 0.675451485464142, siRelative, siView, siObj, siXYZ, , , , , , , , , , 0
SaveKey "null.kine.local.posx,null.kine.local.posy,null.kine.local.posz", 50
SetValue "PlayControl.Key", 75
SetValue "PlayControl.Current", 75
Translate , 10.2864186748647, -1.78186588189925, 0.178186588189925, siRelative, siView, siObj, siXYZ, , , , , , , , , , 0
SaveKey "null.kine.local.posx,null.kine.local.posy,null.kine.local.posz", 75
SetValue "PlayControl.Key", 100
SetValue "PlayControl.Current", 100
Translate , -10.9943908103816, 8.70213570229867, -0.870213570229867, siRelative, siView, siObj, siXYZ, , , , , , , , , , 0
SaveKey "null.kine.local.posx,null.kine.local.posy,null.kine.local.posz", 100
' Select all the keys between frames 25 and 50 (inclusive) on each of the posx, posy and posz curves.
SelectKeysInTimespan "null.kine.local.posx,null.kine.local.posy,null.kine.local.posz", siSetKeySelection, 25, 50
' If you wish you can now view that key selection opening a DopeSheet.  The
' selected keys will be drawn in yellow.
' Select all the keys between frames 23 and 31 (inclusive) on each of the posx, posy and posz curves.
' And then add all the keys between frames 48 and 53 (inclusive) again on those same curves.
SelectKeysInTimespan "null.kine.local.posx,null.kine.local.posy,null.kine.local.posz", siSetKeySelection, 23, 31
SelectKeysInTimespan "null.kine.local.posx,null.kine.local.posy,null.kine.local.posz", siAddToKeySelection, 48, 53
' Deselect all the keys
DeselectAllKeys

See Also

DeselectAllKeys ScaleAndOffset CopyKeys CutKeys DeleteKeys PasteKeys