## GetDrivingActions

### Introduced

v1.5

### Description

Gets the actions that drive the specified objects in the scene.

### Scripting Syntax

    oReturn = GetDrivingActions( [InputObjs], [Consider Time], [Time], [Keep Compound Actions], [Keep Inactive Actions] );

### Return Value

Returns the actions that are driving the objects (a XSICollection object).

### Parameters

Parameter | Type | Description
--- | --- | ---
InputObjs | String | List of objects Default Value: Current selection
Consider Time | Boolean | Whether to only return actions active at supplied time Default Value: False
Time | Double | Frame number Default Value: Current frame.
Keep Compound Actions | Boolean | Whether to return compound actions Default Value: True
Keep Inactive Actions | Boolean | Whether to return inactive actions Default Value: False

### Examples

#### VBScript Example

    '
    '       This example demonstrates how to use the GetDrivingActions() command.
    '
    'Create a little sample scene with a simple animated sphere
    NewScene , false
    'Make sure we are in Mixed Weight Mode
    SetUserPref "ShapeInstancingMode", 1
    set oSphere = ActiveSceneRoot.AddGeometry( "Sphere", "MeshSurface" )
    SaveShapeKey "sphere", , , 1, , , , , siShapeLocalReferenceMode
    'Move a vertice and record that as the shape at frame 20
    SelectGeometryComponents "sphere.pnt[33]"
    Translate , 3, 0, 0, siRelative, siView, siObj, siXYZ
    SaveShapeKey oSphere & ".pnt[33]", , , 20, , , , , siShapeLocalReferenceMode
    'Move another point as shape for frame 30
    SelectGeometryComponents "sphere.pnt[1]"
    Translate , 0, 3, 0, siRelative, siView, siObj, siXYZ
    SaveShapeKey oSphere & ".pnt[1]", , , 30, , , , , siShapeLocalReferenceMode
    'Access the ShapeClips which have been created on the object
    set oClips = GetDrivingActions( oSphere, False, , False, False )
    LogMessage oSphere & " is driven by these Shape Clips"
    for each oClip in oClips
            LogMessage oClip
    next

### See Also

SelectActionsFromObjects SelectObjectsFromAction ShapeClip