SDL 3.0
SDL_pixels.h File Reference
+ Include dependency graph for SDL_pixels.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  SDL_Color
 
struct  SDL_FColor
 
struct  SDL_Palette
 
struct  SDL_PixelFormatDetails
 

Macros

#define SDL_ALPHA_OPAQUE   255
 
#define SDL_ALPHA_OPAQUE_FLOAT   1.0f
 
#define SDL_ALPHA_TRANSPARENT   0
 
#define SDL_ALPHA_TRANSPARENT_FLOAT   0.0f
 
#define SDL_DEFINE_PIXELFOURCC(A, B, C, D)   SDL_FOURCC(A, B, C, D)
 
#define SDL_DEFINE_PIXELFORMAT(type, order, layout, bits, bytes)
 
#define SDL_PIXELFLAG(format)   (((format) >> 28) & 0x0F)
 
#define SDL_PIXELTYPE(format)   (((format) >> 24) & 0x0F)
 
#define SDL_PIXELORDER(format)   (((format) >> 20) & 0x0F)
 
#define SDL_PIXELLAYOUT(format)   (((format) >> 16) & 0x0F)
 
#define SDL_BITSPERPIXEL(format)    (SDL_ISPIXELFORMAT_FOURCC(format) ? 0 : (((format) >> 8) & 0xFF))
 
#define SDL_BYTESPERPIXEL(format)
 
#define SDL_ISPIXELFORMAT_INDEXED(format)
 
#define SDL_ISPIXELFORMAT_PACKED(format)
 
#define SDL_ISPIXELFORMAT_ARRAY(format)
 
#define SDL_ISPIXELFORMAT_10BIT(format)
 
#define SDL_ISPIXELFORMAT_FLOAT(format)
 
#define SDL_ISPIXELFORMAT_ALPHA(format)
 
#define SDL_ISPIXELFORMAT_FOURCC(format)
 
#define SDL_DEFINE_COLORSPACE(type, range, primaries, transfer, matrix, chroma)
 
#define SDL_COLORSPACETYPE(cspace)   (SDL_ColorType)(((cspace) >> 28) & 0x0F)
 
#define SDL_COLORSPACERANGE(cspace)   (SDL_ColorRange)(((cspace) >> 24) & 0x0F)
 
#define SDL_COLORSPACECHROMA(cspace)   (SDL_ChromaLocation)(((cspace) >> 20) & 0x0F)
 
#define SDL_COLORSPACEPRIMARIES(cspace)   (SDL_ColorPrimaries)(((cspace) >> 10) & 0x1F)
 
#define SDL_COLORSPACETRANSFER(cspace)   (SDL_TransferCharacteristics)(((cspace) >> 5) & 0x1F)
 
#define SDL_COLORSPACEMATRIX(cspace)   (SDL_MatrixCoefficients)((cspace) & 0x1F)
 
#define SDL_ISCOLORSPACE_MATRIX_BT601(cspace)   (SDL_COLORSPACEMATRIX(cspace) == SDL_MATRIX_COEFFICIENTS_BT601 || SDL_COLORSPACEMATRIX(cspace) == SDL_MATRIX_COEFFICIENTS_BT470BG)
 
#define SDL_ISCOLORSPACE_MATRIX_BT709(cspace)   (SDL_COLORSPACEMATRIX(cspace) == SDL_MATRIX_COEFFICIENTS_BT709)
 
#define SDL_ISCOLORSPACE_MATRIX_BT2020_NCL(cspace)   (SDL_COLORSPACEMATRIX(cspace) == SDL_MATRIX_COEFFICIENTS_BT2020_NCL)
 
#define SDL_ISCOLORSPACE_LIMITED_RANGE(cspace)   (SDL_COLORSPACERANGE(cspace) != SDL_COLOR_RANGE_FULL)
 
#define SDL_ISCOLORSPACE_FULL_RANGE(cspace)   (SDL_COLORSPACERANGE(cspace) == SDL_COLOR_RANGE_FULL)
 

Enumerations

enum  SDL_PixelType {
  SDL_PIXELTYPE_UNKNOWN ,
  SDL_PIXELTYPE_INDEX1 ,
  SDL_PIXELTYPE_INDEX4 ,
  SDL_PIXELTYPE_INDEX8 ,
  SDL_PIXELTYPE_PACKED8 ,
  SDL_PIXELTYPE_PACKED16 ,
  SDL_PIXELTYPE_PACKED32 ,
  SDL_PIXELTYPE_ARRAYU8 ,
  SDL_PIXELTYPE_ARRAYU16 ,
  SDL_PIXELTYPE_ARRAYU32 ,
  SDL_PIXELTYPE_ARRAYF16 ,
  SDL_PIXELTYPE_ARRAYF32 ,
  SDL_PIXELTYPE_INDEX2
}
 
enum  SDL_BitmapOrder {
  SDL_BITMAPORDER_NONE ,
  SDL_BITMAPORDER_4321 ,
  SDL_BITMAPORDER_1234
}
 
enum  SDL_PackedOrder {
  SDL_PACKEDORDER_NONE ,
  SDL_PACKEDORDER_XRGB ,
  SDL_PACKEDORDER_RGBX ,
  SDL_PACKEDORDER_ARGB ,
  SDL_PACKEDORDER_RGBA ,
  SDL_PACKEDORDER_XBGR ,
  SDL_PACKEDORDER_BGRX ,
  SDL_PACKEDORDER_ABGR ,
  SDL_PACKEDORDER_BGRA
}
 
enum  SDL_ArrayOrder {
  SDL_ARRAYORDER_NONE ,
  SDL_ARRAYORDER_RGB ,
  SDL_ARRAYORDER_RGBA ,
  SDL_ARRAYORDER_ARGB ,
  SDL_ARRAYORDER_BGR ,
  SDL_ARRAYORDER_BGRA ,
  SDL_ARRAYORDER_ABGR
}
 
enum  SDL_PackedLayout {
  SDL_PACKEDLAYOUT_NONE ,
  SDL_PACKEDLAYOUT_332 ,
  SDL_PACKEDLAYOUT_4444 ,
  SDL_PACKEDLAYOUT_1555 ,
  SDL_PACKEDLAYOUT_5551 ,
  SDL_PACKEDLAYOUT_565 ,
  SDL_PACKEDLAYOUT_8888 ,
  SDL_PACKEDLAYOUT_2101010 ,
  SDL_PACKEDLAYOUT_1010102
}
 
enum  SDL_PixelFormat {
  SDL_PIXELFORMAT_UNKNOWN = 0 ,
  SDL_PIXELFORMAT_INDEX1LSB = 0x11100100u ,
  SDL_PIXELFORMAT_INDEX1MSB = 0x11200100u ,
  SDL_PIXELFORMAT_INDEX2LSB = 0x1c100200u ,
  SDL_PIXELFORMAT_INDEX2MSB = 0x1c200200u ,
  SDL_PIXELFORMAT_INDEX4LSB = 0x12100400u ,
  SDL_PIXELFORMAT_INDEX4MSB = 0x12200400u ,
  SDL_PIXELFORMAT_INDEX8 = 0x13000801u ,
  SDL_PIXELFORMAT_RGB332 = 0x14110801u ,
  SDL_PIXELFORMAT_XRGB4444 = 0x15120c02u ,
  SDL_PIXELFORMAT_XBGR4444 = 0x15520c02u ,
  SDL_PIXELFORMAT_XRGB1555 = 0x15130f02u ,
  SDL_PIXELFORMAT_XBGR1555 = 0x15530f02u ,
  SDL_PIXELFORMAT_ARGB4444 = 0x15321002u ,
  SDL_PIXELFORMAT_RGBA4444 = 0x15421002u ,
  SDL_PIXELFORMAT_ABGR4444 = 0x15721002u ,
  SDL_PIXELFORMAT_BGRA4444 = 0x15821002u ,
  SDL_PIXELFORMAT_ARGB1555 = 0x15331002u ,
  SDL_PIXELFORMAT_RGBA5551 = 0x15441002u ,
  SDL_PIXELFORMAT_ABGR1555 = 0x15731002u ,
  SDL_PIXELFORMAT_BGRA5551 = 0x15841002u ,
  SDL_PIXELFORMAT_RGB565 = 0x15151002u ,
  SDL_PIXELFORMAT_BGR565 = 0x15551002u ,
  SDL_PIXELFORMAT_RGB24 = 0x17101803u ,
  SDL_PIXELFORMAT_BGR24 = 0x17401803u ,
  SDL_PIXELFORMAT_XRGB8888 = 0x16161804u ,
  SDL_PIXELFORMAT_RGBX8888 = 0x16261804u ,
  SDL_PIXELFORMAT_XBGR8888 = 0x16561804u ,
  SDL_PIXELFORMAT_BGRX8888 = 0x16661804u ,
  SDL_PIXELFORMAT_ARGB8888 = 0x16362004u ,
  SDL_PIXELFORMAT_RGBA8888 = 0x16462004u ,
  SDL_PIXELFORMAT_ABGR8888 = 0x16762004u ,
  SDL_PIXELFORMAT_BGRA8888 = 0x16862004u ,
  SDL_PIXELFORMAT_XRGB2101010 = 0x16172004u ,
  SDL_PIXELFORMAT_XBGR2101010 = 0x16572004u ,
  SDL_PIXELFORMAT_ARGB2101010 = 0x16372004u ,
  SDL_PIXELFORMAT_ABGR2101010 = 0x16772004u ,
  SDL_PIXELFORMAT_RGB48 = 0x18103006u ,
  SDL_PIXELFORMAT_BGR48 = 0x18403006u ,
  SDL_PIXELFORMAT_RGBA64 = 0x18204008u ,
  SDL_PIXELFORMAT_ARGB64 = 0x18304008u ,
  SDL_PIXELFORMAT_BGRA64 = 0x18504008u ,
  SDL_PIXELFORMAT_ABGR64 = 0x18604008u ,
  SDL_PIXELFORMAT_RGB48_FLOAT = 0x1a103006u ,
  SDL_PIXELFORMAT_BGR48_FLOAT = 0x1a403006u ,
  SDL_PIXELFORMAT_RGBA64_FLOAT = 0x1a204008u ,
  SDL_PIXELFORMAT_ARGB64_FLOAT = 0x1a304008u ,
  SDL_PIXELFORMAT_BGRA64_FLOAT = 0x1a504008u ,
  SDL_PIXELFORMAT_ABGR64_FLOAT = 0x1a604008u ,
  SDL_PIXELFORMAT_RGB96_FLOAT = 0x1b10600cu ,
  SDL_PIXELFORMAT_BGR96_FLOAT = 0x1b40600cu ,
  SDL_PIXELFORMAT_RGBA128_FLOAT = 0x1b208010u ,
  SDL_PIXELFORMAT_ARGB128_FLOAT = 0x1b308010u ,
  SDL_PIXELFORMAT_BGRA128_FLOAT = 0x1b508010u ,
  SDL_PIXELFORMAT_ABGR128_FLOAT = 0x1b608010u ,
  SDL_PIXELFORMAT_YV12 = 0x32315659u ,
  SDL_PIXELFORMAT_IYUV = 0x56555949u ,
  SDL_PIXELFORMAT_YUY2 = 0x32595559u ,
  SDL_PIXELFORMAT_UYVY = 0x59565955u ,
  SDL_PIXELFORMAT_YVYU = 0x55595659u ,
  SDL_PIXELFORMAT_NV12 = 0x3231564eu ,
  SDL_PIXELFORMAT_NV21 = 0x3132564eu ,
  SDL_PIXELFORMAT_P010 = 0x30313050u ,
  SDL_PIXELFORMAT_EXTERNAL_OES = 0x2053454fu ,
  SDL_PIXELFORMAT_MJPG = 0x47504a4du ,
  SDL_PIXELFORMAT_RGBA32 = SDL_PIXELFORMAT_RGBA8888 ,
  SDL_PIXELFORMAT_ARGB32 = SDL_PIXELFORMAT_ARGB8888 ,
  SDL_PIXELFORMAT_BGRA32 = SDL_PIXELFORMAT_BGRA8888 ,
  SDL_PIXELFORMAT_ABGR32 = SDL_PIXELFORMAT_ABGR8888 ,
  SDL_PIXELFORMAT_RGBX32 = SDL_PIXELFORMAT_RGBX8888 ,
  SDL_PIXELFORMAT_XRGB32 = SDL_PIXELFORMAT_XRGB8888 ,
  SDL_PIXELFORMAT_BGRX32 = SDL_PIXELFORMAT_BGRX8888 ,
  SDL_PIXELFORMAT_XBGR32 = SDL_PIXELFORMAT_XBGR8888
}
 
enum  SDL_ColorType {
  SDL_COLOR_TYPE_UNKNOWN = 0 ,
  SDL_COLOR_TYPE_RGB = 1 ,
  SDL_COLOR_TYPE_YCBCR = 2
}
 
enum  SDL_ColorRange {
  SDL_COLOR_RANGE_UNKNOWN = 0 ,
  SDL_COLOR_RANGE_LIMITED = 1 ,
  SDL_COLOR_RANGE_FULL = 2
}
 
enum  SDL_ColorPrimaries {
  SDL_COLOR_PRIMARIES_UNKNOWN = 0 ,
  SDL_COLOR_PRIMARIES_BT709 = 1 ,
  SDL_COLOR_PRIMARIES_UNSPECIFIED = 2 ,
  SDL_COLOR_PRIMARIES_BT470M = 4 ,
  SDL_COLOR_PRIMARIES_BT470BG = 5 ,
  SDL_COLOR_PRIMARIES_BT601 = 6 ,
  SDL_COLOR_PRIMARIES_SMPTE240 = 7 ,
  SDL_COLOR_PRIMARIES_GENERIC_FILM = 8 ,
  SDL_COLOR_PRIMARIES_BT2020 = 9 ,
  SDL_COLOR_PRIMARIES_XYZ = 10 ,
  SDL_COLOR_PRIMARIES_SMPTE431 = 11 ,
  SDL_COLOR_PRIMARIES_SMPTE432 = 12 ,
  SDL_COLOR_PRIMARIES_EBU3213 = 22 ,
  SDL_COLOR_PRIMARIES_CUSTOM = 31
}
 
enum  SDL_TransferCharacteristics {
  SDL_TRANSFER_CHARACTERISTICS_UNKNOWN = 0 ,
  SDL_TRANSFER_CHARACTERISTICS_BT709 = 1 ,
  SDL_TRANSFER_CHARACTERISTICS_UNSPECIFIED = 2 ,
  SDL_TRANSFER_CHARACTERISTICS_GAMMA22 = 4 ,
  SDL_TRANSFER_CHARACTERISTICS_GAMMA28 = 5 ,
  SDL_TRANSFER_CHARACTERISTICS_BT601 = 6 ,
  SDL_TRANSFER_CHARACTERISTICS_SMPTE240 = 7 ,
  SDL_TRANSFER_CHARACTERISTICS_LINEAR = 8 ,
  SDL_TRANSFER_CHARACTERISTICS_LOG100 = 9 ,
  SDL_TRANSFER_CHARACTERISTICS_LOG100_SQRT10 = 10 ,
  SDL_TRANSFER_CHARACTERISTICS_IEC61966 = 11 ,
  SDL_TRANSFER_CHARACTERISTICS_BT1361 = 12 ,
  SDL_TRANSFER_CHARACTERISTICS_SRGB = 13 ,
  SDL_TRANSFER_CHARACTERISTICS_BT2020_10BIT = 14 ,
  SDL_TRANSFER_CHARACTERISTICS_BT2020_12BIT = 15 ,
  SDL_TRANSFER_CHARACTERISTICS_PQ = 16 ,
  SDL_TRANSFER_CHARACTERISTICS_SMPTE428 = 17 ,
  SDL_TRANSFER_CHARACTERISTICS_HLG = 18 ,
  SDL_TRANSFER_CHARACTERISTICS_CUSTOM = 31
}
 
enum  SDL_MatrixCoefficients {
  SDL_MATRIX_COEFFICIENTS_IDENTITY = 0 ,
  SDL_MATRIX_COEFFICIENTS_BT709 = 1 ,
  SDL_MATRIX_COEFFICIENTS_UNSPECIFIED = 2 ,
  SDL_MATRIX_COEFFICIENTS_FCC = 4 ,
  SDL_MATRIX_COEFFICIENTS_BT470BG = 5 ,
  SDL_MATRIX_COEFFICIENTS_BT601 = 6 ,
  SDL_MATRIX_COEFFICIENTS_SMPTE240 = 7 ,
  SDL_MATRIX_COEFFICIENTS_YCGCO = 8 ,
  SDL_MATRIX_COEFFICIENTS_BT2020_NCL = 9 ,
  SDL_MATRIX_COEFFICIENTS_BT2020_CL = 10 ,
  SDL_MATRIX_COEFFICIENTS_SMPTE2085 = 11 ,
  SDL_MATRIX_COEFFICIENTS_CHROMA_DERIVED_NCL = 12 ,
  SDL_MATRIX_COEFFICIENTS_CHROMA_DERIVED_CL = 13 ,
  SDL_MATRIX_COEFFICIENTS_ICTCP = 14 ,
  SDL_MATRIX_COEFFICIENTS_CUSTOM = 31
}
 
enum  SDL_ChromaLocation {
  SDL_CHROMA_LOCATION_NONE = 0 ,
  SDL_CHROMA_LOCATION_LEFT = 1 ,
  SDL_CHROMA_LOCATION_CENTER = 2 ,
  SDL_CHROMA_LOCATION_TOPLEFT = 3
}
 
enum  SDL_Colorspace {
  SDL_COLORSPACE_UNKNOWN = 0 ,
  SDL_COLORSPACE_SRGB = 0x120005a0u ,
  SDL_COLORSPACE_SRGB_LINEAR = 0x12000500u ,
  SDL_COLORSPACE_HDR10 = 0x12002600u ,
  SDL_COLORSPACE_JPEG = 0x220004c6u ,
  SDL_COLORSPACE_BT601_LIMITED = 0x211018c6u ,
  SDL_COLORSPACE_BT601_FULL = 0x221018c6u ,
  SDL_COLORSPACE_BT709_LIMITED = 0x21100421u ,
  SDL_COLORSPACE_BT709_FULL = 0x22100421u ,
  SDL_COLORSPACE_BT2020_LIMITED = 0x21102609u ,
  SDL_COLORSPACE_BT2020_FULL = 0x22102609u ,
  SDL_COLORSPACE_RGB_DEFAULT = SDL_COLORSPACE_SRGB ,
  SDL_COLORSPACE_YUV_DEFAULT = SDL_COLORSPACE_JPEG
}
 

Functions

const char * SDL_GetPixelFormatName (SDL_PixelFormat format)
 
bool SDL_GetMasksForPixelFormat (SDL_PixelFormat format, int *bpp, Uint32 *Rmask, Uint32 *Gmask, Uint32 *Bmask, Uint32 *Amask)
 
SDL_PixelFormat SDL_GetPixelFormatForMasks (int bpp, Uint32 Rmask, Uint32 Gmask, Uint32 Bmask, Uint32 Amask)
 
const SDL_PixelFormatDetailsSDL_GetPixelFormatDetails (SDL_PixelFormat format)
 
SDL_PaletteSDL_CreatePalette (int ncolors)
 
bool SDL_SetPaletteColors (SDL_Palette *palette, const SDL_Color *colors, int firstcolor, int ncolors)
 
void SDL_DestroyPalette (SDL_Palette *palette)
 
Uint32 SDL_MapRGB (const SDL_PixelFormatDetails *format, const SDL_Palette *palette, Uint8 r, Uint8 g, Uint8 b)
 
Uint32 SDL_MapRGBA (const SDL_PixelFormatDetails *format, const SDL_Palette *palette, Uint8 r, Uint8 g, Uint8 b, Uint8 a)
 
void SDL_GetRGB (Uint32 pixel, const SDL_PixelFormatDetails *format, const SDL_Palette *palette, Uint8 *r, Uint8 *g, Uint8 *b)
 
void SDL_GetRGBA (Uint32 pixel, const SDL_PixelFormatDetails *format, const SDL_Palette *palette, Uint8 *r, Uint8 *g, Uint8 *b, Uint8 *a)
 

Macro Definition Documentation

◆ SDL_ALPHA_OPAQUE

#define SDL_ALPHA_OPAQUE   255

CategoryPixels

SDL offers facilities for pixel management.

Largely these facilities deal with pixel format: what does this set of bits represent?

If you mostly want to think of a pixel as some combination of red, green, blue, and maybe alpha intensities, this is all pretty straightforward, and in many cases, is enough information to build a perfectly fine game.

However, the actual definition of a pixel is more complex than that:

Pixels are a representation of a color in a particular color space.

The first characteristic of a color space is the color type. SDL understands two different color types, RGB and YCbCr, or in SDL also referred to as YUV.

RGB colors consist of red, green, and blue channels of color that are added together to represent the colors we see on the screen.

https://en.wikipedia.org/wiki/RGB_color_model

YCbCr colors represent colors as a Y luma brightness component and red and blue chroma color offsets. This color representation takes advantage of the fact that the human eye is more sensitive to brightness than the color in an image. The Cb and Cr components are often compressed and have lower resolution than the luma component.

https://en.wikipedia.org/wiki/YCbCr

When the color information in YCbCr is compressed, the Y pixels are left at full resolution and each Cr and Cb pixel represents an average of the color information in a block of Y pixels. The chroma location determines where in that block of pixels the color information is coming from.

The color range defines how much of the pixel to use when converting a pixel into a color on the display. When the full color range is used, the entire numeric range of the pixel bits is significant. When narrow color range is used, for historical reasons, the pixel uses only a portion of the numeric range to represent colors.

The color primaries and white point are a definition of the colors in the color space relative to the standard XYZ color space.

https://en.wikipedia.org/wiki/CIE_1931_color_space

The transfer characteristic, or opto-electrical transfer function (OETF), is the way a color is converted from mathematically linear space into a non-linear output signals.

https://en.wikipedia.org/wiki/Rec._709#Transfer_characteristics

The matrix coefficients are used to convert between YCbCr and RGB colors. A fully opaque 8-bit alpha value.

Since
This macro is available since SDL 3.2.0.
See also
SDL_ALPHA_TRANSPARENT

Definition at line 100 of file SDL_pixels.h.

◆ SDL_ALPHA_OPAQUE_FLOAT

#define SDL_ALPHA_OPAQUE_FLOAT   1.0f

A fully opaque floating point alpha value.

Since
This macro is available since SDL 3.2.0.
See also
SDL_ALPHA_TRANSPARENT_FLOAT

Definition at line 109 of file SDL_pixels.h.

◆ SDL_ALPHA_TRANSPARENT

#define SDL_ALPHA_TRANSPARENT   0

A fully transparent 8-bit alpha value.

Since
This macro is available since SDL 3.2.0.
See also
SDL_ALPHA_OPAQUE

Definition at line 118 of file SDL_pixels.h.

◆ SDL_ALPHA_TRANSPARENT_FLOAT

#define SDL_ALPHA_TRANSPARENT_FLOAT   0.0f

A fully transparent floating point alpha value.

Since
This macro is available since SDL 3.2.0.
See also
SDL_ALPHA_OPAQUE_FLOAT

Definition at line 127 of file SDL_pixels.h.

◆ SDL_BITSPERPIXEL

#define SDL_BITSPERPIXEL (   format)     (SDL_ISPIXELFORMAT_FOURCC(format) ? 0 : (((format) >> 8) & 0xFF))

A macro to determine an SDL_PixelFormat's bits per pixel.

Note that this macro double-evaluates its parameter, so do not use expressions with side-effects here.

FourCC formats will report zero here, as it rarely makes sense to measure them per-pixel.

Parameters
formatan SDL_PixelFormat to check.
Returns
the bits-per-pixel of format.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.
See also
SDL_BYTESPERPIXEL

Definition at line 340 of file SDL_pixels.h.

341 : (((format) >> 8) & 0xFF))

◆ SDL_BYTESPERPIXEL

#define SDL_BYTESPERPIXEL (   format)
Value:
((((format) == SDL_PIXELFORMAT_YUY2) || \
((format) == SDL_PIXELFORMAT_UYVY) || \
((format) == SDL_PIXELFORMAT_YVYU) || \
((format) == SDL_PIXELFORMAT_P010)) ? 2 : 1) : (((format) >> 0) & 0xFF))
@ SDL_PIXELFORMAT_P010
Definition SDL_pixels.h:674
@ SDL_PIXELFORMAT_YVYU
Definition SDL_pixels.h:668
@ SDL_PIXELFORMAT_UYVY
Definition SDL_pixels.h:666
@ SDL_PIXELFORMAT_YUY2
Definition SDL_pixels.h:664
#define SDL_ISPIXELFORMAT_FOURCC(format)
Definition SDL_pixels.h:506

A macro to determine an SDL_PixelFormat's bytes per pixel.

Note that this macro double-evaluates its parameter, so do not use expressions with side-effects here.

FourCC formats do their best here, but many of them don't have a meaningful measurement of bytes per pixel.

Parameters
formatan SDL_PixelFormat to check.
Returns
the bytes-per-pixel of format.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.
See also
SDL_BITSPERPIXEL

Definition at line 361 of file SDL_pixels.h.

366 : 1) : (((format) >> 0) & 0xFF))

◆ SDL_COLORSPACECHROMA

#define SDL_COLORSPACECHROMA (   cspace)    (SDL_ChromaLocation)(((cspace) >> 20) & 0x0F)

A macro to retrieve the chroma sample location of an SDL_Colorspace.

Parameters
cspacean SDL_Colorspace to check.
Returns
the SDL_ChromaLocation of cspace.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 893 of file SDL_pixels.h.

◆ SDL_COLORSPACEMATRIX

#define SDL_COLORSPACEMATRIX (   cspace)    (SDL_MatrixCoefficients)((cspace) & 0x1F)

A macro to retrieve the matrix coefficients of an SDL_Colorspace.

Parameters
cspacean SDL_Colorspace to check.
Returns
the SDL_MatrixCoefficients of cspace.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 929 of file SDL_pixels.h.

◆ SDL_COLORSPACEPRIMARIES

#define SDL_COLORSPACEPRIMARIES (   cspace)    (SDL_ColorPrimaries)(((cspace) >> 10) & 0x1F)

A macro to retrieve the primaries of an SDL_Colorspace.

Parameters
cspacean SDL_Colorspace to check.
Returns
the SDL_ColorPrimaries of cspace.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 905 of file SDL_pixels.h.

◆ SDL_COLORSPACERANGE

#define SDL_COLORSPACERANGE (   cspace)    (SDL_ColorRange)(((cspace) >> 24) & 0x0F)

A macro to retrieve the range of an SDL_Colorspace.

Parameters
cspacean SDL_Colorspace to check.
Returns
the SDL_ColorRange of cspace.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 881 of file SDL_pixels.h.

◆ SDL_COLORSPACETRANSFER

#define SDL_COLORSPACETRANSFER (   cspace)    (SDL_TransferCharacteristics)(((cspace) >> 5) & 0x1F)

A macro to retrieve the transfer characteristics of an SDL_Colorspace.

Parameters
cspacean SDL_Colorspace to check.
Returns
the SDL_TransferCharacteristics of cspace.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 917 of file SDL_pixels.h.

◆ SDL_COLORSPACETYPE

#define SDL_COLORSPACETYPE (   cspace)    (SDL_ColorType)(((cspace) >> 28) & 0x0F)

A macro to retrieve the type of an SDL_Colorspace.

Parameters
cspacean SDL_Colorspace to check.
Returns
the SDL_ColorType for cspace.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 869 of file SDL_pixels.h.

◆ SDL_DEFINE_COLORSPACE

#define SDL_DEFINE_COLORSPACE (   type,
  range,
  primaries,
  transfer,
  matrix,
  chroma 
)
Value:
(((Uint32)(type) << 28) | ((Uint32)(range) << 24) | ((Uint32)(chroma) << 20) | \
((Uint32)(primaries) << 10) | ((Uint32)(transfer) << 5) | ((Uint32)(matrix) << 0))
uint32_t Uint32
Definition SDL_stdinc.h:461

A macro for defining custom SDL_Colorspace formats.

For example, defining SDL_COLORSPACE_SRGB looks like this:

@ SDL_MATRIX_COEFFICIENTS_IDENTITY
Definition SDL_pixels.h:792
@ SDL_COLOR_RANGE_FULL
Definition SDL_pixels.h:726
@ SDL_COLOR_PRIMARIES_BT709
Definition SDL_pixels.h:738
@ SDL_CHROMA_LOCATION_NONE
Definition SDL_pixels.h:816
#define SDL_DEFINE_COLORSPACE(type, range, primaries, transfer, matrix, chroma)
Definition SDL_pixels.h:855
@ SDL_COLOR_TYPE_RGB
Definition SDL_pixels.h:712
@ SDL_TRANSFER_CHARACTERISTICS_SRGB
Definition SDL_pixels.h:774
Parameters
typethe type of the new format, probably an SDL_ColorType value.
rangethe range of the new format, probably a SDL_ColorRange value.
primariesthe primaries of the new format, probably an SDL_ColorPrimaries value.
transferthe transfer characteristics of the new format, probably an SDL_TransferCharacteristics value.
matrixthe matrix coefficients of the new format, probably an SDL_MatrixCoefficients value.
chromathe chroma sample location of the new format, probably an SDL_ChromaLocation value.
Returns
a format value in the style of SDL_Colorspace.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 855 of file SDL_pixels.h.

◆ SDL_DEFINE_PIXELFORMAT

#define SDL_DEFINE_PIXELFORMAT (   type,
  order,
  layout,
  bits,
  bytes 
)
Value:
((1 << 28) | ((type) << 24) | ((order) << 20) | ((layout) << 16) | \
((bits) << 8) | ((bytes) << 0))

A macro for defining custom non-FourCC pixel formats.

For example, defining SDL_PIXELFORMAT_RGBA8888 looks like this:

@ SDL_PIXELTYPE_PACKED32
Definition SDL_pixels.h:142
@ SDL_PACKEDLAYOUT_8888
Definition SDL_pixels.h:211
#define SDL_DEFINE_PIXELFORMAT(type, order, layout, bits, bytes)
Definition SDL_pixels.h:259
@ SDL_PACKEDORDER_RGBA
Definition SDL_pixels.h:175
Parameters
typethe type of the new format, probably a SDL_PixelType value.
orderthe order of the new format, probably a SDL_BitmapOrder, SDL_PackedOrder, or SDL_ArrayOrder value.
layoutthe layout of the new format, probably an SDL_PackedLayout value or zero.
bitsthe number of bits per pixel of the new format.
bytesthe number of bytes per pixel of the new format.
Returns
a format value in the style of SDL_PixelFormat.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 259 of file SDL_pixels.h.

◆ SDL_DEFINE_PIXELFOURCC

#define SDL_DEFINE_PIXELFOURCC (   A,
  B,
  C,
 
)    SDL_FOURCC(A, B, C, D)

A macro for defining custom FourCC pixel formats.

For example, defining SDL_PIXELFORMAT_YV12 looks like this:

SDL_DEFINE_PIXELFOURCC('Y', 'V', '1', '2')
#define SDL_DEFINE_PIXELFOURCC(A, B, C, D)
Definition SDL_pixels.h:235
Parameters
Athe first character of the FourCC code.
Bthe second character of the FourCC code.
Cthe third character of the FourCC code.
Dthe fourth character of the FourCC code.
Returns
a format value in the style of SDL_PixelFormat.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 235 of file SDL_pixels.h.

◆ SDL_ISCOLORSPACE_FULL_RANGE

#define SDL_ISCOLORSPACE_FULL_RANGE (   cspace)    (SDL_COLORSPACERANGE(cspace) == SDL_COLOR_RANGE_FULL)

A macro to determine if an SDL_Colorspace has a full range.

Parameters
cspacean SDL_Colorspace to check.
Returns
true if full range, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 994 of file SDL_pixels.h.

◆ SDL_ISCOLORSPACE_LIMITED_RANGE

#define SDL_ISCOLORSPACE_LIMITED_RANGE (   cspace)    (SDL_COLORSPACERANGE(cspace) != SDL_COLOR_RANGE_FULL)

A macro to determine if an SDL_Colorspace has a limited range.

Parameters
cspacean SDL_Colorspace to check.
Returns
true if limited range, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 982 of file SDL_pixels.h.

◆ SDL_ISCOLORSPACE_MATRIX_BT2020_NCL

#define SDL_ISCOLORSPACE_MATRIX_BT2020_NCL (   cspace)    (SDL_COLORSPACEMATRIX(cspace) == SDL_MATRIX_COEFFICIENTS_BT2020_NCL)

A macro to determine if an SDL_Colorspace uses BT2020_NCL matrix coefficients.

Parameters
cspacean SDL_Colorspace to check.
Returns
true if BT2020_NCL, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 970 of file SDL_pixels.h.

◆ SDL_ISCOLORSPACE_MATRIX_BT601

#define SDL_ISCOLORSPACE_MATRIX_BT601 (   cspace)    (SDL_COLORSPACEMATRIX(cspace) == SDL_MATRIX_COEFFICIENTS_BT601 || SDL_COLORSPACEMATRIX(cspace) == SDL_MATRIX_COEFFICIENTS_BT470BG)

A macro to determine if an SDL_Colorspace uses BT601 (or BT470BG) matrix coefficients.

Note that this macro double-evaluates its parameter, so do not use expressions with side-effects here.

Parameters
cspacean SDL_Colorspace to check.
Returns
true if BT601 or BT470BG, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 945 of file SDL_pixels.h.

◆ SDL_ISCOLORSPACE_MATRIX_BT709

#define SDL_ISCOLORSPACE_MATRIX_BT709 (   cspace)    (SDL_COLORSPACEMATRIX(cspace) == SDL_MATRIX_COEFFICIENTS_BT709)

A macro to determine if an SDL_Colorspace uses BT709 matrix coefficients.

Parameters
cspacean SDL_Colorspace to check.
Returns
true if BT709, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 957 of file SDL_pixels.h.

◆ SDL_ISPIXELFORMAT_10BIT

#define SDL_ISPIXELFORMAT_10BIT (   format)
Value:
(!SDL_ISPIXELFORMAT_FOURCC(format) && \
#define SDL_PIXELLAYOUT(format)
Definition SDL_pixels.h:320
@ SDL_PACKEDLAYOUT_2101010
Definition SDL_pixels.h:212
#define SDL_PIXELTYPE(format)
Definition SDL_pixels.h:290

A macro to determine if an SDL_PixelFormat is a 10-bit format.

Note that this macro double-evaluates its parameter, so do not use expressions with side-effects here.

Parameters
formatan SDL_PixelFormat to check.
Returns
true if the format is 10-bit, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 442 of file SDL_pixels.h.

◆ SDL_ISPIXELFORMAT_ALPHA

#define SDL_ISPIXELFORMAT_ALPHA (   format)
Value:
((SDL_ISPIXELFORMAT_PACKED(format) && \
#define SDL_ISPIXELFORMAT_PACKED(format)
Definition SDL_pixels.h:402
@ SDL_ARRAYORDER_ARGB
Definition SDL_pixels.h:192
@ SDL_ARRAYORDER_BGRA
Definition SDL_pixels.h:194
@ SDL_ARRAYORDER_ABGR
Definition SDL_pixels.h:195
@ SDL_ARRAYORDER_RGBA
Definition SDL_pixels.h:191
#define SDL_ISPIXELFORMAT_ARRAY(format)
Definition SDL_pixels.h:421
#define SDL_PIXELORDER(format)
Definition SDL_pixels.h:305
@ SDL_PACKEDORDER_ABGR
Definition SDL_pixels.h:178
@ SDL_PACKEDORDER_BGRA
Definition SDL_pixels.h:179
@ SDL_PACKEDORDER_ARGB
Definition SDL_pixels.h:174

A macro to determine if an SDL_PixelFormat has an alpha channel.

Note that this macro double-evaluates its parameter, so do not use expressions with side-effects here.

Parameters
formatan SDL_PixelFormat to check.
Returns
true if the format has alpha, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 478 of file SDL_pixels.h.

◆ SDL_ISPIXELFORMAT_ARRAY

#define SDL_ISPIXELFORMAT_ARRAY (   format)
Value:
(!SDL_ISPIXELFORMAT_FOURCC(format) && \
@ SDL_PIXELTYPE_ARRAYU16
Definition SDL_pixels.h:144
@ SDL_PIXELTYPE_ARRAYU8
Definition SDL_pixels.h:143
@ SDL_PIXELTYPE_ARRAYF16
Definition SDL_pixels.h:146
@ SDL_PIXELTYPE_ARRAYU32
Definition SDL_pixels.h:145
@ SDL_PIXELTYPE_ARRAYF32
Definition SDL_pixels.h:147

A macro to determine if an SDL_PixelFormat is an array format.

Note that this macro double-evaluates its parameter, so do not use expressions with side-effects here.

Parameters
formatan SDL_PixelFormat to check.
Returns
true if the format is an array, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 421 of file SDL_pixels.h.

◆ SDL_ISPIXELFORMAT_FLOAT

#define SDL_ISPIXELFORMAT_FLOAT (   format)
Value:

A macro to determine if an SDL_PixelFormat is a floating point format.

Note that this macro double-evaluates its parameter, so do not use expressions with side-effects here.

Parameters
formatan SDL_PixelFormat to check.
Returns
true if the format is 10-bit, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 460 of file SDL_pixels.h.

◆ SDL_ISPIXELFORMAT_FOURCC

#define SDL_ISPIXELFORMAT_FOURCC (   format)
Value:
/* The flag is set to 1 because 0x1? is not in the printable ASCII range */ \
((format) && (SDL_PIXELFLAG(format) != 1))
#define SDL_PIXELFLAG(format)
Definition SDL_pixels.h:276

A macro to determine if an SDL_PixelFormat is a "FourCC" format.

This covers custom and other unusual formats.

Note that this macro double-evaluates its parameter, so do not use expressions with side-effects here.

Parameters
formatan SDL_PixelFormat to check.
Returns
true if the format has alpha, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 506 of file SDL_pixels.h.

◆ SDL_ISPIXELFORMAT_INDEXED

#define SDL_ISPIXELFORMAT_INDEXED (   format)
Value:
(!SDL_ISPIXELFORMAT_FOURCC(format) && \
@ SDL_PIXELTYPE_INDEX2
Definition SDL_pixels.h:149
@ SDL_PIXELTYPE_INDEX4
Definition SDL_pixels.h:138
@ SDL_PIXELTYPE_INDEX1
Definition SDL_pixels.h:137
@ SDL_PIXELTYPE_INDEX8
Definition SDL_pixels.h:139

A macro to determine if an SDL_PixelFormat is an indexed format.

Note that this macro double-evaluates its parameter, so do not use expressions with side-effects here.

Parameters
formatan SDL_PixelFormat to check.
Returns
true if the format is indexed, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 382 of file SDL_pixels.h.

◆ SDL_ISPIXELFORMAT_PACKED

#define SDL_ISPIXELFORMAT_PACKED (   format)
Value:
(!SDL_ISPIXELFORMAT_FOURCC(format) && \
@ SDL_PIXELTYPE_PACKED8
Definition SDL_pixels.h:140
@ SDL_PIXELTYPE_PACKED16
Definition SDL_pixels.h:141

A macro to determine if an SDL_PixelFormat is a packed format.

Note that this macro double-evaluates its parameter, so do not use expressions with side-effects here.

Parameters
formatan SDL_PixelFormat to check.
Returns
true if the format is packed, false otherwise.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 402 of file SDL_pixels.h.

◆ SDL_PIXELFLAG

#define SDL_PIXELFLAG (   format)    (((format) >> 28) & 0x0F)

A macro to retrieve the flags of an SDL_PixelFormat.

This macro is generally not needed directly by an app, which should use specific tests, like SDL_ISPIXELFORMAT_FOURCC, instead.

Parameters
formatan SDL_PixelFormat to check.
Returns
the flags of format.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 276 of file SDL_pixels.h.

◆ SDL_PIXELLAYOUT

#define SDL_PIXELLAYOUT (   format)    (((format) >> 16) & 0x0F)

A macro to retrieve the layout of an SDL_PixelFormat.

This is usually a value from the SDL_PackedLayout enumeration, or zero if a layout doesn't make sense for the format type.

Parameters
formatan SDL_PixelFormat to check.
Returns
the layout of format.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 320 of file SDL_pixels.h.

◆ SDL_PIXELORDER

#define SDL_PIXELORDER (   format)    (((format) >> 20) & 0x0F)

A macro to retrieve the order of an SDL_PixelFormat.

This is usually a value from the SDL_BitmapOrder, SDL_PackedOrder, or SDL_ArrayOrder enumerations, depending on the format type.

Parameters
formatan SDL_PixelFormat to check.
Returns
the order of format.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 305 of file SDL_pixels.h.

◆ SDL_PIXELTYPE

#define SDL_PIXELTYPE (   format)    (((format) >> 24) & 0x0F)

A macro to retrieve the type of an SDL_PixelFormat.

This is usually a value from the SDL_PixelType enumeration.

Parameters
formatan SDL_PixelFormat to check.
Returns
the type of format.

\threadsafety It is safe to call this macro from any thread.

Since
This macro is available since SDL 3.2.0.

Definition at line 290 of file SDL_pixels.h.

Enumeration Type Documentation

◆ SDL_ArrayOrder

Array component order, low byte -> high byte.

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_ARRAYORDER_NONE 
SDL_ARRAYORDER_RGB 
SDL_ARRAYORDER_RGBA 
SDL_ARRAYORDER_ARGB 
SDL_ARRAYORDER_BGR 
SDL_ARRAYORDER_BGRA 
SDL_ARRAYORDER_ABGR 

Definition at line 187 of file SDL_pixels.h.

◆ SDL_BitmapOrder

Bitmap pixel order, high bit -> low bit.

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_BITMAPORDER_NONE 
SDL_BITMAPORDER_4321 
SDL_BITMAPORDER_1234 

Definition at line 157 of file SDL_pixels.h.

158{
SDL_BitmapOrder
Definition SDL_pixels.h:158
@ SDL_BITMAPORDER_1234
Definition SDL_pixels.h:161
@ SDL_BITMAPORDER_NONE
Definition SDL_pixels.h:159
@ SDL_BITMAPORDER_4321
Definition SDL_pixels.h:160

◆ SDL_ChromaLocation

Colorspace chroma sample location.

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_CHROMA_LOCATION_NONE 

RGB, no chroma sampling

SDL_CHROMA_LOCATION_LEFT 

In MPEG-2, MPEG-4, and AVC, Cb and Cr are taken on midpoint of the left-edge of the 2x2 square. In other words, they have the same horizontal location as the top-left pixel, but is shifted one-half pixel down vertically.

SDL_CHROMA_LOCATION_CENTER 

In JPEG/JFIF, H.261, and MPEG-1, Cb and Cr are taken at the center of the 2x2 square. In other words, they are offset one-half pixel to the right and one-half pixel down compared to the top-left pixel.

SDL_CHROMA_LOCATION_TOPLEFT 

In HEVC for BT.2020 and BT.2100 content (in particular on Blu-rays), Cb and Cr are sampled at the same location as the group's top-left Y pixel ("co-sited", "co-located").

Definition at line 814 of file SDL_pixels.h.

815{
816 SDL_CHROMA_LOCATION_NONE = 0, /**< RGB, no chroma sampling */
817 SDL_CHROMA_LOCATION_LEFT = 1, /**< In MPEG-2, MPEG-4, and AVC, Cb and Cr are taken on midpoint of the left-edge of the 2x2 square. In other words, they have the same horizontal location as the top-left pixel, but is shifted one-half pixel down vertically. */
818 SDL_CHROMA_LOCATION_CENTER = 2, /**< In JPEG/JFIF, H.261, and MPEG-1, Cb and Cr are taken at the center of the 2x2 square. In other words, they are offset one-half pixel to the right and one-half pixel down compared to the top-left pixel. */
819 SDL_CHROMA_LOCATION_TOPLEFT = 3 /**< In HEVC for BT.2020 and BT.2100 content (in particular on Blu-rays), Cb and Cr are sampled at the same location as the group's top-left Y pixel ("co-sited", "co-located"). */
SDL_ChromaLocation
Definition SDL_pixels.h:815
@ SDL_CHROMA_LOCATION_TOPLEFT
Definition SDL_pixels.h:819
@ SDL_CHROMA_LOCATION_CENTER
Definition SDL_pixels.h:818
@ SDL_CHROMA_LOCATION_LEFT
Definition SDL_pixels.h:817

◆ SDL_ColorPrimaries

Colorspace color primaries, as described by https://www.itu.int/rec/T-REC-H.273-201612-S/en

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_COLOR_PRIMARIES_UNKNOWN 
SDL_COLOR_PRIMARIES_BT709 

ITU-R BT.709-6

SDL_COLOR_PRIMARIES_UNSPECIFIED 
SDL_COLOR_PRIMARIES_BT470M 

ITU-R BT.470-6 System M

SDL_COLOR_PRIMARIES_BT470BG 

ITU-R BT.470-6 System B, G / ITU-R BT.601-7 625

SDL_COLOR_PRIMARIES_BT601 

ITU-R BT.601-7 525, SMPTE 170M

SDL_COLOR_PRIMARIES_SMPTE240 

SMPTE 240M, functionally the same as SDL_COLOR_PRIMARIES_BT601

SDL_COLOR_PRIMARIES_GENERIC_FILM 

Generic film (color filters using Illuminant C)

SDL_COLOR_PRIMARIES_BT2020 

ITU-R BT.2020-2 / ITU-R BT.2100-0

SDL_COLOR_PRIMARIES_XYZ 

SMPTE ST 428-1

SDL_COLOR_PRIMARIES_SMPTE431 

SMPTE RP 431-2

SDL_COLOR_PRIMARIES_SMPTE432 

SMPTE EG 432-1 / DCI P3

SDL_COLOR_PRIMARIES_EBU3213 

EBU Tech. 3213-E

SDL_COLOR_PRIMARIES_CUSTOM 

Definition at line 735 of file SDL_pixels.h.

736{
738 SDL_COLOR_PRIMARIES_BT709 = 1, /**< ITU-R BT.709-6 */
740 SDL_COLOR_PRIMARIES_BT470M = 4, /**< ITU-R BT.470-6 System M */
741 SDL_COLOR_PRIMARIES_BT470BG = 5, /**< ITU-R BT.470-6 System B, G / ITU-R BT.601-7 625 */
742 SDL_COLOR_PRIMARIES_BT601 = 6, /**< ITU-R BT.601-7 525, SMPTE 170M */
743 SDL_COLOR_PRIMARIES_SMPTE240 = 7, /**< SMPTE 240M, functionally the same as SDL_COLOR_PRIMARIES_BT601 */
744 SDL_COLOR_PRIMARIES_GENERIC_FILM = 8, /**< Generic film (color filters using Illuminant C) */
745 SDL_COLOR_PRIMARIES_BT2020 = 9, /**< ITU-R BT.2020-2 / ITU-R BT.2100-0 */
746 SDL_COLOR_PRIMARIES_XYZ = 10, /**< SMPTE ST 428-1 */
747 SDL_COLOR_PRIMARIES_SMPTE431 = 11, /**< SMPTE RP 431-2 */
748 SDL_COLOR_PRIMARIES_SMPTE432 = 12, /**< SMPTE EG 432-1 / DCI P3 */
749 SDL_COLOR_PRIMARIES_EBU3213 = 22, /**< EBU Tech. 3213-E */
SDL_ColorPrimaries
Definition SDL_pixels.h:736
@ SDL_COLOR_PRIMARIES_SMPTE431
Definition SDL_pixels.h:747
@ SDL_COLOR_PRIMARIES_CUSTOM
Definition SDL_pixels.h:750
@ SDL_COLOR_PRIMARIES_EBU3213
Definition SDL_pixels.h:749
@ SDL_COLOR_PRIMARIES_GENERIC_FILM
Definition SDL_pixels.h:744
@ SDL_COLOR_PRIMARIES_BT601
Definition SDL_pixels.h:742
@ SDL_COLOR_PRIMARIES_UNSPECIFIED
Definition SDL_pixels.h:739
@ SDL_COLOR_PRIMARIES_SMPTE240
Definition SDL_pixels.h:743
@ SDL_COLOR_PRIMARIES_XYZ
Definition SDL_pixels.h:746
@ SDL_COLOR_PRIMARIES_UNKNOWN
Definition SDL_pixels.h:737
@ SDL_COLOR_PRIMARIES_SMPTE432
Definition SDL_pixels.h:748
@ SDL_COLOR_PRIMARIES_BT2020
Definition SDL_pixels.h:745
@ SDL_COLOR_PRIMARIES_BT470BG
Definition SDL_pixels.h:741
@ SDL_COLOR_PRIMARIES_BT470M
Definition SDL_pixels.h:740

◆ SDL_ColorRange

Colorspace color range, as described by https://www.itu.int/rec/R-REC-BT.2100-2-201807-I/en

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_COLOR_RANGE_UNKNOWN 
SDL_COLOR_RANGE_LIMITED 

Narrow range, e.g. 16-235 for 8-bit RGB and luma, and 16-240 for 8-bit chroma

SDL_COLOR_RANGE_FULL 

Full range, e.g. 0-255 for 8-bit RGB and luma, and 1-255 for 8-bit chroma

Definition at line 722 of file SDL_pixels.h.

723{
725 SDL_COLOR_RANGE_LIMITED = 1, /**< Narrow range, e.g. 16-235 for 8-bit RGB and luma, and 16-240 for 8-bit chroma */
726 SDL_COLOR_RANGE_FULL = 2 /**< Full range, e.g. 0-255 for 8-bit RGB and luma, and 1-255 for 8-bit chroma */
SDL_ColorRange
Definition SDL_pixels.h:723
@ SDL_COLOR_RANGE_LIMITED
Definition SDL_pixels.h:725
@ SDL_COLOR_RANGE_UNKNOWN
Definition SDL_pixels.h:724

◆ SDL_Colorspace

Colorspace definitions.

Since similar colorspaces may vary in their details (matrix, transfer function, etc.), this is not an exhaustive list, but rather a representative sample of the kinds of colorspaces supported in SDL.

Since
This enum is available since SDL 3.2.0.
See also
SDL_ColorPrimaries
SDL_ColorRange
SDL_ColorType
SDL_MatrixCoefficients
SDL_TransferCharacteristics
Enumerator
SDL_COLORSPACE_UNKNOWN 
SDL_COLORSPACE_SRGB 

Equivalent to DXGI_COLOR_SPACE_RGB_FULL_G22_NONE_P709

SDL_COLORSPACE_SRGB_LINEAR 

Equivalent to DXGI_COLOR_SPACE_RGB_FULL_G10_NONE_P709

SDL_COLORSPACE_HDR10 

Equivalent to DXGI_COLOR_SPACE_RGB_FULL_G2084_NONE_P2020

SDL_COLORSPACE_JPEG 

Equivalent to DXGI_COLOR_SPACE_YCBCR_FULL_G22_NONE_P709_X601

SDL_COLORSPACE_BT601_LIMITED 

Equivalent to DXGI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P601

SDL_COLORSPACE_BT601_FULL 

Equivalent to DXGI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P601

SDL_COLORSPACE_BT709_LIMITED 

Equivalent to DXGI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P709

SDL_COLORSPACE_BT709_FULL 

Equivalent to DXGI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P709

SDL_COLORSPACE_BT2020_LIMITED 

Equivalent to DXGI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P2020

SDL_COLORSPACE_BT2020_FULL 

Equivalent to DXGI_COLOR_SPACE_YCBCR_FULL_G22_LEFT_P2020

SDL_COLORSPACE_RGB_DEFAULT 

The default colorspace for RGB surfaces if no colorspace is specified

SDL_COLORSPACE_YUV_DEFAULT 

The default colorspace for YUV surfaces if no colorspace is specified

Definition at line 1011 of file SDL_pixels.h.

1012{
1014
1015 /* sRGB is a gamma corrected colorspace, and the default colorspace for SDL rendering and 8-bit RGB surfaces */
1016 SDL_COLORSPACE_SRGB = 0x120005a0u, /**< Equivalent to DXGI_COLOR_SPACE_RGB_FULL_G22_NONE_P709 */
1017 /* SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_RGB,
1018 SDL_COLOR_RANGE_FULL,
1019 SDL_COLOR_PRIMARIES_BT709,
1020 SDL_TRANSFER_CHARACTERISTICS_SRGB,
1021 SDL_MATRIX_COEFFICIENTS_IDENTITY,
1022 SDL_CHROMA_LOCATION_NONE), */
1023
1024 /* This is a linear colorspace and the default colorspace for floating point surfaces. On Windows this is the scRGB colorspace, and on Apple platforms this is kCGColorSpaceExtendedLinearSRGB for EDR content */
1025 SDL_COLORSPACE_SRGB_LINEAR = 0x12000500u, /**< Equivalent to DXGI_COLOR_SPACE_RGB_FULL_G10_NONE_P709 */
1026 /* SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_RGB,
1027 SDL_COLOR_RANGE_FULL,
1028 SDL_COLOR_PRIMARIES_BT709,
1029 SDL_TRANSFER_CHARACTERISTICS_LINEAR,
1030 SDL_MATRIX_COEFFICIENTS_IDENTITY,
1031 SDL_CHROMA_LOCATION_NONE), */
1032
1033 /* HDR10 is a non-linear HDR colorspace and the default colorspace for 10-bit surfaces */
1034 SDL_COLORSPACE_HDR10 = 0x12002600u, /**< Equivalent to DXGI_COLOR_SPACE_RGB_FULL_G2084_NONE_P2020 */
1035 /* SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_RGB,
1036 SDL_COLOR_RANGE_FULL,
1037 SDL_COLOR_PRIMARIES_BT2020,
1038 SDL_TRANSFER_CHARACTERISTICS_PQ,
1039 SDL_MATRIX_COEFFICIENTS_IDENTITY,
1040 SDL_CHROMA_LOCATION_NONE), */
1041
1042 SDL_COLORSPACE_JPEG = 0x220004c6u, /**< Equivalent to DXGI_COLOR_SPACE_YCBCR_FULL_G22_NONE_P709_X601 */
1043 /* SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_YCBCR,
1044 SDL_COLOR_RANGE_FULL,
1045 SDL_COLOR_PRIMARIES_BT709,
1046 SDL_TRANSFER_CHARACTERISTICS_BT601,
1047 SDL_MATRIX_COEFFICIENTS_BT601,
1048 SDL_CHROMA_LOCATION_NONE), */
1049
1050 SDL_COLORSPACE_BT601_LIMITED = 0x211018c6u, /**< Equivalent to DXGI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P601 */
1051 /* SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_YCBCR,
1052 SDL_COLOR_RANGE_LIMITED,
1053 SDL_COLOR_PRIMARIES_BT601,
1054 SDL_TRANSFER_CHARACTERISTICS_BT601,
1055 SDL_MATRIX_COEFFICIENTS_BT601,
1056 SDL_CHROMA_LOCATION_LEFT), */
1057
1058 SDL_COLORSPACE_BT601_FULL = 0x221018c6u, /**< Equivalent to DXGI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P601 */
1059 /* SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_YCBCR,
1060 SDL_COLOR_RANGE_FULL,
1061 SDL_COLOR_PRIMARIES_BT601,
1062 SDL_TRANSFER_CHARACTERISTICS_BT601,
1063 SDL_MATRIX_COEFFICIENTS_BT601,
1064 SDL_CHROMA_LOCATION_LEFT), */
1065
1066 SDL_COLORSPACE_BT709_LIMITED = 0x21100421u, /**< Equivalent to DXGI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P709 */
1067 /* SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_YCBCR,
1068 SDL_COLOR_RANGE_LIMITED,
1069 SDL_COLOR_PRIMARIES_BT709,
1070 SDL_TRANSFER_CHARACTERISTICS_BT709,
1071 SDL_MATRIX_COEFFICIENTS_BT709,
1072 SDL_CHROMA_LOCATION_LEFT), */
1073
1074 SDL_COLORSPACE_BT709_FULL = 0x22100421u, /**< Equivalent to DXGI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P709 */
1075 /* SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_YCBCR,
1076 SDL_COLOR_RANGE_FULL,
1077 SDL_COLOR_PRIMARIES_BT709,
1078 SDL_TRANSFER_CHARACTERISTICS_BT709,
1079 SDL_MATRIX_COEFFICIENTS_BT709,
1080 SDL_CHROMA_LOCATION_LEFT), */
1081
1082 SDL_COLORSPACE_BT2020_LIMITED = 0x21102609u, /**< Equivalent to DXGI_COLOR_SPACE_YCBCR_STUDIO_G22_LEFT_P2020 */
1083 /* SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_YCBCR,
1084 SDL_COLOR_RANGE_LIMITED,
1085 SDL_COLOR_PRIMARIES_BT2020,
1086 SDL_TRANSFER_CHARACTERISTICS_PQ,
1087 SDL_MATRIX_COEFFICIENTS_BT2020_NCL,
1088 SDL_CHROMA_LOCATION_LEFT), */
1089
1090 SDL_COLORSPACE_BT2020_FULL = 0x22102609u, /**< Equivalent to DXGI_COLOR_SPACE_YCBCR_FULL_G22_LEFT_P2020 */
1091 /* SDL_DEFINE_COLORSPACE(SDL_COLOR_TYPE_YCBCR,
1092 SDL_COLOR_RANGE_FULL,
1093 SDL_COLOR_PRIMARIES_BT2020,
1094 SDL_TRANSFER_CHARACTERISTICS_PQ,
1095 SDL_MATRIX_COEFFICIENTS_BT2020_NCL,
1096 SDL_CHROMA_LOCATION_LEFT), */
1097
1098 SDL_COLORSPACE_RGB_DEFAULT = SDL_COLORSPACE_SRGB, /**< The default colorspace for RGB surfaces if no colorspace is specified */
1099 SDL_COLORSPACE_YUV_DEFAULT = SDL_COLORSPACE_JPEG /**< The default colorspace for YUV surfaces if no colorspace is specified */
SDL_Colorspace
@ SDL_COLORSPACE_BT2020_LIMITED
@ SDL_COLORSPACE_BT601_LIMITED
@ SDL_COLORSPACE_BT709_FULL
@ SDL_COLORSPACE_HDR10
@ SDL_COLORSPACE_BT601_FULL
@ SDL_COLORSPACE_UNKNOWN
@ SDL_COLORSPACE_BT2020_FULL
@ SDL_COLORSPACE_JPEG
@ SDL_COLORSPACE_BT709_LIMITED
@ SDL_COLORSPACE_SRGB_LINEAR
@ SDL_COLORSPACE_SRGB
@ SDL_COLORSPACE_RGB_DEFAULT
@ SDL_COLORSPACE_YUV_DEFAULT

◆ SDL_ColorType

Colorspace color type.

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_COLOR_TYPE_UNKNOWN 
SDL_COLOR_TYPE_RGB 
SDL_COLOR_TYPE_YCBCR 

Definition at line 709 of file SDL_pixels.h.

710{
SDL_ColorType
Definition SDL_pixels.h:710
@ SDL_COLOR_TYPE_YCBCR
Definition SDL_pixels.h:713
@ SDL_COLOR_TYPE_UNKNOWN
Definition SDL_pixels.h:711

◆ SDL_MatrixCoefficients

Colorspace matrix coefficients.

These are as described by https://www.itu.int/rec/T-REC-H.273-201612-S/en

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_MATRIX_COEFFICIENTS_IDENTITY 
SDL_MATRIX_COEFFICIENTS_BT709 

ITU-R BT.709-6

SDL_MATRIX_COEFFICIENTS_UNSPECIFIED 
SDL_MATRIX_COEFFICIENTS_FCC 

US FCC Title 47

SDL_MATRIX_COEFFICIENTS_BT470BG 

ITU-R BT.470-6 System B, G / ITU-R BT.601-7 625, functionally the same as SDL_MATRIX_COEFFICIENTS_BT601

SDL_MATRIX_COEFFICIENTS_BT601 

ITU-R BT.601-7 525

SDL_MATRIX_COEFFICIENTS_SMPTE240 

SMPTE 240M

SDL_MATRIX_COEFFICIENTS_YCGCO 
SDL_MATRIX_COEFFICIENTS_BT2020_NCL 

ITU-R BT.2020-2 non-constant luminance

SDL_MATRIX_COEFFICIENTS_BT2020_CL 

ITU-R BT.2020-2 constant luminance

SDL_MATRIX_COEFFICIENTS_SMPTE2085 

SMPTE ST 2085

SDL_MATRIX_COEFFICIENTS_CHROMA_DERIVED_NCL 
SDL_MATRIX_COEFFICIENTS_CHROMA_DERIVED_CL 
SDL_MATRIX_COEFFICIENTS_ICTCP 

ITU-R BT.2100-0 ICTCP

SDL_MATRIX_COEFFICIENTS_CUSTOM 

Definition at line 790 of file SDL_pixels.h.

791{
793 SDL_MATRIX_COEFFICIENTS_BT709 = 1, /**< ITU-R BT.709-6 */
795 SDL_MATRIX_COEFFICIENTS_FCC = 4, /**< US FCC Title 47 */
796 SDL_MATRIX_COEFFICIENTS_BT470BG = 5, /**< ITU-R BT.470-6 System B, G / ITU-R BT.601-7 625, functionally the same as SDL_MATRIX_COEFFICIENTS_BT601 */
797 SDL_MATRIX_COEFFICIENTS_BT601 = 6, /**< ITU-R BT.601-7 525 */
798 SDL_MATRIX_COEFFICIENTS_SMPTE240 = 7, /**< SMPTE 240M */
800 SDL_MATRIX_COEFFICIENTS_BT2020_NCL = 9, /**< ITU-R BT.2020-2 non-constant luminance */
801 SDL_MATRIX_COEFFICIENTS_BT2020_CL = 10, /**< ITU-R BT.2020-2 constant luminance */
802 SDL_MATRIX_COEFFICIENTS_SMPTE2085 = 11, /**< SMPTE ST 2085 */
805 SDL_MATRIX_COEFFICIENTS_ICTCP = 14, /**< ITU-R BT.2100-0 ICTCP */
SDL_MatrixCoefficients
Definition SDL_pixels.h:791
@ SDL_MATRIX_COEFFICIENTS_BT709
Definition SDL_pixels.h:793
@ SDL_MATRIX_COEFFICIENTS_BT2020_CL
Definition SDL_pixels.h:801
@ SDL_MATRIX_COEFFICIENTS_BT601
Definition SDL_pixels.h:797
@ SDL_MATRIX_COEFFICIENTS_BT2020_NCL
Definition SDL_pixels.h:800
@ SDL_MATRIX_COEFFICIENTS_SMPTE240
Definition SDL_pixels.h:798
@ SDL_MATRIX_COEFFICIENTS_YCGCO
Definition SDL_pixels.h:799
@ SDL_MATRIX_COEFFICIENTS_CHROMA_DERIVED_NCL
Definition SDL_pixels.h:803
@ SDL_MATRIX_COEFFICIENTS_CHROMA_DERIVED_CL
Definition SDL_pixels.h:804
@ SDL_MATRIX_COEFFICIENTS_UNSPECIFIED
Definition SDL_pixels.h:794
@ SDL_MATRIX_COEFFICIENTS_CUSTOM
Definition SDL_pixels.h:806
@ SDL_MATRIX_COEFFICIENTS_ICTCP
Definition SDL_pixels.h:805
@ SDL_MATRIX_COEFFICIENTS_FCC
Definition SDL_pixels.h:795
@ SDL_MATRIX_COEFFICIENTS_BT470BG
Definition SDL_pixels.h:796
@ SDL_MATRIX_COEFFICIENTS_SMPTE2085
Definition SDL_pixels.h:802

◆ SDL_PackedLayout

Packed component layout.

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_PACKEDLAYOUT_NONE 
SDL_PACKEDLAYOUT_332 
SDL_PACKEDLAYOUT_4444 
SDL_PACKEDLAYOUT_1555 
SDL_PACKEDLAYOUT_5551 
SDL_PACKEDLAYOUT_565 
SDL_PACKEDLAYOUT_8888 
SDL_PACKEDLAYOUT_2101010 
SDL_PACKEDLAYOUT_1010102 

Definition at line 203 of file SDL_pixels.h.

204{
SDL_PackedLayout
Definition SDL_pixels.h:204
@ SDL_PACKEDLAYOUT_NONE
Definition SDL_pixels.h:205
@ SDL_PACKEDLAYOUT_1010102
Definition SDL_pixels.h:213
@ SDL_PACKEDLAYOUT_565
Definition SDL_pixels.h:210
@ SDL_PACKEDLAYOUT_332
Definition SDL_pixels.h:206
@ SDL_PACKEDLAYOUT_5551
Definition SDL_pixels.h:209
@ SDL_PACKEDLAYOUT_1555
Definition SDL_pixels.h:208
@ SDL_PACKEDLAYOUT_4444
Definition SDL_pixels.h:207

◆ SDL_PackedOrder

Packed component order, high bit -> low bit.

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_PACKEDORDER_NONE 
SDL_PACKEDORDER_XRGB 
SDL_PACKEDORDER_RGBX 
SDL_PACKEDORDER_ARGB 
SDL_PACKEDORDER_RGBA 
SDL_PACKEDORDER_XBGR 
SDL_PACKEDORDER_BGRX 
SDL_PACKEDORDER_ABGR 
SDL_PACKEDORDER_BGRA 

Definition at line 169 of file SDL_pixels.h.

◆ SDL_PixelFormat

Pixel format.

SDL's pixel formats have the following naming convention:

  • Names with a list of components and a single bit count, such as RGB24 and ABGR32, define a platform-independent encoding into bytes in the order specified. For example, in RGB24 data, each pixel is encoded in 3 bytes (red, green, blue) in that order, and in ABGR32 data, each pixel is encoded in 4 bytes alpha, blue, green, red) in that order. Use these names if the property of a format that is important to you is the order of the bytes in memory or on disk.
  • Names with a bit count per component, such as ARGB8888 and XRGB1555, are "packed" into an appropriately-sized integer in the platform's native endianness. For example, ARGB8888 is a sequence of 32-bit integers; in each integer, the most significant bits are alpha, and the least significant bits are blue. On a little-endian CPU such as x86, the least significant bits of each integer are arranged first in memory, but on a big-endian CPU such as s390x, the most significant bits are arranged first. Use these names if the property of a format that is important to you is the meaning of each bit position within a native-endianness integer.
  • In indexed formats such as INDEX4LSB, each pixel is represented by encoding an index into the palette into the indicated number of bits, with multiple pixels packed into each byte if appropriate. In LSB formats, the first (leftmost) pixel is stored in the least-significant bits of the byte; in MSB formats, it's stored in the most-significant bits. INDEX8 does not need LSB/MSB variants, because each pixel exactly fills one byte.

The 32-bit byte-array encodings such as RGBA32 are aliases for the appropriate 8888 encoding for the current platform. For example, RGBA32 is an alias for ABGR8888 on little-endian CPUs like x86, or an alias for RGBA8888 on big-endian CPUs.

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_PIXELFORMAT_UNKNOWN 
SDL_PIXELFORMAT_INDEX1LSB 
SDL_PIXELFORMAT_INDEX1MSB 
SDL_PIXELFORMAT_INDEX2LSB 
SDL_PIXELFORMAT_INDEX2MSB 
SDL_PIXELFORMAT_INDEX4LSB 
SDL_PIXELFORMAT_INDEX4MSB 
SDL_PIXELFORMAT_INDEX8 
SDL_PIXELFORMAT_RGB332 
SDL_PIXELFORMAT_XRGB4444 
SDL_PIXELFORMAT_XBGR4444 
SDL_PIXELFORMAT_XRGB1555 
SDL_PIXELFORMAT_XBGR1555 
SDL_PIXELFORMAT_ARGB4444 
SDL_PIXELFORMAT_RGBA4444 
SDL_PIXELFORMAT_ABGR4444 
SDL_PIXELFORMAT_BGRA4444 
SDL_PIXELFORMAT_ARGB1555 
SDL_PIXELFORMAT_RGBA5551 
SDL_PIXELFORMAT_ABGR1555 
SDL_PIXELFORMAT_BGRA5551 
SDL_PIXELFORMAT_RGB565 
SDL_PIXELFORMAT_BGR565 
SDL_PIXELFORMAT_RGB24 
SDL_PIXELFORMAT_BGR24 
SDL_PIXELFORMAT_XRGB8888 
SDL_PIXELFORMAT_RGBX8888 
SDL_PIXELFORMAT_XBGR8888 
SDL_PIXELFORMAT_BGRX8888 
SDL_PIXELFORMAT_ARGB8888 
SDL_PIXELFORMAT_RGBA8888 
SDL_PIXELFORMAT_ABGR8888 
SDL_PIXELFORMAT_BGRA8888 
SDL_PIXELFORMAT_XRGB2101010 
SDL_PIXELFORMAT_XBGR2101010 
SDL_PIXELFORMAT_ARGB2101010 
SDL_PIXELFORMAT_ABGR2101010 
SDL_PIXELFORMAT_RGB48 
SDL_PIXELFORMAT_BGR48 
SDL_PIXELFORMAT_RGBA64 
SDL_PIXELFORMAT_ARGB64 
SDL_PIXELFORMAT_BGRA64 
SDL_PIXELFORMAT_ABGR64 
SDL_PIXELFORMAT_RGB48_FLOAT 
SDL_PIXELFORMAT_BGR48_FLOAT 
SDL_PIXELFORMAT_RGBA64_FLOAT 
SDL_PIXELFORMAT_ARGB64_FLOAT 
SDL_PIXELFORMAT_BGRA64_FLOAT 
SDL_PIXELFORMAT_ABGR64_FLOAT 
SDL_PIXELFORMAT_RGB96_FLOAT 
SDL_PIXELFORMAT_BGR96_FLOAT 
SDL_PIXELFORMAT_RGBA128_FLOAT 
SDL_PIXELFORMAT_ARGB128_FLOAT 
SDL_PIXELFORMAT_BGRA128_FLOAT 
SDL_PIXELFORMAT_ABGR128_FLOAT 
SDL_PIXELFORMAT_YV12 

Planar mode: Y + V + U (3 planes)

SDL_PIXELFORMAT_IYUV 

Planar mode: Y + U + V (3 planes)

SDL_PIXELFORMAT_YUY2 

Packed mode: Y0+U0+Y1+V0 (1 plane)

SDL_PIXELFORMAT_UYVY 

Packed mode: U0+Y0+V0+Y1 (1 plane)

SDL_PIXELFORMAT_YVYU 

Packed mode: Y0+V0+Y1+U0 (1 plane)

SDL_PIXELFORMAT_NV12 

Planar mode: Y + U/V interleaved (2 planes)

SDL_PIXELFORMAT_NV21 

Planar mode: Y + V/U interleaved (2 planes)

SDL_PIXELFORMAT_P010 

Planar mode: Y + U/V interleaved (2 planes)

SDL_PIXELFORMAT_EXTERNAL_OES 

Android video texture format

SDL_PIXELFORMAT_MJPG 

Motion JPEG

SDL_PIXELFORMAT_RGBA32 
SDL_PIXELFORMAT_ARGB32 
SDL_PIXELFORMAT_BGRA32 
SDL_PIXELFORMAT_ABGR32 
SDL_PIXELFORMAT_RGBX32 
SDL_PIXELFORMAT_XRGB32 
SDL_PIXELFORMAT_BGRX32 
SDL_PIXELFORMAT_XBGR32 

Definition at line 548 of file SDL_pixels.h.

549{
551 SDL_PIXELFORMAT_INDEX1LSB = 0x11100100u,
552 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX1, SDL_BITMAPORDER_4321, 0, 1, 0), */
553 SDL_PIXELFORMAT_INDEX1MSB = 0x11200100u,
554 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX1, SDL_BITMAPORDER_1234, 0, 1, 0), */
555 SDL_PIXELFORMAT_INDEX2LSB = 0x1c100200u,
556 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX2, SDL_BITMAPORDER_4321, 0, 2, 0), */
557 SDL_PIXELFORMAT_INDEX2MSB = 0x1c200200u,
558 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX2, SDL_BITMAPORDER_1234, 0, 2, 0), */
559 SDL_PIXELFORMAT_INDEX4LSB = 0x12100400u,
560 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX4, SDL_BITMAPORDER_4321, 0, 4, 0), */
561 SDL_PIXELFORMAT_INDEX4MSB = 0x12200400u,
562 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX4, SDL_BITMAPORDER_1234, 0, 4, 0), */
563 SDL_PIXELFORMAT_INDEX8 = 0x13000801u,
564 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_INDEX8, 0, 0, 8, 1), */
565 SDL_PIXELFORMAT_RGB332 = 0x14110801u,
566 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED8, SDL_PACKEDORDER_XRGB, SDL_PACKEDLAYOUT_332, 8, 1), */
567 SDL_PIXELFORMAT_XRGB4444 = 0x15120c02u,
568 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB, SDL_PACKEDLAYOUT_4444, 12, 2), */
569 SDL_PIXELFORMAT_XBGR4444 = 0x15520c02u,
570 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR, SDL_PACKEDLAYOUT_4444, 12, 2), */
571 SDL_PIXELFORMAT_XRGB1555 = 0x15130f02u,
572 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB, SDL_PACKEDLAYOUT_1555, 15, 2), */
573 SDL_PIXELFORMAT_XBGR1555 = 0x15530f02u,
574 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR, SDL_PACKEDLAYOUT_1555, 15, 2), */
575 SDL_PIXELFORMAT_ARGB4444 = 0x15321002u,
576 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ARGB, SDL_PACKEDLAYOUT_4444, 16, 2), */
577 SDL_PIXELFORMAT_RGBA4444 = 0x15421002u,
578 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_RGBA, SDL_PACKEDLAYOUT_4444, 16, 2), */
579 SDL_PIXELFORMAT_ABGR4444 = 0x15721002u,
580 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ABGR, SDL_PACKEDLAYOUT_4444, 16, 2), */
581 SDL_PIXELFORMAT_BGRA4444 = 0x15821002u,
582 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_BGRA, SDL_PACKEDLAYOUT_4444, 16, 2), */
583 SDL_PIXELFORMAT_ARGB1555 = 0x15331002u,
584 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ARGB, SDL_PACKEDLAYOUT_1555, 16, 2), */
585 SDL_PIXELFORMAT_RGBA5551 = 0x15441002u,
586 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_RGBA, SDL_PACKEDLAYOUT_5551, 16, 2), */
587 SDL_PIXELFORMAT_ABGR1555 = 0x15731002u,
588 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_ABGR, SDL_PACKEDLAYOUT_1555, 16, 2), */
589 SDL_PIXELFORMAT_BGRA5551 = 0x15841002u,
590 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_BGRA, SDL_PACKEDLAYOUT_5551, 16, 2), */
591 SDL_PIXELFORMAT_RGB565 = 0x15151002u,
592 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XRGB, SDL_PACKEDLAYOUT_565, 16, 2), */
593 SDL_PIXELFORMAT_BGR565 = 0x15551002u,
594 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED16, SDL_PACKEDORDER_XBGR, SDL_PACKEDLAYOUT_565, 16, 2), */
595 SDL_PIXELFORMAT_RGB24 = 0x17101803u,
596 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU8, SDL_ARRAYORDER_RGB, 0, 24, 3), */
597 SDL_PIXELFORMAT_BGR24 = 0x17401803u,
598 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU8, SDL_ARRAYORDER_BGR, 0, 24, 3), */
599 SDL_PIXELFORMAT_XRGB8888 = 0x16161804u,
600 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_XRGB, SDL_PACKEDLAYOUT_8888, 24, 4), */
601 SDL_PIXELFORMAT_RGBX8888 = 0x16261804u,
602 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_RGBX, SDL_PACKEDLAYOUT_8888, 24, 4), */
603 SDL_PIXELFORMAT_XBGR8888 = 0x16561804u,
604 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_XBGR, SDL_PACKEDLAYOUT_8888, 24, 4), */
605 SDL_PIXELFORMAT_BGRX8888 = 0x16661804u,
606 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_BGRX, SDL_PACKEDLAYOUT_8888, 24, 4), */
607 SDL_PIXELFORMAT_ARGB8888 = 0x16362004u,
608 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ARGB, SDL_PACKEDLAYOUT_8888, 32, 4), */
609 SDL_PIXELFORMAT_RGBA8888 = 0x16462004u,
610 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_RGBA, SDL_PACKEDLAYOUT_8888, 32, 4), */
611 SDL_PIXELFORMAT_ABGR8888 = 0x16762004u,
612 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ABGR, SDL_PACKEDLAYOUT_8888, 32, 4), */
613 SDL_PIXELFORMAT_BGRA8888 = 0x16862004u,
614 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_BGRA, SDL_PACKEDLAYOUT_8888, 32, 4), */
615 SDL_PIXELFORMAT_XRGB2101010 = 0x16172004u,
616 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_XRGB, SDL_PACKEDLAYOUT_2101010, 32, 4), */
617 SDL_PIXELFORMAT_XBGR2101010 = 0x16572004u,
618 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_XBGR, SDL_PACKEDLAYOUT_2101010, 32, 4), */
619 SDL_PIXELFORMAT_ARGB2101010 = 0x16372004u,
620 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ARGB, SDL_PACKEDLAYOUT_2101010, 32, 4), */
621 SDL_PIXELFORMAT_ABGR2101010 = 0x16772004u,
622 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_PACKED32, SDL_PACKEDORDER_ABGR, SDL_PACKEDLAYOUT_2101010, 32, 4), */
623 SDL_PIXELFORMAT_RGB48 = 0x18103006u,
624 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU16, SDL_ARRAYORDER_RGB, 0, 48, 6), */
625 SDL_PIXELFORMAT_BGR48 = 0x18403006u,
626 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU16, SDL_ARRAYORDER_BGR, 0, 48, 6), */
627 SDL_PIXELFORMAT_RGBA64 = 0x18204008u,
628 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU16, SDL_ARRAYORDER_RGBA, 0, 64, 8), */
629 SDL_PIXELFORMAT_ARGB64 = 0x18304008u,
630 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU16, SDL_ARRAYORDER_ARGB, 0, 64, 8), */
631 SDL_PIXELFORMAT_BGRA64 = 0x18504008u,
632 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU16, SDL_ARRAYORDER_BGRA, 0, 64, 8), */
633 SDL_PIXELFORMAT_ABGR64 = 0x18604008u,
634 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYU16, SDL_ARRAYORDER_ABGR, 0, 64, 8), */
635 SDL_PIXELFORMAT_RGB48_FLOAT = 0x1a103006u,
636 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF16, SDL_ARRAYORDER_RGB, 0, 48, 6), */
637 SDL_PIXELFORMAT_BGR48_FLOAT = 0x1a403006u,
638 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF16, SDL_ARRAYORDER_BGR, 0, 48, 6), */
639 SDL_PIXELFORMAT_RGBA64_FLOAT = 0x1a204008u,
640 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF16, SDL_ARRAYORDER_RGBA, 0, 64, 8), */
641 SDL_PIXELFORMAT_ARGB64_FLOAT = 0x1a304008u,
642 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF16, SDL_ARRAYORDER_ARGB, 0, 64, 8), */
643 SDL_PIXELFORMAT_BGRA64_FLOAT = 0x1a504008u,
644 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF16, SDL_ARRAYORDER_BGRA, 0, 64, 8), */
645 SDL_PIXELFORMAT_ABGR64_FLOAT = 0x1a604008u,
646 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF16, SDL_ARRAYORDER_ABGR, 0, 64, 8), */
647 SDL_PIXELFORMAT_RGB96_FLOAT = 0x1b10600cu,
648 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF32, SDL_ARRAYORDER_RGB, 0, 96, 12), */
649 SDL_PIXELFORMAT_BGR96_FLOAT = 0x1b40600cu,
650 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF32, SDL_ARRAYORDER_BGR, 0, 96, 12), */
651 SDL_PIXELFORMAT_RGBA128_FLOAT = 0x1b208010u,
652 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF32, SDL_ARRAYORDER_RGBA, 0, 128, 16), */
653 SDL_PIXELFORMAT_ARGB128_FLOAT = 0x1b308010u,
654 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF32, SDL_ARRAYORDER_ARGB, 0, 128, 16), */
655 SDL_PIXELFORMAT_BGRA128_FLOAT = 0x1b508010u,
656 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF32, SDL_ARRAYORDER_BGRA, 0, 128, 16), */
657 SDL_PIXELFORMAT_ABGR128_FLOAT = 0x1b608010u,
658 /* SDL_DEFINE_PIXELFORMAT(SDL_PIXELTYPE_ARRAYF32, SDL_ARRAYORDER_ABGR, 0, 128, 16), */
659
660 SDL_PIXELFORMAT_YV12 = 0x32315659u, /**< Planar mode: Y + V + U (3 planes) */
661 /* SDL_DEFINE_PIXELFOURCC('Y', 'V', '1', '2'), */
662 SDL_PIXELFORMAT_IYUV = 0x56555949u, /**< Planar mode: Y + U + V (3 planes) */
663 /* SDL_DEFINE_PIXELFOURCC('I', 'Y', 'U', 'V'), */
664 SDL_PIXELFORMAT_YUY2 = 0x32595559u, /**< Packed mode: Y0+U0+Y1+V0 (1 plane) */
665 /* SDL_DEFINE_PIXELFOURCC('Y', 'U', 'Y', '2'), */
666 SDL_PIXELFORMAT_UYVY = 0x59565955u, /**< Packed mode: U0+Y0+V0+Y1 (1 plane) */
667 /* SDL_DEFINE_PIXELFOURCC('U', 'Y', 'V', 'Y'), */
668 SDL_PIXELFORMAT_YVYU = 0x55595659u, /**< Packed mode: Y0+V0+Y1+U0 (1 plane) */
669 /* SDL_DEFINE_PIXELFOURCC('Y', 'V', 'Y', 'U'), */
670 SDL_PIXELFORMAT_NV12 = 0x3231564eu, /**< Planar mode: Y + U/V interleaved (2 planes) */
671 /* SDL_DEFINE_PIXELFOURCC('N', 'V', '1', '2'), */
672 SDL_PIXELFORMAT_NV21 = 0x3132564eu, /**< Planar mode: Y + V/U interleaved (2 planes) */
673 /* SDL_DEFINE_PIXELFOURCC('N', 'V', '2', '1'), */
674 SDL_PIXELFORMAT_P010 = 0x30313050u, /**< Planar mode: Y + U/V interleaved (2 planes) */
675 /* SDL_DEFINE_PIXELFOURCC('P', '0', '1', '0'), */
676 SDL_PIXELFORMAT_EXTERNAL_OES = 0x2053454fu, /**< Android video texture format */
677 /* SDL_DEFINE_PIXELFOURCC('O', 'E', 'S', ' ') */
678
679 SDL_PIXELFORMAT_MJPG = 0x47504a4du, /**< Motion JPEG */
680 /* SDL_DEFINE_PIXELFOURCC('M', 'J', 'P', 'G') */
681
682 /* Aliases for RGBA byte arrays of color data, for the current platform */
683 #if SDL_BYTEORDER == SDL_BIG_ENDIAN
692 #else
701 #endif
SDL_PixelFormat
Definition SDL_pixels.h:549
@ SDL_PIXELFORMAT_BGR48_FLOAT
Definition SDL_pixels.h:637
@ SDL_PIXELFORMAT_RGBA128_FLOAT
Definition SDL_pixels.h:651
@ SDL_PIXELFORMAT_BGR565
Definition SDL_pixels.h:593
@ SDL_PIXELFORMAT_EXTERNAL_OES
Definition SDL_pixels.h:676
@ SDL_PIXELFORMAT_ARGB64
Definition SDL_pixels.h:629
@ SDL_PIXELFORMAT_RGB332
Definition SDL_pixels.h:565
@ SDL_PIXELFORMAT_INDEX2LSB
Definition SDL_pixels.h:555
@ SDL_PIXELFORMAT_INDEX1LSB
Definition SDL_pixels.h:551
@ SDL_PIXELFORMAT_RGB96_FLOAT
Definition SDL_pixels.h:647
@ SDL_PIXELFORMAT_RGBX32
Definition SDL_pixels.h:688
@ SDL_PIXELFORMAT_ABGR4444
Definition SDL_pixels.h:579
@ SDL_PIXELFORMAT_BGRA4444
Definition SDL_pixels.h:581
@ SDL_PIXELFORMAT_BGR24
Definition SDL_pixels.h:597
@ SDL_PIXELFORMAT_INDEX4MSB
Definition SDL_pixels.h:561
@ SDL_PIXELFORMAT_ABGR2101010
Definition SDL_pixels.h:621
@ SDL_PIXELFORMAT_BGRA32
Definition SDL_pixels.h:686
@ SDL_PIXELFORMAT_XBGR2101010
Definition SDL_pixels.h:617
@ SDL_PIXELFORMAT_RGBA64_FLOAT
Definition SDL_pixels.h:639
@ SDL_PIXELFORMAT_INDEX2MSB
Definition SDL_pixels.h:557
@ SDL_PIXELFORMAT_BGRA64_FLOAT
Definition SDL_pixels.h:643
@ SDL_PIXELFORMAT_MJPG
Definition SDL_pixels.h:679
@ SDL_PIXELFORMAT_RGBA8888
Definition SDL_pixels.h:609
@ SDL_PIXELFORMAT_RGBA5551
Definition SDL_pixels.h:585
@ SDL_PIXELFORMAT_ARGB1555
Definition SDL_pixels.h:583
@ SDL_PIXELFORMAT_XBGR4444
Definition SDL_pixels.h:569
@ SDL_PIXELFORMAT_RGBA64
Definition SDL_pixels.h:627
@ SDL_PIXELFORMAT_INDEX8
Definition SDL_pixels.h:563
@ SDL_PIXELFORMAT_XRGB2101010
Definition SDL_pixels.h:615
@ SDL_PIXELFORMAT_XRGB8888
Definition SDL_pixels.h:599
@ SDL_PIXELFORMAT_BGRX32
Definition SDL_pixels.h:690
@ SDL_PIXELFORMAT_YV12
Definition SDL_pixels.h:660
@ SDL_PIXELFORMAT_ABGR32
Definition SDL_pixels.h:687
@ SDL_PIXELFORMAT_BGRX8888
Definition SDL_pixels.h:605
@ SDL_PIXELFORMAT_RGB24
Definition SDL_pixels.h:595
@ SDL_PIXELFORMAT_BGRA64
Definition SDL_pixels.h:631
@ SDL_PIXELFORMAT_ABGR8888
Definition SDL_pixels.h:611
@ SDL_PIXELFORMAT_XBGR32
Definition SDL_pixels.h:691
@ SDL_PIXELFORMAT_NV12
Definition SDL_pixels.h:670
@ SDL_PIXELFORMAT_BGRA8888
Definition SDL_pixels.h:613
@ SDL_PIXELFORMAT_ABGR128_FLOAT
Definition SDL_pixels.h:657
@ SDL_PIXELFORMAT_ARGB32
Definition SDL_pixels.h:685
@ SDL_PIXELFORMAT_ABGR1555
Definition SDL_pixels.h:587
@ SDL_PIXELFORMAT_NV21
Definition SDL_pixels.h:672
@ SDL_PIXELFORMAT_IYUV
Definition SDL_pixels.h:662
@ SDL_PIXELFORMAT_ARGB8888
Definition SDL_pixels.h:607
@ SDL_PIXELFORMAT_ABGR64_FLOAT
Definition SDL_pixels.h:645
@ SDL_PIXELFORMAT_ABGR64
Definition SDL_pixels.h:633
@ SDL_PIXELFORMAT_XRGB32
Definition SDL_pixels.h:689
@ SDL_PIXELFORMAT_XBGR1555
Definition SDL_pixels.h:573
@ SDL_PIXELFORMAT_RGB48
Definition SDL_pixels.h:623
@ SDL_PIXELFORMAT_XRGB4444
Definition SDL_pixels.h:567
@ SDL_PIXELFORMAT_BGR96_FLOAT
Definition SDL_pixels.h:649
@ SDL_PIXELFORMAT_ARGB4444
Definition SDL_pixels.h:575
@ SDL_PIXELFORMAT_RGB48_FLOAT
Definition SDL_pixels.h:635
@ SDL_PIXELFORMAT_BGR48
Definition SDL_pixels.h:625
@ SDL_PIXELFORMAT_RGBA32
Definition SDL_pixels.h:684
@ SDL_PIXELFORMAT_BGRA128_FLOAT
Definition SDL_pixels.h:655
@ SDL_PIXELFORMAT_ARGB64_FLOAT
Definition SDL_pixels.h:641
@ SDL_PIXELFORMAT_INDEX1MSB
Definition SDL_pixels.h:553
@ SDL_PIXELFORMAT_INDEX4LSB
Definition SDL_pixels.h:559
@ SDL_PIXELFORMAT_RGBX8888
Definition SDL_pixels.h:601
@ SDL_PIXELFORMAT_BGRA5551
Definition SDL_pixels.h:589
@ SDL_PIXELFORMAT_ARGB128_FLOAT
Definition SDL_pixels.h:653
@ SDL_PIXELFORMAT_XRGB1555
Definition SDL_pixels.h:571
@ SDL_PIXELFORMAT_RGB565
Definition SDL_pixels.h:591
@ SDL_PIXELFORMAT_XBGR8888
Definition SDL_pixels.h:603
@ SDL_PIXELFORMAT_ARGB2101010
Definition SDL_pixels.h:619
@ SDL_PIXELFORMAT_UNKNOWN
Definition SDL_pixels.h:550
@ SDL_PIXELFORMAT_RGBA4444
Definition SDL_pixels.h:577

◆ SDL_PixelType

Pixel type.

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_PIXELTYPE_UNKNOWN 
SDL_PIXELTYPE_INDEX1 
SDL_PIXELTYPE_INDEX4 
SDL_PIXELTYPE_INDEX8 
SDL_PIXELTYPE_PACKED8 
SDL_PIXELTYPE_PACKED16 
SDL_PIXELTYPE_PACKED32 
SDL_PIXELTYPE_ARRAYU8 
SDL_PIXELTYPE_ARRAYU16 
SDL_PIXELTYPE_ARRAYU32 
SDL_PIXELTYPE_ARRAYF16 
SDL_PIXELTYPE_ARRAYF32 
SDL_PIXELTYPE_INDEX2 

Definition at line 134 of file SDL_pixels.h.

◆ SDL_TransferCharacteristics

Colorspace transfer characteristics.

These are as described by https://www.itu.int/rec/T-REC-H.273-201612-S/en

Since
This enum is available since SDL 3.2.0.
Enumerator
SDL_TRANSFER_CHARACTERISTICS_UNKNOWN 
SDL_TRANSFER_CHARACTERISTICS_BT709 

Rec. ITU-R BT.709-6 / ITU-R BT1361

SDL_TRANSFER_CHARACTERISTICS_UNSPECIFIED 
SDL_TRANSFER_CHARACTERISTICS_GAMMA22 

ITU-R BT.470-6 System M / ITU-R BT1700 625 PAL & SECAM

SDL_TRANSFER_CHARACTERISTICS_GAMMA28 

ITU-R BT.470-6 System B, G

SDL_TRANSFER_CHARACTERISTICS_BT601 

SMPTE ST 170M / ITU-R BT.601-7 525 or 625

SDL_TRANSFER_CHARACTERISTICS_SMPTE240 

SMPTE ST 240M

SDL_TRANSFER_CHARACTERISTICS_LINEAR 
SDL_TRANSFER_CHARACTERISTICS_LOG100 
SDL_TRANSFER_CHARACTERISTICS_LOG100_SQRT10 
SDL_TRANSFER_CHARACTERISTICS_IEC61966 

IEC 61966-2-4

SDL_TRANSFER_CHARACTERISTICS_BT1361 

ITU-R BT1361 Extended Colour Gamut

SDL_TRANSFER_CHARACTERISTICS_SRGB 

IEC 61966-2-1 (sRGB or sYCC)

SDL_TRANSFER_CHARACTERISTICS_BT2020_10BIT 

ITU-R BT2020 for 10-bit system

SDL_TRANSFER_CHARACTERISTICS_BT2020_12BIT 

ITU-R BT2020 for 12-bit system

SDL_TRANSFER_CHARACTERISTICS_PQ 

SMPTE ST 2084 for 10-, 12-, 14- and 16-bit systems

SDL_TRANSFER_CHARACTERISTICS_SMPTE428 

SMPTE ST 428-1

SDL_TRANSFER_CHARACTERISTICS_HLG 

ARIB STD-B67, known as "hybrid log-gamma" (HLG)

SDL_TRANSFER_CHARACTERISTICS_CUSTOM 

Definition at line 760 of file SDL_pixels.h.

761{
763 SDL_TRANSFER_CHARACTERISTICS_BT709 = 1, /**< Rec. ITU-R BT.709-6 / ITU-R BT1361 */
765 SDL_TRANSFER_CHARACTERISTICS_GAMMA22 = 4, /**< ITU-R BT.470-6 System M / ITU-R BT1700 625 PAL & SECAM */
766 SDL_TRANSFER_CHARACTERISTICS_GAMMA28 = 5, /**< ITU-R BT.470-6 System B, G */
767 SDL_TRANSFER_CHARACTERISTICS_BT601 = 6, /**< SMPTE ST 170M / ITU-R BT.601-7 525 or 625 */
768 SDL_TRANSFER_CHARACTERISTICS_SMPTE240 = 7, /**< SMPTE ST 240M */
772 SDL_TRANSFER_CHARACTERISTICS_IEC61966 = 11, /**< IEC 61966-2-4 */
773 SDL_TRANSFER_CHARACTERISTICS_BT1361 = 12, /**< ITU-R BT1361 Extended Colour Gamut */
774 SDL_TRANSFER_CHARACTERISTICS_SRGB = 13, /**< IEC 61966-2-1 (sRGB or sYCC) */
775 SDL_TRANSFER_CHARACTERISTICS_BT2020_10BIT = 14, /**< ITU-R BT2020 for 10-bit system */
776 SDL_TRANSFER_CHARACTERISTICS_BT2020_12BIT = 15, /**< ITU-R BT2020 for 12-bit system */
777 SDL_TRANSFER_CHARACTERISTICS_PQ = 16, /**< SMPTE ST 2084 for 10-, 12-, 14- and 16-bit systems */
778 SDL_TRANSFER_CHARACTERISTICS_SMPTE428 = 17, /**< SMPTE ST 428-1 */
779 SDL_TRANSFER_CHARACTERISTICS_HLG = 18, /**< ARIB STD-B67, known as "hybrid log-gamma" (HLG) */
SDL_TransferCharacteristics
Definition SDL_pixels.h:761
@ SDL_TRANSFER_CHARACTERISTICS_BT709
Definition SDL_pixels.h:763
@ SDL_TRANSFER_CHARACTERISTICS_BT1361
Definition SDL_pixels.h:773
@ SDL_TRANSFER_CHARACTERISTICS_CUSTOM
Definition SDL_pixels.h:780
@ SDL_TRANSFER_CHARACTERISTICS_HLG
Definition SDL_pixels.h:779
@ SDL_TRANSFER_CHARACTERISTICS_LOG100_SQRT10
Definition SDL_pixels.h:771
@ SDL_TRANSFER_CHARACTERISTICS_UNKNOWN
Definition SDL_pixels.h:762
@ SDL_TRANSFER_CHARACTERISTICS_BT601
Definition SDL_pixels.h:767
@ SDL_TRANSFER_CHARACTERISTICS_IEC61966
Definition SDL_pixels.h:772
@ SDL_TRANSFER_CHARACTERISTICS_UNSPECIFIED
Definition SDL_pixels.h:764
@ SDL_TRANSFER_CHARACTERISTICS_SMPTE428
Definition SDL_pixels.h:778
@ SDL_TRANSFER_CHARACTERISTICS_LOG100
Definition SDL_pixels.h:770
@ SDL_TRANSFER_CHARACTERISTICS_GAMMA28
Definition SDL_pixels.h:766
@ SDL_TRANSFER_CHARACTERISTICS_SMPTE240
Definition SDL_pixels.h:768
@ SDL_TRANSFER_CHARACTERISTICS_BT2020_10BIT
Definition SDL_pixels.h:775
@ SDL_TRANSFER_CHARACTERISTICS_PQ
Definition SDL_pixels.h:777
@ SDL_TRANSFER_CHARACTERISTICS_LINEAR
Definition SDL_pixels.h:769
@ SDL_TRANSFER_CHARACTERISTICS_BT2020_12BIT
Definition SDL_pixels.h:776
@ SDL_TRANSFER_CHARACTERISTICS_GAMMA22
Definition SDL_pixels.h:765

Function Documentation

◆ SDL_CreatePalette()

SDL_Palette * SDL_CreatePalette ( int  ncolors)
extern

Create a palette structure with the specified number of color entries.

The palette entries are initialized to white.

Parameters
ncolorsrepresents the number of color entries in the color palette.
Returns
a new SDL_Palette structure on success or NULL on failure (e.g. if there wasn't enough memory); call SDL_GetError() for more information.

\threadsafety It is safe to call this function from any thread.

Since
This function is available since SDL 3.2.0.
See also
SDL_DestroyPalette
SDL_SetPaletteColors
SDL_SetSurfacePalette

◆ SDL_DestroyPalette()

void SDL_DestroyPalette ( SDL_Palette palette)
extern

Free a palette created with SDL_CreatePalette().

Parameters
palettethe SDL_Palette structure to be freed.

\threadsafety It is safe to call this function from any thread, as long as the palette is not modified or destroyed in another thread.

Since
This function is available since SDL 3.2.0.
See also
SDL_CreatePalette

◆ SDL_GetMasksForPixelFormat()

bool SDL_GetMasksForPixelFormat ( SDL_PixelFormat  format,
int *  bpp,
Uint32 Rmask,
Uint32 Gmask,
Uint32 Bmask,
Uint32 Amask 
)
extern

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

Parameters
formatone of the SDL_PixelFormat values.
bppa bits per pixel value; usually 15, 16, or 32.
Rmaska pointer filled in with the red mask for the format.
Gmaska pointer filled in with the green mask for the format.
Bmaska pointer filled in with the blue mask for the format.
Amaska pointer filled in with the alpha mask for the format.
Returns
true on success or false on failure; call SDL_GetError() for more information.

\threadsafety It is safe to call this function from any thread.

Since
This function is available since SDL 3.2.0.
See also
SDL_GetPixelFormatForMasks

◆ SDL_GetPixelFormatDetails()

const SDL_PixelFormatDetails * SDL_GetPixelFormatDetails ( SDL_PixelFormat  format)
extern

Create an SDL_PixelFormatDetails structure corresponding to a pixel format.

Returned structure may come from a shared global cache (i.e. not newly allocated), and hence should not be modified, especially the palette. Weird errors such as Blit combination not supported may occur.

Parameters
formatone of the SDL_PixelFormat values.
Returns
a pointer to a SDL_PixelFormatDetails structure or NULL on failure; call SDL_GetError() for more information.

\threadsafety It is safe to call this function from any thread.

Since
This function is available since SDL 3.2.0.

◆ SDL_GetPixelFormatForMasks()

SDL_PixelFormat SDL_GetPixelFormatForMasks ( int  bpp,
Uint32  Rmask,
Uint32  Gmask,
Uint32  Bmask,
Uint32  Amask 
)
extern

Convert a bpp value and RGBA masks to an enumerated pixel format.

This will return SDL_PIXELFORMAT_UNKNOWN if the conversion wasn't possible.

Parameters
bppa bits per pixel value; usually 15, 16, or 32.
Rmaskthe red mask for the format.
Gmaskthe green mask for the format.
Bmaskthe blue mask for the format.
Amaskthe alpha mask for the format.
Returns
the SDL_PixelFormat value corresponding to the format masks, or SDL_PIXELFORMAT_UNKNOWN if there isn't a match.

\threadsafety It is safe to call this function from any thread.

Since
This function is available since SDL 3.2.0.
See also
SDL_GetMasksForPixelFormat

◆ SDL_GetPixelFormatName()

const char * SDL_GetPixelFormatName ( SDL_PixelFormat  format)
extern

Get the human readable name of a pixel format.

Parameters
formatthe pixel format to query.
Returns
the human readable name of the specified pixel format or "SDL_PIXELFORMAT_UNKNOWN" if the format isn't recognized.

\threadsafety It is safe to call this function from any thread.

Since
This function is available since SDL 3.2.0.

◆ SDL_GetRGB()

void SDL_GetRGB ( Uint32  pixel,
const SDL_PixelFormatDetails format,
const SDL_Palette palette,
Uint8 r,
Uint8 g,
Uint8 b 
)
extern

Get RGB values from a pixel in the specified format.

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

Parameters
pixela pixel value.
formata pointer to SDL_PixelFormatDetails describing the pixel format.
palettean optional palette for indexed formats, may be NULL.
ra pointer filled in with the red component, may be NULL.
ga pointer filled in with the green component, may be NULL.
ba pointer filled in with the blue component, may be NULL.

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

Since
This function is available since SDL 3.2.0.
See also
SDL_GetPixelFormatDetails
SDL_GetRGBA
SDL_MapRGB
SDL_MapRGBA

◆ SDL_GetRGBA()

void SDL_GetRGBA ( Uint32  pixel,
const SDL_PixelFormatDetails format,
const SDL_Palette palette,
Uint8 r,
Uint8 g,
Uint8 b,
Uint8 a 
)
extern

Get RGBA values from a pixel in the specified format.

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

Parameters
pixela pixel value.
formata pointer to SDL_PixelFormatDetails describing the pixel format.
palettean optional palette for indexed formats, may be NULL.
ra pointer filled in with the red component, may be NULL.
ga pointer filled in with the green component, may be NULL.
ba pointer filled in with the blue component, may be NULL.
aa pointer filled in with the alpha component, may be NULL.

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

Since
This function is available since SDL 3.2.0.
See also
SDL_GetPixelFormatDetails
SDL_GetRGB
SDL_MapRGB
SDL_MapRGBA

◆ SDL_MapRGB()

Uint32 SDL_MapRGB ( const SDL_PixelFormatDetails format,
const SDL_Palette palette,
Uint8  r,
Uint8  g,
Uint8  b 
)
extern

Map an RGB triple to an opaque pixel value for a given pixel format.

This function maps the RGB color value to the specified pixel format and returns the pixel value best approximating the given RGB color value for the given pixel format.

If the format has a palette (8-bit) the index of the closest matching color in the palette will be returned.

If the specified pixel format has an alpha component it will be returned as all 1 bits (fully opaque).

If the pixel format bpp (color depth) is less than 32-bpp then the unused upper bits of the return value can safely be ignored (e.g., with a 16-bpp format the return value can be assigned to a Uint16, and similarly a Uint8 for an 8-bpp format).

Parameters
formata pointer to SDL_PixelFormatDetails describing the pixel format.
palettean optional palette for indexed formats, may be NULL.
rthe red component of the pixel in the range 0-255.
gthe green component of the pixel in the range 0-255.
bthe blue component of the pixel in the range 0-255.
Returns
a pixel value.

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

Since
This function is available since SDL 3.2.0.
See also
SDL_GetPixelFormatDetails
SDL_GetRGB
SDL_MapRGBA
SDL_MapSurfaceRGB

◆ SDL_MapRGBA()

Uint32 SDL_MapRGBA ( const SDL_PixelFormatDetails format,
const SDL_Palette palette,
Uint8  r,
Uint8  g,
Uint8  b,
Uint8  a 
)
extern

Map an RGBA quadruple to a pixel value for a given pixel format.

This function maps the RGBA color value to the specified pixel format and returns the pixel value best approximating the given RGBA color value for the given pixel format.

If the specified pixel format has no alpha component the alpha value will be ignored (as it will be in formats with a palette).

If the format has a palette (8-bit) the index of the closest matching color in the palette will be returned.

If the pixel format bpp (color depth) is less than 32-bpp then the unused upper bits of the return value can safely be ignored (e.g., with a 16-bpp format the return value can be assigned to a Uint16, and similarly a Uint8 for an 8-bpp format).

Parameters
formata pointer to SDL_PixelFormatDetails describing the pixel format.
palettean optional palette for indexed formats, may be NULL.
rthe red component of the pixel in the range 0-255.
gthe green component of the pixel in the range 0-255.
bthe blue component of the pixel in the range 0-255.
athe alpha component of the pixel in the range 0-255.
Returns
a pixel value.

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

Since
This function is available since SDL 3.2.0.
See also
SDL_GetPixelFormatDetails
SDL_GetRGBA
SDL_MapRGB
SDL_MapSurfaceRGBA

◆ SDL_SetPaletteColors()

bool SDL_SetPaletteColors ( SDL_Palette palette,
const SDL_Color colors,
int  firstcolor,
int  ncolors 
)
extern

Set a range of colors in a palette.

Parameters
palettethe SDL_Palette structure to modify.
colorsan array of SDL_Color structures to copy into the palette.
firstcolorthe index of the first palette entry to modify.
ncolorsthe number of entries to modify.
Returns
true on success or false on failure; call SDL_GetError() for more information.

\threadsafety It is safe to call this function from any thread, as long as the palette is not modified or destroyed in another thread.

Since
This function is available since SDL 3.2.0.