NAME

       SDL_GPUSwapchainComposition - Specifies the texture format and colorspace of the swapchain textures.

HEADER FILE

       Defined in SDL3/SDL_gpu.h

SYNOPSIS

       #include "SDL3/SDL.h"

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

DESCRIPTION

       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 sRGB encoding.

       • SDR_LINEAR: B8G8R8A8_SRGB or R8G8B8A8_SRGB swapchain. Pixel values are
         stored in memory in sRGB encoding but accessed in shaders in "linear
         sRGB" encoding which is sRGB but with a linear transfer function.

       • HDR_EXTENDED_LINEAR: R16G16B16A16_FLOAT swapchain. Pixel values are in
         extended linear sRGB encoding and permits values outside of the [0, 1]
         range.

       • HDR10_ST2084: A2R10G10B10 or A2B10G10R10 swapchain. Pixel values are in
         BT.2020 ST2084 (PQ) encoding.

AVAILABILITY

       This enum is available since SDL 3.2.0.

SEE ALSO

       •(3),   SDL_SetGPUSwapchainParameters(3),   •(3),   SDL_WindowSupportsGPUSwapchainComposition(3),   •(3),
       SDL_WaitAndAcquireGPUSwapchainTexture(3)

Simple Directmedia Layer                            SDL 3.2.8                 SDL_GPUSwapchainComposition(3type)