WIP

third_party/wayland-protocols/unstable/remote-shell/remote-shell-unstable-v1.xml

 <?xml version="1.0" encoding="UTF-8"?>
 <protocol name="remote_shell_unstable_v1">
 
   <copyright>
     Copyright 2016 The Chromium Authors.
 
     Permission is hereby granted, free of charge, to any person obtaining a
     copy of this software and associated documentation files (the "Software"),
     to deal in the Software without restriction, including without limitation
     the rights to use, copy, modify, merge, publish, distribute, sublicense,
@@ skipping 20 matching lines @@
     Warning! The protocol described in this file is experimental and backward
     incompatible changes may be made. Backward compatible changes may be added
     together with the corresponding interface version bump. Backward
     incompatible changes are done by bumping the version number in the protocol
     and interface names and resetting the interface version. Once the protocol
     is to be declared stable, the 'z' prefix and the version number in the
     protocol and interface names are removed and the interface version number is
     reset.
   </description>
 
-  <interface name="zcr_remote_shell_v1" version="5">
+  <interface name="zcr_remote_shell_v1" version="6">
     <description summary="remote_shell">
       The global interface that allows clients to turn a wl_surface into a
       "real window" which is remotely managed but can be stacked, activated
       and made fullscreen by the user.
     </description>
 
     <enum name="container">
       <description summary="containers for remote surfaces">
         Determine how a remote surface should be stacked relative to other
         shell surfaces.
@@ skipping 81 matching lines @@
       <arg name="height" type="int"/>
       <arg name="transform" type="int"/>
       <arg name="scale_factor" type="fixed"/>
       <arg name="work_area_inset_left" type="int"/>
       <arg name="work_area_inset_top" type="int"/>
       <arg name="work_area_inset_right" type="int"/>
       <arg name="work_area_inset_bottom" type="int"/>
       <arg name="layout_mode" type="uint"/>
     </event>
 
-    <!-- Version 5 additions -->
+    <!-- Version 6 additions -->
 
-    <event name="workspace" since="5">
+    <event name="workspace" since="6">
       <description summary="area of remote shell">
         Defines an area of the remote shell used for layout. Each series of
         "workspace" events must be terminated by a "configure" event.
       </description>
       <arg name="id_hi" type="uint"/>
       <arg name="id_lo" type="uint"/>
       <arg name="x" type="int"/>
       <arg name="y" type="int"/>
       <arg name="width" type="int"/>
       <arg name="height" type="int"/>
       <arg name="inset_left" type="int"/>
       <arg name="inset_top" type="int"/>
       <arg name="inset_right" type="int"/>
       <arg name="inset_bottom" type="int"/>
       <arg name="transform" type="int"/>
       <arg name="scale_factor" type="fixed"/>
     </event>
 
-    <event name="configure" since="5">
+    <event name="configure" since="6">
       <description summary="suggests configuration of remote shell">
         Suggests a new configuration of the remote shell. Preceded by a series
         of "workspace" events.
       </description>
       <arg name="layout_mode" type="uint"/>
     </event>
   </interface>
 
-  <interface name="zcr_remote_surface_v1" version="5">
+  <interface name="zcr_remote_surface_v1" version="6">
     <description summary="A desktop window">
       An interface that may be implemented by a wl_surface, for
       implementations that provide a desktop-style user interface
       and allows for remotely managed windows.
 
       It provides requests to treat surfaces like windows, allowing to set
       properties like app id and geometry.
 
       The client must call wl_surface.commit on the corresponding wl_surface
       for the remote_surface state to take effect.
@@ skipping 278 matching lines @@
       <description summary="unset always on top">
         Request that surface is made to be not always on top.
 
         This is only a request that the window should be not always on top.
         The compositor may choose to ignore this request.
       </description>
     </request>
 
     <!-- Version 5 additions -->
 
-    <event name="configure" since="5">
+    <request name="set_icon_png_chunk" since="5">
+      <description summary="Set a chunk of surface icon">
+        Set a chunk of surface custom icon compressed in png format.
+
+        This icon may be used to show the task icon in a task bar.
+
+        If flag contains 0x1 bit then this is the first chunk of data.
+        If flag contains 0x2 bit then this is the last chunk of data.
+        Both bits may be set or not set.
+      </description>
+      <arg name="flags" type="uint"/>
+      <arg name="chunk" type="array"/>
+    </request>
+
+    <request name="reset_icon_png" since="5">
+      <description summary="Reset surface icon">
+        This reset any previosly set surface custom icon.
+
+        Default app icon will be used to show the task icon in a task bar.
+      </description>
+    </request>
+
+    <!-- Version 6 additions -->
+
+    <event name="configure" since="6">
       <description summary="suggest a surface change">
         The configure event asks the client to change surface state.
 
         The client must apply the origin offset to window positions in
         set_window_geometry requests.
 
         The states listed in the event are state_type values, and might change
         due to a client request or an event directly handled by the compositor.
 
         Clients should arrange their surface for the new state, and then send an
         ack_configure request with the serial sent in this configure event at
         some point before committing the new surface.
 
         If the client receives multiple configure events before it can respond
         to one, it is free to discard all but the last event it received.
       </description>
       <arg name="origin_offset_x" type="int"/>
       <arg name="origin_offset_y" type="int"/>
       <arg name="states" type="array"/>
       <arg name="serial" type="uint"/>
     </event>
 
-    <request name="ack_configure" since="5">
+    <request name="ack_configure" since="6">
       <description summary="ack a configure event">
         When a configure event is received, if a client commits the
         surface in response to the configure event, then the client
         must make an ack_configure request sometime before the commit
         request, passing along the serial of the configure event.
 
         For instance, the compositor might use this information during display
         configuration to change its coordinate space for set_window_geometry
         requests only when the client has switched to the new coordinate space.
 
         If the client receives multiple configure events before it
         can respond to one, it only has to ack the last configure event.
 
         A client is not required to commit immediately after sending
         an ack_configure request - it may even ack_configure several times
         before its next surface commit.
 
         A client may send multiple ack_configure requests before committing, but
         only the last request sent before a commit indicates which configure
         event the client really is responding to.
       </description>
       <arg name="serial" type="uint" summary="the serial from the configure event"/>
     </request>
 
-    <request name="move" since="5">
+    <request name="move" since="6">
       <description summary="start an interactive move">
         Start an interactive, user-driven move of the surface.
 
         The compositor responds to this request with a configure event that
         transitions to the "moving" state. The client must only initiate motion
         after acknowledging the state change. The compositor can assume that
         subsequent set_window_geometry requests are position updates until the
         next state transition is acknowledged.
 
         The compositor may ignore move requests depending on the state of the
@@ skipping 10 matching lines @@
     </description>
 
     <request name="destroy" type="destructor">
       <description summary="Destroy the notification_surface">
         Unmap and destroy the notification surface.
       </description>
     </request>
   </interface>
 
 </protocol>