GetDrivingActions

Introduced

1.5

Description

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

Scripting Syntax

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

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

Return Value

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

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

Autodesk Softimage v7.5