Brugerhåndbog
MIDI-syntaks
OnSong bruger en tekstbaseret syntaks til at udtrykke MIDI-kommandoer. Selvom du kan bruge MIDI-begivenheder i Metadataredigeringen, kan du også udtrykke MIDI-kommandoer i tekst.
Afgrænsede værdier
Først og fremmest kan flere MIDI-kommandoer adskilles af forskellige tegn, herunder: et tabulatortegn, komma, semikolon, lodret streg eller linjeskift. Kommaet er den mest almindelige afgrænsning. For eksempel:
1.2:0@0, PC1.2:3@0, N67@1, START, SS8
Kanal
Hver post kan indeholde et @-symbol. Den numeriske værdi efter symbolet er den kanal, som kommandoen skal sendes på. Da kanaler i MIDI starter på nul, ville kanal et være nul (0), kanal to være en (1), osv.
Hvis der ikke bruges et @-symbol, sendes eller modtages kommandoen på alle kanaler.
Præfikser
Hver post på listen indeholder et præfiks. Dette præfiks bestemmer, hvilken type MIDI-kommando der skal sendes. Disse omfatter:
- PC eller Intet præfiks er en programændringshændelse.
- N er en notat-hændelse
- CC er en kontrolændringshændelse.
- NRPN er et ikke-registreret parameternummer.
- SS er en sangtildelingshændelse.
- START er en startkommando.
- STOP er en stopkommando.
- CONTINUE er en fortsætkommando.
- WAIT venter et bestemt tidsrum, før der sendes flere begivenheder.
- F0 præfikerer en SysEx-besked.
- @ præfikerer et MIDI-globalt mærke.
Værdier
Værdien af kommandoen vises lige før @-symbolet eller i slutningen af posten, hvis der ikke er givet noget @. Dette er værdien af programændringen, kontrolændringen, noten eller sangtildelingen baseret på præfikset. I tilfælde af SysEx-poster gives den hexadecimale værdi af SysEx direkte efter F0-præfikset, som bruges som header til alle SysEx-kommandoer.
Underværdier
I nogle tilfælde formidles yderligere oplysninger i MIDI-kommandoen som underværdier. For eksempel kan MSB og LSB samt hastighed af kontrolværdier sendes på denne måde. Dette udtrykkes ved tilføjelse af et kolon i værdi-delen. Underværdien har forskellig kontekst afhængigt af typen af MIDI-kommando, der sendes:
- Programændring har underværdier, der stemmer overens med MSB/LSB for programændringen. Disse værdier er adskilt af et punktum med MSB på venstre side og LSB på højre side.
- Kontrolændring har værdien af kontrollen, der er indstillet ved hjælp af denne. Tallet kan være mellem 0 og 127. Hvis det udelades, udledes værdien 127. Du kan også adskille flere værdier med en bindestreg for at gå gennem værdier. For eksempel vil 127-0 låse værdien 127 mellem til- og fra-tilstande.
- Nothændelse har en underværdi, der vedrører hastigheden, hvormed noten skal afspilles. Dette kan indstilles til en numerisk værdi mellem 0 og 127. Du kan gå gennem flere nothastigheder ved at adskille dem med en bindestreg.
Eksempler
Lad os starte med en simpel programændring. I dette scenario bruger vi programændring 8, som også sender en MSB på 4 og en LSB på 2 på kanal 1. Eksemplet starter med den mest komplekse variation af dette og fjerner bankvalget og kanalen for at blive mere bredt dækkende:
PC3.1:7@0, 3.1:7@0, 3:7@0, 3:7, 7@0, 7
Kontrolændringer er lignende, bortset fra at venstre side af syntaksen er kontrolændringsnummeret, og højre side er en valgfri værdi. Hvis værdien ikke er angivet, sendes 127 i stedet. Vi sender kontrolændring 106 med en værdi på 64 på kanal 3.
CC105:63@2, CC105:63. CC105@2, CC105
Lad os nu se på nothændelser. Vi ønsker at afspille C4 på kanal 8 med 75 % hastighed, vi ville indtaste det følgende, fordi OnSong begynder at tælle MIDI C0 som 0 på MIDI-noteskalaen:
N60:95@7, N60@7, N60:95, N60
Igen er det vigtigt at huske, at når værdier fjernes fra MIDI-syntaksen, bliver MIDI-sætningen bredere og mindre specifik. For eksempel vil den sidste version af nothændelsen sende C4 med 100 % hastighed på alle kanaler.
Vi kan også forsinke MIDI ved at tilføje en WAIT-kommando. Det følgende vil forsinke MIDI'et i 2 sekunder samt 500 ms (et halvt sekund). Du kan angive sekunder som 1-10 sekunder eller i millisekunder.
WAIT2, WAIT500
Endelig kan vi referere til MIDI-globaler, som er forudkonfigurerede lister over MIDI-begivenheder, der kan henvises til. Hvis du har en MIDI-global med "on" som mærke (uden anførselstegn), kan du referere til denne global med det følgende:
@on
