Chromium Code Reviews| OLD | NEW |
|---|---|
| 1 <?xml version="1.0" encoding="UTF-8"?> | 1 <?xml version="1.0" encoding="UTF-8"?> |
| 2 <protocol name="remote_shell_unstable_v1"> | 2 <protocol name="remote_shell_unstable_v1"> |
| 3 | 3 |
| 4 <copyright> | 4 <copyright> |
| 5 Copyright 2016 The Chromium Authors. | 5 Copyright 2016 The Chromium Authors. |
| 6 | 6 |
| 7 Permission is hereby granted, free of charge, to any person obtaining a | 7 Permission is hereby granted, free of charge, to any person obtaining a |
| 8 copy of this software and associated documentation files (the "Software"), | 8 copy of this software and associated documentation files (the "Software"), |
| 9 to deal in the Software without restriction, including without limitation | 9 to deal in the Software without restriction, including without limitation |
| 10 the rights to use, copy, modify, merge, publish, distribute, sublicense, | 10 the rights to use, copy, modify, merge, publish, distribute, sublicense, |
| (...skipping 20 matching lines...) Expand all Loading... | |
| 31 Warning! The protocol described in this file is experimental and backward | 31 Warning! The protocol described in this file is experimental and backward |
| 32 incompatible changes may be made. Backward compatible changes may be added | 32 incompatible changes may be made. Backward compatible changes may be added |
| 33 together with the corresponding interface version bump. Backward | 33 together with the corresponding interface version bump. Backward |
| 34 incompatible changes are done by bumping the version number in the protocol | 34 incompatible changes are done by bumping the version number in the protocol |
| 35 and interface names and resetting the interface version. Once the protocol | 35 and interface names and resetting the interface version. Once the protocol |
| 36 is to be declared stable, the 'z' prefix and the version number in the | 36 is to be declared stable, the 'z' prefix and the version number in the |
| 37 protocol and interface names are removed and the interface version number is | 37 protocol and interface names are removed and the interface version number is |
| 38 reset. | 38 reset. |
| 39 </description> | 39 </description> |
| 40 | 40 |
| 41 <interface name="zwp_remote_shell_v1" version="1"> | 41 <interface name="zwp_remote_shell_v1" version="2"> |
| 42 <description summary="remote_shell"> | 42 <description summary="remote_shell"> |
| 43 The global interface that allows clients to turn a wl_surface into a | 43 The global interface that allows clients to turn a wl_surface into a |
| 44 "real window" which is remotely managed but can be stacked, activated | 44 "real window" which is remotely managed but can be stacked, activated |
| 45 and made fullscreen by the user. | 45 and made fullscreen by the user. |
| 46 </description> | 46 </description> |
| 47 | 47 |
| 48 <enum name="container"> | 48 <enum name="container"> |
| 49 <description summary="containers for remote surfaces"> | 49 <description summary="containers for remote surfaces"> |
| 50 Determine how a remote surface should be stacked relative to other | 50 Determine how a remote surface should be stacked relative to other |
| 51 shell surfaces. | 51 shell surfaces. |
| (...skipping 46 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 98 | 98 |
| 99 <event name="activated"> | 99 <event name="activated"> |
| 100 <description summary="activated surface changed"> | 100 <description summary="activated surface changed"> |
| 101 Notifies client that the activated surface changed. | 101 Notifies client that the activated surface changed. |
| 102 </description> | 102 </description> |
| 103 <arg name="gained_active" type="object" interface="wl_surface" allow-null= "true"/> | 103 <arg name="gained_active" type="object" interface="wl_surface" allow-null= "true"/> |
| 104 <arg name="lost_active" type="object" interface="wl_surface" allow-null="t rue"/> | 104 <arg name="lost_active" type="object" interface="wl_surface" allow-null="t rue"/> |
| 105 </event> | 105 </event> |
| 106 </interface> | 106 </interface> |
| 107 | 107 |
| 108 <interface name="zwp_remote_surface_v1" version="1"> | 108 <interface name="zwp_remote_surface_v1" version="2"> |
| 109 <description summary="A desktop window"> | 109 <description summary="A desktop window"> |
| 110 An interface that may be implemented by a wl_surface, for | 110 An interface that may be implemented by a wl_surface, for |
| 111 implementations that provide a desktop-style user interface | 111 implementations that provide a desktop-style user interface |
| 112 and allows for remotely managed windows. | 112 and allows for remotely managed windows. |
| 113 | 113 |
| 114 It provides requests to treat surfaces like windows, allowing to set | 114 It provides requests to treat surfaces like windows, allowing to set |
| 115 properties like app id and geometry. | 115 properties like app id and geometry. |
| 116 | 116 |
| 117 The client must call wl_surface.commit on the corresponding wl_surface | 117 The client must call wl_surface.commit on the corresponding wl_surface |
| 118 for the remote_surface state to take effect. | 118 for the remote_surface state to take effect. |
| (...skipping 76 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 195 The close event is sent by the compositor when the user | 195 The close event is sent by the compositor when the user |
| 196 wants the surface to be closed. This should be equivalent to | 196 wants the surface to be closed. This should be equivalent to |
| 197 the user clicking the close button in client-side decorations, | 197 the user clicking the close button in client-side decorations, |
| 198 if your application has any... | 198 if your application has any... |
| 199 | 199 |
| 200 This is only a request that the user intends to close your | 200 This is only a request that the user intends to close your |
| 201 window. The client may choose to ignore this request, or show | 201 window. The client may choose to ignore this request, or show |
| 202 a dialog to ask the user to save their data... | 202 a dialog to ask the user to save their data... |
| 203 </description> | 203 </description> |
| 204 </event> | 204 </event> |
| 205 | |
| 206 <!-- Version 2 additions --> | |
| 207 | |
| 208 <request name="fullscreen" since="2"> | |
| 209 <description summary="fullscreen"> | |
| 210 Request that surface is made fullscreen. | |
| 211 | |
| 212 This is only a request that the window should be made fullscreen. | |
| 213 The compositor may choose to ignore this request. The client should | |
| 214 listen to set_fullscreen events to determine if the window was | |
| 215 made fullscreen or not. | |
| 216 </description> | |
| 217 </request> | |
| 218 | |
| 219 <request name="maximize" since="2"> | |
| 220 <description summary="maximize"> | |
| 221 Request that surface is maximized. The window geometry will be updated | |
| 222 to whatever the compositor finds appropriate for a maximized window. | |
| 223 | |
| 224 This is only a request that the window should be maximized. The | |
| 225 compositor may choose to ignore this request. The client should | |
| 226 listen to set_maximized events to determine if the window was | |
| 227 maximized or not. | |
| 228 </description> | |
| 229 </request> | |
| 230 | |
| 231 <request name="minimize" since="2"> | |
| 232 <description summary="minimize"> | |
| 233 Request that surface is minimized. | |
| 234 | |
| 235 This is only a request that the window should be maximized. The | |
|
mtomasz
2016/06/03 03:56:42
nit: maximized -> minimized?
reveman
2016/06/03 11:25:30
done
| |
| 236 compositor may choose to ignore this request. The client should | |
| 237 listen to set_minimized events to determine if the window was | |
| 238 minimized or not. | |
| 239 </description> | |
| 240 </request> | |
| 241 | |
| 242 <request name="restore" since="2"> | |
| 243 <description summary="restore"> | |
| 244 Request that surface is restored. This restores the window geometry | |
| 245 to what it was before the window was minimized, maximized or made | |
| 246 fullscreen. | |
| 247 | |
| 248 This is only a request that the window should be restored. The | |
| 249 compositor may choose to ignore this request. The client should | |
| 250 listen to unset_maximized, unset_minimize and unset_fullscreen | |
| 251 events to determine if the window was restored or not. | |
| 252 </description> | |
| 253 </request> | |
| 254 | |
| 255 <event name="set_maximized" since="2"> | |
| 256 <description summary="surface wants to be maximized"> | |
| 257 The set_maximized event is sent by the compositor when the user | |
| 258 wants the surface to be maximized. | |
| 259 | |
| 260 This is only a request that the user intends to maximized the window. | |
| 261 The client may choose to ignore this request. | |
| 262 </description> | |
| 263 </event> | |
| 264 | |
| 265 <event name="unset_maximized" since="2"> | |
| 266 <description summary="surface wants to be restored"> | |
| 267 The unset_maximized event is sent by the compositor when the user | |
| 268 wants the surface to be made visible. | |
| 269 | |
| 270 This is only a request that the user intends to make your | |
| 271 window visible. The client may choose to ignore this request. | |
| 272 </description> | |
| 273 </event> | |
| 274 | |
| 275 <event name="set_minimize" since="2"> | |
|
mtomasz
2016/06/03 06:30:30
nit: set_minimized
reveman
2016/06/03 11:25:29
done
| |
| 276 <description summary="surface wants to be minimized"> | |
| 277 The set_minimized event is sent by the compositor when the user | |
| 278 wants the surface to be minimized. | |
| 279 | |
| 280 This is only a request that the user intends to minimize the window. | |
| 281 The client may choose to ignore this request. | |
| 282 </description> | |
| 283 </event> | |
| 284 | |
| 285 <event name="unset_minimized" since="2"> | |
| 286 <description summary="surface wants to be restored"> | |
| 287 The unset_minimized event is sent by the compositor when the user | |
| 288 wants the surface to be made visible. | |
| 289 | |
| 290 This is only a request that the user intends to make your | |
| 291 window visible. The client may choose to ignore this request. | |
| 292 </description> | |
| 293 </event> | |
| 205 </interface> | 294 </interface> |
| 206 | 295 |
| 207 </protocol> | 296 </protocol> |
| OLD | NEW |