Visualizza wikitesto di Ottenere la forma d'onda di un file audio usando una linea di pipeline con la funzione 'gst parse launch()'

La funzione esterna ''gst_parse_launch()'' della libreria ''GStreamer'' consente di costruire e gestire in modo semplice una pipeline ''GStreamer''. La riga della pipeline gestita dalla funzione esterna ''gst_parse_launch()'' è un insieme di elementi separati da punti esclamativi (!). Le proprietà possono essere aggiunte agli elementi, sotto forma di: ''proprietà = valore''.

Sarà necessario avere installata nel sistema e richiamare nell'applicazione Gambas la libreria condivisa: "''libgstreamer-1.0'' ".

La creazione della forma d'onda dell'audio è gestita dal plugin "''wavescope''" all'interno della riga della ''pipeline'' della funzione ''gst_parse_launch()''.

Va precisato che il valore del dettaglio ''framerate'' è composto da una frazione il cui denominatore rappresenta i secondi di durata rappresentati nella/dalla forma d'onda. Pertanto se si vuole ottenere la forma d'onda dell'intero file audio, la frazione da assegnare sarà: ''1/durata_del_file_audio_in_secondi''.


==Ottenere la forma d'onda di file audio di formato ''WAV'', ''MP3'', ''OGG'' e ''FLAC''==
Mostriamo un esempio pratico per ottenere la forma d'onda di file audio di formato ''WAV'', ''MP3'' ed ''OGG'':
 Library "libgstreamer-1.0"
 
 Private Enum GST_STATE_VOID_PENDING = 0, GST_STATE_NULL, GST_STATE_READY, GST_STATE_PAUSED, GST_STATE_PLAYING
  
 <FONT Color=gray>' ''gst_init (int *argc, char **argv[])''
 ' ''Initializes the GStreamer library, setting up internal path lists, registering built-in elements, and loading standard plugins.''</font>
 Private Extern gst_init(argc As Pointer, argv As Pointer)
 
 <FONT Color=gray>' ''GstElement * gst_parse_launch (const gchar *pipeline_description, GError **error)''
 ' ''Create a new pipeline based on command line syntax.''</font>
 Private Extern gst_parse_launch(description As String, GError As Pointer) As Pointer
 
 <FONT Color=gray>' ''GstStateChangeReturn gst_element_set_state(GstElement *element, GstState state)''
 ' ''Sets the state of the element.''</font>
 Private Extern gst_element_set_state(gstelement As Pointer, state As Integer) As Integer
  
 <FONT Color=gray>' ''void gst_object_unref(gpointer object)''
 ' ''Decrements the reference count on object.''</font>
 Private Extern gst_object_unref(gobject As Pointer)
 
 
 Public Sub Main()
  
  Dim audio As Pointer
      
  gst_init(0, 0)
   
  audio = gst_parse_launch("uridecodebin uri=file://<FONT Color=darkgreen>''/percorso/del/file/audio''</font> ! audioconvert ! wavescope ! video/x-raw, width=2000, framerate=1/<FONT Color=#B22222>durata_del_file_audio_in_secondi</font> ! " & 
   "jpegenc quality=20 ! filesink location=/tmp/waveform.jpg", 0)
           
 <FONT Color=gray>' ''Avviamo la creazione del file .jpg con la forma d'onda del file audio:''</font>
  gst_element_set_state(audio, GST_STATE_PLAYING)
   
  wait 1
   
  gst_object_unref(audio)
          
 End



=Riferimenti=
* http://docs.gstreamer.com/display/GstSDK/gst-launch
* https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-bad-plugins/html/gst-plugins-bad-plugins-wavescope.html
* http://gstreamer.freedesktop.org/
* http://gstreamer.com/