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

# SDL\_Colorspace(3type)

Colorspace definitions.

## NAME

SDL\_Colorspace - Colorspace definitions.

## HEADER FILE

Defined in SDL3/SDL\_pixels.h

## SYNOPSIS

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

**typedef enum SDL\_Colorspace** **{**     **SDL\_COLORSPACE\_UNKNOWN = 0,**     **/\* sRGB is a gamma corrected colorspace, and the default colorspace for SDL rendering and 8-bit RGB surfaces \*/**     **SDL\_COLORSPACE\_SRGB = 0x120005a0u, /\*\*\< Equivalent to DXGI\_COLOR\_SPACE\_RGB\_FULL\_G22\_NONE\_P709 \*/**         **/\* SDL\_DEFINE\_COLORSPACE(SDL\_COLOR\_TYPE\_RGB,**                                  **SDL\_COLOR\_RANGE\_FULL,**                                  **SDL\_COLOR\_PRIMARIES\_BT709,**                                  **SDL\_TRANSFER\_CHARACTERISTICS\_SRGB,**                                  **SDL\_MATRIX\_COEFFICIENTS\_IDENTITY,**                                  **SDL\_CHROMA\_LOCATION\_NONE), \*/**     **/\* 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 \*/**     **SDL\_COLORSPACE\_SRGB\_LINEAR = 0x12000500u, /\*\*\< Equivalent to DXGI\_COLOR\_SPACE\_RGB\_FULL\_G10\_NONE\_P709  \*/**         **/\* SDL\_DEFINE\_COLORSPACE(SDL\_COLOR\_TYPE\_RGB,**                                  **SDL\_COLOR\_RANGE\_FULL,**                                  **SDL\_COLOR\_PRIMARIES\_BT709,**                                  **SDL\_TRANSFER\_CHARACTERISTICS\_LINEAR,**                                  **SDL\_MATRIX\_COEFFICIENTS\_IDENTITY,**                                  **SDL\_CHROMA\_LOCATION\_NONE), \*/**     **/\* HDR10 is a non-linear HDR colorspace and the default colorspace for 10-bit surfaces \*/**     **SDL\_COLORSPACE\_HDR10 = 0x12002600u, /\*\*\< Equivalent to DXGI\_COLOR\_SPACE\_RGB\_FULL\_G2084\_NONE\_P2020  \*/**         **/\* SDL\_DEFINE\_COLORSPACE(SDL\_COLOR\_TYPE\_RGB,**                                  **SDL\_COLOR\_RANGE\_FULL,**                                  **SDL\_COLOR\_PRIMARIES\_BT2020,**                                  **SDL\_TRANSFER\_CHARACTERISTICS\_PQ,**                                  **SDL\_MATRIX\_COEFFICIENTS\_IDENTITY,**                                  **SDL\_CHROMA\_LOCATION\_NONE), \*/**     **SDL\_COLORSPACE\_JPEG = 0x220004c6u, /\*\*\< Equivalent to DXGI\_COLOR\_SPACE\_YCBCR\_FULL\_G22\_NONE\_P709\_X601 \*/**         **/\* SDL\_DEFINE\_COLORSPACE(SDL\_COLOR\_TYPE\_YCBCR,**                                  **SDL\_COLOR\_RANGE\_FULL,**                                  **SDL\_COLOR\_PRIMARIES\_BT709,**                                  **SDL\_TRANSFER\_CHARACTERISTICS\_BT601,**                                  **SDL\_MATRIX\_COEFFICIENTS\_BT601,**                                  **SDL\_CHROMA\_LOCATION\_NONE), \*/**     **SDL\_COLORSPACE\_BT601\_LIMITED = 0x211018c6u, /\*\*\< Equivalent to DXGI\_COLOR\_SPACE\_YCBCR\_STUDIO\_G22\_LEFT\_P601 \*/**         **/\* SDL\_DEFINE\_COLORSPACE(SDL\_COLOR\_TYPE\_YCBCR,**                                  **SDL\_COLOR\_RANGE\_LIMITED,**                                  **SDL\_COLOR\_PRIMARIES\_BT601,**                                  **SDL\_TRANSFER\_CHARACTERISTICS\_BT601,**                                  **SDL\_MATRIX\_COEFFICIENTS\_BT601,**                                  **SDL\_CHROMA\_LOCATION\_LEFT), \*/**     **SDL\_COLORSPACE\_BT601\_FULL = 0x221018c6u, /\*\*\< Equivalent to DXGI\_COLOR\_SPACE\_YCBCR\_STUDIO\_G22\_LEFT\_P601 \*/**         **/\* SDL\_DEFINE\_COLORSPACE(SDL\_COLOR\_TYPE\_YCBCR,**                                  **SDL\_COLOR\_RANGE\_FULL,**                                  **SDL\_COLOR\_PRIMARIES\_BT601,**                                  **SDL\_TRANSFER\_CHARACTERISTICS\_BT601,**                                  **SDL\_MATRIX\_COEFFICIENTS\_BT601,**                                  **SDL\_CHROMA\_LOCATION\_LEFT), \*/**     **SDL\_COLORSPACE\_BT709\_LIMITED = 0x21100421u, /\*\*\< Equivalent to DXGI\_COLOR\_SPACE\_YCBCR\_STUDIO\_G22\_LEFT\_P709 \*/**         **/\* SDL\_DEFINE\_COLORSPACE(SDL\_COLOR\_TYPE\_YCBCR,**                                  **SDL\_COLOR\_RANGE\_LIMITED,**                                  **SDL\_COLOR\_PRIMARIES\_BT709,**                                  **SDL\_TRANSFER\_CHARACTERISTICS\_BT709,**                                  **SDL\_MATRIX\_COEFFICIENTS\_BT709,**                                  **SDL\_CHROMA\_LOCATION\_LEFT), \*/**     **SDL\_COLORSPACE\_BT709\_FULL = 0x22100421u, /\*\*\< Equivalent to DXGI\_COLOR\_SPACE\_YCBCR\_STUDIO\_G22\_LEFT\_P709 \*/**         **/\* SDL\_DEFINE\_COLORSPACE(SDL\_COLOR\_TYPE\_YCBCR,**                                  **SDL\_COLOR\_RANGE\_FULL,**                                  **SDL\_COLOR\_PRIMARIES\_BT709,**                                  **SDL\_TRANSFER\_CHARACTERISTICS\_BT709,**                                  **SDL\_MATRIX\_COEFFICIENTS\_BT709,**                                  **SDL\_CHROMA\_LOCATION\_LEFT), \*/**     **SDL\_COLORSPACE\_BT2020\_LIMITED = 0x21102609u, /\*\*\< Equivalent to DXGI\_COLOR\_SPACE\_YCBCR\_STUDIO\_G22\_LEFT\_P2020 \*/**         **/\* SDL\_DEFINE\_COLORSPACE(SDL\_COLOR\_TYPE\_YCBCR,**                                  **SDL\_COLOR\_RANGE\_LIMITED,**                                  **SDL\_COLOR\_PRIMARIES\_BT2020,**                                  **SDL\_TRANSFER\_CHARACTERISTICS\_PQ,**                                  **SDL\_MATRIX\_COEFFICIENTS\_BT2020\_NCL,**                                  **SDL\_CHROMA\_LOCATION\_LEFT), \*/**     **SDL\_COLORSPACE\_BT2020\_FULL = 0x22102609u, /\*\*\< Equivalent to DXGI\_COLOR\_SPACE\_YCBCR\_FULL\_G22\_LEFT\_P2020 \*/**         **/\* SDL\_DEFINE\_COLORSPACE(SDL\_COLOR\_TYPE\_YCBCR,**                                  **SDL\_COLOR\_RANGE\_FULL,**                                  **SDL\_COLOR\_PRIMARIES\_BT2020,**                                  **SDL\_TRANSFER\_CHARACTERISTICS\_PQ,**                                  **SDL\_MATRIX\_COEFFICIENTS\_BT2020\_NCL,**                                  **SDL\_CHROMA\_LOCATION\_LEFT), \*/**     **SDL\_COLORSPACE\_RGB\_DEFAULT = SDL\_COLORSPACE\_SRGB, /\*\*\< The default colorspace for RGB surfaces if no colorspace is specified \*/**     **SDL\_COLORSPACE\_YUV\_DEFAULT = SDL\_COLORSPACE\_JPEG  /\*\*\< The default colorspace for YUV surfaces if no colorspace is specified \*/** **} SDL\_Colorspace;**

## DESCRIPTION

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.

## AVAILABILITY

This enum is available since SDL 3.2.0.

## SEE ALSO

**•**(3), [**SDL\_ColorPrimaries**(3type)](/SDL_ColorPrimaries/3type.md), **•**(3), [**SDL\_ColorRange**(3type)](/SDL_ColorRange/3type.md), **•**(3), [**SDL\_ColorType**(3type)](/SDL_ColorType/3type.md), **•**(3), [**SDL\_MatrixCoefficients**(3type)](/SDL_MatrixCoefficients/3type.md), **•**(3), [**SDL\_TransferCharacteristics**(3type)](/SDL_TransferCharacteristics/3type.md)