Felhasználói kézikönyv

MIDI szintaxis

Az OnSong szöveges szintaxist használ a MIDI-parancsok kifejezésére. Míg a MIDI-események a Metaadatok szerkesztőben használhatók, a MIDI-parancsokat szövegben is kifejezhet.

Elválasztott értékek

Mindenekelőtt több MIDI-parancs különféle karakterekkel választható el: tabulátor karakter, vessző, pontosvessző, függőleges cső 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 egy @ szimbólumot. A szimbólum után álló numerikus érték az a csatorna, amelyen a parancsot küldeni kell. Mivel a MIDI-csatornák nulláról kezdődnek, az első csatorna nulla (0), a második csatorna egy (1) lenne, stb.

Ha nincs @ szimbólum, a parancs az összes csatornán elküldhető vagy fogadható.

Előtagok

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

PC vagy nincs előtag egy programváltási esemény.
N egy nótaesemény
CC egy vezérlőváltozási esemény.
NRPN egy nem regisztrált paraméteszám.
SS egy dal kiválasztási eseménye.
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-üzenetet előz meg.
@ egy MIDI globális címkét előz meg.

Értékek

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

Alértékek

Néhány esetben további információk közvetítésre kerülnek a MIDI-parancsban alértékekként. Például az MSB és az LSB, valamint a vezérlőértékek sebessége ilyen módon küldhető. Ezt a kettőspont hozzáadásával fejezzük ki az érték részben. Az alérték különböző kontextusban van, attól függően, hogy milyen típusú MIDI-parancsot küldtek:

Programváltás olyan alértékeket tartalmaz, amelyek a programváltás MSB/LSB-jéhez igazodnak. Ezeket az értékeket egy ponttal választják el, az MSB a bal oldalon és az LSB a jobb oldalon.
Vezérlőváltozás a vezérléshez beállított érték. A szám 0 és 127 között lehet. Ha nincs megadva, a 127 érték feltételezésre kerül. Több értéket kötőjellel is választhat el az értékek között. Például a 127-0 a 127 értéket rögzíti a be- és kikapcsolt állapotok között.
Nótaesemény egy alértékkel rendelkezik, amely a nóta lejátszandó sebességére vonatkozik. Ez 0 és 127 közötti numerikus értékre állítható. Több nótasebességen keresztül léphet kötőjellel elválasztva.

Példák

Kezdjük egy egyszerű programváltással. Ebben az esetben 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ót é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őváltozások hasonlóak, azzal a különbséggel, hogy a szintaxis bal oldala a vezérlőváltozás száma, a jobb oldala pedig egy opcionális érték. Ha az érték nincs megadva, helyette a 127 érték kerül elküldésre. Az 106-os vezérlőváltozást 64 értékkel küldünk a 3. csatornán.

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

Most nézzük meg a nótaesemények. Ha a C4-et az 8. csatornán 75% sebességgel szeretnénk játszani, a következőt kell megadnunk, mivel az OnSong a MIDI C0-t a MIDI nótaskála 0-ára kezdi:

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-utasítás szélesebb körűvé és kevésbé specifikusvá válik. Például a nótaesemény utolsó verziója a C4-et 100% sebességgel az összes csatornán küldi el.

A MIDI-t késleltethetjük a WAIT parancs hozzáadásával. Az alábbiak 2 másodperccel és 500 ms-mal (fél másodperccel) késleltetik a MIDI-t. A másodperceket 1-10 másodpercként vagy ezredmásodpercben adhatja meg.

WAIT2, WAIT500

Végül hivatkozhatunk MIDI-globálisokra, amelyek előkonfigurált MIDI-eseménylista. Ha van egy MIDI-globálisa az „on" címkével (idézőjelek nélkül), akkor ezt a globálist az alábbival hivatkozhatja meg:

@on

OnSong 2026 — Utolsó frissítés: March 11, 2020