Subsistema Seq: introduzione - Cronologia

Vuott: Redirect alla pagina ALSA e Gambas - Subsistema Seq: introduzione

2022-01-12T23:58:21Z

Redirect alla pagina ALSA e Gambas - Subsistema Seq: introduzione

Vuott il 00:15, 14 ott 2020

2020-10-14T00:15:17Z

← Versione meno recente		Versione delle 18:15, 13 ott 2020
Riga 69:		Riga 69:

	Riguardo al punto 2, va definita una zona di memoria. Per preparare e modificare questa zona di memoria è possibile usare una delle seguenti risorse:		Riguardo al punto 2, va definita una zona di memoria. Per preparare e modificare questa zona di memoria è possibile usare una delle seguenti risorse:
	* [[Alsa_e_Gambas:~~_Uso_dei_Memory_Stream~~\|'''''~~Stream~~''''']];		* [[Alsa_e_Gambas:_Uso_di_un'area_di_memoria_allocata\|'''''Area di memoria allocata''''']];
	* [[Alsa_e_Gambas:_Uso_delle_Strutture\|'''''Struttura''''']];		* [[Alsa_e_Gambas:_Uso_delle_Strutture\|'''''Struttura''''']];
	* [[Alsa_e_Gambas:_Uso_di_una_Classe_specifica\|'''''Classe specifica''''']].		* [[Alsa_e_Gambas:_Uso_di_una_Classe_specifica\|'''''Classe specifica''''']].

Vuott il 23:44, 13 ott 2020

2020-10-13T23:44:33Z

← Versione meno recente		Versione delle 17:44, 13 ott 2020
Riga 68:		Riga 68:
	Riguardo al punto 1, ALSA vuole una zona di memoria contenente, in posizioni specifiche, i valori adatti per la preparazione e per la realizzazione dell'evento Midi. Nello specifico, ALSA vuole una zona di memoria contigua, dove nel primo byte c'è il tipo di evento, nel secondo byte i flag, dal terzo al sesto byte il timestamp e via dicendo.		Riguardo al punto 1, ALSA vuole una zona di memoria contenente, in posizioni specifiche, i valori adatti per la preparazione e per la realizzazione dell'evento Midi. Nello specifico, ALSA vuole una zona di memoria contigua, dove nel primo byte c'è il tipo di evento, nel secondo byte i flag, dal terzo al sesto byte il timestamp e via dicendo.

	Riguardo al punto 2, va definita una zona di memoria. Per preparare e modificare questa zona di memoria è possibile usare [[Alsa_e_Gambas:_Uso_dei_Memory_Stream\|'''''Stream''''']] o [[Alsa_e_Gambas:_Uso_delle_Strutture\|'''''~~Strutture~~''''']] ~~oppure una~~ [[Alsa_e_Gambas:_Uso_di_una_Classe_specifica\|'''''Classe specifica''''']].		Riguardo al punto 2, va definita una zona di memoria. Per preparare e modificare questa zona di memoria è possibile usare una delle seguenti risorse:
			* [[Alsa_e_Gambas:_Uso_dei_Memory_Stream\|'''''Stream''''']];
			* [[Alsa_e_Gambas:_Uso_delle_Strutture\|'''''Struttura''''']];
			* [[Alsa_e_Gambas:_Uso_di_una_Classe_specifica\|'''''Classe specifica''''']].

	Riguardo infine al punto 3, l'organizzazione generale significa: ogni volta che viene inviato un evento ad ALSA, è necessario passargli una zona di memoria che sarà sempre la stessa, ri-scrivendola ogni volta, evitando (anche se potrebbe essere un’alternativa) di crearla al momento. Per preparare un evento, inoltre, visto che ci sono membri comuni, si userà una sola routine comune a tutti gli eventi.		Riguardo infine al punto 3, l'organizzazione generale significa: ogni volta che viene inviato un evento ad ALSA, è necessario passargli una zona di memoria che sarà sempre la stessa, ri-scrivendola ogni volta, evitando (anche se potrebbe essere un’alternativa) di crearla al momento. Per preparare un evento, inoltre, visto che ci sono membri comuni, si userà una sola routine comune a tutti gli eventi.

Vuott il 09:52, 9 set 2020

2020-09-09T09:52:59Z

← Versione meno recente		Versione delle 03:52, 9 set 2020
Riga 257:		Riga 257:
	File.Save("/tmp/libalsa.c", "#include <stdio.h>\n#include <alsa/seq_event.h>\n\n" &		File.Save("/tmp/libalsa.c", "#include <stdio.h>\n#include <alsa/seq_event.h>\n\n" &
	"void Eventi_ALSA() {\n\n" &		"void Eventi_ALSA() {\n\n" &
			" printf(\"\e[1m E V E N T I Id\e[0m\\n\\n\");\n" &
	" printf(\"SND_SEQ_EVENT_NOTEON = %d\\n\", SND_SEQ_EVENT_NOTEON);\n" &		" printf(\"SND_SEQ_EVENT_NOTEON = %d\\n\", SND_SEQ_EVENT_NOTEON);\n" &
	" printf(\"SND_SEQ_EVENT_NOTEOFF = %d\\n\", SND_SEQ_EVENT_NOTEOFF);\n" &		" printf(\"SND_SEQ_EVENT_NOTEOFF = %d\\n\", SND_SEQ_EVENT_NOTEOFF);\n" &

Vuott il 09:45, 9 set 2020

2020-09-09T09:45:19Z

← Versione meno recente		Versione delle 03:45, 9 set 2020
Riga 241:		Riga 241:
	<FONT Color=gray>' ''void Eventi_ALSA()''		<FONT Color=gray>' ''void Eventi_ALSA()''
	' ''Mostra i valori delle Costanti identificatrici degli eventi ALSA.''</font>		' ''Mostra i valori delle Costanti identificatrici degli eventi ALSA.''</font>
	Private Extern ~~Id_Eventi_ALSA~~()		Private Extern Eventi_ALSA()

Vuott il 09:40, 9 set 2020

2020-09-09T09:40:50Z

← Versione meno recente		Versione delle 03:40, 9 set 2020
Riga 305:		Riga 305:
	''int snd_seq_drain_output(snd_seq_t * seq)''		''int snd_seq_drain_output(snd_seq_t * seq)''
	che sversa il contenuto della zona di memoria allocata al sequencer ALSA. Tale funzione ritorna un integer uguale a zero, se tutti gli eventi sono stati inviati al sequencer, e quindi se il buffer intermedio è stato svuotato. Ritorna un valore negativo ritorna un errore.		che sversa il contenuto della zona di memoria allocata al sequencer ALSA. Tale funzione ritorna un integer uguale a zero, se tutti gli eventi sono stati inviati al sequencer, e quindi se il buffer intermedio è stato svuotato. Ritorna un valore negativo ritorna un errore.
	<BR>Più in particolare, questa funzione viene invocata dopo ogni evento; e questo assicura che l'evento venga processato in tempo, svuotando il buffer intermedio precedentemente riempito di dati dalla funzione:		<BR>Più in particolare, questa funzione viene invocata dopo ogni evento; e questo assicura che l'evento venga processato in tempo, svuotando il buffer intermedio precedentemente riempito di dati dalla funzione: "''snd_seq_event_output'' " <SUP>[[[#Note\|Nota 9]]]</sup> descritta nel precedente paragrafo.
	''snd_seq_event_output'' <SUP>[[[#Note\|Nota 9]]]</sup>
	~~precedentemente~~ descritta.

	Detta funzione ~~di ALSA~~ dovrà essere dichiarata con '''Extern''', in questo modo:		Detta funzione "''snd_seq_drain_output'' " dovrà essere dichiarata con '''Extern''', in questo modo:
	<FONT Color= #B22222>Private Extern snd_seq_drain_output(handle As Pointer) As Integer</font>		<FONT Color= #B22222>Private Extern snd_seq_drain_output(handle As Pointer) As Integer</font>
	Verrà scritta così in un'apposita routine:		Verrà scritta così in un'apposita routine:

Vuott il 09:37, 9 set 2020

2020-09-09T09:37:15Z

← Versione meno recente		Versione delle 03:37, 9 set 2020
Riga 206:		Riga 206:
	</tr>		</tr>
	<TR>		<TR>
	<TD>'''duration''' / '''~~Param~~'''</td><TD> </td><TD>un Integer</td><TD></td>		<TD>'''duration''' / '''param'''</td><TD> </td><TD>un Integer</td><TD></td>
	</tr>		</tr>
	<TR>		<TR>
	<TD>'''value'''</td><TD> </td><TD>un Integer</td><TD> </td>		<TD>---- / '''value'''</td><TD> </td><TD>un Integer</td><TD> </td>
	</tr>		</tr>
	</table>		</table>
Riga 220:		Riga 220:
	<TD><Font color="blue">'''Byte'''</font>:</td><TD></td><TD>16</td><TD></td><TD>17</td><TD></td><TD>18</td><TD></td><TD>19</td><TD></td><TD>20 21 22 23</td><TD></td><TD>24 25 26 27</td></tr>		<TD><Font color="blue">'''Byte'''</font>:</td><TD></td><TD>16</td><TD></td><TD>17</td><TD></td><TD>18</td><TD></td><TD>19</td><TD></td><TD>20 21 22 23</td><TD></td><TD>24 25 26 27</td></tr>
	<TR>		<TR>
	<TD></td><TD>(da 0 a 15 i dati comuni)...</td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—~~- - - -~~</td><TD>-</td><TD>┴—</td><TD></td><TD>┴—————</td><TD></td><TD>┴—————</td></tr>		<TD></td><TD>(da 0 a 15 i dati comuni)...</td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—————</td><TD></td><TD>┴—————</td></tr>
	<TR>		<TR>
	<TD><Font color="red">'''Dati'''</font>:</td><TD></td><TD>'''C'''~~anale~~</td><TD>│</td><TD>'''N'''~~ota~~</td><TD>│</td><TD>'''V'''elocity</td><TD>-</td><TD>('''O'''~~ff_Velocity)~~</td><TD>│</td><TD>'''P'''aram</td><TD>│</td><TD>'''V'''alue</td></tr>		<TD><Font color="red">'''Dati'''</font>:</td><TD></td><TD>'''c'''hannel</td><TD>│</td><TD>'''n'''ote</td><TD>│</td><TD>'''v'''elocity</td><TD>\|</td><TD>'''o'''ff_velocity</td><TD>│</td><TD>'''d'''uration/'''p'''aram</td><TD>│</td><TD>'''v'''alue</td></tr>

	</table>		</table>
Riga 288:		Riga 288:
	===Accodare gli eventi in un buffer "intermedio"===		===Accodare gli eventi in un buffer "intermedio"===

	Al termine della scrittura nella zona di memoria riservata di tutti i dati necessari per definire l'evento Midi desiderato, sarà inserita la funzione di ALSA, espressa in C: ''int snd_seq_event_output(snd_seq_t * seq, snd_seq_event_t * ev)'', che pone in uscita un evento~~. Più~~ precisamente ~~questa funzione~~ accoda un evento in un buffer intermedio. Tale funzione ritorna il numero (integer) di eventi rimanenti da far uscire, oppure un codice di errore se negativo.		Al termine della scrittura nella zona di memoria riservata di tutti i dati necessari per definire l'evento Midi desiderato, sarà inserita la funzione di ALSA, espressa in C:
	Detta funzione di ALSA dovrà essere dichiarata con '''Extern''', in questo modo:		''int snd_seq_event_output(snd_seq_t * seq, snd_seq_event_t * ev)''
			che pone in uscita un evento e più precisamente ''accoda'' un evento in un buffer intermedio.
			<BR>Tale funzione ritorna il numero (integer) di eventi rimanenti da far uscire, oppure un codice di errore se negativo.
			<BR>Detta funzione di ALSA dovrà essere dichiarata con '''Extern''', in questo modo:
	<FONT Color= #B22222>Private Extern snd_seq_event_output(handle As Pointer, ev As Pointer) As Integer</font>		<FONT Color= #B22222>Private Extern snd_seq_event_output(handle As Pointer, ev As Pointer) As Integer</font>
	e nella routine sarà invocata così:		e nella routine sarà invocata così:
Riga 299:		Riga 302:
	===Passare ad ALSA i valori presenti nella memoria allocata===		===Passare ad ALSA i valori presenti nella memoria allocata===

	Al termine di ciascuna routine ~~per l~~'invio dell'evento Midi desiderato viene richiamata la subroutine "''flush( )''", presente nella classe secondaria CAlsa.class, la quale contiene la funzione di ALSA, espressa in C: ''int snd_seq_drain_output(snd_seq_t * seq)'', che sversa il contenuto della zona di memoria allocata al sequencer ALSA. Tale funzione ritorna un integer uguale a zero, se tutti gli eventi sono stati inviati al sequencer, e quindi se il buffer intermedio è stato svuotato. Un valore negativo ritorna un errore.		Nel nostro progetto esemplificativo iniziale al termine di ciascuna routine, finalizzata all'invio dell'evento Midi desiderato, viene prevista e richiamata la subroutine "''flush( )''", presente nella classe secondaria ''CAlsa.class'', la quale contiene la funzione di ALSA, espressa in C:
	<BR>Più in particolare, questa funzione viene invocata dopo ogni evento; e questo assicura che l'evento venga processato in tempo, svuotando il buffer intermedio precedentemente riempito di dati dalla funzione: ''snd_seq_event_output'' <SUP>[[[#Note\|Nota 9]]]</sup>, precedentemente descritta.		''int snd_seq_drain_output(snd_seq_t * seq)''
			che sversa il contenuto della zona di memoria allocata al sequencer ALSA. Tale funzione ritorna un integer uguale a zero, se tutti gli eventi sono stati inviati al sequencer, e quindi se il buffer intermedio è stato svuotato. Ritorna un valore negativo ritorna un errore.
			<BR>Più in particolare, questa funzione viene invocata dopo ogni evento; e questo assicura che l'evento venga processato in tempo, svuotando il buffer intermedio precedentemente riempito di dati dalla funzione:
			''snd_seq_event_output'' <SUP>[[[#Note\|Nota 9]]]</sup>
			precedentemente descritta.

	Detta funzione di ALSA dovrà essere dichiarata con '''Extern''', in questo modo:		Detta funzione di ALSA dovrà essere dichiarata con '''Extern''', in questo modo:
Riga 306:		Riga 313:
	Verrà scritta così in un'apposita routine:		Verrà scritta così in un'apposita routine:
	'''Public''' Sub flush()		'''Public''' Sub flush()

	Dim err As Integer		Dim err As Integer

	err = snd_seq_drain_output(handle) <FONT Color=gray>' ''drain output buffer to sequencer</font>		err = snd_seq_drain_output(handle) <FONT Color=gray>' ''drain output buffer to sequencer</font>
	Printerr("Flush", err)		Printerr("Flush", err)

	'''End'''		'''End'''

Vuott il 09:20, 9 set 2020

2020-09-09T09:20:36Z

← Versione meno recente		Versione delle 03:20, 9 set 2020
Riga 194:		Riga 194:
	<TABLE>		<TABLE>
	<TR>		<TR>
	<TD>'''~~Canale~~'''</td><TD> </td><TD> un singolo byte</td><TD> </td>		<TD>'''channel'''</td><TD> </td><TD> un singolo byte</td><TD> </td>
	</tr>		</tr>
	<TR>		<TR>
	<TD>'''~~Nota~~'''</td><TD> </td><TD> un singolo byte</td><TD> </td>		<TD>'''note''' / '''unused'''</td><TD> </td><TD> un singolo byte</td><TD> </td>
	</tr>		</tr>
	<TR>		<TR>
	<TD>'''~~Velocity~~'''</td><TD> </td><TD> un singolo byte <SUP>[[[#Note\|Nota 8]]]</sup></td><TD> </td>		<TD>'''velocity''' / '''unused'''</td><TD> </td><TD> un singolo byte <SUP>[[[#Note\|Nota 8]]]</sup></td><TD> </td>
	</tr>		</tr>
	<TR>		<TR>
	<TD>('''~~Off_Velocity~~'''~~) <SUP>[[[#Note\|Nota 9]]]<~~/~~sup>~~</td><TD> </td><TD>un singolo byte</td><TD></td>		<TD>'''off_velocity''' / '''unused'''</td><TD> </td><TD>un singolo byte</td><TD></td>
	</tr>		</tr>
	<TR>		<TR>
	<TD>'''Param''' ~~<SUP>[[[#Note\|Nota 10]]]</sup>~~</td><TD> </td><TD>un Integer</td><TD></td>		<TD>'''duration''' / '''Param'''</td><TD> </td><TD>un Integer</td><TD></td>
	</tr>		</tr>
	<TR>		<TR>
	<TD>'''~~Value~~'''</td><TD> </td><TD>un Integer</td><TD> </td>		<TD>'''value'''</td><TD> </td><TD>un Integer</td><TD> </td>
	</tr>		</tr>
	</table>		</table>
Riga 300:		Riga 300:

	Al termine di ciascuna routine per l'invio dell'evento Midi desiderato viene richiamata la subroutine "''flush( )''", presente nella classe secondaria CAlsa.class, la quale contiene la funzione di ALSA, espressa in C: ''int snd_seq_drain_output(snd_seq_t * seq)'', che sversa il contenuto della zona di memoria allocata al sequencer ALSA. Tale funzione ritorna un integer uguale a zero, se tutti gli eventi sono stati inviati al sequencer, e quindi se il buffer intermedio è stato svuotato. Un valore negativo ritorna un errore.		Al termine di ciascuna routine per l'invio dell'evento Midi desiderato viene richiamata la subroutine "''flush( )''", presente nella classe secondaria CAlsa.class, la quale contiene la funzione di ALSA, espressa in C: ''int snd_seq_drain_output(snd_seq_t * seq)'', che sversa il contenuto della zona di memoria allocata al sequencer ALSA. Tale funzione ritorna un integer uguale a zero, se tutti gli eventi sono stati inviati al sequencer, e quindi se il buffer intermedio è stato svuotato. Un valore negativo ritorna un errore.
	<BR>Più in particolare, questa funzione viene invocata dopo ogni evento; e questo assicura che l'evento venga processato in tempo, svuotando il buffer intermedio precedentemente riempito di dati dalla funzione: ''snd_seq_event_output'' <SUP>[[[#Note\|Nota 11]]]</sup>, precedentemente descritta.		<BR>Più in particolare, questa funzione viene invocata dopo ogni evento; e questo assicura che l'evento venga processato in tempo, svuotando il buffer intermedio precedentemente riempito di dati dalla funzione: ''snd_seq_event_output'' <SUP>[[[#Note\|Nota 9]]]</sup>, precedentemente descritta.

	Detta funzione di ALSA dovrà essere dichiarata con '''Extern''', in questo modo:		Detta funzione di ALSA dovrà essere dichiarata con '''Extern''', in questo modo:
Riga 315:		Riga 315:

	=Note=		=Note=
	[1] Si suggerisce di dare un'occhiata al capitolo [[~~Traduzione_della_comunità_di_Gambas-it#Interfacciare_Gambas_con_librerie_esterne~~\|Interfacciare Gambas con librerie esterne]], redatta da D. Blengino, presente nell'area "Guide della Comunità", ove sarà possibile avere le informazioni basilari necessarie per la gestione delle API di ALSA. Lì, tra l'altro, sono anche presenti esempi esplicativi della funzione Extern per la gestione di ALSA con Gambas, e l'intera codifica di una classe CAlsa.Class relativa all'esempio di una Drum Machine. Si precisa che la conoscenza della funzione Extern, relativa alle dichiarazioni esterne in Gambas, nonché delle API di ALSA (richiamate appunto dalla funzione Extern), è comunque presupposto necessario ed imprescindibile per la gestione in Gambas dei dati Midi con ALSA.		[1] Si suggerisce di dare un'occhiata al capitolo [[Un_contributo_sulle_funzioni_esterne_in_Gambas_a_cura_di_Doriano_B.\|Interfacciare Gambas con librerie esterne]], redatta da D. Blengino, presente nell'area "Guide della Comunità", ove sarà possibile avere le informazioni basilari necessarie per la gestione delle API di ALSA. Lì, tra l'altro, sono anche presenti esempi esplicativi della funzione Extern per la gestione di ALSA con Gambas, e l'intera codifica di una classe CAlsa.Class relativa all'esempio di una Drum Machine. Si precisa che la conoscenza della funzione Extern, relativa alle dichiarazioni esterne in Gambas, nonché delle API di ALSA (richiamate appunto dalla funzione Extern), è comunque presupposto necessario ed imprescindibile per la gestione in Gambas dei dati Midi con ALSA.

	[2] Una libreria, come lo stesso nome indica, contiene una raccolta di subroutine da utilizzare più volte da più programmi.		[2] Una libreria, come lo stesso nome indica, contiene una raccolta di subroutine da utilizzare più volte da più programmi.
Riga 337:		Riga 337:
	[8] Questo tipo di dato può essere definito anche '''''Short''''', qualora non si intenda utilizzare l'evento ALSA: ''SND_SEQ_EVENT_NOTE''. Si dovrà ovviamente eliminare il successivo dato ''Off_Velocity'', poiché il tipo ''Short'' occupa 2 byte.		[8] Questo tipo di dato può essere definito anche '''''Short''''', qualora non si intenda utilizzare l'evento ALSA: ''SND_SEQ_EVENT_NOTE''. Si dovrà ovviamente eliminare il successivo dato ''Off_Velocity'', poiché il tipo ''Short'' occupa 2 byte.

	[9~~] Questo dato è utilizzato solo con l'evento ALSA: ''SND_SEQ_EVENT_NOTE''.~~		[9] Distinzione fra la funzione ''err = snd_seq_event_output(handle, ev)'' ed ''err = snd_seq_drain_output(handle)'':

	~~[10] Questo dato è definito "'''Duration'''" nel caso di utilizzo dell'evento ALSA: ''SND_SEQ_EVENT_NOTE''.~~

	~~[11~~] Distinzione fra la funzione ''err = snd_seq_event_output(handle, ev)'' ed ''err = snd_seq_drain_output(handle)'':
	* ''err = snd_seq_event_output(handle, ev)'' --> accoda gli eventi in un buffer "intermedio". Quando tale buffer è pieno, viene svuotato automaticamente nel buffer-ALSA. Lo svuotamento di tale buffer intermedio può essere indotto anche se esso non è pieno.		* ''err = snd_seq_event_output(handle, ev)'' --> accoda gli eventi in un buffer "intermedio". Quando tale buffer è pieno, viene svuotato automaticamente nel buffer-ALSA. Lo svuotamento di tale buffer intermedio può essere indotto anche se esso non è pieno.
	* ''err = snd_seq_drain_output(handle)'' --> svuota "a richiesta" il buffer intermedio (anche quindi se il buffer intermedio non è pieno).		* ''err = snd_seq_drain_output(handle)'' --> svuota "a richiesta" il buffer intermedio (anche quindi se il buffer intermedio non è pieno).

Vuott il 09:08, 9 set 2020

2020-09-09T09:08:39Z

Vuott il 09:04, 9 set 2020

2020-09-09T09:04:28Z

← Versione meno recente		Versione delle 03:04, 9 set 2020
Riga 46:		Riga 46:

	====Linee generali====		====Linee generali====
	Nella sezione precedente abbiamo detto che il dispositivo ALSA svolge sostanzialmente due compiti: quello di ''scheduling'', pianificare l'esecuzione di processi, ossia pianificare secondo una precisa sequenza, come in un elenco, l'invio degli eventi e quello di ''dispatching'', ossia di indirizzarli all'esatta destinazione nel momento giusto. La fase della gestione reale degli eventi è lasciata ai programmi applicativi-utente (come i sequencer), i quali, in qualità di ''Client'', comunicano tali dati con il dispositivo ALSA (più precisamente con uno dei suoi sub-sistemi; per il Midi: ''seq''). Abbiamo anche detto che il nostro applicativo deve possedere le funzioni di un Client. Più precisamente una parte di esso svolgerà le funzioni di Client. Si rende pertanto necessario creare appunto un ''Client'', capace di comunicare con gli altri dispositivi esterni e certamente con il dispositivo ALSA. Per creare il nostro Client dobbiamo utilizzare particolari funzioni di ALSA, che dovranno essere preventivamente "richiamate"; attraverso con una particolare dichiarazione contenente l'istruzione "'''Extern'''".		Nella sezione precedente abbiamo detto che il dispositivo ALSA svolge sostanzialmente due compiti: quello di ''scheduling'', pianificare l'esecuzione di processi, ossia pianificare secondo una precisa sequenza, come in un elenco, l'invio degli eventi e quello di ''dispatching'', ossia di indirizzarli all'esatta destinazione nel momento giusto. La fase della gestione reale degli eventi è lasciata ai programmi applicativi-utente (come i sequencer), i quali, in qualità di ''Client'' <SUP>[[[#Note\|Nota 6 bis]]]</sup>, comunicano tali dati con il dispositivo ALSA (più precisamente con uno dei suoi sub-sistemi; per il Midi: ''seq'') che invece fa da ''Server''.
			<BR>Abbiamo anche detto che il nostro applicativo deve possedere le funzioni di un Client. Più precisamente una parte di esso svolgerà le funzioni di Client. Si rende pertanto necessario creare appunto un ''Client'', capace di comunicare con gli altri dispositivi esterni e certamente con il dispositivo ALSA. Per creare il nostro Client dobbiamo utilizzare particolari funzioni di ALSA, che dovranno essere preventivamente "richiamate"; attraverso con una particolare dichiarazione contenente l'istruzione "'''Extern'''".
	<p>Il nostro progetto seguirà più o meno la struttura base di ogni applicazione in ALSA:</p>		<p>Il nostro progetto seguirà più o meno la struttura base di ogni applicazione in ALSA:</p>
	<p>1) aprire il subsistema specifico (in questo caso "seq" del dispositivo ALSA mediante l'apposita funzione;</p>		<p>1) aprire il subsistema specifico (in questo caso "seq" del dispositivo ALSA mediante l'apposita funzione;</p>
Riga 136:		Riga 137:
	<TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴———</td><TD></td><TD>┴————</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td></tr>		<TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴———</td><TD></td><TD>┴————</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td><TD></td><TD>┴—</td></tr>
	<TR>		<TR>
	<TD><Font color="red">'''Dati'''</font>:</td><TD>'''T'''ype</td><TD>│</td><TD>'''F'''lags</td><TD>│</td><TD>'''T'''ag</td><TD>│</td><TD>'''Q'''ueue</td><TD>│</td><TD>~~Tick~~ / '''R'''eal Tv_sec</td><TD>│</td><TD>0 / '''R'''eal Tv_nsec</td><TD>│</td><TD>'''I'''d_client</td><TD>│</td><TD>'''P'''orta_client</td><TD>│</td><TD>'''C'''lient_dest</td><TD>│</td><TD>'''P'''orta_dest</td></tr>		<TD><Font color="red">'''Dati'''</font>:</td><TD>'''T'''ype</td><TD>│</td><TD>'''F'''lags</td><TD>│</td><TD>'''T'''ag</td><TD>│</td><TD>'''Q'''ueue</td><TD>│</td><TD>'''T'''ick / '''R'''eal Tv_sec</td><TD>│</td><TD>0 / '''R'''eal Tv_nsec</td><TD>│</td><TD>'''I'''d_client</td><TD>│</td><TD>'''P'''orta_client</td><TD>│</td><TD>'''C'''lient_dest</td><TD>│</td><TD>'''P'''orta_dest</td></tr>

	</table>		</table>
Riga 325:		Riga 326:

	[6] Un Handle (''maniglia'') rappresenta "''una '''variabile''' associata a un oggetto complesso, che lo identifica''". Possiamo dire che in modo figurato questa ''maniglia'' è la ''protuberanza'' con la quale si interagisce con l'oggetto medesimo. In gambas, per esempio, qualsiasi oggetto (form, o altro) è un ''handle'', e per creare un oggetto/handle in Gambas, come è noto, bisogna scrivere "NEW oggetto_da_creare", in ALSA invece la funzione per creare l'handle è, come sappiamo: ''variab_int = snd_seq_etc_etc(xxx, ......) as integer''.		[6] Un Handle (''maniglia'') rappresenta "''una '''variabile''' associata a un oggetto complesso, che lo identifica''". Possiamo dire che in modo figurato questa ''maniglia'' è la ''protuberanza'' con la quale si interagisce con l'oggetto medesimo. In gambas, per esempio, qualsiasi oggetto (form, o altro) è un ''handle'', e per creare un oggetto/handle in Gambas, come è noto, bisogna scrivere "NEW oggetto_da_creare", in ALSA invece la funzione per creare l'handle è, come sappiamo: ''variab_int = snd_seq_etc_etc(xxx, ......) as integer''.

			[6 bis] Sul rapporto Client/Server in ALSA: https://www.alsa-project.org/alsa-doc/alsa-lib/seq.html

	[7] Vedere: https://www.alsa-project.org/alsa-doc/alsa-lib/structsnd__seq__event__t.html		[7] Vedere: https://www.alsa-project.org/alsa-doc/alsa-lib/structsnd__seq__event__t.html

← Versione meno recente		Versione delle 03:08, 9 set 2020
Riga 70:		Riga 70:
	Riguardo al punto 2, va definita una zona di memoria. Per preparare e modificare questa zona di memoria è possibile usare [[Alsa_e_Gambas:_Uso_dei_Memory_Stream\|'''''Stream''''']] o [[Alsa_e_Gambas:_Uso_delle_Strutture\|'''''Strutture''''']] oppure una [[Alsa_e_Gambas:_Uso_di_una_Classe_specifica\|'''''Classe specifica''''']].		Riguardo al punto 2, va definita una zona di memoria. Per preparare e modificare questa zona di memoria è possibile usare [[Alsa_e_Gambas:_Uso_dei_Memory_Stream\|'''''Stream''''']] o [[Alsa_e_Gambas:_Uso_delle_Strutture\|'''''Strutture''''']] oppure una [[Alsa_e_Gambas:_Uso_di_una_Classe_specifica\|'''''Classe specifica''''']].

	Riguardo infine al punto 3, l'organizzazione generale significa: ogni volta che viene inviato un evento ad ALSA, è necessario passargli una zona di memoria che sarà sempre la stessa, ri-scrivendola ogni volta, evitando (anche se potrebbe essere un’alternativa) di crearla al momento. Per preparare un evento, inoltre, visto che ci sono ~~campi~~ comuni, si userà una sola routine comune a tutti gli eventi.		Riguardo infine al punto 3, l'organizzazione generale significa: ogni volta che viene inviato un evento ad ALSA, è necessario passargli una zona di memoria che sarà sempre la stessa, ri-scrivendola ogni volta, evitando (anche se potrebbe essere un’alternativa) di crearla al momento. Per preparare un evento, inoltre, visto che ci sono membri comuni, si userà una sola routine comune a tutti gli eventi.


Riga 118:		Riga 118:
	</table>		</table>

	Da considerare che i ~~campi~~ ''Time'', ''Source'' e ''Dest'' sono dati <span style= "text-decoration:underline">''strutturati''</span>, cioé contengono al loro interno altri ~~campi~~. Per questi dati il membro è uno solo, ma per ragioni tecniche viene spezzato in due istruzioni. Quindi un evento in ALSA contiene 4 dati semplici + 3 strutturati "doppi" (totale sette), ma i tre strutturati vengono scritti, per ragioni tecniche, con un passaggio doppio, e quindi il totale delle scritture diventa 10.		Da considerare che i membri ''Time'', ''Source'' e ''Dest'' sono dati <span style= "text-decoration:underline">''strutturati''</span>, cioé contengono al loro interno altri membri. Per questi dati il membro è uno solo, ma per ragioni tecniche viene spezzato in due istruzioni. Quindi un evento in ALSA contiene 4 dati semplici + 3 strutturati "doppi" (totale sette), ma i tre strutturati vengono scritti, per ragioni tecniche, con un passaggio doppio, e quindi il totale delle scritture diventa 10.
	<p>In particolare riguardo ai membri della Struttura ALSA degli Eventi Midi: <SUP>[[[#Note\|Nota 7 bis]]]</sup>:		<p>In particolare riguardo ai membri della Struttura ALSA degli Eventi Midi: <SUP>[[[#Note\|Nota 7 bis]]]</sup>:
	* '''Type''' contiene il tipo di evento;		* '''Type''' contiene il tipo di evento;
Riga 124:		Riga 124:
	* '''Tag''' può contenere un marcatore arbitrario;		* '''Tag''' può contenere un marcatore arbitrario;
	* '''Queue''' contiene il valore per lo ''Scheduling queue'';		* '''Queue''' contiene il valore per lo ''Scheduling queue'';
	* '''Time''' contiene al suo interno due ~~campi~~ entrambi di un integer: il primo ed il secondo per il ''timestamp'' specificato in ''Real time''; oppure solo il primo per il ''timestamp'' specificato in ''Midi Tick'', in tal caso il secondo membro non serve e può essere posto a zero;		* '''Time''' contiene al suo interno due mebri entrambi di un integer: il primo ed il secondo per il ''timestamp'' specificato in ''Real time''; oppure solo il primo per il ''timestamp'' specificato in ''Midi Tick'', in tal caso il secondo membro non serve e può essere posto a zero;
	* '''Source''' contiene l'indirizzo del sorgente dell'evento. E' formato da due ~~campi~~: il primo l'identificativo numerico, il secondo il numero della porta;		* '''Source''' contiene l'indirizzo del sorgente dell'evento. E' formato da due membri: il primo l'identificativo numerico, il secondo il numero della porta;
	* '''Dest''' contiene l'indirizzo del destinatario dell'evento. E' formato da due ~~campi~~: il primo l'identificativo numerico, il secondo il numero della porta.</p>		* '''Dest''' contiene l'indirizzo del destinatario dell'evento. E' formato da due membri: il primo l'identificativo numerico, il secondo il numero della porta.</p>

	Complessivamente i dati generali, comuni a tutti i messaggi Midi, occupano ben 16 byte della memoria allocata:		Complessivamente i dati generali, comuni a tutti i messaggi Midi, occupano ben 16 byte della memoria allocata:
Riga 191:		Riga 191:
	} snd_seq_ev_ctrl_t;		} snd_seq_ev_ctrl_t;

	Volendo fondere le due precedenti ''Strutture'', otteniamo un'unica organizzazione dei dati i cui ~~campi~~, che andranno a contenere i dati degli specifici Messaggi Midi, sono i seguenti:		Volendo fondere le due precedenti ''Strutture'', otteniamo un'unica organizzazione dei dati i cui membri, che andranno a contenere i dati degli specifici Messaggi Midi, sono i seguenti:
	<TABLE>		<TABLE>
	<TR>		<TR>