VU Meter visualization
Компонент для foobar2000 v0.9-1.3
Сборка от 2013-02-16
=============================
Компонент представляет собой имитацию аналогового стерео волюметра (Модель 702
производства  Ernest Turner). Визуализация доступна как в виде отдельного окна
так и в виде CUI-панели или DUI-элемента.


Описание настроек
=================
Настройки  находятся на странице "Advanced" окна конфигурации плеера, в группе
параметров "Display\VU Meter":
 Skins folder - задаёт папку с пользовательскими индикаторами.
                Пустая строка (по умолчанию) соответствует папке в которой
                находится сам компонент. Во всех остальных случаях это путь
                относительно папки с foobar2000.exe.

 Left / Right preamp - величина (в децибелах) добавляемая к сигналу.
                       Возможные значения +/-100 децибел (+20 по умолчанию).

 Approximation length - постоянная времени в секундах.
                        Возможные значения 0.02-1 сек. (0.2 по умолчанию).

 Automatic gain control - автоматическая подстройка уровня сигнала.
 

Команды меню
=================
View\Visualizations\
 Analog VU Meter - активирует визуализацию в виде отдельного окна. Двойной
                   щелчок по окну меняет его размеры на размеры по умолчанию.

View\Visualizations\
 Analog VU Meter skins* - содержит список всех индикаторов по группам,
                          позволяя выбрать активный для каждой группы.

   Previous skin* - загрузка предыдущего индикатора в группе.
   Next skin* - загрузка следующего индикатора в группе.

 *- команда видна только в полной версии меню (то есть при нажатом Shift).

CUI-панель можно добавить через меню "Visualisations\Analog VU Meter".
DUI-элемент "Analog VU Meter" находится в группе "Playback Visualization".


Контекстное меню панели
=================
X1xY1 => X2xY2 - меняет размеры элемента на размеры по умолчанию для данного
                 индикатора. X1xY1 - текущие размеры окна, а X2xY2 - размеры
                 по умолчанию.

Layout\
 Left+Right (H) - два индикатора: левый канал слева, правый канал справа.
 Left+Right (V) - два индикатора: левый канал сверху, правый канал снизу.
 Left only - только левый канал.
 Right only - только правый канал.
 Mono - моно режим: сигнал от обоих каналов на единственном индикаторе.

 Lock aspect ratio - включает/выключает режим сохранения пропорций.

Group - позволяет выбрать группу индикаторов.
        Меню видно только при наличии двух и более групп.

<Индикатор> - загружает указанный индикатор.
              Меню видно только при наличии в группе двух и более индикаторов.


Пользовательские индикаторы
=================
Помимо  встроенного,  компонент может загружать из BIN-файлов пользовательские
индикаторы. Для создание и редактирования индикаторов используется специальная
утилита, которую можно скачать по адресу:
http://sites.google.com/site/foobar2000components/home/vumeter/VUEditor.zip

Если  левый и правый индикаторы визуально отличаются, то имена соответствующих
файлов должны быть: "Индикатор1.bin" для левого, "Индикатор2.bin" для правого.
Для моно режима, в этом случае, будет использован левый индикатор.

Файлы с индикаторами можно поделить на группы помещая их в подпапки.  Корневой
папке соответствует группа <Default> (в неё же входит и встроенный индикатор).
Панели, принадлежащие одной группе, меняют свои индикаторы синхронно.

Компонент  отслеживает состояние файлов и папок с индикаторами и автоматически
перезагружает индикаторы в случае их изменения.


Прочее
=================
Помимо  раздельного управления уровнем (Left/Right preamp) компонент позволяет
изменять общий уровень с помощью колёсика мыши: на 0.1 дБ с нажатым Shift-ом и
на 1.0 дБ без Shift-а.
На системах с сенсорным экраном уровень можно менять путём прокрутки вверх или
вниз.

Так же имеется возможность переключать индикаторы с помощью кнопок мыши:
 Нажатие левой кнопки при нажатой правой - предыдущий индикатор в группе.
 Нажатие правой кнопки при нажатой левой - следующий индикатор в группе.
На  системах  с сенсорным экраном индикаторы можно переключать путём нажатия с
касанием (Press and Tap).

Компонент реализует ряд интерфейсов доступных из компонента "WSH Panel Mod".
Пример использования можно найти в файле VUMeter.js, а сам компонент на сайте:
http://code.google.com/p/foo-wsh-panel-mod/downloads/list


Совместимость
=================
Компонент  полностью  совместим с UI-компонентами foo_ui_std, foo_ui_columns и
должен  работать со всеми версиями плеера, поддерживающими 75-ю версию SDK (на
данный момент это версии с 0.9.6.0 и по 1.2.3.0).

Компонент написан на Паскале, без использования foobar2000 SDK.


История изменений
=================
2010.05.02 Экспериментальная версия.
2010.05.03 Первая публичная версия.
2010.05.04 Добавлена поддержка CUI.
2010.05.05 Добавлен параметр "Approximation length" и затухание на паузе.
2010.05.07 Улучшена работа во время переходных процессов и добавлена поддержка
           многоканальных треков.
2010.05.08 Добавлена поддержка DUI. Исправлены небольшие ошибки.
2010.05.19 Добавлена поддержка Direct2D (только для Vista и выше).
2010.05.27 Добавлена поддержка старых версий вплоть до 0.9.6.0.
2010.06.01 Добавлен параметр "Use D2D rendering".
2010.06.03 Заменена анимация по умолчанию (теперь она больше и лучше).
2012.02.22 Убран параметр "Use D2D rendering".
           Управление Signal compensation колёсиком мыши.
2012.04.09 Поддержка Peak level в пользовательских индикаторах.
2012.04.24 Отдельные Signal compensation для правого и левого канала.
2012.04.25 Расширена поддержка пользовательских индикаторов.
2012.04.29 Небольшие исправления встроенного индикатора.
2012.05.02 Поддержка индикаторов с линейной шкалой.
2012.05.07 Добавлен параметр "Lock aspect ratio".
2012.05.23 Добавлен режим "Left+Right (V)".
2012.05.26 Добавлена возможность управления компонентом из скриптов.
2012.06.06 Улучшена совместимость с локализованными версиями плеера.
2012.12.20 Добавлен параметр "Automatic gain control".
2013.02.07 Улучшена отрисовка в режиме "Lock aspect ratio".
2013.02.16 Direct2D заменён на DirectX.
