cogl_texture_new_with_size ()

CoglTexture *
cogl_texture_new_with_size (unsigned int width,
                            unsigned int height,
                            CoglTextureFlags flags,
                            CoglPixelFormat internal_format);

Creates a new CoglTexture with the specified dimensions and pixel format.

Since: 0.8

cogl_texture_new_from_file ()

CoglTexture *
cogl_texture_new_from_file (const char *filename,
                            CoglTextureFlags flags,
                            CoglPixelFormat internal_format,
                            CoglError **error);

Creates a CoglTexture from an image file.

Since: 0.8

cogl_texture_new_from_data ()

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

Creates a new CoglTexture based on data residing in memory.

Since: 0.8

cogl_texture_new_from_foreign ()

CoglTexture *
cogl_texture_new_from_foreign (unsigned int gl_handle,
                               unsigned int gl_target,
                               unsigned int width,
                               unsigned int height,
                               unsigned int x_pot_waste,
                               unsigned int y_pot_waste,
                               CoglPixelFormat format);

Creates a CoglTexture based on an existing OpenGL texture; the width, height and format are passed along since it is not always possible to query these from OpenGL.

The waste arguments allow you to create a Cogl texture that maps to a region smaller than the real OpenGL texture. For instance if your hardware only supports power-of-two textures you may load a non-power-of-two image into a larger power-of-two texture and use the waste arguments to tell Cogl which region should be mapped to the texture coordinate range [0:1].

Since: 0.8

cogl_texture_new_from_bitmap ()

CoglTexture *
cogl_texture_new_from_bitmap (CoglBitmap *bitmap,
                              CoglTextureFlags flags,
                              CoglPixelFormat internal_format);

Creates a CoglTexture from a CoglBitmap.

Since: 1.0

cogl_texture_new_from_sub_texture ()

CoglTexture *
cogl_texture_new_from_sub_texture (CoglTexture *full_texture,
                                   int sub_x,
                                   int sub_y,
                                   int sub_width,
                                   int sub_height);

Creates a new texture which represents a subregion of another texture. The GL resources will be shared so that no new texture data is actually allocated.

Sub textures have undefined behaviour texture coordinates outside of the range [0,1] are used. They also do not work with CoglVertexBuffers.

The sub texture will keep a reference to the full texture so you do not need to keep one separately if you only want to use the sub texture.

Since: 1.2

cogl_is_texture ()

CoglBool
cogl_is_texture (void *object);

Gets whether the given object references a texture object.

cogl_texture_get_width ()

unsigned int
cogl_texture_get_width (CoglTexture *texture);

Queries the width of a cogl texture.

cogl_texture_get_height ()

unsigned int
cogl_texture_get_height (CoglTexture *texture);

Queries the height of a cogl texture.

cogl_texture_get_format ()

CoglPixelFormat
cogl_texture_get_format (CoglTexture *texture);

Queries the CoglPixelFormat of a cogl texture.

cogl_texture_get_rowstride ()

unsigned int
cogl_texture_get_rowstride (CoglTexture *texture);

Determines the bytes-per-pixel for the CoglPixelFormat retrieved from cogl_texture_get_format() and multiplies that by the texture's width.

cogl_texture_get_max_waste ()

int
cogl_texture_get_max_waste (CoglTexture *texture);

Queries the maximum wasted (unused) pixels in one dimension of a GPU side texture.

cogl_texture_is_sliced ()

CoglBool
cogl_texture_is_sliced (CoglTexture *texture);

Queries if a texture is sliced (stored as multiple GPU side tecture objects).

cogl_texture_get_gl_texture ()

CoglBool
cogl_texture_get_gl_texture (CoglTexture *texture,
                             unsigned int *out_gl_handle,
                             unsigned int *out_gl_target);

Queries the GL handles for a GPU side texture through its CoglTexture.

If the texture is spliced the data for the first sub texture will be queried.

cogl_texture_get_data ()

int
cogl_texture_get_data (CoglTexture *texture,
                       CoglPixelFormat format,
                       unsigned int rowstride,
                       uint8_t *data);

Copies the pixel data from a cogl texture to system memory.

cogl_texture_set_region ()

CoglBool
cogl_texture_set_region (CoglTexture *texture,
                         int src_x,
                         int src_y,
                         int dst_x,
                         int dst_y,
                         unsigned int dst_width,
                         unsigned int dst_height,
                         int width,
                         int height,
                         CoglPixelFormat format,
                         unsigned int rowstride,
                         const uint8_t *data);

Sets the pixels in a rectangular subregion of texture from an in-memory buffer containing pixel data.

struct CoglTextureVertex

struct CoglTextureVertex {
  float x, y, z;
  float tx, ty;

  CoglColor color;
};

Used to specify vertex information when calling cogl_polygon()

enum CoglTextureFlags

Flags to pass to the cogl_texture_new_* family of functions.

Since: 1.0