﻿Polivoks — эмуляция синтезатора «Поливокс»: установка и работа
================================================================

Форматы:
- Windows x64: Polivoks.vst3 (для DAW) и Polivoks.exe (отдельное приложение).
- macOS 10.15 и новее, Apple Silicon и Intel: Polivoks.component (Audio Unit для Logic Pro,
  GarageBand, MainStage), Polivoks.vst3 (Ableton Live, Bitwig, Reaper, Cubase и другие DAW)
  и Polivoks.app (отдельное приложение).


УСТАНОВКА — WINDOWS
-------------------
1. Скопируйте папку Polivoks.vst3 целиком в
   C:\Program Files\Common Files\VST3\
2. Ableton Live: Options -> Settings (в старых версиях Preferences) -> Plug-Ins:
   включите «Use VST3 Plug-In System Folders» и нажмите «Rescan».
3. Плагин появится в браузере в разделе Plug-Ins -> VST3 (возможно, в папке
   Ivan Abrosimov). Перетащите его на MIDI-дорожку.

Без DAW: Polivoks.exe — отдельное приложение с экранной клавиатурой.
Кнопка Options -> Audio/MIDI Settings: выбор звуковой карты и MIDI-клавиатуры.

Windows может показать предупреждение SmartScreen для Polivoks.exe: программа не подписана.
Нажмите «Подробнее» -> «Выполнить в любом случае».


УСТАНОВКА — macOS
-----------------
1. Скопируйте файлы:
     Polivoks.component -> ~/Library/Audio/Plug-Ins/Components/
     Polivoks.vst3      -> ~/Library/Audio/Plug-Ins/VST3/
   (Папка ~/Library скрыта: в Finder — меню «Переход» -> «Переход к папке…», введите путь.)
2. Плагин пока не подписан сертификатом Apple, поэтому macOS блокирует файлы, скачанные
   из интернета. Один раз выполните в Терминале:
     xattr -dr com.apple.quarantine ~/Library/Audio/Plug-Ins/Components/Polivoks.component
     xattr -dr com.apple.quarantine ~/Library/Audio/Plug-Ins/VST3/Polivoks.vst3
     xattr -dr com.apple.quarantine /путь/к/Polivoks.app
3. Logic Pro: Logic Pro -> Настройки -> Менеджер плагинов (Plug-in Manager). Найдите
   Ivan Abrosimov -> Polivoks; если он не прошёл проверку, нажмите «Reset & Rescan Selection».
   Плагин находится в инструментах: AU Instruments -> Ivan Abrosimov -> Polivoks.
4. Ableton Live и другие DAW на Mac используют Polivoks.vst3 — включите VST3 в настройках
   плагинов DAW и выполните пересканирование.


ГДЕ ХРАНЯТСЯ ДАННЫЕ
-------------------
- Свои пресеты (*.polivoks):
    Windows: Документы\Polivoks\Presets
    macOS:   ~/Library/Audio/Presets/Ivan Abrosimov/Polivoks
- Рейтинги (ratings.xml), привязки MIDI Learn по умолчанию (midi-map.xml), язык и отметка
  о первом запуске (settings.xml):
    Windows: %APPDATA%\Polivoks
    macOS:   ~/Library/Application Support/Polivoks


УПРАВЛЕНИЕ
----------
- Все ручки как на оригинальной панели. Двойной щелчок — значение по умолчанию.
- Подробное руководство по каждой ручке встроено в плагин: шестерёнка справа вверху ->
  вкладка ОБУЧЕНИЕ (на всех 13 языках).
- Тумблер «УДЕРЖАНИЕ НОТ» (справа внизу, в блоке усилителя; на оригинале — «ВКЛ.»):
  вверх (ВКЛ.) — сыгранные ноты звучат и после отпускания клавиш; новый аккорд, взятый после
  отпускания всех клавиш, заменяет удерживаемый; при включении звучит последняя сыгранная нота
  (если ещё ничего не играли — тишина до первой ноты). Вниз (ВЫКЛ.) — обычный режим.
- Тумблер «ВЫХОД»: ВКЛ. — звук идёт, ВЫКЛ. — плагин заглушён.
- Колесо модуляции (CC1) или педаль экспрессии (CC11) — педаль частоты среза, как у оригинала.
- Изгиб высоты и педаль сустейна работают, хотя в оригинале их нет.
- Внешний вход: у плагина есть аудиовход, но подаёт ли DAW на него звук для инструмента,
  зависит от DAW (в Ableton ещё не проверено). Сигнал входа регулируется ручкой «ВНЕШНИЙ»;
  вместе с «УДЕРЖАНИЕМ НОТ» (сыграйте одну ноту) фильтр работает как обработка звука.

Верхняя панель (в оригинале нет)
Слева направо: БИБЛИОТЕКА, ◀ имя пресета ▶, рейтинг, СОХРАНИТЬ, ПОДДЕРЖАТЬ АВТОРА;
справа — ТЕМП и шестерёнка.

Клавиатура внизу
- Весь диапазон MIDI (C-1…G9), на экране 4 октавы. Прокрутка — стрелки по краям, колесо мыши
  или жест тачпада. Щелчок мышью по клавише играет ноту.


ЯЗЫК ИНТЕРФЕЙСА
---------------
- 13 языков: английский, китайский, хинди, испанский, арабский, французский, бенгальский,
  португальский, индонезийский, урду, русский, немецкий, японский.
- Выбор — в окне «О плагине» или в настройках (шестерёнка -> вкладка ОБУЧЕНИЕ -> «ЯЗЫК
  ИНТЕРФЕЙСА»). Переводятся надписи на панели, верхняя панель, библиотека, настройки, названия
  заводских пресетов, руководство, а также названия и значения параметров, которые показывает
  DAW. Логотип «ПОЛИВОКС» остаётся как на оригинале.
- Некоторые DAW перечитывают названия параметров только после повторной загрузки плагина
  или проекта.


О ПЛАГИНЕ И ПОДДЕРЖКА АВТОРА
----------------------------
- При первом запуске каждого формата (VST3 в DAW, AU в Logic, отдельное приложение) появляется
  окно «О плагине» (по умолчанию на английском, язык выбирается в списке вверху окна).
  Закрывается кнопкой «Продолжить», дальше не мешает.
- Снова открыть его — кнопка «ПОДДЕРЖАТЬ АВТОРА» в верхней панели: там донаты и контакты.
- Условия использования — в папке License (файл на вашем языке).


ПРЕСЕТЫ
-------
- БИБЛИОТЕКА (или щелчок по имени пресета) открывает список. Щелчок по строке — загрузить.
  Фильтры слева: ВСЕ / ЗАВОДСКИЕ / МОИ, «РЕЙТИНГ НЕ НИЖЕ» (1–5 звёзд), поиск по названию
  и описанию. Стрелки ◀ ▶ листают пресеты с учётом этих фильтров.
- Рейтинг: щелчок по звезде ставит оценку, повторный щелчок по той же звезде — снимает.
  Можно оценивать и в списке, и в верхней панели. Оценки общие для всех копий плагина
  на этом компьютере.
- СОХРАНИТЬ — сохранить текущий звук как свой пресет. Если имя занято, пресет перезаписывается
  (окно об этом предупредит). Свои пресеты удаляются в библиотеке: «УДАЛИТЬ», затем
  «ТОЧНО УДАЛИТЬ?».
- Свои пресеты лежат в папке пресетов (см. «Где хранятся данные», кнопка «ОТКРЫТЬ ПАПКУ
  ПРЕСЕТОВ» в библиотеке). Их можно копировать между компьютерами.
- Звёздочка и надпись «ИЗМЕНЁН» у имени — звук отличается от сохранённого пресета.
- В пресет не входят темп и тумблер «ВЫХОД».


ТЕМП
----
- ПРОЕКТ — темп и сетка берутся из DAW. СВОЙ — темп задаётся в поле справа: тяните вверх/вниз
  (с Shift — точнее), крутите колесо мыши или дважды щёлкните и введите число (30–300 BPM).
- В отдельном приложении проекта нет, поэтому там только поле своего темпа.
- Если DAW не сообщает темп, плагин работает по своему темпу.

Синхронизация с темпом
- Модулятор: кнопка «СИНХР. ТЕМП» под ручкой частоты. Когда она горит, ручка «ЧАСТОТА»
  превращается в «ДЕЛЕНИЕ»: от 4 тактов до 1/32, с пунктирными (.) и триольными (т) долями.
  Справа показан текущий темп и его источник. В режиме ПРОЕКТ во время воспроизведения фаза
  модулятора привязана к сетке проекта, на остановке модулятор идёт с тем же темпом сам.
- Циклы огибающих: тумблер «РЕЖИМ ГО» в фильтре и в усилителе трёхпозиционный —
  однократно / цикл / ТЕМП. В положении ТЕМП огибающая перезапускается на каждом делении сетки
  (ручка «ДЕЛЕНИЕ» рядом), пока нажата клавиша или включено «УДЕРЖАНИЕ НОТ».


ШЕСТЕРЁНКА СПРАВА ВВЕРХУ
------------------------
Справа к окну добавляется панель (окно становится шире). Вкладки:
- ОБУЧЕНИЕ — открывается первой: выбор языка и подробное руководство по всем параметрам
  на выбранном языке (оглавление кликабельное). Язык общий для всего плагина.
- MIDI — MIDI Learn (ниже).

MIDI Learn (шестерёнка -> вкладка MIDI)
Многие DAW (например, Ableton с Push) сами раскладывают параметры по контроллеру — тогда
MIDI Learn не нужен. Он пригодится там, где такого нет.
1. Шестерёнка -> вкладка MIDI -> «ВКЛЮЧИТЬ MIDI LEARN» — ручки подсветятся.
2. Щёлкните по ручке или тумблеру — он выделится.
3. Покрутите ручку на контроллере — привязка готова, на ручке появится номер CC.
- Правый щелчок по привязанной ручке в этом режиме снимает привязку; в списке справа — крестик.
- Выйти из режима: «ВЫЙТИ» на плашке над панелью, кнопка в настройках или Esc.
- Привязки сохраняются в проекте. «СОХРАНИТЬ КАК ПРИВЯЗКИ ПО УМОЛЧАНИЮ» — новые копии плагина
  будут сразу с ними (файл midi-map.xml, см. «Где хранятся данные»).
- Контроллер должен приходить на MIDI-дорожку с плагином (в Ableton: вход дорожки — ваш
  контроллер, Monitor — In или Auto с включённой записью). Если тот же контроллер назначен
  в Ableton через MIDI Map (Ctrl+M на Windows, Cmd+M на Mac), Ableton перехватит его раньше
  плагина.
- Привязанный CC управляет только параметром: если привязать CC1 (колесо модуляции) или
  CC64 (сустейн), их обычная функция для этого плагина отключится.
