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

SDL_HINT_VIDEO_DISPLAY_PRIORITY

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

Header File

Defined in <SDL3/SDL_hints.h>

Syntax

#define SDL_HINT_VIDEO_DISPLAY_PRIORITY "SDL_VIDEO_DISPLAY_PRIORITY"

Remarks

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.

Version

This hint is available since SDL 3.2.0.

---

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.