MIDI szintaxis

Az OnSong szöveges szintaxist használ a MIDI parancsok kifejezésére. Bár használhatod az MIDI Események szerkesztőt a Metaadatok szerkesztőben, közvetlenül szövegben is kifejezhetsz MIDI parancsokat.

Határolójelek

Mindenekelőtt több MIDI parancs elválasztható különböző karakterekkel, mint például: tabulátor karakter, vessző, pontosvessző, függőleges vonal vagy új sor. A vessző a leggyakoribb elválasztó. Például:

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

Csatorna

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

Ha nem használsz @ szimbólumot, a parancs az összes csatornára kerül elküldésre vagy fogadásra.

Előtagok

A lista minden bejegyzése tartalmaz egy előtagot. Ez az előtag határozza meg, milyen típusú MIDI parancsot kell küldeni. Ezek a következőket tartalmazzák:

• PC vagy Nincs előtag egy programváltási esemény.
• N egy nótaesemény.
• CC egy vezérlőváltási esemény.
• SS egy dalválasztási esemény.
• START egy kezdési parancs.
• STOP egy leállítási parancs.
• CONTINUE egy folytatási parancs.
• F0 egy SysEx üzenetet vezet be.

Értékek

A parancs értéke közvetlenül az @ szimbólum előtt vagy a bejegyzés végén jelenik meg, ha nincs @ megadva. Ez a programváltás, vezérlőváltás, nóta vagy dalválasztás értéke az előtag alapján. SysEx bejegyzések esetén a SysEx hexadecimális értéke közvetlenül az F0 előtag után van megadva, amely az összes SysEx parancs fejléceként szolgál.

Alértékek

Néhány esetben további információ van közvetítve a MIDI parancsban alértékekként. Például az MSB és az LSB, valamint a vezérlőértékek sebessége is ily módon küldhető. Ez a két pont hozzáadásával fejeződik ki az érték részben. Az alérték más kontextussal rendelkezik a küldött MIDI parancs típusától függően:

• Programváltás olyan alértékekkel rendelkezik, amelyek a programváltás MSB/LSB-jével vannak összehangolva. Ezeket az értékeket pont választja el, az MSB a bal oldalon és az LSB a jobb oldalon.
• Vezérlőváltás ennek a vezérlő értékét használja. A szám 0 és 127 között lehet. Ha nincs megadva, a 127 értéke értelmezett.
• Nótaesemény a sebességhez kapcsolódó alértékkel rendelkezik, amellyel a nótát játszani kell. Ez 0 és 127 közötti numerikus értékre állítható.

Példák

Kezdjünk egy egyszerű programváltással. Ebben a forgatókönyvben a 8. programváltást használjuk, amely az 1. csatornán 4-es MSB-t és 2-es LSB-t is küld. A példa a legbonyolultabb variációval kezdődik, és eltávolítja a bankválasztást és csatornát, hogy tágabb legyen:

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

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

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

Most nézzük meg a nótaeseményeket. A C4-et a 8. csatornán 75%-os sebességgel szeretnénk játszani, a következőt kellene beírnunk, mivel az OnSong a MIDI C0-t 0-ként számolja a MIDI nótaskálán:

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

Ismét fontos megjegyezni, hogy ahogy az értékek eltávolításra kerülnek a MIDI szintaxisból, a MIDI nyilatkozat tágabb és kevésbé specifikus lesz. Például a nótaesemény utolsó verziója a C4-et 100%-os sebességgel az összes csatornán játssza le.