(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_HINT_VIDEO_DRIVER

A variable that specifies a video backend to use.

Header File

Defined in <SDL3/SDL_hints.h>

Syntax

#define SDL_HINT_VIDEO_DRIVER "SDL_VIDEO_DRIVER"

Remarks

By default, SDL will try all available video backends in a reasonable order until it finds one that can work, but this hint allows the app or user to force a specific target, such as "x11" if, say, you are on Wayland but want to try talking to the X server instead.

This hint should be set before SDL is initialized.

Version

This hint is available since SDL 3.0.0.

CategoryAPI, CategoryAPIMacro, CategoryHints