Función SDL_SetColorKey

Sintaxis

int SDL_SetColorKey(SDL_Surface * surface,
                    int flag, Uint32 key);

Descripción

Establece la clave de color (píxel transparente) en una superficie.

Parámetros

surface

La estructura SDL_Surface a actualizar.

flag

SDL_TRUE para activar la clave de color, SDL_FALSE para desactivarla.

key

El píxel transparente.

Valor de retorno

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

Observaciones

La clave de color define un valor de píxel que será tratado como transparente en un blit. Por ejemplo, se puede utilizar para especificar que los píxeles cian deben ser considerados transparentes, y por lo tanto no renderizados.

Es un píxel del formato utilizado por la superficie, tal y como lo genera SDL_MapRGB().

La aceleración RLE puede acelerar sustancialmente el blitting de imágenes con grandes tramos horizontales de píxeles transparentes. Ver SDL_SetSurfaceRLE() para más detalles.