Memory-managed wrapper type.

Type class for types which can be safely cast to Texture, for instance with toTexture.

Cast to Texture, for types for which this is known to be safe. For general casts, use castTo.

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 FormatArgb32, so every downloaded pixel requires 4 bytes of memory.

Downloading a texture into a Cairo image surface:

c code

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);

For more flexible download capabilites, see [structgdk.TextureDownloader].

Gets the memory format most closely associated with the data of the texture.

Note that it may not be an exact match for texture data stored on the GPU or with compression.

The format can give an indication about the bit depth and opacity of the texture and is useful to determine the best format for downloading the texture.

Since: 4.10

Returns the height of the texture, in pixels.

Returns the width of texture, in pixels.

Creates a new texture object representing the GdkPixbuf.

This function is threadsafe, so that you can e.g. use GTask and taskRunInThread to avoid blocking the main thread while loading a big image.

Creates a new texture by loading an image from memory,

The file format is detected automatically. The supported formats are PNG, JPEG and TIFF, though more formats might be available.

If Nothing is returned, then error will be set.

This function is threadsafe, so that you can e.g. use GTask and taskRunInThread to avoid blocking the main thread while loading a big image.

Since: 4.6

Creates a new texture by loading an image from a file.

The file format is detected automatically. The supported formats are PNG, JPEG and TIFF, though more formats might be available.

If Nothing is returned, then error will be set.

This function is threadsafe, so that you can e.g. use GTask and taskRunInThread to avoid blocking the main thread while loading a big image.

Creates a new texture by loading an image from a file.

The file format is detected automatically. The supported formats are PNG, JPEG and TIFF, though more formats might be available.

If Nothing is returned, then error will be set.

This function is threadsafe, so that you can e.g. use GTask and taskRunInThread to avoid blocking the main thread while loading a big image.

Since: 4.6

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 resourcePath 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 textureNewFromFile to load it.

This function is threadsafe, so that you can e.g. use GTask and taskRunInThread to avoid blocking the main thread while loading a big image.

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 File or other location, you might want to use textureSaveToPngBytes or look into the gdk-pixbuf library.

Store the given texture in memory as a PNG file.

Use textureNewFromBytes to read it back.

If you want to serialize a texture, this is a convenient and portable way to do that.

If you need more control over the generated image, such as attaching metadata, you should look into an image handling library such as the gdk-pixbuf library.

If you are dealing with high dynamic range float data, you might also want to consider textureSaveToTiffBytes instead.

Since: 4.6

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

GTK will attempt to store data without loss.

Since: 4.6

Store the given texture in memory as a TIFF file.

Use textureNewFromBytes to read it back.

This function is intended to store a representation of the texture's data that is as accurate as possible. This is particularly relevant when working with high dynamic range images and floating-point texture data.

If that is not your concern and you are interested in a smaller size and a more portable format, you might want to use textureSaveToPngBytes.

Since: 4.6

Construct a GValueConstruct with valid value for the “height” property. This is rarely needed directly, but it is used by new.

Get the value of the “height” property. When overloading is enabled, this is equivalent to

get texture #height

Construct a GValueConstruct with valid value for the “width” property. This is rarely needed directly, but it is used by new.

Get the value of the “width” property. When overloading is enabled, this is equivalent to

get texture #width