From 58384280d75c15b451d690908e9c7fba3e788b16 Mon Sep 17 00:00:00 2001 From: Yuxuan Shui Date: Mon, 6 Feb 2023 22:52:59 +0000 Subject: [PATCH] protocol: clarify when wl_surface.enter events are sent It was unclear what happens when a output global is bound. I believe the expectation is that all surfaces on that output will receive enter. Also make it explicit a surface must be mapped, i.e. have both content and role, to enter an output. Signed-off-by: Yuxuan Shui --- protocol/wayland.xml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/protocol/wayland.xml b/protocol/wayland.xml index a94e85c2..d911d47a 100644 --- a/protocol/wayland.xml +++ b/protocol/wayland.xml @@ -1635,7 +1635,7 @@ This is emitted whenever a surface's creation, movement, or resizing results in some part of it being within the scanout region of an - output. + output. A surface must be mapped before it can enter any outputs. Note that a surface may be overlapping with zero or more outputs. @@ -2562,6 +2562,9 @@ actually visible. This typically corresponds to a monitor that displays part of the compositor space. This object is published as global during start up, or when a monitor is hotplugged. + + When an output global is first bound, wl_surface.enter events should be + sent for all surfaces already on that output.