devela::_dep::sdl3::hint::names

Constant RENDER_DRIVER

pub const RENDER_DRIVER: &'static str;
Available on crate feature dep_sdl3 only.
Expand description

A variable specifying which render driver to use.

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.