(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_GPUSwapchainComposition

Specifies the texture format and colorspace of the swapchain textures.

Header File

Defined in <SDL3/SDL_gpu.h>

Syntax

typedef enum SDL_GPUSwapchainComposition
{
    SDL_GPU_SWAPCHAINCOMPOSITION_SDR,
    SDL_GPU_SWAPCHAINCOMPOSITION_SDR_LINEAR,
    SDL_GPU_SWAPCHAINCOMPOSITION_HDR_EXTENDED_LINEAR,
    SDL_GPU_SWAPCHAINCOMPOSITION_HDR10_ST2048
} SDL_GPUSwapchainComposition;

Remarks

SDR will always be supported. Other compositions may not be supported on certain systems.

It is recommended to query SDL_WindowSupportsGPUSwapchainComposition after claiming the window if you wish to change the swapchain composition from SDR.

• SDR: B8G8R8A8 or R8G8B8A8 swapchain. Pixel values are in nonlinear sRGB encoding.
• SDR_LINEAR: B8G8R8A8_SRGB or R8G8B8A8_SRGB swapchain. Pixel values are in nonlinear sRGB encoding.
• HDR_EXTENDED_LINEAR: R16G16B16A16_SFLOAT swapchain. Pixel values are in extended linear encoding.
• HDR10_ST2048: A2R10G10B10 or A2B10G10R10 swapchain. Pixel values are in PQ ST2048 encoding.

Version

This enum is available since SDL 3.1.3

See Also

• SDL_SetGPUSwapchainParameters
• SDL_WindowSupportsGPUSwapchainComposition
• SDL_WaitAndAcquireGPUSwapchainTexture

---

CategoryAPI, CategoryAPIEnum, CategoryGPU

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.