gdk_texture_new_for_pixbuf ()

GdkTexture *
gdk_texture_new_for_pixbuf (GdkPixbuf *pixbuf);

Creates a new texture object representing the GdkPixbuf.

gdk_texture_new_from_resource ()

GdkTexture *
gdk_texture_new_from_resource (const char *resource_path);

Creates a new texture by loading an image from a resource. The file format is detected automatically. The supported formats are PNG and JPEG, though more formats might be available.

It is a fatal error if resource_path does not specify a valid image resource and the program will abort if that happens. If you are unsure about the validity of a resource, use gdk_texture_new_from_file() to load it.

gdk_texture_new_from_file ()

GdkTexture *
gdk_texture_new_from_file (GFile *file,
                           GError **error);

Creates a new texture by loading an image from a file. The file format is detected automatically. The supported formats are PNG and JPEG, though more formats might be available.

If NULL is returned, then error will be set.

gdk_texture_get_width ()

int
gdk_texture_get_width (GdkTexture *texture);

Returns the width of texture , in pixels.

gdk_texture_get_height ()

int
gdk_texture_get_height (GdkTexture *texture);

Returns the height of the texture , in pixels.

gdk_texture_download ()

void
gdk_texture_download (GdkTexture *texture,
                      guchar *data,
                      gsize stride);

Downloads the texture into local memory. This may be an expensive operation, as the actual texture data may reside on a GPU or on a remote display server.

The data format of the downloaded data is equivalent to CAIRO_FORMAT_ARGB32, so every downloaded pixel requires 4 bytes of memory.

Downloading a texture into a Cairo image surface:

1
2
3
4
5
6
7

surface = cairo_image_surface_create (CAIRO_FORMAT_ARGB32,
                                      gdk_texture_get_width (texture),
                                      gdk_texture_get_height (texture));
gdk_texture_download (texture,
                      cairo_image_surface_get_data (surface),
                      cairo_image_surface_get_stride (surface));
cairo_surface_mark_dirty (surface);

gdk_texture_save_to_png ()

gboolean
gdk_texture_save_to_png (GdkTexture *texture,
                         const char *filename);

Store the given texture to the filename as a PNG file.

This is a utility function intended for debugging and testing. If you want more control over formats, proper error handling or want to store to a GFile or other location, you might want to look into using the gdk-pixbuf library.

gdk_memory_texture_new ()

GdkTexture *
gdk_memory_texture_new (int width,
                        int height,
                        GdkMemoryFormat format,
                        GBytes *bytes,
                        gsize stride);

Creates a new texture for a blob of image data. The GBytes must contain stride x height pixels in the given format.

gdk_gl_texture_new ()

GdkTexture *
gdk_gl_texture_new (GdkGLContext *context,
                    guint id,
                    int width,
                    int height,
                    GDestroyNotify destroy,
                    gpointer data);

Creates a new texture for an existing GL texture.

Note that the GL texture must not be modified until destroy is called, which will happen when the GdkTexture object is finalized, or due to an explicit call of gdk_gl_texture_release().

gdk_gl_texture_release ()

void
gdk_gl_texture_release (GdkGLTexture *self);

Releases the GL resources held by a GdkGLTexture that was created with gdk_gl_texture_new().

The texture contents are still available via the gdk_texture_download() function, after this function has been called.

GdkTexture

typedef struct _GdkTexture GdkTexture;

The GdkTexture structure contains only private data.

GdkMemoryTexture

typedef struct _GdkMemoryTexture GdkMemoryTexture;

A GdkTexture representing image data in memory.

GdkGLTexture

typedef struct _GdkGLTexture GdkGLTexture;

A GdkTexture representing a GL texture object.

enum GdkMemoryFormat

GdkMemoryFormat describes a format that bytes can have in memory.

It describes formats by listing the contents of the memory passed to it. So GDK_MEMORY_A8R8G8B8 will be 1 byte (8 bits) of alpha, followed by a byte each of red, green and blue. It is not endian-dependent, so CAIRO_FORMAT_ARGB32 is represented by different GdkMemoryFormats on architectures with different endiannesses.

Its naming is modelled after VkFormat (see https://www.khronos.org/registry/vulkan/specs/1.0/html/vkspec.htmlVkFormat for details).

GDK_MEMORY_DEFAULT

#define GDK_MEMORY_DEFAULT GDK_MEMORY_B8G8R8A8_PREMULTIPLIED

This is the default memory format used by GTK and is the format provided by gdk_texture_download(). It is equal to CAIRO_FORMAT_ARGB32.

Be aware that unlike the GdkMemoryFormat values, this format is different for different endianness.

The “height” property

  “height”                   int

The height of the texture, in pixels.

Owner: GdkTexture

Flags: Read / Write / Construct Only

Allowed values: >= 1

Default value: 1

The “width” property

  “width”                    int

The width of the texture, in pixels.

Owner: GdkTexture

Flags: Read / Write / Construct Only

Allowed values: >= 1

Default value: 1