(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_HINT_RENDER_DRIVER

A variable specifying which render driver to use.

Header File

Defined in <SDL3/SDL_hints.h>

Syntax

#define SDL_HINT_RENDER_DRIVER "SDL_RENDER_DRIVER"

Remarks

If the application doesn't pick a specific renderer to use, this variable specifies the name of the preferred renderer. If the preferred renderer can't be initialized, creating a renderer will fail.

This variable is case insensitive and can be set to the following values:

• "direct3d"
• "direct3d11"
• "direct3d12"
• "opengl"
• "opengles2"
• "opengles"
• "metal"
• "vulkan"
• "software"

The default varies by platform, but it's the first one in the list that is available on the current platform.

This hint should be set before creating a renderer.

Version

This hint is available since SDL 3.1.3.

---

CategoryAPI, CategoryAPIMacro, CategoryHints

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.