SDL_pixels.h

Función SDL_MapRGB

Sintaxis

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

Descripción

Proyecta un triplete RGB a un valor de pixel opaco para un formato de pixel dado.

Parámetros

format: Una estructura SDL_PixelFormat que describe el formato de pixel.
r: La componente roja del pixel en el rango 0-255.
g: La componente verde del pixel en el rango 0-255.
b: La componente azul del pixel en el rango 0-255.

Valor de retorno

Devuelve el valor del pixel.

Observaciones

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

Si el formato tiene una paleta (8 bits) se devolverá el índice del color que más se aproxime en la paleta.

Si el formato de píxel especificado tiene un componente alfa, se devolverá como todos los bits 1 (totalmente opaco).

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).