Cogl.Texture.set_data

### Method

# Cogl Textureset_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: `CoglPixelFormat`

  The `CoglPixelFormat` used in the source `data` buffer.

`rowstride`

  Type: `int`

  Rowstride of the source `data` buffer (computed from the texture width and `format` if it equals 0)

`data`

  Type: An array of `uint8_t`

  The source data, pointing to the first top-left pixel to set.

  The data is owned by the caller of the method.

`level`

  Type: `int`

  The 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 a `NULL` `GError*`.
  The argument will be left initialized to `NULL` by 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.

#### Return value

Type: `gboolean`

`TRUE` if the data upload was successful, and `FALSE` otherwise.