Синтаксис MIDI

OnSong использует текстовый синтаксис для выражения команд MIDI. Хотя вы можете использовать События MIDI в Редакторе метаданных, вы также можете выражать команды MIDI в тексте.

Разделённые значения

Прежде всего, несколько команд MIDI можно разделить различными символами, включая: символ табуляции, запятую, точку с запятой, вертикальную черту или новую строку. Запятая — самый распространённый разделитель. Например:

1.2:0@0, PC1.2:3@0, N67@1, START, SS8

Канал

Каждая запись может содержать символ @. Числовое значение после символа — это канал, на котором должна быть отправлена команда. Поскольку каналы в MIDI начинаются с нуля, первый канал будет нулевым (0), второй канал — единицей (1) и так далее.

Если символ @ не используется, команда отправляется или получается на всех каналах.

Префиксы

Каждая запись в списке содержит префикс. Этот префикс определяет тип отправляемой команды MIDI. К ним относятся:

• PC или без префикса — событие смены программы.
• N — событие ноты.
• CC — событие изменения контроллера.
• NRPN — номер незарегистрированного параметра.
• SS — событие выбора песни.
• START — команда запуска.
• STOP — команда остановки.
• CONTINUE — команда продолжения.
• WAIT — ожидание определённого времени перед отправкой дополнительных событий.
• F0 — префикс сообщения SysEx.
• @ — префикс глобального тега MIDI.

Значения

Значение команды появляется непосредственно перед символом @ или в конце записи, если @ не указан. Это значение смены программы, изменения контроллера, ноты или выбора песни в зависимости от префикса. В случае записей SysEx шестнадцатеричное значение SysEx предоставляется непосредственно после префикса F0, который используется как заголовок для всех команд SysEx.

Подзначения

В некоторых случаях дополнительная информация передаётся в команде MIDI как подзначения. Например, MSB и LSB, а также скорость значений контроля можно отправить таким образом. Это выражается добавлением двоеточия в часть значения. Подзначение имеет разный контекст в зависимости от типа отправляемой команды MIDI:

• Смена программы имеет подзначения, соответствующие MSB/LSB смены программы. Эти значения разделены точкой с MSB слева и LSB справа.
• Изменение контроллера имеет значение установленного контроля. Число может быть от 0 до 127. Если не указано, используется значение 127. Вы также можете разделить несколько значений дефисом для перемещения по значениям. Например, 127-0 зафиксирует значение 127 между включённым и выключённым состояниями.
• Событие ноты имеет подзначение, связанное со скоростью воспроизведения ноты. Это может быть установлено на числовое значение между 0 и 127. Вы можете перемещаться по несколько скоростям ноты, разделяя их дефисом.

Примеры

Начнём с простой смены программы. В этом сценарии мы используем смену программы 8, которая также отправляет MSB 4 и LSB 2 на канал 1. Пример начинается с самого сложного варианта и убирает выбор банка и канала, чтобы стать более общим:

PC3.1:7@0, 3.1:7@0, 3:7@0, 3:7, 7@0, 7

Изменения контроллера похожи, за исключением того, что левая сторона синтаксиса — номер изменения контроллера, а правая сторона — необязательное значение. Если значение не указано, вместо этого отправляется 127. Мы отправим изменение контроллера 106 со значением 64 на канал 3.

CC105:63@2, CC105:63. CC105@2, CC105

Теперь посмотрим на события нот. Мы хотим воспроизвести C4 на канале 8 с 75% скоростью, мы введём следующее, потому что OnSong начинает отсчёт MIDI C0 с 0 на шкале нот MIDI:

N60:95@7, N60@7, N60:95, N60

Опять же, важно помнить, что по мере удаления значений из синтаксиса MIDI оператор MIDI становится более общим и менее конкретным. Например, последняя версия события ноты отправит C4 со скоростью 100% на всех каналах.

Мы также можем задержать MIDI, добавив команду WAIT. Следующие команды задержат MIDI на 2 секунды, а также на 500 мс (полсекунды). Вы можете указать время в секундах от 1 до 10 или в миллисекундах.

WAIT2, WAIT500

Наконец, мы можем ссылаться на глобальные переменные MIDI, которые являются предконфигурированными списками событий MIDI, на которые можно ссылаться. Если у вас есть глобальная переменная MIDI с тегом «on» (без кавычек), вы можете ссылаться на эту глобальную переменную следующим образом:

@on