[PATCH wayland] protocol: Add minimize request and (un)maximize events.

Scott Moreau oreaus at gmail.com
Tue Oct 16 23:01:05 PDT 2012

In order for clients to notify the compositor that they wish to be minimized, a
minimize request is needed. This can be used to minimize the surface when a
user clicks the clients minimize button.

The compositor needs a way to tell clients to maximize and unmaximize their
surfaces. The desktop shell client can ask the compositor that a surface be
sent an (un)maximized event, in response to a panel button for example.


Hi Kristian,

I wanted to present these patches while we are breaking the protocol last minute.
They should be harmless since none of the paths are reached, just stubs put in
place. This would allow us to make the shell client more featureful, especially
utilizing the upcoming surface_data interface. So I'm proposing that we make
provisions for these basic necessities now, if it's not too much trouble.



 protocol/wayland.xml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index 019816d..be37646 100644
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -594,6 +594,14 @@
       <arg name="output" type="object" interface="wl_output" allow-null="true"/>
+    <request name="set_minimized">
+      <description summary="minimize the surface">
+	A request from the client to notify the compositor that it wants to be
+	minimized. While in this state, the client is responsible for making
+	sure that its buffer contents are ready to be shown at any given time.
+      </description>
+    </request>
     <request name="set_title">
       <description summary="set surface title">
@@ -640,6 +648,20 @@
 	to the client owning the popup surface.
+    <event name="maximize">
+      <description summary="suggest maximize">
+	The maximize event is to signal to the client that it should become
+	maximized.
+      </description>
+    </event>
+    <event name="unmaximize">
+      <description summary="suggest unmaximize">
+	The unmaximize event is to signal to the client that it should become
+	unmaximized.
+      </description>
+    </event>
   <interface name="wl_surface" version="1">

More information about the wayland-devel mailing list