//
// SUNVOX
// 2.1
//

==============================
ИНСТРУМЕНТЫ РИСОВАНИЯ ПАТТЕРНА
==============================

Начиная с версии 2.1 паттерн можно редактировать при помощи инструментов рисования.
Соответствующее окно открывается через пункт "Рисовать" в меню редактора паттерна.

Доступны следующие инструменты:
  * рисовать кистью в выбранных колонках;
  * рисовать командой Note OFF;
  * рисовать уровни в колонке VV; (после выбора данного инструмента устанавливается рабочая колонка VV, но ее можно изменить на любую другую);
  * рисовать уровни в колонке XXYY; (после выбора данного инструмента устанавливается рабочая колонка XXYY, но ее можно изменить на любую другую);
  * стирать значения в выбранных колонках;
  * стирать значения во всех колонках;
  * проиграть и скопировать в кисть (только выбранные колонки).

Все описанные выше инструменты работают только при активном режиме редактирования паттерна.

УРОВНИ - это графическое представление значений в выбранной колонке трека.
До версии 2.1 в редакторе паттерна был пункт меню "Рисовать уровни XXYY".
Начиная с версии 2.1 эта функция перенесена в окно инструментов рисования паттерна.

КИСТЬ - это кусок паттерна, которым можно рисовать на другом паттерне.
Кисть хранится в экранной музыкальной клавиатуре.
В простейшем случае, кисть - это последний сыгранный на клавиатуре аккорд. Ноты первой строки такой кисти будут подсвечены зеленым цветом на клавиатуре.
Чтобы проиграть/изменить/сохранить/загрузить кисть - увеличьте высоту клавиатуры и нажмите появившуюся слева кнопку "+".

===================
ПАНЕЛИ ИНСТРУМЕНТОВ
===================

Панель инструментов 1 - это основной горизонтальный разделитель с кнопками PLAY, STOP и т.д.
Панель инструментов 2 - это дополнительный горизонтальный разделитель, который находится над таймлинией.
Плавающая панель инструментов - это окно, которое открывается из Главного меню -> Панель инструментов.

Начиная с версии 2.1 эти три панели можно настраивать - добавлять/удалять кнопки.
Для этого зайдите в Главное меню -> Настройки -> Панели.
Каждая панель описывается строкой с названиями кнопок или команд через запятую.
Команды < и > задают направление добавления кнопок: слева-направо или справа-налево.
Допустимые названия:
  * < - переключить направление добавления кнопок: слева-направо (по умолчанию);
  * > - переключить направление добавления кнопок: справа-налево;
  * play;
  * play2 - играть с начала;
  * play3 - играть паттерн;
  * stop;
  * rec - запись;
  * vol - громкость;
  * svol - громкость (короткий вариант);
  * lev - индикатор уровня сигнала;
  * undo;
  * redo;
  * cut;
  * copy;
  * paste;
  * dup - размножить;
  * bpm - BPM;
  * bpmtpl - BPM и TPL;
  * clock - текущее время;
  * cpu - загрузка процессора;
  * cpu2 - загрузка процессора (нажатие открывает список модулей).

//
// SUNVOX
// 2.0
//

==========
УПРАВЛЕНИЕ
==========

В основных окнах SunVox (паттерн, модули, таймлиния) два режима: выделение и навигация.
Левая кнопка мыши = выделение или навигация (в зависимости от режима).
Средняя кнопка мыши = навигация.
По умолчанию на десктопах - выделение.
По умолчанию на мобильных устройствах - навигация.
Если Главное меню -> Настройки -> Интерфейс -> Тип управления = "Пальцами", то SunVox будет работать как на мобильном устройстве.

Что делать, если нужна навигация, но нет средней кнопки мыши?
macOS:
  * CMD + левая кнопка;
  * или установите какое-нибудь приложение для эмуляции средней кнопки, например Middle.
Все системы:
  * на некоторых тачпадах можно эмулировать среднюю кнопку мыши через нажатие тремя пальцами или одновременное нажатие левой и правой кнопок (см. системные настройки тачпада);
  * переключайтесь между режимами редактирования при помощи кнопки с прямоугольником выделения;
  * если такой кнопки нет - раскомментируйте одну из опций show_sel_btn в sunvox_config.ini;

Общие правила для всех устройств:
  * основная рабочая кнопка мыши - левая; нажатие пером или пальцем эквивалентно нажатию левой кнопки мыши;
  * двойной клик в пустой области - создание нового объекта (если возможно);
  * двойной клик на объекте открывает его свойства (если возможно);
  * колесо прокрутки - увеличение или прокрутка вверх-вниз;
  * правая кнопка - меню;
  * SHIFT + левая кнопка = соединение модулей или отключение привязки к сетке таймлинии;
  * CTRL + левая кнопка = режим множественного выделения (предыдущее выделение не очищается);

==========
СУПЕРТРЕКИ
==========

Начиная с SunVox 2.0 таймлиния может работать в двух режимах: классическом (по умолчанию) и режиме супертреков.
В классическом режиме все паттерны имеют внутри независимые наборы треков.
В режиме супертреков паттерны могут дополнять друг друга, если находятся на одном супертреке. Супертрек - это 32 трека, которые могут использоваться несколькими паттернами одновременно.
В режиме супертреков можно активировать опцию "не выключать ноты в конце паттерна": так один короткий паттерн может включить ноты, а другой короткий (где-то далеко на таймлинии, но на том же супертреке) их выключить.
Благодаря супертрекам более корректно грузятся и играют старые трекерные форматы XM и MOD.

=====================
УПАКОВКА В METAMODULE
=====================

Выделенные модули можно упаковать в один MetaModule (см. меню редактора модулей).
При этом модули должны соответствовать следующей топологии: TT -> SEL( IN -> ... ) -> R
TT - источники сигнала (опциональные) вне выделения;
SEL() - выделенные модули, которые будут упакованы в MetaModule;
IN - принимающий модуль (опциональный) внутри выделения; может быть только один;
... - любые модули внутри выделения;
R - приемник (опциональный), принимающий сигналы от модулей внутри выделения; может быть только один.

================================
ГОРЯЧИЕ КЛАВИШИ ДИАЛОГОВОГО ОКНА
================================

Y или ENTER = первая кнопка слева;
N = последняя кнопка справа;
ESC = отмена;
1...9 = кнопки слева направо;
