Brukerhåndbok
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 tabulatortegn, komma, semikolon, vertikal strek eller linjeskift. Komma er den 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 være én (1), og så videre.
Hvis intet @-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 Intet prefiks er en programendringshendelse.
- N er en notehendelse
- CC er en kontrollendringshendelse.
- NRPN er et ikke-registrert parameternummer.
- SS er en låthendelse.
- 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, noten eller låtvalget basert på prefikset. I tilfelle SysEx-oppføringer, gis den heksadesimale verdien av SysEx direkte etter F0-prefikset som brukes som et topptekst for alle SysEx-kommandoer.
Underverdier
I noen tilfeller formiddles tilleggsinformasjon i MIDI-kommandoen som underverdier. For eksempel kan MSB og LSB, samt hastighet av kontrollverdier, sendes på denne måten. Dette uttrykkes gjennom tillegg av et kolon i verdidelen. Underverdien har ulik kontekst avhengig av typen MIDI-kommando som sendes:
- Programendring har underverdier som samsvarer med MSB/LSB for programendringen. Disse verdiene er separert med en periode med MSB på venstre side og LSB på høyre side.
- Kontrollendring har verdien av kontrollen som er angitt ved bruk av denne. Tallet kan være mellom 0 og 127. Hvis det utelates, antakkes 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 relatert til hastigheten som noten skal spilles med. Dette kan settes til en numerisk verdi mellom 0 og 127. Du kan gå gjennom flere notefarter 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 mer bredt:
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 sender kontrollendring 106 med en verdi på 64 på kanal 3.
CC105:63@2, CC105:63. CC105@2, CC105
Nå skal vi se på notehendelser. Vi vil spille C4 på kanal 8 med 75 % hastighet, ville vi angitt 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-utsagnet bredere og mindre spesifikt. For eksempel vil den siste versjonen av notehendelsen sende C4 med 100 % hastighet på alle kanaler.
Vi kan også forsinke MIDI ved å legge til en WAIT-kommando. Følgende vil forsinke MIDI-en 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 henvises til. Hvis du har en MIDI global med "on" som tagger (uten sitater), kan du referere til den globalen med følgende:
@on
