The GRAPHIC_BAR_SETTINGS structure 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 details about the use of graphic bars refer to the How to perform custom feedbacks rendering using graphic bars section.
For further details about methods of the Waveform Analyzer refer to the GraphicBarsMan class section.
C# definition
public struct GRAPHIC_BAR_SETTINGS
{
public enumGraphicBarOrientations nOrientation;
public bool bAppearance3d;
public bool bSmoothing;
public bool bAutomaticDrop;
public Color colorStart;
public Color colorEnd;
public Color colorBackground;
public enumGraphicBarShapes nShape;
};
Member
|
Description
|
|
|
nOrientation
|
Graphic bar orientation.
Supported values are the following:
Mnemonic constant
|
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 be smoothed as seen on the image below:
|
true
|
The graphic bar will not 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
|
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:
|
|
|
