plucky (3) SDL_HINT_RENDER_DRIVER.3.gz

Provided by: libsdl3-doc_3.2.4+ds-2_all bug

NAME

       SDL_HINT_RENDER_DRIVER - A variable specifying which render driver to use.

HEADER FILE

       Defined in SDL3/SDL_hints.h

SYNOPSIS

       #include "SDL3/SDL.h"

       #define SDL_HINT_RENDER_DRIVER SDL_RENDER_DRIVER"

DESCRIPTION

       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"

       • "gpu"

       • "software"

       This hint accepts a comma-separated list of driver names, and each will be tried in the order listed when
       creating a renderer until one succeeds or all of them fail.

       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.

AVAILABILITY

       This hint is available since SDL 3.2.0.