diff options
| author | Simon Ser <contact@emersion.fr> | 2020-04-16 19:08:53 +0200 |
|---|---|---|
| committer | Simon Ser <contact@emersion.fr> | 2020-10-29 13:07:20 +0000 |
| commit | 6741dafbf7a50e8a3f3b7667b4fecbf7c55f21ff (patch) | |
| tree | 2419a7e509a9b39ea74bfe3f71897e3046b95b70 | |
| parent | protocol: make it clear wl_surface.enter/leave are not for frame throttling (diff) | |
| download | wayland-6741dafbf7a50e8a3f3b7667b4fecbf7c55f21ff.tar wayland-6741dafbf7a50e8a3f3b7667b4fecbf7c55f21ff.tar.gz wayland-6741dafbf7a50e8a3f3b7667b4fecbf7c55f21ff.tar.bz2 wayland-6741dafbf7a50e8a3f3b7667b4fecbf7c55f21ff.tar.lz wayland-6741dafbf7a50e8a3f3b7667b4fecbf7c55f21ff.tar.xz wayland-6741dafbf7a50e8a3f3b7667b4fecbf7c55f21ff.tar.zst wayland-6741dafbf7a50e8a3f3b7667b4fecbf7c55f21ff.zip | |
protocol: deprecate non-current wl_output.mode
The current wl_output.mode event has several issues when used to advertise
modes that aren't current:
- It's not possible to remove some modes. This is an issue for virtual
outputs and when the kernel prunes some modes because of link limitations.
- wl_output.mode fails to carry metadata such as aspect ratio, which results
in duplicated or missing modes.
- It's not clear, given the current set of protocols, how non-current modes
are useful to clients. Xwayland ignores non-current modes.
GNOME and wlroots already only advertise the current mode because of these
issues.
If a protocol needs the clients to know about all available modes, it should
advertise these modes itself instead of relying on wl_output.mode.
Signed-off-by: Simon Ser <contact@emersion.fr>
Closes: https://gitlab.freedesktop.org/wayland/wayland/-/issues/92
| -rw-r--r-- | protocol/wayland.xml | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/protocol/wayland.xml b/protocol/wayland.xml index f896818..dce579d 100644 --- a/protocol/wayland.xml +++ b/protocol/wayland.xml @@ -2547,6 +2547,10 @@ current. In other words, the current mode is always the last mode that was received with the current flag set. + Non-current modes are deprecated. A compositor can decide to only + advertise the current mode and never send other modes. Clients + should not rely on non-current modes. + The size of a mode is given in physical hardware units of the output device. This is not necessarily the same as the output size in the global compositor space. For instance, |