Copyright © 2001-2023 MultiMedia Soft

GRAPHIC_BAR_SETTINGS structure

Previous pageReturn to chapter overviewNext page

The GRAPHIC_BAR_SETTINGS class describes the graphical settings applied to a specific graphic bar. The current settings can be retrieved through the GraphicBarManager.GetGraphicalSettings method and modified through the GraphicBarManager.SetGraphicalSettings method.

 

For further details about methods of the Graphic Bars Manager refer to the GraphicBarsManager object.

For a tutorial about the use of the Graphic Bars Manager refer to the How to perform custom feedbacks rendering using graphic bars section.

 

 

Visual C++ definition

 

typedef struct

{

 long       nOrientation;

 short       bAppearance3d;

 short       bSmoothing;

 short       bAutomaticDrop;

 OLE_COLOR   colorStart;

 OLE_COLOR   colorEnd;

 OLE_COLOR   colorBackground;

 long       nShape;

} GRAPHIC_BAR_SETTINGS;

 

This data structure is defined inside the AdjMmsEngDef.h header file which can be found inside the product's Include directory (default \Program Files\MultiMedia Soft\Active DJ Studio\include).

 

Visual Basic definition

 

Public Type GRAPHIC_BAR_SETTINGS

nOrientation As enumGraphicBarOrientations

bAppearance3d As Boolean

bSmoothing As Boolean

bAutomaticDrop As Boolean

colorStart As OLE_COLOR

colorEnd As OLE_COLOR

colorBackground As OLE_COLOR

nShape As enumGraphicBarShapes

End Type

 

This data structure is defined inside the AdjMmsEngDef.bas module file which can be found inside the product's Include directory (default \Program Files\MultiMedia Soft\Active DJ Studio\include).

 

 

Member

Description

 

 

nOrientation

Graphic bar orientation.

Supported values are the following:

Mnemonic constant

Numeric value

Meaning

GRAPHIC_BAR_ORIENT_VERTICAL

0

The graphic bar is oriented vertically as seen in the image below:

 

amp3dj_i000075

GRAPHIC_BAR_ORIENT_HORIZONTAL

(default)

1

The graphic bar is oriented horizontally as seen in the image below:

 

amp3dj_i000071

bAppearance3d

Boolean value that specifies if the graphic bar is displayed with 3D borders.

Supported values are the following:

Value

Meaning

False (default)

Doesn't display 3D borders

True

Displays 3D borders

bSmoothing

Smoothing flag.

Supported values are the following:

Value

Meaning

False (default)

The graphic bar will not be smoothed as seen on the image below:

 

amp3dj_i000071

True

The graphic bar will be smoothed as seen on the image below:

 

amp3dj_i000072

bAutomaticDrop

Automatic drop flag: this feature allows decreasing the displayed value to 0 with a certain delay as seen on certain hardware based VU-meters when no input sound is available.

Supported values are the following:

Value

Meaning

False (default)

The displayed level will not drop automatically, allowing a smoother decrease

True

The displayed level will drop automatically, allowing an immediate decrease

colorStart

The color starting the gradient rendering (default is set to light Green)

colorEnd

The color ending the gradient rendering. Use the same value of the colorStart member if you want a single color graphic bar. (default is set to light Red)

colorBackground

The color used as a background  (default is set to Black)

 

amp3dj_i000076

nShape

Graphic bar orientation.

Supported values are the following:

Mnemonic constant

Numeric value

Meaning

GRAPHIC_BAR_SHAPE_RECT

(default)

0

The gradient will have a rectangular shape:

 

amp3dj_i000071

GRAPHIC_BAR_SHAPE_ROUND_RECT

1

The gradient will have a rounded rectangle shape:

 

amp3dj_i000073

GRAPHIC_BAR_SHAPE_ELLIPSE

2

The gradient will have an elliptic shape:

 

amp3dj_i000074