Sync SDL3 wiki -> header

This commit is contained in:
SDL Wiki Bot 2024-02-12 17:55:23 +00:00
parent dca2721b91
commit 59f1e66adc

View File

@ -842,7 +842,8 @@ extern DECLSPEC SDL_Window *SDLCALL SDL_CreatePopupWindow(SDL_Window *parent, in
* be always on top
* - `SDL_PROP_WINDOW_CREATE_BORDERLESS_BOOLEAN`: true if the window has no
* window decoration
* - `SDL_PROP_WINDOW_CREATE_EXTERNAL_GRAPHICS_CONTEXT_BOOLEAN`: true if the window will be used with an externally managed graphics context.
* - `SDL_PROP_WINDOW_CREATE_EXTERNAL_GRAPHICS_CONTEXT_BOOLEAN`: true if the
* window will be used with an externally managed graphics context.
* - `SDL_PROP_WINDOW_CREATE_FOCUSABLE_BOOLEAN`: true if the window should
* accept keyboard input (defaults true)
* - `SDL_PROP_WINDOW_CREATE_FULLSCREEN_BOOLEAN`: true if the window should
@ -895,18 +896,18 @@ extern DECLSPEC SDL_Window *SDLCALL SDL_CreatePopupWindow(SDL_Window *parent, in
*
* These are additional supported properties on Wayland:
*
* - `SDL_PROP_WINDOW_CREATE_WAYLAND_SCALE_TO_DISPLAY_BOOLEAN` - 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.
* - `SDL_PROP_WINDOW_CREATE_WAYLAND_SCALE_TO_DISPLAY_BOOLEAN` - 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.
* - `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