SDL_GPUPresentMode.3type - Man Page

Defined in SDL3/SDL_gpu.h

#include "SDL3/SDL.h"

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

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.

This enum is available since SDL 3.2.0.

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