diff --git a/docs/README-wayland.md b/docs/README-wayland.md index d07be3b0d..85ac3e5d6 100644 --- a/docs/README-wayland.md +++ b/docs/README-wayland.md @@ -8,7 +8,7 @@ encounter limitations or behavior that is different from other windowing systems ### 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 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 diff --git a/include/SDL3/SDL_video.h b/include/SDL3/SDL_video.h index fe0842897..8b8d280d8 100644 --- a/include/SDL3/SDL_video.h +++ b/include/SDL3/SDL_video.h @@ -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 * 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 - * 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. Potential - * issues include, but are not limited to: rounding errors can result when - * odd window sizes/scales are used, the window may be unusably small, the - * window may jump in visible size at times, the window may appear to be - * larger than the desktop space, and possible loss of cursor precision can - * occur. New applications should be designed with proper DPI awareness and - * handling instead of enabling this. + * 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. + * Potential issues include, but are not limited to: rounding errors can + * result when odd window sizes/scales are used, the window may be unusably + * small, the window may jump in visible size at times, the window may + * appear to be larger than the desktop space, and possible loss of cursor + * precision can occur. New applications should be designed with proper DPI + * awareness and handling instead of enabling this. * - `SDL_PROP_WINDOW_CREATE_WAYLAND_SURFACE_ROLE_CUSTOM_BOOLEAN` - true if * the application wants to use the Wayland surface for a custom role and * does not want it attached to an XDG toplevel window. See