From 17e49ba8443d76f05df89c9663e3661af292a1a4 Mon Sep 17 00:00:00 2001 From: Drew DeVault Date: Fri, 2 Aug 2019 17:17:32 -0400 Subject: [PATCH] Improve description of wl_surface The original text makes some assumptions about surfaces which may not be true and fails to capture some details which are important to the essential traits of a wl_surface. --- protocol/wayland.xml | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/protocol/wayland.xml b/protocol/wayland.xml index 50fe381c..94d4222a 100644 --- a/protocol/wayland.xml +++ b/protocol/wayland.xml @@ -1279,8 +1279,10 @@ - A surface is a rectangular area that is displayed on the screen. - It has a location, size and pixel contents. + A surface is a rectangular area that may be displayed on zero + or more outputs, and shown any number of times at the compositor's + discretion. They can present wl_buffers, receive user input, and + define a local coordinate system. The size of a surface (and relative positions on it) is described in surface-local coordinates, which may differ from the buffer