SDL_GPUPresentMode3type
Specifies the timing that will be used to present swapchain textures to the os.
Usage
#include "SDL3/SDL.h"
typedef enum SDL_GPUPresentMode { SDL_GPU_PRESENTMODE_VSYNC, SDL_GPU_PRESENTMODE_IMMEDIATE, SDL_GPU_PRESENTMODE_MAILBOX } SDL_GPUPresentMode;
Header file
Defined in SDL3/SDL_gpu.h
Overview
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.