gdk-pixbuf-gdk-pixbuf: The GdkPixbuf Structure
Description
Information that describes an image.Methods and Functions
gdkPixbufGetColorspace(object)
gdkPixbufGetNChannels(object)
gdkPixbufGetHasAlpha(object)
gdkPixbufGetBitsPerSample(object)
gdkPixbufGetPixels(object)
gdkPixbufGetWidth(object)
gdkPixbufGetHeight(object)
gdkPixbufGetRowstride(object)
gdkPixbufGetOption(object, key)
gdkPixbuf(width = -1, height = -1, filename, colorspace, has.alpha, bits.per.sample, preserve.aspect.ratio = 1, data, stream, cancellable = NULL, rowstride, .errwarn = TRUE)
Hierarchy
GObject
+----GdkPixbuf
Detailed Description
The GdkPixbuf
structure contains
information that describes an image in memory.Enums and Flags
GdkPixbufError
-
An error code in the
GDK_PIXBUF_ERROR
domain. Many gdk-pixbuf
operations can cause errors in this domain, or in the G_FILE_ERROR
domain.
corrupt-image
- An image file was broken somehow.
insufficient-memory
- Not enough memory.
bad-option-value
- A bad option was passed to a pixbuf save module.
unknown-type
- Unknown image type.
unsupported-operation
- Don't know how to perform the
given operation on the type of image at hand.
failed
- Generic failure code, something went wrong.
GdkColorspace
-
This enumeration defines the color spaces that are supported by
the
gdk-pixbuf
library. Currently only RGB is supported.
GdkPixbufAlphaMode
-
These values can be passed to
gdkPixbufRenderToDrawableAlpha
to control how the alpha
channel of an image should be handled. This function can create a
bilevel clipping mask (black and white) and use it while painting
the image. In the future, when the X Window System gets an alpha
channel extension, it will be possible to do full alpha
compositing onto arbitrary drawables. For now both cases fall
back to a bilevel clipping mask.
bilevel
- A bilevel clipping mask (black and white)
will be created and used to draw the image. Pixels below 0.5 opacity
will be considered fully transparent, and all others will be
considered fully opaque.
full
- For now falls back to
GDK_PIXBUF_ALPHA_BILEVEL
.
In the future it will do full alpha compositing.
Properties
bits-per-sample
[integer : Read / Write / Construct Only]- The number of bits per sample.
Currently only 8 bit per sample are supported.
Allowed values: [1,16] Default value: 8
colorspace
[GdkColorspace
: Read / Write / Construct Only]- The colorspace in which the samples are interpreted. Default value: GDK_COLORSPACE_RGB
has-alpha
[logical : Read / Write / Construct Only]- Whether the pixbuf has an alpha channel. Default value: FALSE
height
[integer : Read / Write / Construct Only]- The number of rows of the pixbuf. Allowed values: >= 1 Default value: 1
n-channels
[integer : Read / Write / Construct Only]- The number of samples per pixel.
Currently, only 3 or 4 samples per pixel are supported.
Allowed values: >= 0 Default value: 3
pixels
[R object : Read / Write / Construct Only]- A pointer to the pixel data of the pixbuf.
rowstride
[integer : Read / Write / Construct Only]- The number of bytes between the start of a row and
the start of the next row. This number must (obviously)
be at least as large as the width of the pixbuf.
Allowed values: >= 1 Default value: 1
width
[integer : Read / Write / Construct Only]- The number of columns of the pixbuf. Allowed values: >= 1 Default value: 1