Low-level primitive textures: Cogl 2.0 Reference Manual

Low-level primitive textures

Low-level primitive textures — Interface for low-level textures like CoglTexture2D and CoglTexture3D.

Functions

CoglBool	cogl_is_primitive_texture ()
void	cogl_primitive_texture_set_auto_mipmap ()

Types and Values

typedef

CoglPrimitiveTexture

Description

A CoglPrimitiveTexture is a texture that is directly represented by a single texture on the GPU. For example these could be a CoglTexture2D, CoglTexture3D or CoglTextureRectangle. This is opposed to high level meta textures which may be composed of multiple primitive textures or a sub-region of another texture such as CoglAtlasTexture and CoglTexture2DSliced.

A texture that implements this interface can be directly used with the low level cogl_primitive_draw() API. Other types of textures need to be first resolved to primitive textures using the CoglMetaTexture interface.

Most developers won't need to use this interface directly but still it is worth understanding the distinction between high-level and primitive textures because you may find other references in the documentation that detail limitations of using primitive textures.

Functions

cogl_is_primitive_texture ()

CoglBool
cogl_is_primitive_texture (void *object);

Gets whether the given object references a primitive texture object.

Parameters

object

A CoglObject pointer

Returns

TRUE if the pointer references a primitive texture, and FALSE otherwise

Since: 2.0

Stability Level: Unstable

cogl_primitive_texture_set_auto_mipmap ()

void
cogl_primitive_texture_set_auto_mipmap
                               (CoglPrimitiveTexture *primitive_texture,
                                CoglBool value);

Sets whether the texture will automatically update the smaller mipmap levels after any part of level 0 is updated. The update will only occur whenever the texture is used for drawing with a texture filter that requires the lower mipmap levels. An application should disable this if it wants to upload its own data for the other levels. By default auto mipmapping is enabled.

Parameters

primitive_texture	A CoglPrimitiveTexture
value	The new value for whether to auto mipmap

Since: 2.0

Stability Level: Unstable

Types and Values

CoglPrimitiveTexture

typedef void CoglPrimitiveTexture;