MIDI-syntaksi

OnSong käyttää tekstipohjaisesti määritettyä syntaksia MIDI-komentojen ilmaisemiseen. Vaikka voit käyttää MIDI-tapahtumia Metatieto-editorissa, voit myös ilmaista MIDI-komentoja tekstissä.

Erotetut arvot

Ensinnäkin useita MIDI-komentoja voidaan erottaa useilla eri merkeillä, kuten: välilehden merkki, pilkku, puolipiste, pystyviiva tai rivinvaihto. Pilkku on yleisin erottelija. Esimerkiksi:

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

Kanava

Jokainen merkintä voi sisältää @ -symbolin. Symbolin jälkeisen numeerisen arvon kanava on kanava, johon komento lähetetään. Koska MIDI:n kanavat alkavat nollasta, kanava yksi olisi nolla (0), kanava kaksi yksi (1) jne.

Jos @ -symbolia ei käytetä, komento lähetetään tai vastaanotetaan kaikilla kanavilla.

Etuliitteet

Jokainen listan merkintä sisältää etuliitteen. Tämä etuliite määrittää, minkä tyyppisen MIDI-komennon lähettää. Nämä sisältävät:

• PC tai Ei etuliitettä on ohjelman muutostapahtumaLähdettä.
• N on nuottitapahtuma
• CC on ohjausmuutostapahtumaLähdettä.
• NRPN on rekisteröimätön parametrinumero.
• SS on kappaleen valintatapahtumaLähdettä.
• START on käynnistyskomento.
• STOP on pysäytyskomento.
• CONTINUE on jatkokomento.
• WAIT odottaa tietyn ajan ennen muiden tapahtumien lähettämistä.
• F0 etuliittelee SysEx-viestin.
• @ etuliittelee MIDI-yleisen tunnisteen.

Arvot

Komennon arvo näkyy juuri ennen @ -symbolia tai merkinnän lopussa, jos @ ei ole annettu. Tämä on ohjelman muutoksen, ohjausmuutoksen, nuotin tai kappaleen valinnan arvo etuliitteen perusteella. SysEx-merkintöjen tapauksessa SysExin heksadesimaaliarvo annetaan suoraan F0-etuliitteen jälkeen, jota käytetään kaikkien SysEx-komentojen otsikkona.

Aliarvot

Joissakin tapauksissa lisätietoja välitetään MIDI-komennossa aliarvoina. Esimerkiksi MSB ja LSB sekä ohjausarvojen nopeus voidaan lähettää tällä tavalla. Tämä ilmaistaan lisäämällä kaksoispiste arvo-osaan. Aliarvolla on eri konteksti riippuen lähetetyn MIDI-komennon tyypistä:

• Ohjelman muutos sisältää aliarivot, jotka vastaavat ohjelman muutoksen MSB/LSB-arvoja. Nämä arvot erotellaan pisteellä, MSB vasemmalla ja LSB oikealla.
• Ohjausmuutos sisältää ohjausarvon arvon. Numero voi olla välillä 0–127. Jos jätetään pois, arvo 127 päätellään. Voit myös erottaa useita arvoja viivalla askeleiden välillä. Esimerkiksi 127-0 lukitsee arvon 127 päälle ja pois päältä.
• Nuottitapahtuma sisältää aliarvon, joka liittyy nopeuteen, jolla nuottia tulee soittaa. Tämä voidaan asettaa numeeriseen arvoon välillä 0–127. Voit siirtyä useisiin nuottien nopeuksiin erottamalla ne viivalla.

Esimerkit

Aloitetaan yksinkertaisella ohjelman muutoksella. Tässä skenaariossa käytämme ohjelman muutosta 8, joka lähettää myös MSB:n 4 ja LSB:n 2 kanavalla 1. Esimerkki alkaa tämän monimutkaisimmasta muunnelmasta ja poistaa pankkivalinnan ja kanavan laajemmaksi:

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

Ohjausmuutokset ovat samanlaisia paitsi että syntaksin vasen puoli on ohjausmuutoksen numero ja oikea puoli on valinnainen arvo. Jos arvoa ei anneta, 127 lähetetään sen sijaan. Lähettävät ohjausmuutos 106 arvolla 64 kanavalla 3.

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

Katsotaan nyt nuottitapahtumia. Haluamme soittaa C4:ää kanavalla 8 75 prosentin nopeudella, syötämme seuraavaa, koska OnSong alkaa laskea MIDI C0:ta 0:na MIDI-asteikolla:

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

Jälleen on tärkeää muistaa, että kun arvot poistetaan MIDI-syntaksista, MIDI-lauseke tulee laajemmaksi ja vähemmän spesifiksi. Esimerkiksi nuottitapahtuman viimeinen versio soittaa C4:ää 100 prosentin nopeudella kaikilla kanavilla.

Voimme myös viivästyttää MIDI:tä lisäämällä WAIT-komennon. Seuraava viivästyttää MIDI:tä 2 sekuntia sekä 500 ms (puoli sekuntia). Voit määrittää sekunteja 1–10 sekunnissa tai millisekunneissa.

WAIT2, WAIT500

Viimeksi voimme viitata MIDI-globaaleihin, jotka ovat esikonfiguroituja MIDI-tapahtumien luetteloja, joihin voidaan viitata. Jos sinulla on MIDI-globaali, jossa tunniste on "on" (ilman lainausmerkkejä), voit viitata tähän globaaliin seuraavalla:

@on