Función SDL_UpdateTexture

Sintaxis

int SDL_UpdateTexture(SDL_Texture * texture,
                      const SDL_Rect * rect,
                      const void *pixels, int pitch);

Descripción

Actualiza el rectángulo de textura dado con nuevos datos de píxeles.

Parámetros

texture

La textura a actualizar.

rect

Una estructura SDL_Rect que representa el área a actualizar, o NULL para actualizar toda la textura.

pixels

Los datos de píxeles sin procesar en el formato de la textura.

pitch

El número de bytes en una fila de datos de píxeles, incluyendo el relleno entre líneas.

Valor de retorno

Devuelve 0 si tiene éxito o un código de error negativo si falla. Ver SDL_GetError.

Observaciones

Los datos de píxel deben estar en el formato de píxel de la textura. Utilizar SDL_QueryTexture() para consultar el formato de píxel de la textura.

Esta es una función bastante lenta, pensada para su uso con texturas estáticas que no cambian a menudo.

Si se pretende que la textura se actualice a menudo, es preferible crear la textura como streaming y utilizar las funciones de bloqueo SDL_LockTexture SDL_UnlockTexture. Aunque esta función funcionará con texturas en streaming, por razones de optimización puede que no se recuperen los píxeles si se bloquea la textura después.