VU Meter visualization
Component for foobar2000 v0.9-1.3
Build on 2013-02-16
=============================
The component is a simulation of an analog stereo volumeter (Model 702
production of Ernest Turner). Visualization is available both as a separate window
and as CUI-DUI-panel or element.


Description of settings
=================
Settings can be found on the page "Advanced" configuration window player in the group
parameters "Display \ VU Meter":
?Skins folder - specifies the directory with custom indicators.
????????????????An empty string (the default) corresponds to the folder in which
????????????????is the component itself. In all other cases, this is the way
????????????????relative to the folder with foobar2000.exe.

?Left / Right preamp - value (in decibels) added to the signal.
???????????????????????Possible values ??+ / -100 dB (20 by default).

?Approximation length - the time constant in seconds.
????????????????????????Possible values ??0.02-1 sec. (Default 0.2).

?Automatic gain control - automatically adjusts signal strength.
?

Menu Commands
=================
View \ Visualizations \
?Analog VU Meter - enables visualization in a separate window. Double
???????????????????clicking on the window for changing the dimensions default size.

View \ Visualizations \
?Analog VU Meter skins * - contains a list of all indicators in groups
??????????????????????????allowing to select the active for each group.

???Previous skin * - loading indicator in the previous group.
???Next skin * - loading indicator in the next group.

?* - The command is visible only in the full version of the menu (ie, down Shift).

CUI-panel can be added via the menu "Visualisations \ Analog VU Meter".
DUI-element "Analog VU Meter" is in group "Playback Visualization".


Context menu bar
=================
X1xY1 => X2xY2 - changes the size of an element on the size of the default of this
?????????????????indicator. X1xY1 - the current size of the window, and X2xY2 - dimensions
?????????????????default.

Layout \
?Left + Right (H) - the two indicators: left left channel, right channel on the right.
?Left + Right (V) - two indicators: the left channel from the top, bottom right channel.
?Left only - only the left channel.
?Right only - only the right channel.
?Mono - mono mode: the signal of both channels into a single indicator.

?Lock aspect ratio - enables / disables the proportions.

Group - allows you to select a group of indicators.
????????The menu is visible only when there are two or more groups.

<LED> - Loads the specified indicator.
??????????????The menu is visible only in the presence of a group of two or more indicators.


Custom Indicators
=================
In addition to the built-in, the component can be downloaded from the BIN-file user
indicators. To create and edit indicators, a special
utility, which can be downloaded at:
http://sites.google.com/site/foobar2000components/home/vumeter/VUEditor.zip

If the left and right indicators are visually different, the names of the corresponding
Files should be: "Indikator1.bin" for left, "Indikator2.bin" for the right.
For the mono mode in this case, the left indicator will be used.

Files with the indicators can be divided into groups by placing them in subfolders. The root
folder has a group <Default> (it also includes built-in display).
The panels belonging to the same group change their lights simultaneously.

Component monitors the status of files and folders with indicators and automatically
reboots the indicators if they change.


Others
=================
In addition to the separate level control (Left / Right preamp) component allows
change the overall level using the mouse wheel: 0.1 dB with pressed Shift-th and
by 1.0 dB and Shift-free.
On systems with touch-screen level can be changed by scrolling up or
downwards.

It is also possible to switch the lights using the mouse:
?Pressing the left button while holding down the right - an early indicator of the group.
?The right mouse button while holding down the left - the next indicator in the group.
On systems with touch-screen indicators can be switched by pressing a
Touch (Press and Tap).

The component implements a number of interfaces available from the component "WSH Panel Mod".
An example of use can be found in the file VUMeter.js, and the component itself on the site:
http://code.google.com/p/foo-wsh-panel-mod/downloads/list


Compatibility
=================
The component is fully compatible with UI-components foo_ui_std, foo_ui_columns and
should work with all versions of the player, supporting the 75th version of the SDK (on the
Currently this version 0.9.6.0 and 1.2.3.0).

The component is written in Pascal, without the use of foobar2000 SDK.


History
=================
Experimental version 2010.05.02.
2010.05.03 The first public version.
2010.05.04 Added support for CUI.
2010.05.05 Added the "Approximation length" and the damping on hiatus.
2010.05.07 Improved performance during transients and adds support
???????????multichannel tracks.
2010.05.08 Added support for DUI. Fixed some minor bugs.
2010.05.19 Added support Direct2D (only for Vista and higher).
2010.05.27 Added support for older versions up to 0.9.6.0.
2010.06.01 Added option "Use D2D rendering".
2010.06.03 replaced the animation by default (which is now bigger and better).
2012.02.22 Removed the option "Use D2D rendering".
???????????Signal compensation management with the mouse wheel.
2012.04.09 Support Peak level in custom indicators.
2012.04.24 Selected Signal compensation for the right and left channel.
2012.04.25 Expanded support for custom indicators.
2012.04.29 Minor corrections built-in indicator.
2012.05.02 LED support with a linear scale.
2012.05.07 Added the "Lock aspect ratio".
2012.05.23 Added mode "Left + Right (V)".
2012.05.26 Added the ability to control a component of the scripts.
2012.06.06 Improved compatibility with localized versions of the player.
2012.12.20 Added the "Automatic gain control".
2013.02.07 Improved drawing mode "Lock aspect ratio".
2013.02.16 Direct2D replaced by DirectX.