Function

Gdkpixbuf_get_from_surface

Declaration [src]

GdkPixbuf*
gdk_pixbuf_get_from_surface (
  cairo_surface_t* surface,
  gint src_x,
  gint src_y,
  gint width,
  gint height
)

Description [src]

Transfers image data from a #cairo_surface_t and converts it to an RGB(A) representation inside a GdkPixbuf. This allows you to efficiently read individual pixels from cairo surfaces. For GdkWindows, use gdk_pixbuf_get_from_window() instead.

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

Parameters

surface cairo_surface_t
 

Surface to copy from.

 The data is owned by the caller of the function.
src_x gint
 

Source X coordinate within surface.

src_y gint
 

Source Y coordinate within surface.

width gint
 

Width in pixels of region to get.

height gint
 

Height in pixels of region to get.

Return value

Returns: GdkPixbuf
 

A newly-created pixbuf with a reference count of 1, or NULL on error.

 The caller of the function takes ownership of the data, and is responsible for freeing it.
 The return value can be NULL.