MIDI szintaxis

A OnSong egy szövegalapú szintaxist használ a MIDI-parancsok kifejezéséhez. Míg a MIDI-események a Metaadat-szerkesztőben használhatók, közvetlenül szövegben is kifejezhet MIDI-parancsokat.

Elhatárolt értékek

Mindenekelőtt több MIDI-parancs különféle karakterekkel választható el: tabulátor karakter, vessző, pontosvessző, függőleges vonal vagy új sor. A vessző a leggyakoribb elhatárolókarakter. Például:

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

Csatorna

Minden bejegyzés tartalmazhat egy @ szimbólumot. A szimbólum után lévő numerikus érték az a csatorna, amelyre a parancsot el kell küldeni. Mivel a MIDI-csatornák nulláról kezdődnek, az első csatorna nulla (0), a második csatorna egy (1) stb. lenne.

Ha nincs @ szimbólum használva, a parancsot az összes csatornán elküldjük vagy fogjuk.

Előtagok

A lista minden bejegyzése tartalmaz egy előtagot. Ez az előtag határozza meg, hogy milyen típusú MIDI-parancsot kell küldeni. Ezek az alábbiak:

• PC vagy nincs előtag egy programváltási esemény.
• N egy jegyzetesemény
• CC egy vezérlésváltozás esemény.
• SS egy dal kiválasztási esemény.
• START egy indítási parancs.
• STOP egy leállítási parancs.
• CONTINUE egy folytatási parancs.
• WAIT egy adott ideig vár, mielőtt további eseményeket küldene.
• F0 egy SysEx-üzenet előtagja.
• @ egy MIDI globális címke előtagja.

Értékek

A parancs értéke közvetlenül az @ szimbólum előtt jelenik meg, vagy a bejegyzés végén, ha nem adunk meg @-ot. Ez a programváltás, vezérlésváltozás, jegyzet vagy dal kiválasztás értéke az előtag alapján. SysEx-bejegyzések esetében a SysEx hexadecimális értéke közvetlenül az F0 előtag után jelenik meg, amely az összes SysEx-parancs fejléceként szolgál.

Alértékek

Bizonyos esetekben további információk kerülnek közvetítésre a MIDI-parancsban alértékekként. Például az MSB és LSB, valamint a vezérlési értékek sebessége ily módon küldhető. Ezt a kolon hozzáadásával fejezzük ki az érték részben. Az alérték különféle kontextussal rendelkezik az elküldött MIDI-parancs típusától függően:

• A programváltásnak vannak olyan alértékei, amelyek a programváltás MSB/LSB értékeivel igazodnak. Ezek az értékek ponttal vannak elválasztva, az MSB balra, az LSB jobbra.
• A vezérlésváltozásnak a vele beállított vezérlési érték van. A szám 0 és 127 között lehet. Ha nincs megadva, a 127 érték kerül alkalmazásra. Több értéket kötőjellel is elválaszthat az értékek közötti léptetéshez. Például a 127-0 a 127 érték lezárásához a ki és be állapotok között.
• A jegyzetesemény alértéke a kapcsolódik a sebességhez, amellyel a hangjegyet játszani kell. Ezt 0 és 127 közötti numerikus értékre állíthatja. Több jegyzet sebességét kötőjellel elválasztva lehet léptetni.

Példák

Kezdjük egy egyszerű programváltással. Ebben a forgatókönyvben a 8. programváltást használjuk, amely az MSB 4-et és az LSB 2-t is elküldi az 1. csatornán. A példa a legbonyolultabb változattal kezdődik, majd eltávolítja a bankválasztást és a csatornát, hogy szélesebb körűvé váljon:

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

A vezérlésváltozások hasonlóak, azzal a különbséggel, hogy a szintaxis bal oldala a vezérlésváltozás száma, a jobb oldala pedig egy opcionális érték. Ha az érték nincs megadva, a 127 kerül elküldésre. A 106. vezérlésváltozást 64-es értékkel fogjuk elküldeni a 3. csatornán.

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

Most nézzük meg a jegyzet eseményeket. Szeretnénk a C4-et az 5. csatornán 75%-os sebességgel játszani, az alábbiak közül választunk, mert a OnSong a MIDI C0-t 0-nak számítja a MIDI-jegyzet skálán:

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

Ismét fontos megjegyezni, hogy ahogy az értékeket eltávolítjuk a MIDI-szintaxisból, a MIDI-utasítás tágabb és kevésbé specifikus lesz. Például a jegyzet esemény utolsó verziója a C4-et 100%-os sebességgel az összes csatornán küldi el.

A MIDI-t késleltethetjük egy WAIT parancs hozzáadásával. Az alábbiak 2 másodpercet, valamint 500 ms-ot (fél másodpercet) késleltetnek a MIDI-t. Másodpercekben 1-10 másodperc vagy ezredmásodpercben megadhatja az időt.

WAIT2, WAIT500

Végül hivatkozhatunk MIDI globális értékekre, amelyek előre konfigurált MIDI-eseménylista. Ha van egy "on" címkével ellátott MIDI globális (idézőjelek nélkül), akkor ezt a globális értéket az alábbival lehet hivatkozni:

@on