mirrors/wayland
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wayland/wayland.git synced 2025-10-29 05:40:16 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

protocol: clarify divergence in compositor behaviour

Browse source 
This is intended to only document the current situation. Whether further
behaviour will be defined is out of scope and left for protocol v7.

See: https://gitlab.freedesktop.org/wayland/wayland/-/merge_requests/363
Signed-off-by: Hugo Osvaldo Barrera <hugo@whynothugo.nl>
This commit is contained in:
Hugo Osvaldo Barrera 2024-05-08 20:54:19 +02:00
parent 0b1626f473
commit 26c419e046
1 changed files with 9 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

12
protocol/wayland.xml
View file

@ -1514,9 +1514,15 @@
mutates the underlying buffer storage, the surface contents become mutates the underlying buffer storage, the surface contents become
undefined immediately. undefined immediately.
If wl_surface.attach is sent with a NULL wl_buffer, or the pending If wl_surface.attach is sent with a NULL wl_buffer, the
wl_buffer has been destroyed, the following wl_surface.commit will following wl_surface.commit will remove the surface content.
remove the surface content.
If a pending wl_buffer has been destroyed, the result is not specified.
Many compositors are known to remove the surface content on the following
wl_surface.commit, but this behaviour is not universal. Clients seeking to
maximise compatibility should not destroy pending buffers and should
ensure that they explicitly remove content from surfaces, even after
destroying buffers.
</description> </description>
<arg name="buffer" type="object" interface="wl_buffer" allow-null="true" <arg name="buffer" type="object" interface="wl_buffer" allow-null="true"
summary="buffer of surface contents"/> summary="buffer of surface contents"/>