Brukerhåndbok

MIDI-syntaks

OnSong bruker en tekstbasert syntaks for å uttrykke MIDI-kommandoer. Mens 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 tabulatortegn, komma, semikolon, loddrett strek eller ny linje. Kommaet er den mest vanlige avgrensningstegnet. 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 en være null (0), kanal to en (1), og så videre.

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 programendringshendelse.
N er en notat-hendelse
CC er en kontrollendringshendelse.
NRPN er et ikke-registrert parameternummer.
SS er en sangsvalghendelse.
START er en startkommando.
STOP er en stoppkommando.
CONTINUE er en fortsettkommando.
WAIT venter en bestemt tid før flere hendelser sendes.
F0 prefikser en SysEx-melding.
@ prefikser en MIDI global-tag.

Verdier

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

Underverdier

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

Programendring har underverdier som samsvarer med MSB/LSB for programendringen. Disse verdiene er adskilt med en periode med MSB på venstre side og LSB på høyre side.
Kontrollendring har verdien av kontrollen som stilles inn ved hjelp av dette. Nummeret kan være mellom 0 og 127. Hvis den utelates, antas verdien 127. Du kan også separere flere verdier med en bindestrek for å gå gjennom verdier. For eksempel vil 127-0 låse verdien 127 mellom på- og av-tilstander.
Notat-hendelse har en underverdi som relaterer seg til hastigheten som notatet skal spilles av. Dette kan stilles inn til en numerisk verdi mellom 0 og 127. Du kan gå gjennom flere notat-hastigheter ved å separere dem med en bindestrek.

Eksempler

La oss starte med en enkel programendring. I dette scenariet bruker vi programendring 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å notat-hendelser. Vi vil spille C4 på kanal 8 med 75% hastighet, vi ville skrive inn følgende fordi OnSong begynner å telle MIDI C0 som 0 på MIDI-notat-skalaen:

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

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

Vi kan også forsinke MIDI ved å legge til en WAIT-kommando. Følgende vil forsinke MIDI med 2 sekunder samt 500 ms (et halvt sekund). Du kan angi sekunder som 1-10 sekunder eller i millisekunder.

WAIT2, WAIT500

Til slutt kan vi referere til MIDI-globaler som er forhåndskonfigurerte lister over MIDI-hendelser som kan refereres. Hvis du har en MIDI-global med "on" som tag (uten anførselstegn), kan du referere til den globalen med følgende:

@on

OnSong 2023 — Sist oppdatert March 11, 2020