Manuale Utente

Sintassi MIDI

OnSong utilizza una sintassi basata su testo per esprimere i comandi MIDI. Sebbene tu possa utilizzare gli Eventi MIDI nell'Editor Metadati, puoi anche esprimere i comandi MIDI in testo.

Valori Delimitati

Innanzitutto, più comandi MIDI possono essere separati da vari caratteri inclusi: un carattere di tabulazione, virgola, punto e virgola, barra verticale o nuova riga. La virgola è il delimitatore più comune. Per esempio:

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

Canale

Ogni voce può contenere un simbolo @. Il valore numerico dopo il simbolo è il canale su cui deve essere inviato il comando. Poiché i canali in MIDI iniziano da zero, il canale uno sarebbe zero (0), il canale due uno (1), ecc.

Se non viene utilizzato il simbolo @, il comando viene inviato o ricevuto su tutti i canali.

Prefissi

Ogni voce dell'elenco contiene un prefisso. Questo prefisso determina il tipo di comando MIDI da inviare. Questi includono:

PC o Nessun Prefisso è un evento di cambio programma.
N è un evento di nota
CC è un evento di cambio controllo.
NRPN è un numero di parametro non registrato.
SS è un evento di selezione brano.
START è un comando di avvio.
STOP è un comando di arresto.
CONTINUE è un comando di continuazione.
WAIT attende un intervallo di tempo specifico prima di inviare altri eventi.
F0 fa da prefisso a un messaggio SysEx.
@ fa da prefisso a un tag MIDI globale.

Valori

Il valore del comando appare appena prima del simbolo @ o alla fine della voce se non ne viene fornito alcuno. Questo è il valore del cambio programma, cambio controllo, nota o selezione brano in base al prefisso. Nel caso di voci SysEx, il valore esadecimale di SysEx viene fornito direttamente dopo il prefisso F0 che viene utilizzato come intestazione per tutti i comandi SysEx.

Sottovalori

In alcuni casi, informazioni aggiuntive vengono comunicate nel comando MIDI come sottovalori. Ad esempio, MSB e LSB, così come la velocità dei valori di controllo possono essere inviati in questo modo. Questo viene espresso attraverso l'aggiunta di due punti nella porzione del valore. Il sottovalore ha un contesto diverso a seconda del tipo di comando MIDI inviato:

Cambio Programma ha sottovalori allineati con l'MSB/LSB del cambio programma. Questi valori sono separati da un punto con l'MSB a sinistra e l'LSB a destra.
Cambio Controllo ha il valore del controllo impostato utilizzando questo. Il numero può essere compreso tra 0 e 127. Se omesso, il valore 127 è implicito. Puoi anche separare più valori con un trattino per scorrere tra i valori. Ad esempio, 127-0 blocca il valore di 127 tra gli stati acceso e spento.
Evento Nota ha un sottovalore relativo alla velocità con cui la nota deve essere riprodotta. Questo può essere impostato su un valore numerico tra 0 e 127. Puoi scorrere attraverso più velocità di nota separandole con un trattino.

Esempi

Iniziamo con un semplice cambio programma. In questo scenario utilizziamo il cambio programma 8 che invia anche un MSB di 4 e un LSB di 2 sul canale 1. L'esempio inizia con la variazione più complessa di questa e rimuove la selezione banca e il canale per diventare più ampio:

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

I cambi controllo sono simili, ad eccezione del fatto che il lato sinistro della sintassi è il numero del cambio controllo e il lato destro è un valore facoltativo. Se il valore non viene fornito, viene inviato 127. Invieremo il Cambio Controllo 106 con un valore di 64 sul canale 3.

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

Ora diamo un'occhiata agli eventi nota. Vogliamo riprodurre Do4 sul canale 8 con una velocità del 75%, inseriremo quanto segue perché OnSong inizia a contare MIDI Do0 come 0 sulla scala delle note MIDI:

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

Di nuovo, è importante ricordare che, man mano che i valori vengono rimossi dalla sintassi MIDI, l'istruzione MIDI diventa più ampia e meno specifica. Ad esempio, l'ultima versione dell'evento nota invierà Do4 al 100% di velocità su tutti i canali.

Possiamo anche ritardare MIDI aggiungendo un comando WAIT. Quanto segue ritarderà MIDI per 2 secondi così come 500 ms (mezzo secondo). Puoi specificare i secondi da 1-10 secondi o in millisecondi.

WAIT2, WAIT500

Infine, possiamo fare riferimento a globali MIDI che sono elenchi preconfigurati di eventi MIDI a cui è possibile fare riferimento. Se disponi di un globale MIDI con "on" come tag (senza virgolette), puoi fare riferimento a quel globale con quanto segue:

@on

OnSong 2023 — Ultimo aggiornamento il March 11, 2020