Uživatelská příručka

Syntaxe MIDI

OnSong používá textovou syntaxi pro vyjadřování MIDI příkazů. Přestože můžete používat MIDI Events v Metadata Editor, můžete také vyjádřit MIDI příkazy v textu.

Oddělené hodnoty

V první řadě je důležité, že více MIDI příkazů lze oddělit různými znaky včetně: tabelá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 se má příkaz odeslat. Protože kanály v MIDI začínají na nule, kanál jeden by byl nula (0), kanál dva jedná (1) atd.

Pokud se nepoužívá symbol @, je příkaz odeslán nebo přijat na všech kanálech.

Předpony

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

PC nebo Bez předpony je událost změny programu.
N je událost noty
CC je událost změny ovládacího prvku.
NRPN je číslo nešifrovaného parametru.
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í.
WAIT čeká určitou dobu před odesláním dalších událostí.
F0 předchází zprávu SysEx.
@ předchází globální značce MIDI.

Hodnoty

Hodnota příkazu se zobrazuje těsně před symbolem @ nebo na konci položky, pokud není @ uvedeno. Toto je hodnota změny programu, změny ovládacího prvku, noty nebo výběru skladby na základě předpony. V případě položek SysEx je hexadecimální hodnota SysEx poskytnuta přímo za předponou F0, která se používá jako záhlaví všech příkazů SysEx.

Podhodnoty

V některých případech jsou v příkazu MIDI předávány další informace jako podhodnoty. Například MSB a LSB, stejně jako rychlost kontrolních hodnot lze tímto způsobem odeslat. Vyjadřuje se to přidáním dvojtečky v části hodnoty. Podhodnota má různý kontext v závislosti na typu odeslaného příkazu MIDI:

Změna programu má podhodnoty zarovnané s MSB/LSB změny programu. Tyto hodnoty jsou odděleny tečkou s MSB vlevo a LSB vpravo.
Změna ovládacího prvku má hodnotu ovládacího prvku nastavenou pomocí této. Čí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 hodnotami. Například 127-0 zamkne hodnotu 127 mezi stavy zapnuto a vypnuto.
Událost noty má podhodnotu související s rychlostí, jakou by měla být nota přehrána. Lze ji nastavit na číselnou hodnotu mezi 0 a 127. Můžete procházet více rychlostmi not tak, že je oddělíte pomlčkou.

Příklady

Začněme 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álu 1. Příklad začíná nejsložitější variantou a odstraňuje výběr banky a kanál, aby se stal širší:

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

Změny ovládacích prvků jsou podobné, až na to, že levá strana syntaxe je číslo změny ovládacího prvku a pravá strana je volitelná hodnota. Pokud hodnota není poskytnuta, místo toho se odešle 127. Odešleme ovládací prvek Změna 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 s rychlostí 75%, zadali bychom následující, protože OnSong začíná počítání MIDI C0 jako 0 na MIDI stupnici not:

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

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

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

WAIT2, WAIT500

Nakonec můžeme odkazovat na globální MIDI, což jsou přednastavené seznamy MIDI událostí, které lze odkazovat. Pokud máte globální MIDI se značkou „on" (bez uvozovek), pak můžete odkazovat na tuto globální položku takto:

@on

OnSong 2023 — Poslední aktualizace: March 11, 2020