Function

CoglTexturenew_from_data

deprecated: 1.18 since: 0.8

Declaration [src]

CoglTexture*
cogl_texture_new_from_data (
  int width,
  int height,
  CoglTextureFlags flags,
  CoglPixelFormat format,
  CoglPixelFormat internal_format,
  int rowstride,
  const uint8_t* data
)

Description [src]

Creates a new CoglTexture based on data residing in memory.

Available since: 0.8

Deprecated since: 1.18

Use specific constructors such as cogl_texture_2d_new_from_data()

Parameters

width

Type: int

Width of texture in pixels.

height

Type: int

Height of texture in pixels.

flags

Type: CoglTextureFlags

Optional flags for the texture, or COGL_TEXTURE_NONE.

format

Type: CoglPixelFormat

The CoglPixelFormat the buffer is stored in in RAM.

internal_format

Type: CoglPixelFormat

The CoglPixelFormat that will be used for storing the buffer on the GPU. If COGL_PIXEL_FORMAT_ANY is given then a premultiplied format similar to the format of the source data will be used. The default blending equations of Cogl expect premultiplied color data; the main use of passing a non-premultiplied format here is if you have non-premultiplied source data and are going to adjust the blend mode (see cogl_material_set_blend()) or use the data for something other than straight blending.

rowstride

Type: int

The memory offset in bytes between the starts of scanlines in data.

data

Type: An array of uint8_t

Pointer the memory region where the source buffer resides.

The data is owned by the caller of the function.

Return value

Type: CoglTexture

A newly created CoglTexture or NULL on failure.

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