Texture

Object Hierarchy:

Description:

[ CCode ( type_id = "gdk_texture_get_type ()" ) ]
public abstract class Texture : Object, Paintable, Icon, LoadableIcon

Refers to pixel data in various forms.

It is primarily meant for pixel data that will not change over multiple frames, and will be used for a long time.

There are various ways to create `GdkTexture` objects from a [class@GdkPixbuf.Pixbuf], or from bytes stored in memory, a file, or a [ struct@Gio.Resource].

The ownership of the pixel data is transferred to the `GdkTexture` instance; you can only make a copy of it, via [method@Gdk.Texture.download].

`GdkTexture` is an immutable object: That means you cannot change anything about it other than increasing the reference count via [ method@GObject.Object.ref], and consequently, it is a threadsafe object.

GDK provides a number of threadsafe texture loading functions: [ctor@Gdk.Texture.new_from_resource], [ctor@Gdk.Texture.new_from_bytes], [ ctor@Gdk.Texture.new_from_file], [ctor@Gdk.Texture.new_from_filename], [ctor@Gdk.Texture.new_for_pixbuf]. Note that these are meant for loading icons and resources that are shipped with the toolkit or application. It is recommended that you use a dedicated image loading framework such as glycin, if you need to load untrusted image data.

All known sub-classes:

DmabufTexture

GLTexture

MemoryTexture

Namespace: Gdk

Package: gtk4

Content:

Properties:

public int height { get; construct; }
The height of the texture, in pixels.
public int width { get; construct; }
The width of the texture, in pixels.

Static methods:

public static Texture for_pixbuf (Pixbuf pixbuf)
Creates a new texture object representing the `GdkPixbuf`.
public static Texture from_bytes (Bytes bytes) throws Error
Creates a new texture by loading an image from memory,
public static Texture from_file (File file) throws Error
Creates a new texture by loading an image from a file.
public static Texture from_filename (string path) throws Error
Creates a new texture by loading an image from a file.
public static Texture from_resource (string resource_path)
Creates a new texture by loading an image from a resource.

Creation methods:

protected Texture ()

Methods:

public void download (uint8[] data, size_t stride)
Downloads the this into local memory.
public MemoryFormat get_format ()
Gets the memory format most closely associated with the data of the texture.
public int get_height ()
Returns the height of the this, in pixels.
public int get_width ()
Returns the width of this, in pixels.
public bool save_to_png (string filename)
Store the given this to the filename as a PNG file.
public Bytes save_to_png_bytes ()
Store the given this in memory as a PNG file.
public bool save_to_tiff (string filename)
Store the given this to the filename as a TIFF file.
public Bytes save_to_tiff_bytes ()
Store the given this in memory as a TIFF file.

Inherited Members:

All known members inherited from class GLib.Object

All known members inherited from interface Gdk.Paintable

All known members inherited from interface GLib.Icon

All known members inherited from interface GLib.LoadableIcon

load

load_async