render: SDL_HINT_RENDER_DRIVER now accepts a comma-separated list.

Fixes #11077.
This commit is contained in:
Ryan C. Gordon
2025-01-21 11:23:04 -05:00
parent 670a7d8126
commit c45c4a5e51
3 changed files with 35 additions and 18 deletions

View File

@@ -2900,6 +2900,10 @@ extern "C" {
* - "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.
*
@@ -3289,6 +3293,10 @@ extern "C" {
* 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 accepts a comma-separated list of driver names, and each will
* be tried in the order listed during init, until one succeeds or all of them
* fail.
*
* This hint should be set before SDL is initialized.
*
* \since This hint is available since SDL 3.1.3.

View File

@@ -219,6 +219,9 @@ extern SDL_DECLSPEC bool SDLCALL SDL_CreateWindowAndRenderer(const char *title,
* don't need a specific renderer, specify NULL and SDL will attempt to choose
* the best option for you, based on what is available on the user's system.
*
* If `name` is a comma-separated list, SDL will try each name, in the order
* listed, until one succeeds or all of them fail.
*
* By default the rendering size matches the window size in pixels, but you
* can call SDL_SetRenderLogicalPresentation() to change the content size and
* scaling options.