## 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