Copyright © 2006-2019 MultiMedia Soft

GRAPHIC_BAR_SETTINGS structure

Previous pageReturn to chapter overviewNext page

The GRAPHIC_BAR_SETTINGS structure (defined as GRAPHIC_BAR_SETTINGS_DLL when used for COM interoperability) 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;

}

Definition for COM interoperability

 

public struct GRAPHIC_BAR_SETTINGS_DLL

{

 public Int32 nOrientation;

 public Int16 bAppearance3d;

 public Int16 bSmoothing;

 public Int16 bAutomaticDrop;

 public Int32 colorStart;

 public Int32 colorEnd;

 public Int32 colorBackground;

 public Int32 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:

 

asrecnet_i00007f

GRAPHIC_BAR_ORIENT_HORIZONTAL

(default)

1

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

 

asrecnet_i00007e

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:

 

asrecnet_i00007e

true

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

 

asrecnet_i000081

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)

 

asrecnet_i000083

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:

 

asrecnet_i00007e

GRAPHIC_BAR_SHAPE_ROUND_RECT

1

The gradient will have a rounded rectangle shape:

 

asrecnet_i000085

GRAPHIC_BAR_SHAPE_ELLIPSE

2

The gradient will have an elliptic shape:

 

asrecnet_i000086