NAME

       SDL_GPUPresentMode - Specifies the timing that will be used to present swapchain textures to the OS.

SYNOPSIS

       #include <SDL3/SDL_gpu.h>

       typedef enum SDL_GPUPresentMode
       {
           SDL_GPU_PRESENTMODE_VSYNC,
           SDL_GPU_PRESENTMODE_IMMEDIATE,
           SDL_GPU_PRESENTMODE_MAILBOX
       } SDL_GPUPresentMode;

DESCRIPTION

       VSYNC mode will always be supported. IMMEDIATE and MAILBOX modes may not be supported on certain systems.

       It  is  recommended  to  query  SDL_WindowSupportsGPUPresentMode after claiming the window if you wish to
       change the present mode to IMMEDIATE or MAILBOX.

       • VSYNC: Waits for vblank before presenting. No tearing is possible. If  there  is  a  pending  image  to
       present, the new image is enqueued for presentation. Disallows tearing at the cost of visual latency.

       • IMMEDIATE: Immediately presents. Lowest latency option, but tearing may occur.

       •  MAILBOX:  Waits  for  vblank before presenting. No tearing is possible. If there is a pending image to
       present, the pending image is replaced by the new image.  Similar  to  VSYNC,  but  with  reduced  visual
       latency.

AVAILABILITY

       This enum is available since SDL 3.2.0.

SEE ALSO

       SDL_SetGPUSwapchainParameters(3),                                    SDL_WindowSupportsGPUPresentMode(3),
       SDL_WaitAndAcquireGPUSwapchainTexture(3)

Simple Directmedia Layer                           SDL 3.2.28                          SDL_GPUPresentMode(3type)