Inviare dati grezzi Midi attraverso il subsistema RawMidi

Premessa

Il sistema Alsa consente di inviare dati Midi grezzi ad un dispositivo Midi esterno mediante il suo subsistema RawMidi.

Nella elaborazione del codice bisognerà, ovviamente, richiamare la libreria estrena di Alsa, attualmente libasound.so.2.0.0, che in Gambas richiameremo così:

Library "libasound:2"

e conseguentemente dichiarare attraverso la parola Extern le funzioni di Alsa necessarie.

Per scrivere dati MIDI, è necessario innanzitutto chiamare la funzione

int snd_rawmidi_open (snd_rawmidi_t **in_rmidi, snd_rawmidi_t **out_rmidi, const char *name, int mode)

passandogli così il nome dell'hardware della scheda, del dispositivo e del sub-dispositivo desiderato. Quella funzione restituirà un handle (maniglia) che è possibile utilizzare per chiamare le successive funzioni esterne necessarie di Alsa.
Detta funzione in Gambas sarà così dichiarata:

Private Extern snd_rawmidi_open(in_rmidi As Pointer, out_rmidi As Pointer, name As String, mode As Integer) As Integer

laddove il parametro in_rmidi, trattandosi in questo caso di inviare dati Midi, sarà posto a zero.

L'altra funzione esterna essenziale è quella che consentirà di inviare i dati grezzi ad un dispositivo Midi esterno:

ssize_t snd_rawmidi_write(snd_rawmidi_t * rawmidi, const void * buffer, size_t size)

che in Gambas sarà dichiarata così:

Private Extern snd_rawmidi_write(in_rmidi As Pointer, buffer As Pointer, size As Integer) As Integer

A questa funzione esterna si passa l'handle, ricevuto dalla funzione snd_rawmidi_open, l'indirizzo di un buffer contenente alcuni dati MIDI, e la quantità di dati da inviare ogni volta.

Vi può essere un limite alla quantità di dati che questa funzione è capace di inviare. È possibile determinare quale sia la dimensione dell'output del buffer del driver chiamando la funzione esterna snd_rawmidi_params_get_buffer_size (), e anche cambiare quelle dimensioni, se lo si ritiene opportuno, chiamando la funzione snd_rawmidi_params_set_buffer_size ().

Modalità Blocking e Non-Blocking

Di norma, un uscita Midi viene aperta in modalità bloccante (Blocking). Ciò significa che, quando vengono passati dei dati Midi alla funzione esterna snd_rawmidi_write(), la stessa non ritornerà alcun valore sino a che quei dati non saranno stati inviati attraverso la porta output.

Esempio

Pagina in costruzione