MIDI-syntaxis

OnSong gebruikt een op tekst gebaseerde syntaxis voor het uitdrukken van MIDI-opdrachten. Hoewel u de MIDI-gebeurtenissen in de Metagegevens-editor kunt gebruiken, kunt u ook MIDI-opdrachten in tekst uitdrukken.

Gescheiden waarden

Allereerst kunnen meerdere MIDI-opdrachten worden gescheiden door verschillende tekens, waaronder: een tabteken, komma, puntkomma, verticale streep of nieuwe regel. De komma is het meest gebruikte scheidingsteken. Bijvoorbeeld:

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

Kanaal

Elke invoer kan een @-symbool bevatten. De numerieke waarde na het symbool is het kanaal waarop de opdracht moet worden verzonden. Omdat kanalen in MIDI op nul beginnen, zou kanaal één nul (0) zijn, kanaal twee één (1), enzovoort.

Als er geen @-symbool wordt gebruikt, wordt de opdracht op alle kanalen verzonden of ontvangen.

Voorvoegsels

Elke invoer in de lijst bevat een voorvoegsel. Dit voorvoegsel bepaalt wat voor soort MIDI-opdracht moet worden verzonden. Deze omvatten:

• PC of Geen voorvoegsel is een programmawijziging-gebeurtenis.
• N is een noot-gebeurtenis
• CC is een besturingswijziging-gebeurtenis.
• SS is een nummerkeuze-gebeurtenis.
• START is een startcommando.
• STOP is een stopcommando.
• CONTINUE is een vervolgcommando.
• F0 voorafgaat aan een SysEx-bericht.

Waarden

De waarde van de opdracht verschijnt net vóór het @-symbool of aan het einde van de invoer als er geen @ is gegeven. Dit is de waarde van de programmawijziging, besturingswijziging, noot of nummerkeuze op basis van het voorvoegsel. In het geval van SysEx-invoeren wordt de hexadecimale waarde van SysEx direct na het F0-voorvoegsel opgegeven, dat als koptekst voor alle SysEx-opdrachten wordt gebruikt.

Subwaarden

In sommige gevallen wordt aanvullende informatie in de MIDI-opdracht als subwaarden overgedragen. Bijvoorbeeld MSB en LSB, evenals snelheid van besturingswaarden kunnen op deze manier worden verzonden. Dit wordt uitgedrukt door het toevoegen van een dubbele punt in het waardegedeelte. De subwaarde heeft verschillende context afhankelijk van het type MIDI-opdracht dat wordt verzonden:

• Programmawijziging heeft subwaarden die aansluiten op de MSB/LSB van de programmawijziging. Deze waarden worden gescheiden door een punt met de MSB aan de linkerkant en de LSB aan de rechterkant.
• Besturingswijziging heeft de waarde van de bediening die hiermee wordt ingesteld. Het getal kan tussen 0 en 127 liggen. Indien weggelaten, wordt de waarde 127 aangenomen.
• Noot-gebeurtenis heeft een subwaarde die betrekking heeft op de snelheid waarmee de noot moet worden gespeeld. Dit kan worden ingesteld op een numerieke waarde tussen 0 en 127.

Voorbeelden

Laten we beginnen met een eenvoudige programmawijziging. In dit scenario gebruiken we programmawijziging 8 die ook een MSB van 4 en een LSB van 2 op kanaal 1 verzendt. Het voorbeeld begint met de meest complexe variant hiervan en verwijdert de bankselectie en het kanaal om breder te worden:

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

Besturingswijzigingen zijn vergelijkbaar, behalve dat de linkerkant van de syntaxis het besturingswijzigingsnummer is en de rechterkant een optionele waarde. Als de waarde niet wordt opgegeven, wordt 127 verzonden. We zullen Besturingswijziging 106 met een waarde van 64 op kanaal 3 verzenden.

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

Laten we nu eens kijken naar noot-gebeurtenissen. Als we C4 op kanaal 8 willen spelen met een snelheid van 75%, zouden we het volgende invoeren omdat OnSong MIDI C0 als 0 op de MIDI-notaschaal begint te tellen:

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

Opnieuw is het belangrijk om te onthouden dat naarmate waarden uit de MIDI-syntaxis worden verwijderd, de MIDI-instructie breder en minder specifiek wordt. De laatste versie van de noot-gebeurtenis zal bijvoorbeeld C4 met 100% snelheid op alle kanalen verzenden.