Constructor

CdkPixbufPixbufnew_from_data

Declaration [src]

CdkPixbuf*
cdk_pixbuf_new_from_data (
  const guchar* data,
  CdkColorspace colorspace,
  gboolean has_alpha,
  int bits_per_sample,
  int width,
  int height,
  int rowstride,
  CdkPixbufDestroyNotify destroy_fn,
  gpointer destroy_fn_data
)

Description [src]

Creates a new CdkPixbuf out of in-memory image data.

Currently only RGB images with 8 bits per sample are supported.

Since you are providing a pre-allocated pixel buffer, you must also specify a way to free that data. This is done with a function of type CdkPixbufDestroyNotify. When a pixbuf created with is finalized, your destroy notification function will be called, and it is its responsibility to free the pixel array.

See also: cdk_pixbuf_new_from_bytes().

Parameters

data

Type: An array of guchar

Image data in 8-bit/sample packed format.

The data is owned by the caller of the function.
colorspace

Type: CdkColorspace

Colorspace for the image data.

has_alpha

Type: gboolean

Whether the data has an opacity channel.

bits_per_sample

Type: int

Number of bits per sample.

width

Type: int

Width of the image in pixels, must be > 0.

height

Type: int

Height of the image in pixels, must be > 0.

rowstride

Type: int

Distance in bytes between row starts.

destroy_fn

Type: CdkPixbufDestroyNotify

Function used to free the data when the pixbuf’s reference count drops to zero, or NULL if the data should not be freed.

The argument can be NULL.
destroy_fn_data

Type: gpointer

Closure data to pass to the destroy notification function.

The argument can be NULL.
The data is owned by the caller of the function.

Return value

Type: CdkPixbuf

A newly-created pixbuf.

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