SCE Shapes

   Print  Previous  Next

Functions Provided By SCE Shapes

Function

Description

void SetColorMode(color colmode)

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

color GetColorMode()

Returns the current color mode. See the color mode 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 shapes of the objects. See below for details.

void SetCount(int fade)

Sets the number of shapes which shall be created.

int GetCount()

Returns the number of shapes currently used.

void SetVectorWidth(float vWidth)

Sets the size of the shapes in percent in relation to the matrix size. A value of 0.01 means a width of 1%, whereas 1.0 means 100%. Valid values range from 0.01 to 99.99.  The given value is related to the smaller dimension of the matrix. So, if there is a matrix with a size of 5x20 pixels, 5 is used. And 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 as percentage. 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 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 gets a width of 5 pixels. Valid values range from 0.01 to 99.99. 1.0 represents 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 SetColor(int idx, color c)

Sets the color with the specified index to the given color value. 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.

int GetColorCount()

Returns the current 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

Value

Description

CM_LOOP

Sets the loop mode. In this mode the effect loops through the colortable to select the colors for new shapes.

CM_SHUFFLE

Sets the shuffle mode. In this mode the effect selects the color for a new shape from the color table by random access.

CM_RANDOM

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

 

Shapes

This effect uses various 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.