Constructor
CoglSubTexturenew
Declaration [src]
CoglTexture*
cogl_sub_texture_new (
  CoglContext* ctx,
  CoglTexture* parent_texture,
  int sub_x,
  int sub_y,
  int sub_width,
  int sub_height
)
Description [src]
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.
Remember: Unless you are using high level drawing APIs such as cogl_rectangle() or other APIs documented to understand the
CoglTexture interface then you need to use the
CoglTexture interface to resolve a CoglSubTexture into a
low-level texture before drawing.
Parameters
- ctx
- 
            Type: CoglContextA CoglContextpointer.The data is owned by the caller of the function. 
- parent_texture
- 
            Type: CoglTextureThe full texture containing a sub-region you want to make a CoglSubTexturefrom.The data is owned by the caller of the function. 
- sub_x
- 
            Type: intThe top-left x coordinate of the parent region to make a texture from. 
- sub_y
- 
            Type: intThe top-left y coordinate of the parent region to make a texture from. 
- sub_width
- 
            Type: intThe width of the parent region to make a texture from. 
- sub_height
- 
            Type: intThe height of the parent region to make a texture from. 
Return value
Type: CoglTexture
A newly allocated CoglSubTexture
         representing a sub-region of parent_texture.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |