---
name: "SDL_HINT_VIDEO_DISPLAY_PRIORITY"
section: "3"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_HINT_VIDEO_DISPLAY_PRIORITY"
---

# SDL\_HINT\_VIDEO\_DISPLAY\_PRIORITY(3)

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

## NAME

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

## SYNOPSIS

```
#include "SDL3/SDL.h"
```

**#define SDL\_HINT\_VIDEO\_DISPLAY\_PRIORITY** *SDL\_VIDEO\_DISPLAY\_PRIORITY"*

## DESCRIPTION

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',

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.