S2L EQ Shapes

   Print  Previous  Next

Functions Provided By S2L EQ Shapes

The following table provides an overview over all functions the effect provides:

Function

Description

void SetColorMode(color colmode)

Sets the color mode for the effect. See the table below for further details.

color GetColorMode()

Returns the currently set color mode. See the table below for further details.

void SetShape(int shape)

Sets the shape of the objects. See below for details.

int GetShape()

Returns the currently used shape of the objects. See below for details.

void SetFade(int fade)

Sets the fade value in BPM. Valid values range from 1 to 3000 BPM.

int GetFade()

Returns the currently used fade value.

void SetSens(int sens)

Set the "Sensitivity" value for the effect. Valid values range from 0 to 100.

int GetSens()

Returns the current "Sensitivity" value of the effect.

void SetVectorWidth(float vWidth)

Sets the size of the shapes in percent referring to the matrix size. Valid values range from 0.01 to 99.99. The given value is related to the smaller dimension of the matrix. E.g. if there is a matrix with a size of 5x20 pixels, the given value means n% of 5. Whereas 1.0 means 100%. As you can see, it is possible to set a much greater value then the smaller dimension.

float GetVectorWidth()

Returns the width of the shapes in percent. See SetVectorWidth for further details.

void SetPixelWidth(int iWidth)

Sets the size of the objects in pixels. Valid values range from 1 to 9999.

int GetPixelWidth()

Returns the size of the objects in pixels.

void SetVectorPitch(float vPitch)

Sets the pitch of the shapes in percent in relation to the matrix size. Valid values range from 0.01 to 99.99. The given value is related to the smaller dimension of the matrix. E.g. if there is a matrix with a size of 5x20 pixels, the given value means n% of 5. Whereas 1.0 means 100%. As you can see, it is possible to set a much greater value then the smaller dimension.

float GetVectorPitch()

Returns the pitch of the shapes in percent. See SetVectorPitch for further details.

void SetPixelPitch(int iPitch)

Sets the pitch between two shapes in pixels. Valid values range from 1 to 9999.

int GetPixelPitch()

Returns the currently set pitch.

void SetVectorBorder(float vBorder)

Sets the border width of the shapes in percent. This value relates to the current width of the shapes. E.g. with a current width of 10 pixels, a value of 0.5 would mean that a border with 5 pixels will be used. Valid values range from 0.01 to 99.99. A value of 1.0 means 100% of the shapes' width.

float GetVectorBorder()

Returns the border width of the shapes in percent relative to the shapes width. See SetVectorBorder for further details.

void SetPixelBorder(int iBorder)

Sets the current border thickness of the shapes in pixels.

int GetPixelBorder()

Returns the current border thickness of the shapes in pixels.

void SetAmplify(int amp)

Sets the "Amplify" value. Valid values range from 0 to 100.

int GetAmplify()

Returns the currently set amplify value.

void SetUseLevel(int enable)

Enables or disables usage of the sound level for the opacity.

int GetUseLevel()

Returns true, if usage of the sound level for the opacity is enabled. Otherwise, false is returned.

void SetColor(int idx, color c)

Sets the color at the specified index in the Color Table dialog. If idx is out of range, nothing happens.

color GetColor(int idx)

Returns the color with the specified index in the color table. If the index is out of range, black is returned.

int GetColorCount()

Returns the number of colors in the color table.

void AddColor(int idx, color c)

Adds another color to the color table at the specified index position. If the index is lower or equal to 0, the new color is added to the first position. If the index is greater than the current number of colors, the new color is added at the end.

void RemoveColor(int idx)

Removes the color located at the specified index. If the given index is out of range, nothing happens. The Color Table of this effect needs to include at least 1 entry.

 

This Effect uses the Color Table. Learn more about Using Colors.

 

Deprecated Functions
Deprecated functions are outdated functions and should not be used anymore.

Function

Description

void SetDrawMode(int mode)

Sets the current draw mode the effect should use. Please note: This function is deprecated and may be removed in one of the next releases. Use SetShape instead.

int GetDrawMode()

Returns the current draw mode. Please note: This function is deprecated and may be removed in one of the next releases. Use GetShape instead.

 

Color Modes

The function SetColorMode can be used to set different coloring modes for the effect.

Value

Description

CM_LOOP

Sets the loop mode. In this mode the effect repetitively selects colors in color table for new shapes in a row.

CM_SHUFFLE

Sets the shuffle mode. In this mode the effect selects the color of a new shape from the color table randomly.

CM_RANDOM

Sets the random mode. In this mode the colors of the shapes are generated randomly. But 10% of the colors will be generated by random access to the color table.

 

Shapes

This effect uses different geometrical figures. With the function SetShape it is possible to change them. The following values can be used as parameters:

Value

Description

DRAW_CROSS

Selects the cross for drawing.

DRAW_CROSS_IMPLODE

Selects the imploding cross for drawing.

DRAW_CROSS_EXPLODE

Selects the exploding cross for drawing.

DRAW_CIRCLE

Selects the unfilled circle for drawing.

DRAW_CIRCLE_IMPLODE

Selects the imploding circle for drawing.

DRAW_CIRCLE_EXPLODE

Selects the exploding circles for drawing.

DRAW_RECT

Selects the unfilled rectangle for drawing.

DRAW_RECT_IMPLODE

Selects the imploding rectangle for drawing.

DRAW_RECT_EXPLODE

Selects the exploding rectangle for drawing.

DRAW_STAR

Selects the star for drawing.

DRAW_STAR_IMPLODE

Selects the imploding star for drawing.

DRAW_STAR_EXPLODE

Selects the exploding star for drawing.

DRAW_DIAMOND

Selects the diamond shape for drawing.

DRAW_DIAMOND_IMPLODE

Selects the imploding diamond for drawing.

DRAW_DIAMOND_EXPLODE

Selects the exploding diamond for drawing.

FILL_CIRCLE

Selects the filled circle for drawing.

FILL_CIRCLE_IMPLODE

Selects the filled imploding circle for drawing.

FILL_CIRCLE_EXPLODE

Selects the filled exploding circle for drawing.

FILL_RECT

Selects the filled rectangle for drawing.

FILL_RECT_IMPLODE

Selects the filled imploding rectangle for drawing.

FILL_RECT_EXPLODE

Selects the filled exploding rectangle for drawing.

Fill_DIAMOND

Selects the filled diamond shape for drawing.

FILL_DIAMOND_IMPLODE

Selects the filled imploding diamond for drawing.

FILL_DIAMOND_EXPLODE

Selects the filled exploding diamond shape for drawing.

DRAW_RANDOM

Selects random shapes for drawing.