geemili
/
SDL
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Sync SDL3 wiki -> header

main
SDL Wiki Bot 2024-01-28 18:32:23 +00:00
parent fbebbab90d
commit 00a8ca403e
2 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/README-wayland.md
View File

@ -8,7 +8,7 @@ encounter limitations or behavior that is different from other windowing systems
### Legacy, DPI-unaware applications are blurry ### Legacy, DPI-unaware applications are blurry
- Wayland handles high-DPI displays by scaling the desktop, which causes applications that are not designed to be - Wayland handles high-DPI displays by scaling the desktop, which causes applications that are not designed to be
DPI-aware to be automatically scaled by the window manager, which results in them being blurry. SDL can _attempt_ to DPI-aware to be automatically scaled by the window manager, which results in them being blurry. SDL can _attempt_ to
scale these applications such that they will be output with a 1:1 pixel aspect, however this may be buggy, especially scale these applications such that they will be output with a 1:1 pixel aspect, however this may be buggy, especially
with odd-sized windows and/or scale factors that aren't quarter-increments (125%, 150%, etc...). To enable this, set with odd-sized windows and/or scale factors that aren't quarter-increments (125%, 150%, etc...). To enable this, set

18
include/SDL3/SDL_video.h
View File

@ -886,15 +886,15 @@ extern DECLSPEC SDL_Window *SDLCALL SDL_CreatePopupWindow(SDL_Window *parent, in
* - `SDL_PROP_WINDOW_CREATE_WAYLAND_SCALE_TO_DISPLAY` - true if the window * - `SDL_PROP_WINDOW_CREATE_WAYLAND_SCALE_TO_DISPLAY` - true if the window
* should use forced scaling designed to produce 1:1 pixel mapping if not * should use forced scaling designed to produce 1:1 pixel mapping if not
* flagged as being DPI-aware. This is intended to allow legacy applications * flagged as being DPI-aware. This is intended to allow legacy applications
* to be displayed without desktop scaling being applied, and has issues with * to be displayed without desktop scaling being applied, and has issues
* certain display configurations, as this forces the window to behave in a * with certain display configurations, as this forces the window to behave
* way that Wayland desktops were not designed to accommodate. Potential * in a way that Wayland desktops were not designed to accommodate.
* issues include, but are not limited to: rounding errors can result when * Potential issues include, but are not limited to: rounding errors can
* odd window sizes/scales are used, the window may be unusably small, the * result when odd window sizes/scales are used, the window may be unusably
* window may jump in visible size at times, the window may appear to be * small, the window may jump in visible size at times, the window may
* larger than the desktop space, and possible loss of cursor precision can * appear to be larger than the desktop space, and possible loss of cursor
* occur. New applications should be designed with proper DPI awareness and * precision can occur. New applications should be designed with proper DPI
* handling instead of enabling this. * awareness and handling instead of enabling this.
* - `SDL_PROP_WINDOW_CREATE_WAYLAND_SURFACE_ROLE_CUSTOM_BOOLEAN` - true if * - `SDL_PROP_WINDOW_CREATE_WAYLAND_SURFACE_ROLE_CUSTOM_BOOLEAN` - true if
* the application wants to use the Wayland surface for a custom role and * the application wants to use the Wayland surface for a custom role and
* does not want it attached to an XDG toplevel window. See * does not want it attached to an XDG toplevel window. See