Method
CoglTextureset_data
Declaration [src]
gboolean
cogl_texture_set_data (
CoglTexture* texture,
CoglPixelFormat format,
int rowstride,
const uint8_t* data,
int level,
GError** error
)
Description [src]
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.
data should point to the first pixel to copy corresponding
to the top left of the mipmap level being set.
If rowstride equals 0 then it will be automatically calculated
from the width of the mipmap level and the bytes-per-pixel for the
given format.
A mipmap level of 0 corresponds to the largest, base image of a
texture and level 1 is half the width and height of level 0. If
dividing any dimension of the previous level by two results in a
fraction then round the number down (floor()), but clamp to 1
something like this:
next_width = MAX (1, floor (prev_width));
You can determine the number of mipmap levels for a given texture like this:
n_levels = 1 + floor (log2 (max_dimension));
Where %max_dimension is the larger of cogl_texture_get_width() and cogl_texture_get_height().
It is an error to pass a level number >= the number of levels that
texture can have according to the above calculation.
Since the storage for a CoglTexture is allocated lazily then
if the given texture has not previously been allocated then this
api can return FALSE and throw an exceptional error if there is
not enough memory to allocate storage for texture.
Parameters
format-
Type:
CoglPixelFormatThe
CoglPixelFormatused in the sourcedatabuffer. rowstride-
Type:
intRowstride of the source
databuffer (computed from the texture width andformatif it equals 0). data-
Type: An array of
uint8_tThe source data, pointing to the first top-left pixel to set.
The data is owned by the caller of the method. level-
Type:
intThe mipmap level to update (Normally 0 for the largest, base texture).
error-
Type:
GError **The return location for a recoverable error.
The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will be left initialized to NULLby the method if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.