Class
GdkTexture
Description [src]
abstract class Gdk.Texture : GObject.Object
implements Gdk.Paintable, Gio.Icon, Gio.LoadableIcon {
/* No available fields */
}GdkTexture is the basic element used to refer to pixel data.
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
GdkPixbuf, or from bytes stored in memory, a file, or a
GResource.
The ownership of the pixel data is transferred to the GdkTexture
instance; you can only make a copy of it, via gdk_texture_download().
GdkTexture is an immutable object: That means you cannot change
anything about it other than increasing the reference count via
g_object_ref(), and consequently, it is a threadsafe object.
GDK provides a number of threadsafe texture loading functions:
gdk_texture_new_from_resource(),
gdk_texture_new_from_bytes(),
gdk_texture_new_from_file(),
gdk_texture_new_from_filename(),
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.
Instance methods
gdk_texture_get_format
Gets the memory format most closely associated with the data of the texture.
since: 4.10
Methods inherited from GdkPaintable (9)
gdk_paintable_compute_concrete_size
Compute a concrete size for the GdkPaintable.
gdk_paintable_get_current_image
Gets an immutable paintable for the current contents displayed by paintable.
gdk_paintable_get_flags
Get flags for the paintable.
gdk_paintable_get_intrinsic_aspect_ratio
Gets the preferred aspect ratio the paintable would like to be displayed at.
gdk_paintable_get_intrinsic_height
Gets the preferred height the paintable would like to be displayed at.
gdk_paintable_get_intrinsic_width
Gets the preferred width the paintable would like to be displayed at.
gdk_paintable_invalidate_contents
Called by implementations of GdkPaintable to invalidate their contents.
gdk_paintable_invalidate_size
Called by implementations of GdkPaintable to invalidate their size.
gdk_paintable_snapshot
Snapshots the given paintable with the given width and height.
Methods inherited from GIcon (4)
g_icon_equal
Checks if two icons are equal.
g_icon_hash
Gets a hash for an icon.
g_icon_serialize
Serializes a GIcon into a GVariant. An equivalent GIcon can be retrieved
back by calling g_icon_deserialize() on the returned value.
As serialization will avoid using raw icon data when possible, it only
makes sense to transfer the GVariant between processes on the same machine,
(as opposed to over the network), and within the same file system namespace.
g_icon_to_string
Generates a textual representation of icon that can be used for
serialization such as when passing icon to a different process or
saving it to persistent storage. Use g_icon_new_for_string() to
get icon back from the returned string.
Methods inherited from GLoadableIcon (3)
g_loadable_icon_load
Loads a loadable icon. For the asynchronous version of this function, see g_loadable_icon_load_async().
g_loadable_icon_load_async
Loads an icon asynchronously. To finish this function, see g_loadable_icon_load_finish(). For the synchronous, blocking version of this function, see g_loadable_icon_load().
g_loadable_icon_load_finish
Finishes an asynchronous icon load started in g_loadable_icon_load_async().
Signals
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.
Signals inherited from GdkPaintable (2)
GdkPaintable::invalidate-contents
Emitted when the contents of the paintable change.
GdkPaintable::invalidate-size
Emitted when the intrinsic size of the paintable changes.