aboutsummaryrefslogtreecommitdiffstats
path: root/protocol
diff options
context:
space:
mode:
authorSimon Ser <contact@emersion.fr>2018-11-05 13:57:00 +0000
committerDerek Foreman <derek.foreman.samsung@gmail.com>2018-11-30 09:25:14 -0600
commit921d0548035673a1bf6aeb9396b9bc728133411e (patch)
tree1f4c1442b77dfabdce62280e6df5fd7d88b097f4 /protocol
parentprotocol: Bump seat to version 7 and require keymaps be private (diff)
downloadwayland-921d0548035673a1bf6aeb9396b9bc728133411e.tar
wayland-921d0548035673a1bf6aeb9396b9bc728133411e.tar.gz
wayland-921d0548035673a1bf6aeb9396b9bc728133411e.tar.bz2
wayland-921d0548035673a1bf6aeb9396b9bc728133411e.tar.lz
wayland-921d0548035673a1bf6aeb9396b9bc728133411e.tar.xz
wayland-921d0548035673a1bf6aeb9396b9bc728133411e.tar.zst
wayland-921d0548035673a1bf6aeb9396b9bc728133411e.zip
protocol: prefer wl_surface.damage_buffer
This commit makes wl_surface.damage_buffer preferred over wl_surface.damage. wl_surface.damage can be implemented in a non-optimal way by the compositor (e.g. by always damaging the whole buffer). Having two requests makes it complicated for the compositor to handle damage, making it necessary to transform one into the other's coordinates. Moreover, integration with wp_viewporter is tricky. Signed-off-by: Simon Ser <contact@emersion.fr> Acked-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk> Reviewed-by: Derek Foreman <derek.foreman.samsung@gmail.com>
Diffstat (limited to 'protocol')
-rw-r--r--protocol/wayland.xml6
1 files changed, 3 insertions, 3 deletions
diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index 802d433..ea04623 100644
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -1397,9 +1397,9 @@
and clears pending damage. The server will clear the current
damage as it repaints the surface.
- Alternatively, damage can be posted with wl_surface.damage_buffer
- which uses buffer coordinates instead of surface coordinates,
- and is probably the preferred and intuitive way of doing this.
+ Note! New clients should not use this request. Instead damage can be
+ posted with wl_surface.damage_buffer which uses buffer coordinates
+ instead of surface coordinates.
</description>
<arg name="x" type="int" summary="surface-local x coordinate"/>
<arg name="y" type="int" summary="surface-local y coordinate"/>