###### (This is the legacy documentation for SDL2, the previous stable version; [SDL3](https://wiki.libsdl.org/SDL3/) is the current stable version.)
# SDL_GetWindowGammaRamp

Get the gamma ramp for a given window's display.

## Header File

Defined in [SDL_video.h](https://github.com/libsdl-org/SDL/blob/SDL2/include/SDL_video.h)

## Syntax

```c
int SDL_GetWindowGammaRamp(SDL_Window * window,
                           Uint16 * red,
                           Uint16 * green,
                           Uint16 * blue);
```

## Function Parameters

|                            |            |                                                                                                               |
| -------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------- |
| [SDL_Window](SDL_Window) * | **window** | the window used to select the display whose gamma ramp will be queried.                                       |
| [Uint16](Uint16) *         | **red**    | a 256 element array of 16-bit quantities filled in with the translation table for the red channel, or NULL.   |
| [Uint16](Uint16) *         | **green**  | a 256 element array of 16-bit quantities filled in with the translation table for the green channel, or NULL. |
| [Uint16](Uint16) *         | **blue**   | a 256 element array of 16-bit quantities filled in with the translation table for the blue channel, or NULL.  |

## Return Value

(int) Returns 0 on success or a negative error code on failure; call
[SDL_GetError](SDL_GetError)() for more information.

## Remarks

Despite the name and signature, this method retrieves the gamma ramp of the
entire display, not an individual window. A window is considered to be
owned by the display that contains the window's center pixel. (The index of
this display can be retrieved using
[SDL_GetWindowDisplayIndex](SDL_GetWindowDisplayIndex)().)

## Version

This function is available since SDL 2.0.0.

## See Also

- [SDL_SetWindowGammaRamp](SDL_SetWindowGammaRamp)

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction), [CategoryVideo](CategoryVideo)