## SISequence

### Description

Offsets or scales the animation of the specified objects by offsetting (stretching) or scaling (shrinking) the portion of an fcurve between a start and end frame using a specified pivot point, then translating the resulting scaled fcurve portion. You can use this command to change the timing of all animation in a scene at once.
By default, the ripple effect is active, meaning that the region offsets other keys that are further along on the timeline (to the right). The rest of the function curve is moved to the right of the inserted region, causing a ripple effect. You can turn this feature off by setting the Ripple argument to False.
This is the equivalent of Animation > Sequence Animation. It should be used when trying to emulate this behaviour through scripting. The ScaleAndOffset command is similar in effect but is the command equivalent of moving or scaling a keyframe region in the dopesheet. When emulating dopesheet behaviour ScaleAndOffset should be used.

### Scripting Syntax

    SISequence( [InputObjs], [Type], [Offset], [Scale], [StartFrame], [EndFrame], [Pivot], Mode, [Ripple], [Discrete Time] );

### 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.
Type | siParameterScope | Parameter scope of the operation. Default Value: siAllAnimatedParameters
Offset | Double | Value of the offset you want to apply to the animation. Default Value: 0
Scale | Double | Value of the scaling factor you want to apply to the animation. Default Value: 1
StartFrame | Double | Start frame of the region on which to operate. Default Value: 1
EndFrame | Double | End frame of the region on which to operate. Default Value: 100
Pivot | Double | Pivot frame for the scaling. Default Value: 1
Mode | siSequenceMode | Affected items for SequenceAll only. Default Value: siFCurvesAnimationSources
Ripple | Boolean | Turn the Ripple effect on or off. Default Value: 1
Discrete Time | Boolean | Make sure that all the keys will fall on frames. Default Value: 1

### Examples

#### VBScript Example

    '

    ' Create a cube and a null with identical animation,

    ' then scale the cube's animation by half and offset it 50 frames.

    '

    dim oNull,oCube

    set oCube = CreatePrim("Cube", "MeshSurface")

    oCube.length = 1

    set oNull = GetPrim("Null")

    AddToMarking "kine.local.pos.posx,kine.local.pos.posz"

    Translate oNull, -3, 0, 3, siAbsolute, siView, siObj, siXYZ

    SaveKey ,1

    Translate oNull, 0, 0, -3, siAbsolute, siView, siObj, siXYZ

    SaveKey , 50

    Translate oNull, 3, 0, 3, siAbsolute, siView, siObj, siXYZ

    SaveKey , 100

    ' Copy null's animation over to the cube

    CopyAllAnimation2 oNull, siAnySource, siAllParam, False

    PasteAllAnimation oCube

    '

    ' Now Scale and offset the cube animation

    ' The begining of the animation is offset to frame 50

    ' and the entire sequence is scaled by 0.5

    '

    SISequence oCube, siAnimParams, 50, 0.5, 1, 100, 1, siFCurvesAnimationSources

    '

    ' The cube will stay at its initial position till

    ' frame 50, then catch up to the null

    '

    PlayForwardsFromStart

### See Also

Sequence ScaleAndOffset ActivateFCurve FCurve