Alsa e Gambas: L'evento Eco

Nella progettazione del nostro sequencer può risultare utile verificare il punto di esecuzione dell'applicativo, come ad esempio conoscere quando il programma sta eseguendo degli eventi Midi. Per sapere ciò che in quel momento sta facendo il nostro client-sequencer, dobbiamo inviare un particolare tipo di evento: l'Eco.
Il sequencer riceve l'evento eco anch'esso temporizzato, e ce lo restituirà nel momento stabilito dal proprio timestamp. Quando il programma ci ritorna l'eco, che noi abbiamo precedentemente inviato, siamo in grado di individuare il punto del processo in cui si trova il sequencer.

L'invio dell'evento "Eco" può essere una soluzione per poter inviare ad Alsa i dati Midi in maniera costante, ricorrente e nel momento opportuno. Infatti, Alsa non è in grado di gestire una quantità elevata di dati: non è possibile inviarle molte centinaia di dati relativi agli eventi Midi ed ai relativi Tempi Delta contenuti in un file Midi. Pertanto, se ne dovrà inviare una quantità adeguata, e comunque tale che Alsa non ne rimanga mai priva, fintanto che l'esecuzione del file Midi non è terminata. Se avvenisse l'interruzione del flusso di dati, vi sarebbe irrimediabilmente una spiacevole interruzione dell'esecuzione del brano. Allora, il sequencer dovrà "sapere" il momento opportuno per inviare ad Alsa un altro gruppo di dati, perché siano gestiti. L'importante, per la corretta e coerente esecuzione del brano Midi, è non causare interruzioni nel flusso di dati Midi da inviare ad Alsa. Riportando quanto sottolineato da Clemens Ladisch all'interno del codice sorgente del suo programma Aplaymidi, esistono tre possibilità su come far attendere il sequencer sino all'invio di un altro gruppo di dati Midi ad Alsa. Esse sono:

• 1) inviare ad Alsa un evento Eco, ed attendere che esso torni al sequencer;
• 2) attendere un avviso di EVENT_STOP per coda degli eventi che viene inviato dalla porta Timer di sistema (questa richiederebbe una sottoscrizione);
• 3) attendere che il pool di uscita sia vuoto (in questo caso si utilizzerebbe la funzione: snd_seq_sync_output_queue(snd_seq_t *seq, size_t size), la quale attende sino a che tutti gli eventi sono stati processati.

Fra le tre possibilità qui mostreremo la prima, quella dell'invio di un evento "Eco".

Scrittura in Gambas

Poiché l'Eco è un evento come qualsiasi altro, e tale è definito e riconosciuto da ALSA, in Gambas lo invieremo utilizzando le medesime modalità (Memory Stream oppure Strutture) che noi conosciamo per inviare un qualsiasi tipo di evento. Avremo solo l'accortezza di indicare il sequencer stesso come destinatario dell'evento Eco. Per fare ciò, dopo aver individuato il numero identificativo e la porta del nostro sequencer-applicativo, dovremo inserire tali valori nella funzione esterna di ALSA: err = snd_seq_connect_to(handle, outport, dclient, dport).

Dunque, tenendo conto del modello di codice riportato agli inizi della nostra guida, scriveremo così:

Const SND_SEQ_EVENT_ECHO As Integer = 50      ' Questa costante di ALSA individua il "tipo" di evento: un'Eco.


Public Sub invioEco(timestamp As Integer)

  Dim err As Integer

prepareev(SND_SEQ_EVENT_ECHO, timestamp)       ' chiama la routine di preparazione di un evento.

Seek #pStream, 16
 WRITE #pStream, 254 as Byte                   ' Identificativo del destinatario: il sequencer invia l'Eco a se stesso.

  WRITE #pStream, 253 as Byte                  ' Porta del destinatario.

err = snd_seq_event_output_buffer(handle, ev)

  printerr("Eco", err)                         ' Consueta gestione dell'errore.

End

L'evento Eco verrà, poi, intercettato come qualsiasi altro evento con le funzioni che già conosciamo per ricevere gli eventi Midi.