MIDI-syntaks

OnSong bruker en tekstbasert syntaks for å uttrykke MIDI-kommandoer. Selv om du kan bruke MIDI-hendelser i Metadataredigeringen, kan du også uttrykke MIDI-kommandoer i tekst.

Avgrensede verdier

Først og fremst kan flere MIDI-kommandoer separeres med ulike tegn, inkludert: et tabulator-tegn, komma, semikolon, loddrett strek eller linjeskift. Komma er den vanligste avgrenseren. For eksempel:

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

Kanal

Hver oppføring kan inneholde et @-symbol. Den numeriske verdien etter symbolet er kanalen som kommandoen skal sendes på. Siden kanaler i MIDI starter på null, ville kanal én være null (0), kanal to en (1), osv.

Hvis ingen @-symbol brukes, sendes eller mottas kommandoen på alle kanaler.

Prefikser

Hver oppføring i listen inneholder et prefiks. Dette prefikset bestemmer hvilken type MIDI-kommando som skal sendes. Disse inkluderer:

• PC eller Ingen prefiks er en programvekslingshendelse.
• N er en notehendelse
• CC er en kontrollendringshendelse.
• SS er en sangsvalghendelse.
• START er en startkommando.
• STOP er en stoppkommando.
• CONTINUE er en fortsettkommando.
• F0 går foran en SysEx-melding.

Verdier

Verdien av kommandoen vises rett før @-symbolet eller på slutten av oppføringen hvis ingen @ er gitt. Dette er verdien av programvekslingen, kontrollendringen, noten eller sangsvalget basert på prefikset. For SysEx-oppføringer oppgis den heksadesimale verdien av SysEx direkte etter F0-prefikset, som brukes som overskrift for alle SysEx-kommandoer.

Underverdier

I noen tilfeller formidles ytterligere informasjon i MIDI-kommandoen som underverdier. For eksempel MSB og LSB, samt hastighet for kontrollverdier kan sendes på denne måten. Dette uttrykkes ved å legge til et kolon i verdidelen. Underverdien har ulik kontekst avhengig av hvilken type MIDI-kommando som sendes:

• Programveksling har underverdier som er justert med MSB/LSB for programvekslingen. Disse verdiene er separert med et punkt med MSB på venstre side og LSB på høyre side.
• Kontrollendring har verdien av kontrollen som er satt ved hjelp av dette. Nummeret kan være mellom 0 og 127. Hvis det utelates, oppgis verdien 127.
• Notehendelse har en underverdi som er knyttet til hastigheten som noten skal spilles med. Dette kan settes til en numerisk verdi mellom 0 og 127.

Eksempler

La oss starte med en enkel programveksling. I dette scenarioet bruker vi programveksling 8 som også sender en MSB på 4 og en LSB på 2 på kanal 1. Eksemplet starter med den mest komplekse variasjonen av dette og fjerner bankvalget og kanalen for å bli bredere:

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

Kontrollendringer er like bortsett fra at venstre side av syntaksen er kontrollendringsnummeret og høyre side er en valgfri verdi. Hvis verdien ikke oppgis, sendes 127 i stedet. Vi vil sende kontrollendring 106 med en verdi på 64 på kanal 3.

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

La oss nå se på notehendelser. Vi vil spille C4 på kanal 8 med 75 % hastighet, vi ville oppgi følgende fordi OnSong begynner å telle MIDI C0 som 0 på MIDI-noteskalaen:

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

Igjen er det viktig å huske at når verdier fjernes fra MIDI-syntaksen, blir MIDI-setningen bredere og mindre spesifikk. For eksempel vil den siste versjonen av notehendelsen spille C4 med 100 % hastighet på alle kanaler.