## EqualizeAction

### Introduced

v1.5

### Description

Creates and returns a new compound clip given an action. The new compound clip holds the new clips, each one representing the contribution of a specific frequency in the original source/clip. It is then possible to "Equalize" the original source/clip simply by playing with the weights of the clips contained in the resulting compound clip.
When you equalize a clip, you do not change the frequencies contained in the original source/clip, but you increase the importance of some of them with respect to the other ones. This is what happens when you play with the graphics equalizer of your sound system: the music is not sped-up or slowed-down, but you can adjust the contributions of the bass, medium or treble so the sound suits your taste. Now you can do the same with an animation...
Note: This command must be run on a source/clip which contains only fcurves. Moreover, all the fcurves have to be equally sampled. So we recommend you Bake or plot your clips before trying to equalize them.

### Scripting Syntax

    oReturn = EqualizeAction( Source, [Time], [Duration], [Name] );

### Return Value

Returns the equalized clip (it's a compound) as a ClipContainer object.

### Parameters

Parameter | Type | Description
--- | --- | ---
Source | String | Action to equalize. Default Value: Current selection
Time | Double | Offset time of the equalized clip.
Duration | Double | Duration of the equalized clip.
Name | Double | Name to use as a basis for the new clip.

### Examples

#### VBScript Example

    '

    ' This example demonstrates how to use the EqualizeAction command to

    ' create a new (equalized) compound clip from an existing action source.

    '

    ' Create an object for our example.

    set oSphere = CreatePrim( "Sphere", "MeshSurface" )

    posParams = "/kine.local.posx,kine.local.posy,kine.local.posz"

    ' Make an Action with it moving diagonally over 20 frames.

    SetPositionKey oSphere, 1, -5, -5, 0

    SetPositionKey oSphere, 20, 5, 5, 0

    set oSource = StoreAction( , oSphere & posParams, 2, "Diagonal", True, 1, 20 )

    ' Create a track and instantiate the Action onto it, starting at frame 10.

    set oTrack = AddTrack( "Scene_Root", , 0 )

    set oClip1 = AddClip( "Scene_Root", oSource, , oTrack, 10 )

    ' Use that action to create a new compound clip

    set oClip2 = EqualizeAction( oSource, 4, 10, "EqualizedActionClip" )

    '==================================================

    ' Helper method to key an object somewhere at a given frame.

    '==================================================

    sub SetPositionKey( in_oObj, in_frame, in_posX, in_posY, in_posZ )

    	Translate in_oObj, in_posX, in_posY, in_posZ, siAbsolute, siParent, siObj, siXYZ

    	SaveKey in_oObj & posParams, in_frame

    end sub

### See Also

EqualizeClips StoreAction