SDL_HINT_VIDEO_DOUBLE_BUFFER(3)

SDL_HINT_VIDEO_DOUBLE_BUFFER3

Tell the video driver that we only want a double buffer.

Usage

#include "SDL3/SDL.h"

#define SDL_HINT_VIDEO_DOUBLE_BUFFER SDL_VIDEO_DOUBLE_BUFFER"

Header file

Defined in SDL3/SDL_hints.h

Overview

By default, most lowlevel 2D APIs will use a triple buffer scheme that wastes no CPU time on waiting for vsync after issuing a flip, but introduces a frame of latency. On the other hand, using a double buffer scheme instead is recommended for cases where low latency is an important factor because we save a whole frame of latency.

We do so by waiting for vsync immediately after issuing a flip, usually just after eglSwapBuffers call in the backend's *_SwapWindow function.

This hint is currently supported on the following drivers:

• Raspberry Pi (raspberrypi)

• Wayland (wayland)

This hint should be set before SDL is initialized.

Availability

This hint is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.