Class
CoglAtlasTexture
Description [src]
final class Cogl.AtlasTexture : Cogl.Texture
{
/* No available fields */
}Functions for managing textures in Cogl’s global set of texture atlases
A texture atlas is a texture that contains many smaller images that an application is interested in. These are packed together as a way of optimizing drawing with those images by avoiding the costs of repeatedly telling the hardware to change what texture it should sample from. This can enable more geometry to be batched together into few draw calls.
Each CoglContext has an shared, pool of texture atlases that are
are managed by Cogl.
This api lets applications upload texture data into one of Cogl’s
shared texture atlases using a high-level CoglAtlasTexture which
represents a sub-region of one of these atlases.
A CoglAtlasTexture is a high-level meta texture which has
some limitations to be aware of.
Constructors
cogl_atlas_texture_new_from_bitmap
Creates a new CoglAtlasTexture texture based on data residing in a
bmp. A CoglAtlasTexture represents a sub-region within one of
Cogl’s shared texture atlases.
cogl_atlas_texture_new_with_size
Creates a CoglAtlasTexture with a given width and height. A
CoglAtlasTexture represents a sub-region within one of Cogl’s
shared texture atlases.
Instance methods
Methods inherited from CoglTexture (18)
cogl_texture_allocate
Explicitly allocates the storage for the given texture which
allows you to be sure that there is enough memory for the
texture and if not then the error can be handled gracefully.
cogl_texture_foreach_in_region
Allows you to manually iterate the low-level textures that define a
given region of a high-level CoglTexture.
cogl_texture_get_components
Queries what components the given texture stores internally as set
via cogl_texture_set_components().
cogl_texture_get_context
cogl_texture_get_data
Copies the pixel data from a cogl texture to system memory.
cogl_texture_get_format
cogl_texture_get_gl_texture
Queries the GL handles for a GPU side texture through its CoglTexture.
cogl_texture_get_height
Queries the height of a cogl texture.
cogl_texture_get_premultiplied
Queries the pre-multiplied alpha status for internally stored red,
green and blue components for the given texture as set by cogl_texture_set_premultiplied().
cogl_texture_get_width
Queries the width of a cogl texture.
cogl_texture_is_get_data_supported
cogl_texture_is_sliced
Queries if a texture is sliced (stored as multiple GPU side tecture objects).
cogl_texture_set_auto_mipmap
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.
cogl_texture_set_components
Affects the internal storage format for this texture by specifying what components will be required for sampling later.
cogl_texture_set_data
texture a CoglTexture.
Sets all the pixels for a given mipmap level by copying the pixel
data pointed to by the data argument into the given texture.
cogl_texture_set_premultiplied
Affects the internal storage format for this texture by specifying whether red, green and blue color components should be stored as pre-multiplied alpha values.
cogl_texture_set_region
Sets the pixels in a rectangular subregion of texture from an in-memory
buffer containing pixel data.
cogl_texture_set_region_from_bitmap
Copies a specified source region from bitmap to the position
(src_x, src_y) of the given destination texture handle.
Properties
Properties inherited from CoglTexture (6)
Cogl.Texture:context
Cogl.Texture:format
Cogl.Texture:height
Cogl.Texture:is-primitive
Cogl.Texture:loader
Cogl.Texture:width
Signals
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.