---
name: "SDL_GetRGB"
section: "3"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_GetRGB"
---

# SDL\_GetRGB(3)

Get RGB values from a pixel in the specified format.

## NAME

SDL\_GetRGB - Get RGB values from a pixel in the specified format.

## HEADER FILE

Defined in SDL3/SDL\_pixels.h

## SYNOPSIS

```
#include "SDL3/SDL.h"
```

**void SDL\_GetRGB(Uint32 pixel, const SDL\_PixelFormatDetails \*format, const SDL\_Palette \*palette, Uint8 \*r, Uint8 \*g, Uint8 \*b);**

## 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\]).

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

## THREAD SAFETY

It is safe to call this function from any thread, as long as the palette is not modified.

## AVAILABILITY

This function is available since SDL 3.2.0.

## SEE ALSO

**•**(3), [**SDL\_GetPixelFormatDetails**(3)](/SDL_GetPixelFormatDetails/3.md), **•**(3), [**SDL\_GetRGBA**(3)](/SDL_GetRGBA/3.md), **•**(3), [**SDL\_MapRGB**(3)](/SDL_MapRGB/3.md), **•**(3), [**SDL\_MapRGBA**(3)](/SDL_MapRGBA/3.md)