Copyright © 2005-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 further details about methods of the Graphic Bars Manager refer to the GraphicBarsMan class.

For a tutorial about the use of the Graphic Bars Manager refer to the How to perform custom feedbacks rendering using graphic bars 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

Numeric value

Meaning

GRAPHIC_BAR_ORIENT_VERTICAL

0

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

 

adjstudnet_i000079

GRAPHIC_BAR_ORIENT_HORIZONTAL

(default)

1

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

 

adjstudnet_i000075

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:

 

adjstudnet_i000075

true

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

 

adjstudnet_i000076

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)

 

adjstudnet_i00007a

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:

 

adjstudnet_i000075

GRAPHIC_BAR_SHAPE_ROUND_RECT

1

The gradient will have a rounded rectangle shape:

 

adjstudnet_i000077

GRAPHIC_BAR_SHAPE_ELLIPSE

2

The gradient will have an elliptic shape:

 

adjstudnet_i000078