Decoding images with GDK-PixBuf¶
method can decode PNG images and provide a cairo surface,
but what about other image formats?
cairocffi.pixbuf module uses GDK-PixBuf
to decode JPEG, GIF, and various other formats (depending on what is installed.)
If you don’t import this module,
it is possible to use the rest of cairocffi without having GDK-PixBuf installed.
GDK-PixBuf is an independent package since version 2.22,
but before that was part of GTK+.
This module also converts pixel data
since the internal format in GDK-PixBuf (big-endian RGBA)
is not the same as in cairo (native-endian ARGB).
For this reason, although it is a “toy” API,
can be faster than
if the format is known to be PNG.
The pixel conversion is done by GTK+ if available,
but a (slower) fallback method is used otherwise.
PixBuf returned an error when loading an image.
The image data is probably corrupted.
decode_to_image_surface(image_data, width=None, height=None)¶
Decode an image from memory into a cairo surface. The file format is detected automatically.
- image_data – A byte string
- width – Integer width in pixels or None
- height – Integer height in pixels or None
A tuple of a new
ImageSurfaceobject and the name of the detected image format.
ImageLoadingErrorif the image data is invalid or in an unsupported format.