Синтаксис 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. Ми відправимо Control Change 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% на всіх каналах.