Cogl.SubTexture
Description: Reference for Cogl.SubTexture

### Class

# CoglSubTexture

#### Description [src]

    final class Cogl.SubTexture : Cogl.Texture
    {
      /* No available fields */
    }

Functions for creating and manipulating sub-textures.

These functions allow high-level textures to be created that represent a sub-region of another texture. For example these can be used to implement custom texture atlasing schemes.

#### Ancestors

- CoglTexture
- GObject

#### Constructors

###### cogl_sub_texture_new

Creates a high-level `CoglSubTexture` representing a sub-region of any other `CoglTexture`. The sub-region must strictly lye within the bounds of the `parent_texture`. The returned texture implements the `CoglTexture` interface because it’s not a low level texture that hardware can understand natively.

#### Instance methods

###### cogl_sub_texture_get_parent

Retrieves the parent texture that `sub_texture` derives its content from. This is the texture that was passed to `cogl_sub_texture_new()` as the parent_texture argument.

##### Methods inherited from CoglTexture (17)

###### 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

No description available.

###### cogl_texture_get_data

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

###### cogl_texture_get_format

No description available.

###### 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

No description available.

###### cogl_texture_is_sliced

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

###### 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`.

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Properties

##### Properties inherited from CoglTexture (5)

###### Cogl.Texture:context

No description available.

###### Cogl.Texture:format

No description available.

###### Cogl.Texture:height

No description available.

###### Cogl.Texture:loader

No description available.

###### Cogl.Texture:width

No description available.

#### 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.

#### Class structure

    struct CoglSubTextureClass {
      /* no available fields */
    }

No description available.