NAME

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

HEADER FILE

       Defined in SDL3/SDL_gpu.h

SYNOPSIS

       #include "SDL3/SDL.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

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

Simple Directmedia Layer                            SDL 3.2.8                          SDL_GPUPresentMode(3type)