Differenze tra le versioni di "Inizializzazione di GStreamer"

Da Gambas-it.org - Wikipedia.
 
(15 versioni intermedie di uno stesso utente non sono mostrate)
Riga 2: Riga 2:
 
Innanzitutto, l'uso delle funzioni esterne del [http://it.wikipedia.org/wiki/Application_programming_interface API] di ''GStreamer'' necessita della dichiarazione della [http://www.gambas-it.org/wiki/index.php?title=Extern:_richiamare_funzioni_esterne_a_Gambas Libreria condivisa .so] esterna, dalla quale richiamare le funzioni necessarie.
 
Innanzitutto, l'uso delle funzioni esterne del [http://it.wikipedia.org/wiki/Application_programming_interface API] di ''GStreamer'' necessita della dichiarazione della [http://www.gambas-it.org/wiki/index.php?title=Extern:_richiamare_funzioni_esterne_a_Gambas Libreria condivisa .so] esterna, dalla quale richiamare le funzioni necessarie.
  
Facendo uso dell'attuale versione 1.0 di ''GStreamer'', ed avendo verificato nel nostro sistema che la libreria da richiamare è: ''libgstreamer-1.0.so.0.6.0'', dichiareremo la libreria così:
+
Facendo uso dell'attuale versione 1.0 di ''GStreamer'', ed avendo verificato nel nostro sistema che la libreria da richiamare è "''libgstreamer-1.0.so.0.2405.0'' ", dichiareremo la libreria così:
  Library "libgstreamer-1.0"  |[[#Note|1]]|
+
  Library "libgstreamer-1.0:0.2407.0"  <SUP>&#091;[[#Note|nota 1]]&#093;</sup>
  
  
Riga 13: Riga 13:
 
  Private Extern gst_init(argc As Pointer, argv As Pointer)
 
  Private Extern gst_init(argc As Pointer, argv As Pointer)
 
potrà essere utilizzata all'interno di una ruotine. Nel nostro caso più semplice, ossia nel caso non si intenda passare a ''GStreamer'' nessun valore d'argomento, i due parametri di tipo ''Pointer'' saranno posti ai rispettivi valori di ''default'':
 
potrà essere utilizzata all'interno di una ruotine. Nel nostro caso più semplice, ossia nel caso non si intenda passare a ''GStreamer'' nessun valore d'argomento, i due parametri di tipo ''Pointer'' saranno posti ai rispettivi valori di ''default'':
   gst_init(0,0)
+
   gst_init(0, 0)
  
  
Riga 21: Riga 21:
 
====Verifica della inizializzazione====
 
====Verifica della inizializzazione====
 
Utilizzeremo la funzione esterna:
 
Utilizzeremo la funzione esterna:
  ''' gboolean gst_is_initialized(void)''
+
  '' gboolean gst_is_initialized(void)''
 
la quale restituisce un valore booleano che se è uguale a ''True'' significa che ''GStreamer'' è stato regolarmente inizializzato. In Gambas la dichiareremo così:
 
la quale restituisce un valore booleano che se è uguale a ''True'' significa che ''GStreamer'' è stato regolarmente inizializzato. In Gambas la dichiareremo così:
 
  Private Extern gst_is_initialized() As Boolean
 
  Private Extern gst_is_initialized() As Boolean
Riga 28: Riga 28:
 
   
 
   
 
  inizializzato = gst_is_initialized()
 
  inizializzato = gst_is_initialized()
  Print inizializzato
+
  If inizializzato = False Then Error.Raise("Impossibile inizializzare GStreamer !")
  
 
====Ottenere in dettaglio il numero della versione di GStreamer====
 
====Ottenere in dettaglio il numero della versione di GStreamer====
Riga 34: Riga 34:
 
  ''void gst_version(guint *major, guint *minor, guint *micro, guint *nano)
 
  ''void gst_version(guint *major, guint *minor, guint *micro, guint *nano)
 
dalla quale, deferenziando successivanete i valori di tipo ''Pointer'' precedentemente ad essa passati, è possibile ottenere ''in dettaglio'' il numero della versione di ''GStreamer''.  In Gambas la dichiareremo così:
 
dalla quale, deferenziando successivanete i valori di tipo ''Pointer'' precedentemente ad essa passati, è possibile ottenere ''in dettaglio'' il numero della versione di ''GStreamer''.  In Gambas la dichiareremo così:
  Private Extern gst_version(majorP As Pointer, minorP As Pointer, microP As Pointer, nanoP As Pointer)
+
  Private Extern gst_version(major As Pointer, minor As Pointer, micro As Pointer, nano As Pointer)
 
e la richiameremo in routine passandole quattro ''Pointer'' che puntano ad un'area allocata di memoria sufficiente per riempire un valore intero:
 
e la richiameremo in routine passandole quattro ''Pointer'' che puntano ad un'area allocata di memoria sufficiente per riempire un valore intero:
 
  Dim major, minor, micro, nano As Pointer
 
  Dim major, minor, micro, nano As Pointer
 
   
 
   
major = Alloc(4)
+
  major = Alloc(SizeOf(gb.Integer), 1)
minor = Alloc(4)
+
  minor = Alloc(SizeOf(gb.Integer), 1)
micro = Alloc(4)
+
  micro = Alloc(SizeOf(gb.Integer), 1)
nano = Alloc(4)
+
  nano = Alloc(SizeOf(gb.Integer), 1)
+
 
 
   gst_version(major, minor, micro, nano)
 
   gst_version(major, minor, micro, nano)
 
   
 
   
  <FONT color=#006400>' ''Passiamo alla dereferenziazione delle variabili di tipo Pointer''
+
  <FONT color=gray>' ''Passiamo alla dereferenziazione delle variabili di tipo Pointer''
 
  ' ''ormai riempiri dalla funzione "gst_version":''</font>
 
  ' ''ormai riempiri dalla funzione "gst_version":''</font>
 
   Print major = "; Int@(major)
 
   Print major = "; Int@(major)
Riga 56: Riga 56:
 
  ''gchar * gst_version_string(void)''
 
  ''gchar * gst_version_string(void)''
 
la quale restituisce un valore stringa che rappresenta una descrizione/denominazione generica di ''GStreamer'' comprensiva dell'attuale versione. In Gambas la dichiareremo così:
 
la quale restituisce un valore stringa che rappresenta una descrizione/denominazione generica di ''GStreamer'' comprensiva dell'attuale versione. In Gambas la dichiareremo così:
  Private Extern gst_version_string()
+
  Private Extern gst_version_string() As String
 
e la richiameremo in routine ad esempio così:
 
e la richiameremo in routine ad esempio così:
  Dim descrizione As String
+
  Dim versione As String
 
   
 
   
 
  versione = gst_version_string()
 
  versione = gst_version_string()
  Print descrizione
+
  Print versione
  
  
==Impostare un ''Elemento'' per la gestione del flusso dei dati==
+
====Il codice completo====
Un ''Elemento'' è la Classe di oggetti più importante in ''GStreamer''. Esso svolge una determinata funzione, ed è utilizzato per gestire il flusso di dati, come ad esempio lettura, decodifica ed invio dei medesimi alla scheda audio. Concatenando più ''Elementi'' (''pipeline'') è possibile sfruttare le loro funzionalità ed ottenere gli obiettivi desiderati (come ad esmepio la riproduzione audio) multimediali.
+
Mostriamo di seguito l'intero codice riunito:
 
+
  Library "libgstreamer-1.0:0.2407.0
Il modo più semplice per creare un ''Elemento'' è utilizzare la funzione:
+
 
''GstElement * gst_element_factory_make(const gchar *factoryname, const gchar *name)
+
<FONT Color=gray>' ''gst_init (int *argc, char **argv[])''
alla quale si passa il nome di un ''Elemento'' fra quelli predisposti da ''GStreamer'' ed una denominazione per l'<I>Elemento</i> appena creato. È possibile passare ''NULL'' come argomento ''name'' per ottenere un unico nome predefinito.
+
' ''Initializes the GStreamer library, setting up internal path lists, registering built-in elements, and loading standard plugins.''</font>
<BR>Detta funzione restituisce una variabile di tipo ''Puntatore'' al nuovo ''Elemento'' creato, che sarà utilizzata per richiamare appunto quell'<I>Elemento</i>.
+
Private Extern gst_init(argc As Pointer, argv As Pointer)
<BR>Il nuovo ''Elemento'' creato con un nome previsto da GStreamer è in grado di gestire solitamente file audio e video, nonché, a seconda dell'<I>Elemento</i> richiamato, altre determinate caratteristiche.
+
<BR>In Gambas dichiareremo la funzione nel seguente modo:
+
<FONT Color=gray>' ''gboolean gst_is_initialized (void)''
  Private Extern gst_element_factory_make(factoryname As String, name As String) As Pointer
+
' ''Check if GStreamer has been initialized.''</font>
e la richiameremo in routine ad esempio così:
+
Private Extern gst_is_initialized() As Boolean
  Private elem As Pointer
+
 +
<FONT Color=gray>' ''void gst_version (guint *major, guint *minor, guint *micro, guint *nano)''
 +
' ''Gets the version number of the GStreamer library.''</font>
 +
Private Extern gst_version(major As Pointer, minor As Pointer, micro As Pointer, nano As Pointer)
 +
 +
<FONT Color=gray>' ''gchar * gst_version_string (void)''
 +
' ''Returns a string that is useful for describing this version of GStreamer.''</font>
 +
  Private Extern gst_version_string() as String
 +
   
 
   
 
   
  Public Sub ......()
+
  Public Sub Main()
 +
 
 +
  Dim inizializzato As Boolean
 +
  Dim major, minor, micro, nano As Pointer
 +
  Dim versione As String
 +
 
 +
  gst_init(0, 0)
 +
 
 +
  inizializzato = gst_is_initialized()
 +
  If inizializzato == False Then Error.Raise("Impossibile inizializzare GStreamer !")
 +
 
 +
  major = Alloc(SizeOf(gb.Integer), 1)
 +
  minor = Alloc(SizeOf(gb.Integer), 1)
 +
  micro = Alloc(SizeOf(gb.Integer), 1)
 +
  nano = Alloc(SizeOf(gb.Integer), 1)
 +
 
 +
  gst_version(major, minor, micro, nano)
 +
 
 +
<FONT Color=gray>' ''Passiamo alla dereferenziazione delle variabili di tipo Pointer ormai riempiti dalla funzione "gst_version()":''</font>
 +
  Print "major = "; Int@(major)
 +
  Print "minor = "; Int@(minor)
 +
  Print "micro = "; Int@(micro)
 +
  Print "nano = "; Int@(nano)
 
   
 
   
  elem = gst_element_factory_make("playbin", "esegui")
+
  <FONT Color=gray>' ''Ora mostriamo il risultato della funzione "gst_version_string()":''</font>
  ......
+
  versione = gst_version_string()
 
+
  Print versione
 
+
 
===Elimnare un ''Elemento''===
+
<FONT Color=gray>' ''Liberiamo la memoria precedentemente allocata:''</font>
Per elimnare un ''Elemento'', precedentemente creato, si utilizza la funzione:
+
  Free(nano)
''void gst_object_unref(gpointer object)''
+
  Free(micro)
alla quale va passata la variabile di tipo ''Pointer'' che punta all'<I>Elemento</i> creato.
+
  Free(minor)
<BR>In Gambas la funzione sarà così dichiarata:
+
  Free(major)
Private Extern gst_object_unref(object As Pointer)
+
 
e la richiameremo in routine ad esempio così:
+
End
gst_object_unref(elem)
 
  
  
Riga 96: Riga 125:
 
=Note=
 
=Note=
 
[1] Come sappiamo, tenendo conto della sua versione, possiamo anche dichiararla così:
 
[1] Come sappiamo, tenendo conto della sua versione, possiamo anche dichiararla così:
  Library "libgstreamer-1.0:0
+
  Library "libgstreamer-1.0
oppure così:
+
oppure in modo più dettagliato:
  Library "libgstreamer-1.0:0.6.0"
+
  Library "libgstreamer-1.0:0.2407.0"
 
 
<FONT color=Red><B>PAGINA IN COSTRUZIONE</b></font>
 

Versione attuale delle 14:22, 2 set 2024

Individuazione e dichiarazione della Libreria .so esterna di GStreamer

Innanzitutto, l'uso delle funzioni esterne del API di GStreamer necessita della dichiarazione della Libreria condivisa .so esterna, dalla quale richiamare le funzioni necessarie.

Facendo uso dell'attuale versione 1.0 di GStreamer, ed avendo verificato nel nostro sistema che la libreria da richiamare è "libgstreamer-1.0.so.0.2405.0 ", dichiareremo la libreria così:

Library "libgstreamer-1.0:0.2407.0"   [nota 1]


Inizializzazione di GStreamer

Il primo passo è quello di inizializzare GStreamer. Tale procedura avverrà mediante l'utilizzo della funzione:

void gst_init(int *argc, char **argv[])

Essa inizializza la libreria GStreamer, la impostazione di liste di percorsi interni, la registrazione di Elementi incorporati, ed il caricamento di plugin standard. In Gambas, dopo aver dichiarato con Extern la predetta funzione in tal modo:

Private Extern gst_init(argc As Pointer, argv As Pointer)

potrà essere utilizzata all'interno di una ruotine. Nel nostro caso più semplice, ossia nel caso non si intenda passare a GStreamer nessun valore d'argomento, i due parametri di tipo Pointer saranno posti ai rispettivi valori di default:

 gst_init(0, 0)


Ottenere informazioni iniziali

E' possibile ottenere subito alcune prime informazioni relativamente all'inizializzazione di GStreamer mediante alcune funzioni.

Verifica della inizializzazione

Utilizzeremo la funzione esterna:

 gboolean gst_is_initialized(void)

la quale restituisce un valore booleano che se è uguale a True significa che GStreamer è stato regolarmente inizializzato. In Gambas la dichiareremo così:

Private Extern gst_is_initialized() As Boolean

e la richiameremo in routine ad esempio così:

Dim inizializzato As Boolean

inizializzato = gst_is_initialized()
If inizializzato = False Then Error.Raise("Impossibile inizializzare GStreamer !")

Ottenere in dettaglio il numero della versione di GStreamer

Utilizzeremo la funzione esterna:

void gst_version(guint *major, guint *minor, guint *micro, guint *nano)

dalla quale, deferenziando successivanete i valori di tipo Pointer precedentemente ad essa passati, è possibile ottenere in dettaglio il numero della versione di GStreamer. In Gambas la dichiareremo così:

Private Extern gst_version(major As Pointer, minor As Pointer, micro As Pointer, nano As Pointer)

e la richiameremo in routine passandole quattro Pointer che puntano ad un'area allocata di memoria sufficiente per riempire un valore intero:

Dim major, minor, micro, nano As Pointer

 major = Alloc(SizeOf(gb.Integer), 1)
 minor = Alloc(SizeOf(gb.Integer), 1)
 micro = Alloc(SizeOf(gb.Integer), 1)
 nano = Alloc(SizeOf(gb.Integer), 1)
 
 gst_version(major, minor, micro, nano)

' Passiamo alla dereferenziazione delle variabili di tipo Pointer
' ormai riempiri dalla funzione "gst_version":
 Print major = "; Int@(major)
 Print minor = "; Int@(minor)
 Print micro = "; Int@(micro)
 Print nano = "; Int@(nano)

Ottenere una descrizione generica di GStreamer

Utilizzeremo la funzione esterna:

gchar * gst_version_string(void)

la quale restituisce un valore stringa che rappresenta una descrizione/denominazione generica di GStreamer comprensiva dell'attuale versione. In Gambas la dichiareremo così:

Private Extern gst_version_string() As String

e la richiameremo in routine ad esempio così:

Dim versione As String

versione = gst_version_string()
Print versione


Il codice completo

Mostriamo di seguito l'intero codice riunito:

 Library "libgstreamer-1.0:0.2407.0
 
' gst_init (int *argc, char **argv[])
' Initializes the GStreamer library, setting up internal path lists, registering built-in elements, and loading standard plugins.
Private Extern gst_init(argc As Pointer, argv As Pointer)

' gboolean gst_is_initialized (void)
' Check if GStreamer has been initialized.
Private Extern gst_is_initialized() As Boolean

' void gst_version (guint *major, guint *minor, guint *micro, guint *nano)
' Gets the version number of the GStreamer library.
Private Extern gst_version(major As Pointer, minor As Pointer, micro As Pointer, nano As Pointer)

' gchar * gst_version_string (void)
' Returns a string that is useful for describing this version of GStreamer.
Private Extern gst_version_string() as String


Public Sub Main()
 
 Dim inizializzato As Boolean
 Dim major, minor, micro, nano As Pointer
 Dim versione As String
  
 gst_init(0, 0)
  
 inizializzato = gst_is_initialized()
 If inizializzato == False Then Error.Raise("Impossibile inizializzare GStreamer !")
 
 major = Alloc(SizeOf(gb.Integer), 1)
 minor = Alloc(SizeOf(gb.Integer), 1)
 micro = Alloc(SizeOf(gb.Integer), 1)
 nano = Alloc(SizeOf(gb.Integer), 1)
  
 gst_version(major, minor, micro, nano)
  
' Passiamo alla dereferenziazione delle variabili di tipo Pointer ormai riempiti dalla funzione "gst_version()":
 Print "major = "; Int@(major)
 Print "minor = "; Int@(minor)
 Print "micro = "; Int@(micro)
 Print "nano = "; Int@(nano)

' Ora mostriamo il risultato della funzione "gst_version_string()":
 versione = gst_version_string()
 Print versione
  
' Liberiamo la memoria precedentemente allocata:
 Free(nano)
 Free(micro)
 Free(minor)
 Free(major)
 
End


Note

[1] Come sappiamo, tenendo conto della sua versione, possiamo anche dichiararla così:

Library "libgstreamer-1.0

oppure in modo più dettagliato:

Library "libgstreamer-1.0:0.2407.0"