Pixbuf

Object Hierarchy:

Description:

public class Pixbuf : Object, Icon

This is the main structure in the &gdk-pixbuf; library.

It is used to represent images. It contains information about the image's pixel data, its color space, bits per sample, width and height, and the rowstride (the number of bytes between the start of one row and the start of the next).

Namespace: Gdk

Package: gdk-pixbuf-2.0

Content:

Properties:

Static methods:

public static Pixbuf from_pixdata (Pixdata pixdata, bool copy_pixels = true) throws Error
Converts a Pixdata to a Pixbuf.
public static unowned PixbufFormat get_file_info (string filename, out int width, out int height)
Parses an image file far enough to determine its format and size.
public static SList<unowned PixbufFormat> get_formats ()
Obtains the available information about the image formats supported by GdkPixbuf.
public static async Pixbuf new_from_stream_async (InputStream stream, Cancellable? cancellable = null) throws Error
Creates a new pixbuf by asynchronously loading an image from an input stream.
public static async Pixbuf new_from_stream_at_scale_async (InputStream stream, int width, int height, bool preserve_aspect_ratio, Cancellable? cancellable = null) throws Error
Creates a new pixbuf by asynchronously loading an image from an input stream.

Creation methods:

public Pixbuf (Colorspace colorspace, bool has_alpha, int bits_per_sample, int width, int height)
Creates a new Pixbuf structure and allocates a buffer for it.
public Pixbuf.from_data (owned uint8[] data, Colorspace colorspace, bool has_alpha, int bits_per_sample, int width, int height, int rowstride, PixbufDestroyNotify? destroy_fn = free)
public Pixbuf.from_file (string filename) throws Error
Creates a new pixbuf by loading an image from a file.
public Pixbuf.from_file_at_scale (string filename, int width, int height, bool preserve_aspect_ratio) throws Error
Creates a new pixbuf by loading an image from a file.
public Pixbuf.from_file_at_size (string filename, int width, int height) throws Error
Creates a new pixbuf by loading an image from a file.
public Pixbuf.from_inline (uint8[] data, bool copy_pixels = true) throws Error
Create a Pixbuf from a flat representation that is suitable for storing as inline data in a program.
public Pixbuf.from_resource (string resource_path) throws Error
Creates a new pixbuf by loading an image from an resource.
public Pixbuf.from_resource_at_scale (string resource_path, int width, int height, bool preserve_aspect_ratio) throws Error
Creates a new pixbuf by loading an image from an resource.
public Pixbuf.from_stream (InputStream stream, Cancellable? cancellable = null) throws Error
Creates a new pixbuf by loading an image from an input stream.
public Pixbuf.from_stream_async (InputStream stream, Cancellable? cancellable) throws Error
public Pixbuf.from_stream_at_scale (InputStream stream, int width, int height, bool preserve_aspect_ratio, Cancellable? cancellable = null) throws Error
Creates a new pixbuf by loading an image from an input stream.
public Pixbuf.from_stream_at_scale_async (InputStream stream, int width, int height, bool preserve_aspect_ratio, Cancellable? cancellable = null) throws Error
public Pixbuf.from_xpm_data (string[] data)
Creates a new pixbuf by parsing XPM data in memory.
public Pixbuf.subpixbuf (Pixbuf src_pixbuf, int src_x, int src_y, int width, int height)
Creates a new pixbuf which represents a sub-region of src_pixbuf.
public Pixbuf.with_unowned_data (uint8[] data, Colorspace colorspace, bool has_alpha, int bits_per_sample, int width, int height, int rowstride, PixbufDestroyNotify? destroy_fn = null)
Creates a new Pixbuf out of in-memory image data.

Methods:

public Pixbuf add_alpha (bool substitute_color, uint8 r, uint8 g, uint8 b)
Takes an existing pixbuf and adds an alpha channel to it.
public Pixbuf apply_embedded_orientation ()
Takes an existing pixbuf and checks for the presence of an associated "orientation" option, which may be provided by the jpeg loader (which reads the exif orientation tag) or the tiff loader (which reads the tiff orientation tag, and compensates it for the partial transforms performed by libtiff).
public void composite (Pixbuf dest, int dest_x, int dest_y, int dest_width, int dest_height, double offset_x, double offset_y, double scale_x, double scale_y, InterpType interp_type, int overall_alpha)
Creates a transformation of the source image src by scaling by scale_x and scale_y then translating by offset_x and offset_y.
public void composite_color (Pixbuf dest, int dest_x, int dest_y, int dest_width, int dest_height, double offset_x, double offset_y, double scale_x, double scale_y, InterpType interp_type, int overall_alpha, int check_x, int check_y, int check_size, uint32 color1, uint32 color2)
Creates a transformation of the source image src by scaling by scale_x and scale_y then translating by offset_x and offset_y, then composites the rectangle (dest_x ,dest_y, dest_width, dest_height) of the resulting image with a checkboard of the colors color1 and color2 and renders it onto the destination image.
public Pixbuf? composite_color_simple (int dest_width, int dest_height, InterpType interp_type, int overall_alpha, int check_size, uint32 color1, uint32 color2)
Creates a new Pixbuf by scaling src to dest_width x dest_height and compositing the result with a checkboard of colors color1 and color2.
public Pixbuf copy ()
Creates a new Pixbuf with a copy of the information in the specified pixbuf.
public void copy_area (int src_x, int src_y, int width, int height, Pixbuf dest_pixbuf, int dest_x, int dest_y)
Copies a rectangular area from src_pixbuf to dest_pixbuf.
public void fill (uint32 pixel)
Clears a pixbuf to the given RGBA value, converting the RGBA value into the pixbuf's pixel format.
public Pixbuf? flip (bool horizontal)
Flips a pixbuf horizontally or vertically and returns the result in a new pixbuf.
public int get_bits_per_sample ()
Queries the number of bits per color sample in a pixbuf.
public size_t get_byte_length ()
Returns the length of the pixel data, in bytes.
public Colorspace get_colorspace ()
Queries the color space of a pixbuf.
public bool get_has_alpha ()
Queries whether a pixbuf has an alpha channel (opacity information).
public int get_height ()
Queries the height of a pixbuf.
public int get_n_channels ()
Queries the number of channels of a pixbuf.
public unowned string get_option (string key)
Looks up key in the list of options that may have been attached to the pixbuf when it was loaded, or that may have been attached by another function using gdk_pixbuf_set_option.
public weak uint8[] get_pixels ()
Queries a pointer to the pixel data of a pixbuf.
public weak uint8[] get_pixels_with_length ()
Queries a pointer to the pixel data of a pixbuf.
public int get_rowstride ()
Queries the rowstride of a pixbuf, which is the number of bytes between the start of a row and the start of the next row.
public int get_width ()
Queries the width of a pixbuf.
public Pixbuf rotate_simple (PixbufRotation angle)
Rotates a pixbuf by a multiple of 90 degrees, and returns the result in a new pixbuf.
public void saturate_and_pixelate (Pixbuf dest, float saturation, bool pixelate)
Modifies saturation and optionally pixelates src, placing the result in dest.
public bool save (string filename, string type, ...) throws Error
Saves pixbuf to a file in format type.
public bool save_to_buffer (out uint8[] buffer, string type, ...) throws Error
Saves pixbuf to a new buffer in format type, which is currently "jpeg", "png", "tiff", "ico" or "bmp".
public bool save_to_bufferv (out uint8[] buffer, string type, string[] option_keys, string[] option_values) throws Error
Saves pixbuf to a new buffer in format type, which is currently "jpeg", "tiff", "png", "ico" or "bmp".
public bool save_to_callback (PixbufSaveFunc save_func, string type, ...) throws Error
Saves pixbuf in format type by feeding the produced data to a callback.
public bool save_to_callbackv (PixbufSaveFunc save_func, string type, string[] option_keys, string[] option_values) throws Error
Saves pixbuf to a callback in format type, which is currently "jpeg", "png", "tiff", "ico" or "bmp".
public bool save_to_stream (OutputStream stream, string type, Cancellable? cancellable = null) throws Error
Saves pixbuf to an output stream.
public async bool save_to_stream_async (OutputStream stream, string type, Cancellable? cancellable = null) throws Error
Saves pixbuf to an output stream asynchronously.
public bool savev (string filename, string type, string[] option_keys, string[] option_values) throws Error
Saves pixbuf to a file in type, which is currently "jpeg", "png", "tiff", "ico" or "bmp".
public void scale (Pixbuf dest, int dest_x, int dest_y, int dest_width, int dest_height, double offset_x, double offset_y, double scale_x, double scale_y, InterpType interp_type)
Creates a transformation of the source image src by scaling by scale_x and scale_y then translating by offset_x and offset_y, then renders the rectangle (dest_x, dest_y, dest_width, dest_height) of the resulting image onto the destination image replacing the previous contents.
public Pixbuf scale_simple (int dest_width, int dest_height, InterpType interp_type)
Create a new Pixbuf containing a copy of src scaled to dest_width x dest_height.

Inherited Members:

All known members inherited from class GLib.Object

All known members inherited from interface GLib.Icon