M2L Single Tone Shapes

   Print  Previous  Next

Functions Provided By M2L Single Tone

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 objects. See below for details.

void SetFade(int fade)

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

int GetFade()

Returns the current fade value.

void SetSens(int sens)

Sets the "Sensitivity" value of 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 relative 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. If there is a matrix with size of 5x20 pixels for example, 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 figures 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. A value of 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. if the current width of the shapes is 10 pixels, a value of 0.5 would mean that the border is drawn with a width of 5 pixels. 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.

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.

void SetColor(int idx, color c)

Sets the color with the specified index in the Color Table to the given color. If the index 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.

 

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 SetPitch(int pitch)

Sets the pitch between two shapes in pixels. Valid valuesrange from 1 to 9999. Please note: This function is deprecated and may be removed in a forthcoming release. Use SetPixelPitch instead

int GetPitch()

Returns the currently set pitch in pixels. Please note: This function is deprecated and may be removed in a forthcoming release. Use GetPixelPitch instead.

void SetThickness(int thickness)

Sets the thickness of the shapes in pixels. Please note: This function is deprecated and may be removed in a forthcoming release. Use SetPixelBorder instead.

int GetThickness()

Returns the current thickness. Please note: This function is deprecated and may be removed in a forthcoming release. Use GetPixelBorder instead.

void SetWidth(int width)

Sets the size of the objects in pixels. Valid values range from 1 to 9999. Please note: This function is deprecated and may be removed in a forthcoming release. Use SetPixelWidth instead.

int GetWidth()

Returns the size of the objects in pixels. Please note: This function is deprecated and may be removed in a forthcoming release. Use GetPixelWidth instead.

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 determine the used coloring mode:

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 parameter:

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.