Syntaxe MIDI

OnSong používá textovou syntaxi pro vyjádření příkazů MIDI. Zatímco můžete použít MIDI Events v editoru metadat, můžete také vyjádřit příkazy MIDI v textu.

Oddělené hodnoty

Především lze více příkazů MIDI oddělit různými znaky včetně: znaku tabulátoru, čárky, středníku, svislého pruhu nebo nového řádku. Čárka je nejčastějším oddělovačem. Například:

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

Kanál

Každá položka může obsahovat symbol @. Číselná hodnota za symbolem je kanál, na kterém má být příkaz poslán. Jelikož kanály v MIDI začínají na nule, kanál jeden by byl nula (0), kanál dva jedna (1) atd.

Pokud se nepoužívá symbol @, příkaz se posílá nebo přijímá na všech kanálech.

Předpony

Každá položka v seznamu obsahuje předponu. Tato předpona určuje, jaký typ příkazu MIDI se má poslat. Patří sem:

• PC nebo bez předpony je událost změny programu.
• N je událost noty
• CC je událost změny řízení.
• SS je událost výběru písně.
• START je příkaz spuštění.
• STOP je příkaz zastavení.
• CONTINUE je příkaz pokračování.
• WAIT čeká určitou dobu před odesláním dalších gebeurteností.
• F0 předchází zprávu SysEx.
• @ předchází globální značku MIDI.

Hodnoty

Hodnota příkazu se zobrazuje těsně před symbolem @ nebo na konci položky, pokud není @ uvedeno. To je hodnota změny programu, změny řízení, noty nebo výběru písně na základě předpony. V případě položek SysEx se hexadecimální hodnota SysEx poskytuje přímo po předponě F0, která se používá jako hlavička všech příkazů SysEx.

Podhodnotiny

V některých případech jsou v příkazu MIDI přenášeny další informace jako podhodnotiny. Například MSB a LSB, stejně jako rychlost hodnot řízení lze posílat tímto způsobem. To se vyjadřuje přidáním dvojtečky do části hodnoty. Podhodnotina má různý kontext v závislosti na typu odeslaného příkazu MIDI:

• Změna programu má podhodnotiny zarovnané s MSB/LSB změny programu. Tyto hodnoty jsou odděleny tečkou s MSB vlevo a LSB vpravo.
• Změna řízení má hodnotu sady řízení pomocí toho. Číslo může být mezi 0 a 127. Pokud je vynecháno, je odvozena hodnota 127. Můžete také oddělit více hodnot pomlčkou, abyste procházeli hodnoty. Například 127-0 bude uzamykovat hodnotu 127 mezi stavy zapnuto a vypnuto.
• Událost noty má podhodnotinu související s rychlostí, kterou by měla být nota přehrána. To lze nastavit na číselnou hodnotu mezi 0 a 127. Více rychlostí not můžete procházet oddělením je pomlčkou.

Příklady

Začneme jednoduchou změnou programu. V tomto scénáři používáme změnu programu 8, která také posílá MSB 4 a LSB 2 na kanálu 1. Příklad začíná nejsložitější variací a odstraňuje výběr banky a kanálu, aby se stal širší:

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

Změny řízení jsou podobné s tím rozdílem, že levá strana syntaxe je číslo změny řízení a pravá strana je volitelná hodnota. Pokud hodnota není uvedena, je místo toho odeslána hodnota 127. Budeme posílat změnu řízení 106 s hodnotou 64 na kanálu 3.

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

Nyní se podívejme na události not. Chceme přehrát C4 na kanálu 8 při rychlosti 75 %, zadali bychom následující, protože OnSong začíná počítat MIDI C0 jako 0 na stupnici not MIDI:

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

Opět je důležité si pamatovat, že jak se hodnoty odstraňují z syntaxe MIDI, příkaz MIDI se stává širší a méně specifický. Například poslední verze události noty bude přehrávat C4 na 100 % rychlosti na všech kanálech.

Můžeme také zpomalit MIDI přidáním příkazu WAIT. Následující bude zpozďovat MIDI o 2 sekundy a také 500 ms (půl sekundy). Můžete zadat sekundy od 1-10 sekund nebo v milisekundách.

WAIT2, WAIT500

Nakonec můžeme odkazovat na globály MIDI, což jsou předkonfigurované seznamy událostí MIDI, na které lze odkazovat. Pokud máte globál MIDI se značkou "on" (bez uvozovek), můžete na tento globál odkazovat následovně:

@on