Brukerveiledning

MIDI-syntaks

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

Skilte verdier

Først og fremst kan flere MIDI-kommandoer separeres med ulike tegn, inkludert: tabulator, komma, semikolon, loddrett strek eller linjeskift. Kommaet er det vanligste skilletegnet. 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 én (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 notefhendelse
CC er en kontrollendringshendelse.
NRPN er et ikke-registrert parameternummer.
SS er en sangvalgshendelse.
START er en startkommando.
STOP er en stoppkommando.
CONTINUE er en fortsettkommando.
WAIT venter en bestemt tid før flere hendelser sendes.
F0 har prefiks til en SysEx-melding.
@ har prefiks til en global MIDI-merke.

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, noten eller sangvalget basert på prefikset. I tilfelle 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 blir tilleggsinformasjon formidlet i MIDI-kommandoen som underverdier. For eksempel kan MSB og LSB, samt hastighet på kontrollverdier, sendes på denne måten. Dette uttrykkes ved å legge til et kolon i verdidelen. Underverdien har ulik kontekst avhengig av typen MIDI-kommando som sendes:

Programendring har underverdier som stemmer overens med MSB/LSB for programendringen. Disse verdiene er atskilt med en periode med MSB på venstre side og LSB på høyre side.
Kontrollendring har verdien for kontrollen som er angitt ved hjelp av denne. Tallet kan være mellom 0 og 127. Hvis det 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.
Notehendelse har en underverdi som angår hastigheten som noten skal spilles med. Dette kan settes til en numerisk verdi mellom 0 og 127. Du kan gå gjennom flere notefhastigheter ved å separere dem med en bindestrek.

Eksempler

La oss starte med en enkel programendring. I dette scenarioet 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 lignende 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 skrive følgende fordi OnSong starter tellingen av 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.

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 globale MIDI-variabler som er forhåndskonfigurerte lister over MIDI-hendelser som kan refereres til. Hvis du har en global MIDI-variabel med "on" som merke (uten anførselstegn), kan du referere til denne globalen med følgende:

@on

OnSong 2026 — Sist oppdatert March 11, 2020