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ä.

Rajoitetut arvot

Ensinnäkin useat MIDI-komennot voidaan erottaa useilla merkeillä, mukaan lukien: sarkain, pilkku, puolipiste, pystyviiva tai rivinvaihe. Pilkku on yleisin erotinmerkki. Esimerkiksi:

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

Kanava

Jokainen merkintä voi sisältää @-symbolin. Symbolin jälkeen oleva numeerinen arvo on kanava, jolla komento lähetetään. Koska MIDI-kanavat alkavat nollasta, kanava yksi olisi nolla (0), kanava kaksi yksi (1) ja niin edelleen.

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äihin kuuluvat:

• PC tai Ei etuliitettä on ohjelmanvaihtotapahtuma.
• N on muistiinpanotapahtuma
• CC on ohjausmuutostenhtapahtuma.
• SS on kappaleenvalintatapahtuma.
• START on käynnistyskomento.
• STOP on pysäytyskomento.
• CONTINUE on jatkamiskomento.
• WAIT odottaa tietyn ajan ennen muiden tapahtumien lähettämistä.
• F0 etuliittelee SysEx-viestin.
• @ etuliittelee MIDI-globaalin tunnisteen.

Arvot

Komennon arvo näkyy juuri @-symbolin ennen tai merkinnän lopussa, jos @-symbolia ei ole annettu. Tämä on ohjelmanvaihdoksen, ohjausmuutoksen, muistiinpanon tai kappaleenvalinnan arvo etuliitteen perusteella. SysEx-merkintöjen tapauksessa SysEx:n heksadesimaaliarvo annetaan suoraan F0-etuliitteen jälkeen, jota käytetään otsakkona kaikille SysEx-komennoille.

Aliarvot

Joissakin tapauksissa MIDI-komennossa välittyy lisätietoja aliarvoina. Esimerkiksi MSB ja LSB sekä ohjausarvojen nopeus voidaan lähettää tällä tavalla. Tämä ilmaistaan lisäämällä kaksoispiste arvo-osaan. Aliarvon konteksti vaihtelee lähetetyn MIDI-komennon tyypin mukaan:

• Ohjelmanvaihto sisältää aliarvoja, jotka kohdistuvat ohjelmanvaihdoksen MSB/LSB-arvoihin. Nämä arvot erotetaan pisteellä, jolloin MSB on vasemmalla ja LSB oikealla.
• Ohjausmuutos sisältää tällä lähetetyn ohjausjoukon arvon. Numero voi olla välillä 0 ja 127. Jos se jätetään pois, arvo 127 päätellään. Voit myös erottaa useita arvoja tavuviivalla vaiheiden kautta. Esimerkiksi 127-0 lukitsee arvon 127 käyttöön ja pois päältä -tilojen välillä.
• Muistiinpanotapahtuma sisältää aliarvon, joka liittyy nopeuden, jolla muistiinpano tulisi soittaa. Tämä voidaan asettaa numeeriseksi arvoksi välillä 0 ja 127. Voit vaihella useiden muistiinpanojen nopeusten välillä erottamalla ne tavuviivalla.

Esimerkkejä

Aloitetaan yksinkertaisesta ohjelmanvaihdosta. Tässä skenaariossa käytämme ohjelmanvaihtoa 8, joka lähettää myös MSB:n 4 ja LSB:n 2 kanavalla 1. Esimerkki alkaa tämän monimutkaisimmasta variaatiosta 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ähetetään ohjausmuutos 106 arvolla 64 kanavalla 3.

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

Katsotaan nyt muistiinpanotapahtumia. Halumme soittaa C4:ää kanavalla 8 75 %:n nopeuudella, kirjoittaisimme seuraavat, koska OnSong aloittaa MIDI C0:n laskemisen nollasta MIDI-asteikolla:

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

Jälleen on tärkeä muistaa, että kun arvoja poistetaan MIDI-syntaksista, MIDI-lause tulee laajemmaksi ja vähemmän spesifiksi. Esimerkiksi muistiinpanotapahtuman viimeinen versio lähettää C4:ää 100 %:n nopeudella kaikilla kanavilla.

Voimme myös viivästyttää MIDI:a lisäämällä WAIT-komennon. Seuraava viivästyttää MIDI:ta 2 sekunnilla sekä 500 ms:llä (puoli sekuntia). Voit määrittää sekunnit 1–10 sekunnin tai millisekuntien välillä.

WAIT2, WAIT500

Lopuksi voimme viitata MIDI-globaaleihin, jotka ovat esikonfiguroituja MIDI-tapahtumien luetteloita, joihin voidaan viitata. Jos sinulla on MIDI-globaali, jonka tunnisteena on "on" (ilman lainausmerkkejä), voit viitata tähän globaaliin seuraavalla tavalla:

@on