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

Constant VIDEO_DISPLAY_PRIORITY

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

A comma separated list containing the names of the displays that SDL should sort to the front of the display list.

When this hint is set, displays with matching name strings will be prioritized in the list of displays, as exposed by calling [SDL_GetDisplays()], with the first listed becoming the primary display. The naming convention can vary depending on the environment, but it is usually a connector name (e.g. ‘DP-1’, ‘DP-2’, ‘HDMI-A-1’,etc…).

On Wayland and X11 desktops, the connector names associated with displays can typically be found by using the xrandr utility.

This hint is currently supported on the following drivers:

  • KMSDRM (kmsdrm)
  • Wayland (wayland)
  • X11 (x11)

This hint should be set before SDL is initialized.

§Availability

This hint is available since SDL 3.2.0.