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:
|
GRAPHIC_BAR_ORIENT_HORIZONTAL
(default)
|
1
|
The graphic bar is oriented horizontally as seen in the image below:
|
|
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:
|
True
|
The graphic bar will be smoothed as seen on the image below:
|
|
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)
|
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:
|
GRAPHIC_BAR_SHAPE_ROUND_RECT
|
1
|
The gradient will have a rounded rectangle shape:
|
GRAPHIC_BAR_SHAPE_ELLIPSE
|
2
|
The gradient will have an elliptic shape:
|
|
|