Función SDL_LockTexture

Sintaxis

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

Descripción

Bloquea una porción de la textura para el acceso de píxeles de sólo escritura.

Parámetros

texture

La textura a bloquear para acceso, que fue creada con SDL_TEXTUREACCESS_STREAMING.

rect

Una estructura SDL_Rect que representa el área a bloquear; NULL para bloquear toda la textura.

pixels

Se rellena con un puntero a los píxeles bloqueados, adecuadamente desplazados por el área bloqueada.

pitch

Se rellena con el paso de los píxeles bloqueados; el paso es la longitud de una fila en bytes.

Valor de retorno

Devuelve 0 en caso de éxito o un código de error negativo si la textura no es válida o no fue creada con SDL_TEXTUREACCESS_STREAMING. Ver SDL_GetError.

Observaciones

Como optimización, los píxeles disponibles para la edición no contienen necesariamente los datos de textura antiguos. Esta es una operación de sólo escritura, y si necesita mantener una copia de los datos de la textura se debe hacer a nivel de aplicación.

Se debe utilizar SDL_UnlockTexture() para desbloquear los píxeles y aplicar cualquier cambio.