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

Type: cairo_surface_t

Surface to copy from.

The data is owned by the caller of the function.

src_x

Type: gint

Source X coordinate within surface.

src_y

Type: gint

Source Y coordinate within surface.

width

Type: gint

Width in pixels of region to get.

height

Type: gint

Height in pixels of region to get.

Return value

Type: 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.