Flags which allow a module to specify further details about the supported operations. GDK_PIXBUF_FORMAT_WRITABLE the module can write out images in the format. GDK_PIXBUF_FORMAT_SCALABLE the image format is scalable GDK_PIXBUF_FORMAT_THREADSAFE the module is threadsafe. If this flag is not set, gdk-pixbuf; will use a lock to prevent multiple threads from using this module at the same time. (Since 2.6) Since 2.2
An enumeration which is used by gdk_pixdata_to_csource() to determine the form of C source to be generated. The three values GDK_PIXDATA_DUMP_PIXDATA_STREAM, GDK_PIXDATA_DUMP_PIXDATA_STRUCT and GDK_PIXDATA_DUMP_MACROS are mutually exclusive, as are GDK_PIXBUF_DUMP_GTYPES and GDK_PIXBUF_DUMP_CTYPES. The remaining elements are optional flags that can be freely added. GDK_PIXDATA_DUMP_PIXDATA_STREAM Generate pixbuf data stream (a single string containing a serialized GdkPixdata structure in network byte order). GDK_PIXDATA_DUMP_PIXDATA_STRUCT Generate GdkPixdata structure (needs the GdkPixdata structure definition from gdk-pixdata.h). GDK_PIXDATA_DUMP_MACROS Generate *_ROWSTRIDE, *_WIDTH, *_HEIGHT, *_BYTES_PER_PIXEL and *_RLE_PIXEL_DATA or *_PIXEL_DATA macro definitions for the image. GDK_PIXDATA_DUMP_GTYPES Generate GLib data types instead of standard C data types. GDK_PIXDATA_DUMP_CTYPES Generate standard C data types instead of GLib data types. GDK_PIXDATA_DUMP_STATIC Generate static symbols. GDK_PIXDATA_DUMP_CONST Generate const symbols. GDK_PIXDATA_DUMP_RLE_DECODER Provide a *_RUN_LENGTH_DECODE(image_buf, rle_data, size, bpp) macro definition to decode run-length encoded image data.
An enumeration containing three sets of flags for a GdkPixdata struct: one for the used colorspace, one for the width of the samples and one for the encoding of the pixel data. GDK_PIXDATA_COLOR_TYPE_RGB each pixel has red, green and blue samples. GDK_PIXDATA_COLOR_TYPE_RGBA each pixel has red, green and blue samples and an alpha value. GDK_PIXDATA_COLOR_TYPE_MASK mask for the colortype flags of the enum. GDK_PIXDATA_SAMPLE_WIDTH_8 each sample has 8 bits. GDK_PIXDATA_SAMPLE_WIDTH_MASK mask for the sample width flags of the enum. GDK_PIXDATA_ENCODING_RAW the pixel data is in raw form. GDK_PIXDATA_ENCODING_RLE the pixel data is run-length encoded. Runs may be up to 127 bytes long; their length is stored in a single byte preceding the pixel data for the run. If a run is constant, its length byte has the high bit set and the pixel data consists of a single pixel which must be repeated. GDK_PIXDATA_ENCODING_MASK mask for the encoding flags of the enum.
Main Gtk struct. An opaque struct representing an animation.
Modules supporting animations must derive a type from GdkPixbufAnimation, providing suitable implementations of the virtual functions. GObjectClass parent_class; the parent class is_static_image () returns whether the given animation is just a static image. get_static_image () returns a static image representing the given animation. get_size () fills width and height with the frame size of the animation. get_iter () returns an iterator for the given animation.
An opaque struct representing an iterator which points to a certain position in an animation.
Modules supporting animations must derive a type from GdkPixbufAnimationIter, providing suitable implementations of the virtual functions. GObjectClass parent_class; the parent class get_delay_time () returns the time in milliseconds that the current frame should be shown. get_pixbuf () returns the current frame. on_currently_loading_frame () returns whether the current frame of iter is being loaded. advance () advances the iterator to current_time, possibly changing the current frame.
Main Gtk struct. A GdkPixbufFormat contains information about the image format accepted by a module. Only modules should access the fields directly, applications should use the gdk_pixbuf_format_* functions. gchar *name; the name of the image format. GdkPixbufModulePattern *signature; the signature of the module. gchar *domain; the message domain for the description. gchar *description; a description of the image format. gchar **mime_types; a NULL-terminated array of MIME types for the image format. gchar **extensions; a NULL-terminated array of typical filename extensions for the image format. guint32 flags; a combination of GdkPixbufFormatFlags. gboolean disabled; a boolean determining whether the loader is disabled. gchar *license; a string containing license information, typically set to shorthands like "GPL", "LGPL", etc. Since 2.2
Main Gtk struct. The GdkPixbufLoader struct contains only private fields.
A GdkPixbufModule contains the necessary functions to load and save images in a certain file format. A GdkPixbufModule can be loaded dynamically from a GModule. Each loadable module must contain a GdkPixbufModuleFillVtableFunc function named fill_vtable, which will get called when the module is loaded and must set the function pointers of the GdkPixbufModule. char *module_name; the name of the module, usually the same as the usual file extension for images of this type, eg. "xpm", "jpeg" or "png". char *module_path; the path from which the module is loaded. GModule *module; the loaded GModule. GdkPixbufFormat *info; a GdkPixbufFormat holding information about the module. load () loads an image from a file. load_xpm_data () loads an image from data in memory. begin_load () begins an incremental load. stop_load () stops an incremental load. load_increment () continues an incremental load. load_animation () loads an animation from a file. save () saves a GdkPixbuf to a file. save_to_callback () saves a GdkPixbuf by calling the given GdkPixbufSaveFunc.
The signature of a module is a set of prefixes. Prefixes are encoded as pairs of ordinary strings, where the second string, called the mask, if not NULL, must be of the same length as the first one and may contain ' ', '!', 'x', 'z', and 'n' to indicate bytes that must be matched, not matched, "don't-care"-bytes, zeros and non-zeros. Each prefix has an associated integer that describes the relevance of the prefix, with 0 meaning a mismatch and 100 a "perfect match". Starting with gdk-pixbuf; 2.8, the first byte of the mask may be '*', indicating an unanchored pattern that matches not only at the beginning, but also in the middle. Versions prior to 2.8 will interpret the '*' like an 'x'. The signature of a module is stored as an array of GdkPixbufModulePatterns. The array is terminated by a pattern where the prefix is NULL. char *prefix; the prefix for this pattern char *mask; mask containing bytes which modify how the prefix is matched against test data int relevance; relevance of this pattern Since 2.2
An opaque struct representing a simple animation.
Main Gtk struct. A GdkPixdata contains pixbuf information in a form suitable for serialization and streaming. guint32 magic; magic number. A valid GdkPixdata structure must have GDK_PIXBUF_MAGIC_NUMBER here. gint32 length; less than 1 to disable length checks, otherwise GDK_PIXDATA_HEADER_LENGTH + length of pixel_data. guint32 pixdata_type; information about colorspace, sample width and encoding, in a GdkPixdataType. guint32 rowstride; Distance in bytes between rows. guint32 width; Width of the image in pixels. guint32 height; Height of the image in pixels. guint8 *pixel_data; width x height pixels, encoded according to pixdata_type and rowstride.