From b61c0f47d5de3731e484b54dc3e6da3b81c81711 Mon Sep 17 00:00:00 2001 From: Pekka Paalanen Date: Wed, 10 Oct 2012 12:47:48 +0300 Subject: [PATCH] protocol: clarify input region on drags and pointers Drag icon and cursor surfaces must never receive input, so their input region is always empty. Signed-off-by: Pekka Paalanen --- protocol/wayland.xml | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/protocol/wayland.xml b/protocol/wayland.xml index 4c089b8c..e5c8c91a 100644 --- a/protocol/wayland.xml +++ b/protocol/wayland.xml @@ -337,8 +337,13 @@ The icon surface is an optional (can be nil) surface that provides an icon to be moved around with the cursor. Initially, the top-left corner of the icon surface is placed at the cursor - hotspot, but subsequent surface.attach request can move the - relative position. + hotspot, but subsequent wl_surface.attach request can move the + relative position. Attach requests must be confirmed with + wl_surface.commit as usual. + + The current and pending input regions of the wl_surface are + cleared, and wl_surface.set_input_region is ignored until the + wl_surface is destroyed. @@ -747,7 +752,9 @@ wl_surface.set_input_region changes the pending input region. wl_surface.commit copies the pending region to the current region. - Otherwise the pending and current regions are never changed. + Otherwise the pending and current regions are never changed, + except cursor and icon surfaces are special cases, see + wl_pointer.set_cursor and wl_data_device.start_drag. The initial value for input region is infinite. That means the whole surface will accept input. Setting the pending input region has copy @@ -869,11 +876,16 @@ On surface.attach requests to the pointer surface, hotspot_x and hotspot_y are decremented by the x and y parameters - passed to the request. + passed to the request. Attach must be confirmed by + wl_surface.commit as usual. The hotspot can also be updated by passing the current set pointer surface to this request with new values for hotspot_x and/or hotspot_y. + + The current and pending input regions of the wl_surface are + cleared, and wl_surface.set_input_region is ignored until the + wl_surface is destroyed.