MIDI-syntaksi

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

Erotellut arvot

Ensinnäkin useita MIDI-komentoja voidaan erottaa eri merkeillä, kuten: sarkaimella, pilkulla, puolipisteellä, pystyviivalla tai rivinvaihdolla. Pilkku on yleisin erotin. Esimerkiksi:

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

Kanava

Jokainen merkintä voi sisältää @ -symbolin. Symbolin jälkeinen numeerinen arvo on kanava, jolla komento lähetetään. Koska MIDI-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ää, millainen MIDI-komento lähetetään. Näihin kuuluvat:

• PC tai ei etuliitettä on ohjelman vaihto -tapahtuma.
• N on nuotti-tapahtuma
• CC on ohjauksen muutos -tapahtuma.
• SS on kappaleen valinta -tapahtuma.
• START on aloituskomento.
• STOP on pysäytyskomento.
• CONTINUE on jatkokomento.
• F0 on SysEx-viestin etuliite.

Arvot

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

Aliarvot

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

• Ohjelman vaihto -arvolla on aliarvoja, jotka kohdistuvat ohjelman vaihdon MSB/LSB-arvoihin. Nämä arvot erotetaan pisteellä, jolloin MSB on vasemmalla ja LSB oikealla.
• Ohjauksen muutos -arvolla on ohjauksen arvo, joka asetetaan käyttämällä tätä. Luku voi olla välillä 0–127. Jos se jätetään pois, arvo 127 oletetaan.
• Nuotti-tapahtuma -arvolla on aliaarvo, joka liittyy nopeuteen, jolla nuotti tulee soida. Tämä voidaan asettaa numeeriseksi arvoksi välillä 0–127.

Esimerkit

Aloitetaan yksinkertaisella ohjelman vaihdolla. Tässä skenaariossa käytämme ohjelman vaihtoa 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 tullakseen laajemmaksi:

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

Ohjauksen muutokset ovat samankaltaisia paitsi että syntaksin vasen puoli on ohjauksen muutoksen numero ja oikea puoli on valinnainen arvo. Jos arvoa ei anneta, 126 lähetetään sen sijaan. Lähetetään ohjauksen muutos 106 arvolla 64 kanavalla 3.

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

Katsotaan nyt nuotti-tapahtumia. Haluamme soittaa C4:ää kanavalla 8 75 % nopeutella, kirjoittaisimme seuraavaa, koska OnSong alkaa laskea MIDI C0:a asteikolla 0:

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

Jälleen kerran on tärkeää muistaa, että kun arvot poistetaan MIDI-syntaksista, MIDI-lauseesta tulee laajempi ja vähemmän spesifinen. Esimerkiksi nuotti-tapahtuman viimeinen versio soittaa C4:ää 100 % nopeudella kaikilla kanavilla.