Función SDL_LockSurface

Sintaxis

int SDL_LockSurface(SDL_Surface * surface);

Descripción

Prepara una superficie para acceder directamente a sus pixels.

Parámetros

surface

La estrucutra SDL_Surface a bloquear.

Valor de retorno

Devuelve 0 si tiene éxito o un código de error negativo en caso de fallo. Llamar a SDL_GetError() para más información.

Observaciones

Entre llamadas a SDL_LockSurface() / SDL_UnlockSurface(), se puede escribir y leer desde surface->pixels, usando el formato de pixel almacenado en surface->format. Una vez se haya terminado de acceder a la superficie, se debe utilizar SDL_UnlockSurface() para liberarla.

No todas las superficies requieren bloqueo. Si SDL_MUSTLOCK(surface) se evalúa a 0, entonces se puede leer y escribir en la superficie en cualquier momento, y el formato de píxel de la superficie no cambiará.