summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKirill Chibisov <contact@kchibisov.com>2023-05-31 10:56:58 +0300
committerSimon Ser <contact@emersion.fr>2023-07-03 09:17:26 +0000
commit174b3487a2ac33d6f93f5313b5eccd65db2a2f12 (patch)
tree06b933375ab031e843a8385e087c93f5e25babae
parent3c1fb30817dc85a5b900f255f6260531d4b6c220 (diff)
stable/xdg-shell: clarify initial wl_surface acknowledgement
Clarify how and when initial wl_surface state provided by the core protocol or by extensions to the wl_surface, like as wp_fractional_scale_v1, is being delivered. The motivation for such change is to make it clear that the first frame for xdg-shell will be perfect, which implies that scaling and similar properties affecting presentation would be delivered in time. Signed-off-by: Kirill Chibisov <contact@kchibisov.com>
-rw-r--r--stable/xdg-shell/xdg-shell.xml6
1 files changed, 4 insertions, 2 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml
index b83c129..777eaa7 100644
--- a/stable/xdg-shell/xdg-shell.xml
+++ b/stable/xdg-shell/xdg-shell.xml
@@ -436,8 +436,10 @@
After creating a role-specific object and setting it up, the client must
perform an initial commit without any buffer attached. The compositor
- will reply with an xdg_surface.configure event. The client must
- acknowledge it and is then allowed to attach a buffer to map the surface.
+ will reply with initial wl_surface state such as
+ wl_surface.preferred_buffer_scale followed by an xdg_surface.configure
+ event. The client must acknowledge it and is then allowed to attach a
+ buffer to map the surface.
Mapping an xdg_surface-based role surface is defined as making it
possible for the surface to be shown by the compositor. Note that