Package: gdk

Function gdk:pixbuf-from-surface

Lambda List

gdk:pixbuf-from-surface (surface xsrc ysrc width height)

Arguments

surface -- a cairo:surface-t instance to copy from
xsrc -- an integer with the source x coordinate within surface
ysrc -- an integer with the source y coordinate within surface
width -- an integer with the width in pixels of region to get
height -- an integer with the height in pixels of region to get

Return Value

The newly created gdk-pixbuf:pixbuf object, or nil on error.

Details

Transfers image data from a cairo:surface-t instance and converts it to an RGB(A) representation inside a gdk-pixbuf:pixbuf object. This allows you to efficiently read individual pixels from Cairo surfaces.

This function will create an RGB pixbuf with 8 bits per channel. The pixbuf will contain an alpha channel if the surface contains one.

Warning

This function is deprecated since 4.12. Use the gdk:texture class and subclasses instead of Cairo surfaces and pixbufs.
 

See also

2024-7-16