|
How to perform custom feedbacks rendering using graphic bars |
  
|
|
How to perform custom feedbacks rendering using graphic bars |
|
Audio Sound Editor API for .NET comes with some new graphical feature implemented through the GraphicBarsManager property: one of these features is the capability to display graphic bars in both horizontal and vertical orientations; these bars work as child controls of the container form (with their own HWND window handle) so the first thing to do is to create one or more instance of the control through a call to the GraphicBarsManager.Create method; as all of the other windows control, the graphic bars can be moved and resized (GraphicBarsManager.Move method), shown or hidden (GraphicBarsManager.Show method), refreshed (GraphicBarsManager.Refresh method) or destroyed (GraphicBarsManager.Destroy method).
Graphic bars can be used for the following purposes:
| • | VU-Meter bars rendering |
| • | Progress bars rendering |
Exactly as for regular Progress bar controls, graphic bars have a range, defined through the GraphicBarsManager.GetRange and GraphicBarsManager.SetRange methods, and a value defined through the GraphicBarsManager.GetValue and GraphicBarsManager.SetValue methods.
Graphical settings related to a specific graphic bar can be retrieved and modified through the GraphicBarsManager.GetGraphicalSettings and GraphicBarsManager.SetGraphicalSettings methods: both of them receive in input an object of class GRAPHIC_BAR_SETTINGS which can manage the following settings:
| • | Orientation through the nOrientation property. |
| • | Colors through the colorStart, colorEnd and colorBackground properties: you can define two colors used for rendering the current value so the graphic bar can display either a gradient color or a solid color. |
| • | 3D appearance through the bAppearance3d property |
| • | Smoothing through the bSmoothing property; graphic bars can be led-based but they can also appear smoothed as seen on the images below: |
| • | Automatic drop through the bAutomaticDrop property; 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. |
| • | Gradient shape through the nShape property; you can define how the gradient limits are rendered as seen on the samples below: |
When using the graphic bar for rendering a VU-Meter bar, you will have to set the range of the graphic bar from 0 to 32767 (using the GraphicBarsManager.SetRange method) and use values passed by the CallbackVuMeterValueChange delegate, predisposed through a previous call to the CallbackVuMeterValueChangeSet method, when calling the GraphicBarsManager.SetValue method.
Samples of use of the GraphicBarsMan class in Visual C#.NET and Visual Basic.NET can be found inside the following samples installed with the product's setup package:
Samples of usage of the waveform scroller applied to the waveform analyzer in Visual C# and Visual Basic.NET can be found inside the following samples installed with the product's setup package:
- SoundEditor
- WaveformAnalyzer (available also in Unmanaged Visual C++ and Visual Basic 6)
