Versione delle 23:00, 20 nov 2021

GDK-PixBuf è una libreria grafica per il caricamento e la manipolazione delle immagini.

Alcune sue funzioni ci consentono di ottenere un Puntatore ai dati grezzi dei file immagine, e così di poterli estrarre.

Sarà necessario avere installata nel sistema la libreria: "libgdk_pixbuf-2.0.so.0.4000.0 "

Mostriamo un semplice esempio pratico:

Library "libgdk_pixbuf-2.0:0.4000.0"

' GdkPixbuf * gdk_pixbuf_new_from_file (const char *filename, GError **error)
' Creates a new pixbuf by loading an image from a file.
Private Extern gdk_pixbuf_new_from_file(filename As String, GError As Pointer) As Pointer

' guchar * gdk_pixbuf_get_pixels (const GdkPixbuf *pixbuf)
' Queries a pointer to the pixel data of a pixbuf.
Private Extern gdk_pixbuf_get_pixels(GdkPixbuf As Pointer) As Pointer

' int gdk_pixbuf_get_width (const GdkPixbuf *pixbuf)
' Queries the width of a pixbuf.
Private Extern gdk_pixbuf_get_width(GdkPixbuf As Pointer) As Integer

' int gdk_pixbuf_get_height (const GdkPixbuf *pixbuf)
' Queries the height of a pixbuf.
Private Extern gdk_pixbuf_get_height(GdkPixbuf As Pointer) As Integer

' int gdk_pixbuf_get_n_channels (const GdkPixbuf *pixbuf)
' Queries the number of channels of a pixbuf.
Private Extern gdk_pixbuf_get_n_channels(GdkPixbuf As Pointer) As Integer

' gboolean gdk_pixbuf_get_has_alpha (const GdkPixbuf *pixbuf)
' Queries whether a pixbuf has an alpha channel (opacity information).
Private Extern gdk_pixbuf_get_has_alpha(GdkPixbuf As Pointer) As Boolean

' void g_object_unref (gpointer object)
' Decreases the reference count of object.
Private Extern g_object_unref(gobject As Pointer)


Public Sub Main()

 Dim nomefile As String
 Dim w, h, i, n As Integer
 Dim pixbuf, dati As Pointer
 Dim b As Byte
 Dim bo As Boolean
 Dim st As Stream
 
 nomeFile = "/percorso/del/file/immagine"

 pixbuf = gdk_pixbuf_new_from_file(nomefile, 0)
 If pixbuf == 0 Then Error.Raise("Errore !")
 
 Print "File immagine: "; nomeFile
 w = gdk_pixbuf_get_width(pixbuf)
 Print "Larghezza:     "; w; " pixel"
 h = gdk_pixbuf_get_height(pixbuf)
 Print "Altezza:       "; h; " pixel"
 i = gdk_pixbuf_get_n_channels(pixbuf)
 Print "Canali:        "; i
 bo = gdk_pixbuf_get_has_alpha(pixbuf)
 Print "Canale Alfa:   "; bo

 dati = gdk_pixbuf_get_pixels(pixbuf)
 If dati == 0 Then Error.Raise("Errore !")
 
' Dereferenziamo il Puntatore con i "Memory Stream", e ne leggiamo i valori contenuti (i dati/byte grezzi dei pixel) dell'immagine:
 st = Memory dati For Read
 For n = 0 To (w * h * i) - 1
   Read #st, b
   Print n, Hex(b)
 Next

 st.Close
 g_object_unref(pixbuf)

End

In quest'altro esempio caricata un'immagine, utilizzando le risorse di Gambas, ed infine i dati ottenuti dei pixel saranno riutilizzati ricreando una nuova immagine identica all'immagine originaria:

Library "libgdk_pixbuf-2.0:0.4000.0"

' GdkPixbuf * gdk_pixbuf_new_from_file (const char *filename, GError **error)
' Creates a new pixbuf by loading an image from a file.
Private Extern gdk_pixbuf_new_from_file(filename As String, GError As Pointer) As Pointer
 
' guchar * gdk_pixbuf_get_pixels (const GdkPixbuf *pixbuf)
' Queries a pointer to the pixel data of a pixbuf.
Private Extern gdk_pixbuf_get_pixels(GdkPixbuf As Pointer) As Pointer

' int gdk_pixbuf_get_width (const GdkPixbuf *pixbuf)
' Queries the width of a pixbuf.
Private Extern gdk_pixbuf_get_width(GdkPixbuf As Pointer) As Integer

' int gdk_pixbuf_get_height (const GdkPixbuf *pixbuf)
' Queries the height of a pixbuf.
Private Extern gdk_pixbuf_get_height(GdkPixbuf As Pointer) As Integer

' int gdk_pixbuf_get_n_channels (const GdkPixbuf *pixbuf)
' Queries the number of channels of a pixbuf.
Private Extern gdk_pixbuf_get_n_channels(GdkPixbuf As Pointer) As Integer

' gboolean gdk_pixbuf_get_has_alpha (const GdkPixbuf *pixbuf)
' Queries whether a pixbuf has an alpha channel (opacity information).
Private Extern gdk_pixbuf_get_has_alpha(GdkPixbuf As Pointer) As Boolean

' void g_object_unref (gpointer object)
' Decreases the reference count of object.
Private Extern g_object_unref(gobject As Pointer)


Public Sub Form_Open()
 
 Dim pixbuf, dati As Pointer
 Dim bb As Byte[]
 Dim w, h, i, n As Integer
 Dim b, c As Byte
 Dim bo As Boolean
 Dim st As Stream
 Dim imago As Image
 
' Caricando il file immagine e ri-salvandolo, garantisce che l'immagine sia a 32-bit:
 imago = Image.Load(/percorso/del/file/immagine)
 imago.Save("/tmp/im.png", 100)
' Per sicurezza distrugge l'Oggetto "Image":
 imago = Null
 
 pixbuf = gdk_pixbuf_new_from_file("/tmp/im.png", 0)
 If pixbuf == 0 Then Error.Raise("Errore !")
 
' Ottiene e mostra alcune informazioni sull'immagine caricata:
 w = gdk_pixbuf_get_width(pixbuf)
 Print "Larghezza:   "; w; " pixel"
 h = gdk_pixbuf_get_height(pixbuf)
 Print "Altezza:     "; h; " pixel"
 i = gdk_pixbuf_get_n_channels(pixbuf)
 Print "Canali:      "; i
 bo = gdk_pixbuf_get_has_alpha(pixbuf)
 Print "Canale Alfa: "; bo

 dati = gdk_pixbuf_get_pixels(pixbuf)
 If dati == 0 Then Error.Raise("Impossibile ottenere un 'Puntatore' ai dati dei pixel dell'immagine !")
 
' Carica i dati nel vettore "bb[]" per gestire successivamente i dati grezzi dei pixel:
 st = Memory dati For Read
 With bb = New Byte[w * h * i]
   .Read(st, 0, .count)
 End With
 st.Close
  
' Viene preparata la variabile di tipo Image per la gestione dei dati del futuro nuovo file immagine:
 With imago = New Image(w, h, Color.Transparent, Image.Standard)
   st = Memory .Data For Write
 End With

' Corregge la disomogeneità della posizione dei byte dei colori dei pixel nel formato Immagine standard e in quello di Gambas:
 For n = 0 To bb.Max Step 4
   b = bb[n]
   c = bb[n + 2]
   bb[n] = c
   bb[n + 2] = b
 Next
 
' Scrive i dati presenti nel vettore "bb[]" nella varibile di tipo "Image":
 bb.Write(st, 0, bb.Count)
  
 st.Close
 g_object_unref(pixbuf)
 
 PictureBox1.Image = imago
 imago.Save("/tmp/imago.png", 100)
   
End

Riferimenti

• GDK-PixBuf Reference Manual