Method

ClutterStageread_pixels

Declaration [src]

guchar*
clutter_stage_read_pixels (
  ClutterStage* stage,
  gint x,
  gint y,
  gint width,
  gint height
)

Description [src]

Makes a screenshot of the stage in RGBA 8bit data, returns a linear buffer with width * 4 as rowstride.

The alpha data contained in the returned buffer is driver-dependent, and not guaranteed to hold any sensible value.

Parameters

x gint
 

X coordinate of the first pixel that is read from stage.

y gint
 

Y coordinate of the first pixel that is read from stage.

width gint
 

Width dimension of pixels to be read, or -1 for the entire stage width.

height gint
 

Height dimension of pixels to be read, or -1 for the entire stage height.

Return value

Returns: An array of guchar
 

A pointer to newly allocated memory with the buffer or NULL if the read failed. Use g_free() on the returned data to release the resources it has allocated.

 The caller of the method takes ownership of the data, and is responsible for freeing it.