SDL_GetRGBA - Get RGBA values from a pixel in the specified format.
Contents
Availability
This function is available since SDL 3.2.0.
Description
This function uses the entire 8-bit [0..255] range when converting color components from pixel formats
with less than 8-bits per RGB component (e.g., a completely white pixel in 16-bit RGB565 format would
return [0xff, 0xff, 0xff] not [0xf8, 0xfc, 0xf8]).
If the surface has no alpha component, the alpha will be returned as 0xff (100% opaque).
Function Parameters
pixel a pixel value.
format a pointer to SDL_PixelFormatDetails describing the pixel format.
palette
an optional palette for indexed formats, may be NULL.
r a pointer filled in with the red component, may be NULL.
g a pointer filled in with the green component, may be NULL.
b a pointer filled in with the blue component, may be NULL.
a a pointer filled in with the alpha component, may be NULL.
Name
SDL_GetRGBA - Get RGBA values from a pixel in the specified format.
See Also
SDL_GetPixelFormatDetails(3), SDL_GetRGB(3), SDL_MapRGB(3), SDL_MapRGBA(3) Simple Directmedia Layer SDL 3.2.20 SDL_GetRGBA(3)
Synopsis
#include<SDL3/SDL_pixels.h>voidSDL_GetRGBA(Uint32pixel,constSDL_PixelFormatDetails*format,constSDL_Palette*palette,Uint8*r,Uint8*g,Uint8*b,Uint8*a);
Thread Safety
It is safe to call this function from any thread, as long as the palette is not modified.
