(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_HINT_VIDEO_WAYLAND_SCALE_TO_DISPLAY

A variable forcing non-DPI-aware Wayland windows to output at 1:1 scaling.

Header File

Defined in <SDL3/SDL_hints.h>

Syntax

#define SDL_HINT_VIDEO_WAYLAND_SCALE_TO_DISPLAY "SDL_VIDEO_WAYLAND_SCALE_TO_DISPLAY"

Remarks

When this hint is set, Wayland windows that are not flagged as being DPI-aware will be output with scaling designed to force 1:1 pixel mapping.

This is intended to allow legacy applications to be displayed without desktop scaling being applied, and has issues with certain display configurations, as this forces the window to behave in a way that Wayland desktops were not designed to accommodate:

• Rounding errors can result with odd window sizes and/or desktop scales.
• The window may be unusably small.
• The window may jump in size at times.
• The window may appear to be larger than the desktop size to the application.
• Possible loss of cursor precision.

New applications should be designed with proper DPI awareness handling instead of enabling this.

The variable can be set to the following values:

• "0": Windows will be scaled normally.
• "1": Windows will be forced to scale to achieve 1:1 output.

This hint should be set before creating a window.

Version

This hint is available since SDL 3.0.0.

---

CategoryAPI, CategoryAPIMacro

---

[ edit | delete | history | feedback | raw ]

[ 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.