Syntaxe MIDI

OnSong používá syntaxi založenou na textu pro vyjádření příkazů MIDI. Zatímco můžete použít Události MIDI v Editoru metadat, můžete také vyjádřit příkazy MIDI v textu.

Oddělené hodnoty

V první řadě lze více příkazů MIDI oddělit různými znaky, včetně: znaku tabulátoru, čárky, středníku, svislé čáry nebo nového řádku. Čárka je nejčastěji používaný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 odeslán. Protože kanály v MIDI začínají na nule, první kanál by byl nula (0), druhý kanál jedničkou (1) atd.

Pokud se nepoužívá symbol @, příkaz se odesí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á odeslat. Patří sem:

• PC nebo Bez předpony je událost změny programu.
• N je poznámková událost
• CC je událost změny ovládání.
• SS je událost výběru skladby.
• START je příkaz spuštění.
• STOP je příkaz zastavení.
• CONTINUE je příkaz pokračování.
• F0 předchází zprávu SysEx.

Hodnoty

Hodnota příkazu se zobrazuje těsně před symbolem @ nebo na konci položky, pokud není @ zadáno. Jedná se o hodnotu změny programu, změny ovládání, poznámky nebo výběru skladby na základě předpony. V případě položek SysEx se hexadecimální hodnota SysEx poskytuje přímo po předponě F0, která slouží jako záhlaví pro všechny příkazy SysEx.

Podhodnocení

V některých případech jsou v příkazu MIDI vyjádřeny další informace jako podhodnocení. Například MSB a LSB a také rychlost ovládacích hodnot lze tímto způsobem odeslat. Vyjadřuje se to přidáním dvojtečky do části hodnoty. Podhodnocení má odlišný kontext v závislosti na typu odeslaného příkazu MIDI:

• Změna programu má podhodnocení zarovnané s MSB/LSB změny programu. Tyto hodnoty jsou odděleny tečkou s MSB vlevo a LSB vpravo.
• Změna ovládání má hodnotu ovládacího prvku nastavenou pomocí tohoto. Číslo může být mezi 0 a 127. Pokud je vynecháno, předpokládá se hodnota 127.
• Událost poznámky má podhodnocení související s rychlostí, kterou má být poznámka přehrána. Lze jej nastavit na číselnou hodnotu mezi 0 a 127.

Příklady

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

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

Změny ovládání jsou podobné s tím rozdílem, že levá strana syntaxe je číslo změny ovládání a pravá strana je volitelná hodnota. Pokud hodnota není poskytuta, je místo toho odeslána hodnota 127. Odešleme řídící změnu 106 s hodnotou 64 na kanálu 3.

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

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

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

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