How to perform custom feedbacks rendering using graphic bars
Active DJ Studio 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:
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 a GRAPHIC_BAR_SETTINGS data structure which can manage the following settings:
When using the control inside a web page, where managing data structures is not an easy task, you can access single parameters of the GRAPHIC_BAR_SETTINGS data structure using the GraphicBarsManager.GetGraphicalSettingsParam and GraphicBarsManager.SetGraphicalSettingsParam methods.
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 sent by the VUMeterValueChange event when calling the GraphicBarsManager.SetValue method.
When using the graphic bar for rendering a Spectrum bar, you will have to set the range of the graphic bar from 0 to 100 (using the GraphicBarsManager.SetRange method) and, after receiving the SpectrumValueChange event, make a call to the Spectrum.GetTable method in order to obtain the 64 values of the spectrum's table: at this point, depending upon the number of instanced spectrum bars, call the GraphicBarsManager.SetValue method for each of them passing the related value contained inside the spectrum table.
Samples of use of the GraphicBarsManager object in Visual C++ 6 and Visual Basic 6 can be found inside the following samples installed with the product's setup package: