SDL_pixels.h

Función SDL_MapRGBA

Sintaxis

Uint32 SDL_MapRGBA(const SDL_PixelFormat * format,
                   Uint8 r, Uint8 g, Uint8 b,
                   Uint8 a);

Descripción

Asigna un cuádruplo RGBA a un valor de píxel para un formato de píxel dado.

Parámetros

format: Una estructura SDL_PixelFormat que describe el formato del píxel.
r: El componente rojo del píxel en el rango 0-255.
g: El componente verde del píxel en el rango 0-255.
b: El componente azul del píxel en el rango 0-255.
a: El componente alfa del píxel en el rango 0-255.

Valor de retorno

Devuelve un valor de píxel.

Observaciones

Esta función mapea el valor de color RGBA al formato de píxel especificado y devuelve el valor de píxel que mejor se aproxima al valor de color RGBA dado para el formato de píxel dado.

Si el formato de píxel especificado no tiene componente alfa, el valor alfa se ignorará (al igual que en los formatos con paleta).

Si el formato tiene una paleta (8 bits), se devolverá el índice del color más parecido de la paleta.

Si el formato de píxel bpp (profundidad de color) es inferior a 32-bpp entonces los bits superiores no utilizados del valor de retorno pueden ser ignorados con seguridad (por ejemplo, con un formato de 16-bpp el valor de retorno puede ser asignado a un Uint16, y de manera similar a un Uint8 para un formato de 8-bpp).