Синтаксис 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 — событие изменения управления.
• SS — событие выбора песни.
• START — команда запуска.
• STOP — команда остановки.
• CONTINUE — команда продолжения.
• F0 предваряет сообщение SysEx.

Значения

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

Подзначения

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

• Смена программы имеет подзначения, совпадающие с MSB/LSB смены программы. Эти значения разделены точкой с MSB слева и LSB справа.
• Изменение управления содержит значение элемента управления, для которого оно используется. Число может быть от 0 до 127. Если опущено, предполагается значение 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% на всех каналах.