###### (This is the documentation for SDL3, which is under heavy development and the API is changing! [SDL2](https://wiki.libsdl.org/SDL2/) is the current stable version!)
# SDL_GetMasksForPixelFormatEnum

Convert one of the enumerated pixel formats to a bpp value and RGBA masks.

## Header File

Defined in [SDL_pixels.h](https://github.com/libsdl-org/SDL/blob/main/include/SDL3/SDL_pixels.h), but apps should use `#include <SDL3/SDL.h>`

## Syntax

```c
SDL_bool SDL_GetMasksForPixelFormatEnum(SDL_PixelFormatEnum format,
                                    int *bpp,
                                    Uint32 * Rmask,
                                    Uint32 * Gmask,
                                    Uint32 * Bmask,
                                    Uint32 * Amask);

```

## Function Parameters

|                |                                                              |
| -------------- | ------------------------------------------------------------ |
| **format**     | one of the [SDL_PixelFormatEnum](SDL_PixelFormatEnum) values |
| **bpp**        | a bits per pixel value; usually 15, 16, or 32                |
| **Rmask**      | a pointer filled in with the red mask for the format         |
| **Gmask**      | a pointer filled in with the green mask for the format       |
| **Bmask**      | a pointer filled in with the blue mask for the format        |
| **Amask**      | a pointer filled in with the alpha mask for the format       |

## Return Value

Returns [SDL_TRUE](SDL_TRUE) on success or [SDL_FALSE](SDL_FALSE) if the
conversion wasn't possible; call [SDL_GetError](SDL_GetError)() for more
information.

## Version

This function is available since SDL 3.0.0.

## See Also

* [SDL_GetPixelFormatEnumForMasks](SDL_GetPixelFormatEnumForMasks)

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