fdo-mirrors/wayland-protocols
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wayland/wayland-protocols.git synced 2025-12-20 04:40:06 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

xdg-output: Remove and tweak contradicting examples

Browse source 
The "logical size" as stated by the first paragraph corresponds to the
monitor size in the global compositor space.

To most clients, this is unnecessary information, and should be ignored,
but some used the listed examples to derive information that contradicts
the very definition of what this event communicates.

One example tried to add surface size assumptions, which was not
correct. Remove this part completely, clients should not try to
configure their surface sizes from the logical size of a monitor.

The other is the list of size examples; it tried to communicate that a
compositor sometimes may not scale the viewport of the monitor in its
global compositor coordinate space, in which case, the logical size
itself matches the actual resolution. Tweak this wording to make that
clear that it does not related to any surface size.

Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
This commit is contained in:
Jonas Ådahl 2023-02-21 13:24:51 +01:00 • committed by Simon Ser
parent cf838fd316
commit 94482ceaf9
1 changed files with 5 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
unstable/xdg-output/xdg-output-unstable-v1.xml
View file

@ -117,10 +117,6 @@
The logical_size event describes the size of the output in the The logical_size event describes the size of the output in the
global compositor space. global compositor space.
For example, a surface without any buffer scale, transformation
nor rotation set, with the size matching the logical_size will
have the same size as the corresponding output when displayed.
Most regular Wayland clients should not pay attention to the Most regular Wayland clients should not pay attention to the
logical size and would rather rely on xdg_shell interfaces. logical size and would rather rely on xdg_shell interfaces.
@ -131,14 +127,14 @@
For example, for a wl_output mode 3840×2160 and a scale factor 2: For example, for a wl_output mode 3840×2160 and a scale factor 2:
- A compositor not scaling the surface buffers will advertise a - A compositor not scaling the monitor viewport in its compositing space
logical size of 3840×2160, will advertise a logical size of 3840×2160,
- A compositor automatically scaling the surface buffers will - A compositor scaling the monitor viewport with scale factor 2 will
advertise a logical size of 1920×1080, advertise a logical size of 1920×1080,
- A compositor using a fractional scale of 1.5 will advertise a - A compositor scaling the monitor viewport using a fractional scale of
logical size of 2560×1440. 1.5 will advertise a logical size of 2560×1440.
For example, for a wl_output mode 1920×1080 and a 90 degree rotation, For example, for a wl_output mode 1920×1080 and a 90 degree rotation,
the compositor will advertise a logical size of 1080x1920. the compositor will advertise a logical size of 1080x1920.