Składnia MIDI

OnSong używa składni tekstowej do wyrażania poleceń MIDI. Chociaż możesz używać Zdarzeń MIDI w Edytorze Metadanych, możesz również wyrażać polecenia MIDI w tekście.

Wartości Rozdzielone

Przede wszystkim, wiele poleceń MIDI można oddzielić różnymi znakami, w tym: znakiem tabulacji, przecinkiem, średnikiem, pionową linią lub nową linią. Przecinek jest najczęściej stosowanym ogranicznikiem. Na przykład:

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

Kanał

Każdy wpis może zawierać symbol @. Wartość liczbowa po symbolu to kanał, na którym ma być wysłane polecenie. Ponieważ kanały w MIDI zaczynają się od zera, kanał jeden byłby zerem (0), kanał drugi jedynką (1) itd.

Jeśli symbol @ nie jest używany, polecenie jest wysyłane lub odbierane na wszystkich kanałach.

Prefiksy

Każdy wpis na liście zawiera prefiks. Ten prefiks określa typ polecenia MIDI do wysłania. Obejmują one:

• PC lub Bez Prefiksu to zdarzenie zmiany programu.
• N to zdarzenie nutowe
• CC to zdarzenie zmiany kontroli.
• SS to zdarzenie wyboru piosenki.
• START to polecenie rozpoczęcia.
• STOP to polecenie zatrzymania.
• CONTINUE to polecenie kontynuacji.
• F0 poprzedza wiadomość SysEx.

Wartości

Wartość polecenia pojawia się tuż przed symbolem @ lub na koniec wpisu, jeśli @ nie jest podane. To jest wartość zmiany programu, zmiany kontroli, nuty lub wyboru piosenki na podstawie prefiksu. W przypadku wpisów SysEx wartość szesnastkowa SysEx jest podawana bezpośrednio po prefiksie F0, który służy jako nagłówek wszystkich poleceń SysEx.

Podwartości

W niektórych przypadkach w poleceniu MIDI są przekazywane dodatkowe informacje jako podwartości. Na przykład MSB i LSB, a także prędkość wartości kontroli można wysłać w ten sposób. Wyrażane jest to poprzez dodanie dwukropka w części wartości. Podwartość ma inny kontekst w zależności od typu wysyłanego polecenia MIDI:

• Zmiana Programu ma podwartości wyrównane z MSB/LSB zmiany programu. Te wartości są oddzielone okresem, przy czym MSB jest po lewej, a LSB po prawej.
• Zmiana Kontroli ma wartość ustawionej kontroli. Liczba może wynosić od 0 do 127. Jeśli zostanie pominięta, przyjmowana jest wartość 127.
• Zdarzenie Nutowe ma podwartość odnoszącą się do prędkości, z jaką nuta powinna być odtwarzana. Można to ustawić na wartość liczbową od 0 do 127.

Przykłady

Zacznijmy od prostej zmiany programu. W tym scenariuszu używamy zmiany programu 8, która również wysyła MSB równy 4 i LSB równy 2 na kanale 1. Przykład zaczyna się od najbardziej złożonej odmiany tego i usuwa wybór banku i kanał, aby stać się bardziej ogólny:

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

Zmiany kontroli są podobne, z wyjątkiem tego, że lewa strona składni to numer zmiany kontroli, a prawa strona to opcjonalna wartość. Jeśli wartość nie jest podana, zamiast niej wysyłana jest wartość 127. Wyślemy Zmianę Kontroli 106 z wartością 64 na kanale 3.

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

Teraz przyjrzyjmy się zdarzeniom nutowym. Chcemy odtwarzać C4 na kanale 8 z prędkością 75%, wprowadzilibyśmy następujące, ponieważ OnSong zaczyna liczyć MIDI C0 jako 0 w skali nut MIDI:

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

Ponownie, ważne jest pamiętanie, że w miarę usuwania wartości ze składni MIDI, instrukcja MIDI staje się bardziej ogólna i mniej specyficzna. Na przykład ostatnia wersja zdarzenia nutowego będzie odtwarzać C4 ze 100% prędkością na wszystkich kanałach.