MIDI-syntaks

OnSong brukar ein tekstbasert syntaks for å uttrykkja MIDI-kommandoar. Medan du kan bruka MIDI-hendingar i Metadatabehandlaren, kan du òg uttrykkja MIDI-kommandoar i tekst.

Avgrensa verdiar

Først og fremst kan fleire MIDI-kommandoar skiljas ved ulike teikn inkludert: eit tabulatortasteikn, komma, semikolon, loddrett strek, eller ny linje. Kommaet er den vanlegaste skiljar. Døme:

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

Kanal

Kvar post kan innehalda eit @-teikn. Den numeriske verdien etter teiknet er kanalen som kommandoen skal sendast på. Sidan kanalane i MIDI startar på null, ville kanal ein vera ein null (0), kanal to ein ein (1), osb.

Viss ingen @-teikn blir brukt, blir kommandoen sendt eller motteken på alle kanalane.

Prefiksar

Kvar post i lista inneheld ein prefiks. Denne prefiksen avgjer kva type MIDI-kommando som skal sendast. Desse inkluderer:

• PC eller ingen prefiks er ein programendringshendelse.
• N er ein notehendelse
• CC er ein kontrollendrings­hendelse.
• NRPN er eit ikkje-registrert parameternummer.
• SS er ein låtvalshendelse.
• START er ein startkommando.
• STOP er ein stoppkommando.
• CONTINUE er ein fortsettingskommando.
• WAIT venter eit bestemt tidsrom før fleire hendingar blir sende.
• F0 er forankring for ei SysEx-melding.
• @ er forankring for ei MIDI global-merking.

Verdiar

Verdien til kommandoen viser seg rett før @-teiknet eller på slutten av posten viss ingen @ er gitt. Dette er verdien til programendringane, kontrollendringar, notar, eller låtval basert på prefiksen. I tilfellet av SysEx-postsane blir den heksadesimale verdien av SysEx gitt rett etter F0-prefiksen som blir brukt som hovud for alle SysEx-kommandoar.

Underverdiar

I nokre tilfelle blir tilleggsinfo formidla i MIDI-kommandoen som underverdiar. For eksempel MSB og LSB, samt farten til kontrollverdiar kan bli sende på denne måten. Dette blir uttrykt gjennom tilleggja av eit kolon i verdidelen. Underverdien har ulik kontekst avhengig av typen MIDI-kommando som blir sendt:

• Programendring har underverdiar som stemmer med MSB/LSB til programendringane. Desse verdiane blir skilde av eit punkt med MSB på venstre sida og LSB på høgre sida.
• Kontrollendringar har verdien til kontrollen som er sett ved hjelp av dette. Talet kan vera mellom 0 og 127. Viss det blir utelaten, blir verdien 127 anteken. Du kan òg skilla fleire verdiar med ein bindestrek for å stegja gjennom verdiar. For eksempel vil 127-0 låsa verdien 127 mellom på og av-tilstander.
• Notehendelse har ein underverdi som er knytt til farten som noten skal spelast på. Dette kan setjast til ein numerisk verdi mellom 0 og 127. Du kan stegja gjennom fleire notehastigheidar ved å skilla dei med ein bindestrek.

Dømer

La oss starta med ein enkel programendring. I dette scenarioet brukar vi programendring 8 som òg sender ein MSB på 4 og ein LSB på 2 på kanal 1. Dømet startar med den mest komplekse variasjonen av dette og fjernar bankeavvalet og kanalen for å bli meir generell:

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

Kontrollendringar er like utanfor at venstre sida av syntaksen er kontrollendringstalet og høgre sida er ein valfri verdi. Viss verdien ikkje blir gitt, blir 127 sendt i staden. Vi skal senda kontrollendring 106 med ein verdi på 64 på kanal 3.

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

No skal me sjå på notehendingar. Vi vil spela C4 på kanal 8 med 75 % fart, vi ville skrivi følgjande fordi OnSong startar telljinga av MIDI C0 som 0 på MIDI-noteskalaen:

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

Igjen er det viktig å hugsa at når verdiar blir fjerna frå MIDI-syntaksen, blir MIDI-statementet meir generelt og mindre spesifikt. For eksempel vil den siste versjonen av notehendinga senda C4 med 100 % fart på alle kanalane.

Me kan òg forsinka MIDI ved å leggja til ein WAIT-kommando. Det følgjande vil forsinka MIDI-en med 2 sekund så vel som 500 ms (halv sekund). Du kan spesifisera sekund som 1-10 sekund eller i millisekund.

WAIT2, WAIT500

Til slutt kan me referera til MIDI-globalantar som er forhåndskonfigurerte lister med MIDI-hendingar som kan bli referera. Viss du har ein MIDI-global med "on" som merkinga (utan anførselsteikn), kan du referera den globalen med det følgjande:

@on