| 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="8"> | 41 <interface name="zwp_remote_shell_v1" version="7"> |
| 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 12 matching lines...) Expand all Loading... |
| 64 <entry name="fullscreen" value="4" summary="fullscreen window state"/> | 64 <entry name="fullscreen" value="4" summary="fullscreen window state"/> |
| 65 <entry name="pinned" value="5" summary="pinned window state"/> | 65 <entry name="pinned" value="5" summary="pinned window state"/> |
| 66 </enum> | 66 </enum> |
| 67 | 67 |
| 68 <enum name="error"> | 68 <enum name="error"> |
| 69 <entry name="role" value="0" summary="given wl_surface has another role"/> | 69 <entry name="role" value="0" summary="given wl_surface has another role"/> |
| 70 <entry name="invalid_notification_id" value="1" | 70 <entry name="invalid_notification_id" value="1" |
| 71 summary="invalid notification id"/> | 71 summary="invalid notification id"/> |
| 72 </enum> | 72 </enum> |
| 73 | 73 |
| 74 <enum name="layout_mode"> | |
| 75 <description summary="the layout mode"> | |
| 76 Determine how a client should layout surfaces. | |
| 77 </description> | |
| 78 <entry name="windowed" value="1" summary="multiple windows"/> | |
| 79 <entry name="tablet" value="2" summary="restricted mode for tablet"/> | |
| 80 </enum> | |
| 81 | |
| 82 <request name="destroy" type="destructor"> | 74 <request name="destroy" type="destructor"> |
| 83 <description summary="destroy remote_shell"> | 75 <description summary="destroy remote_shell"> |
| 84 Destroy this remote_shell object. | 76 Destroy this remote_shell object. |
| 85 | 77 |
| 86 Destroying a bound remote_shell object while there are surfaces | 78 Destroying a bound remote_shell object while there are surfaces |
| 87 still alive created by this remote_shell object instance is illegal | 79 still alive created by this remote_shell object instance is illegal |
| 88 and will result in a protocol error. | 80 and will result in a protocol error. |
| 89 </description> | 81 </description> |
| 90 </request> | 82 </request> |
| 91 | 83 |
| (...skipping 37 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 129 | 121 |
| 130 <request name="get_notification_surface" since="6"> | 122 <request name="get_notification_surface" since="6"> |
| 131 <description summary="create a notification surface from a surface"> | 123 <description summary="create a notification surface from a surface"> |
| 132 Creates a notification_surface for the given surface, gives it the | 124 Creates a notification_surface for the given surface, gives it the |
| 133 notification_surface role and associated it with a notification id. | 125 notification_surface role and associated it with a notification id. |
| 134 </description> | 126 </description> |
| 135 <arg name="id" type="new_id" interface="zwp_notification_surface_v1"/> | 127 <arg name="id" type="new_id" interface="zwp_notification_surface_v1"/> |
| 136 <arg name="surface" type="object" interface="wl_surface"/> | 128 <arg name="surface" type="object" interface="wl_surface"/> |
| 137 <arg name="notification_id" type="string" /> | 129 <arg name="notification_id" type="string" /> |
| 138 </request> | 130 </request> |
| 139 | |
| 140 <!-- Version 8 additions --> | |
| 141 | |
| 142 <event name="layout_mode_changed" since="8"> | |
| 143 <description summary="layout mode changed"> | |
| 144 The shell_mode_changed event is sent by the compositor when | |
| 145 the shell mode was changed. | |
| 146 | |
| 147 This is an event to notify that the shell mode has switched. | |
| 148 </description> | |
| 149 <arg name="layout_mode" type="uint"/> | |
| 150 </event> | |
| 151 </interface> | 131 </interface> |
| 152 | 132 |
| 153 <interface name="zwp_remote_surface_v1" version="8"> | 133 <interface name="zwp_remote_surface_v1" version="7"> |
| 154 <description summary="A desktop window"> | 134 <description summary="A desktop window"> |
| 155 An interface that may be implemented by a wl_surface, for | 135 An interface that may be implemented by a wl_surface, for |
| 156 implementations that provide a desktop-style user interface | 136 implementations that provide a desktop-style user interface |
| 157 and allows for remotely managed windows. | 137 and allows for remotely managed windows. |
| 158 | 138 |
| 159 It provides requests to treat surfaces like windows, allowing to set | 139 It provides requests to treat surfaces like windows, allowing to set |
| 160 properties like app id and geometry. | 140 properties like app id and geometry. |
| 161 | 141 |
| 162 The client must call wl_surface.commit on the corresponding wl_surface | 142 The client must call wl_surface.commit on the corresponding wl_surface |
| 163 for the remote_surface state to take effect. | 143 for the remote_surface state to take effect. |
| (...skipping 284 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 448 The state_type_changed event is sent by the compositor when the surface | 428 The state_type_changed event is sent by the compositor when the surface |
| 449 state changed. | 429 state changed. |
| 450 | 430 |
| 451 This is an event to notify that the window state changed in compositor. | 431 This is an event to notify that the window state changed in compositor. |
| 452 The state change may be triggered by a client's request, or some user | 432 The state change may be triggered by a client's request, or some user |
| 453 action directly handled by the compositor. The client may choose to | 433 action directly handled by the compositor. The client may choose to |
| 454 ignore this event. | 434 ignore this event. |
| 455 </description> | 435 </description> |
| 456 <arg name="state_type" type="uint"/> | 436 <arg name="state_type" type="uint"/> |
| 457 </event> | 437 </event> |
| 458 | |
| 459 <!-- Version 8 additions --> | |
| 460 | |
| 461 <request name="set_system_modal" since="8"> | |
| 462 <description summary="suggests a re-layout of remote shell input area"> | |
| 463 Suggests a surface should become system modal. | |
| 464 </description> | |
| 465 </request> | |
| 466 | |
| 467 <request name="unset_system_modal" since="8"> | |
| 468 <description summary="suggests a re-layout of remote shell input area"> | |
| 469 Suggests a surface should become non system modal. | |
| 470 </description> | |
| 471 </request> | |
| 472 </interface> | 438 </interface> |
| 473 | 439 |
| 474 <!-- Version 6 additions --> | 440 <!-- Version 6 additions --> |
| 475 | 441 |
| 476 <interface name="zwp_notification_surface_v1" version="6"> | 442 <interface name="zwp_notification_surface_v1" version="6"> |
| 477 <description summary="A notification window"> | 443 <description summary="A notification window"> |
| 478 An interface that may be implemented by a wl_surface to host | 444 An interface that may be implemented by a wl_surface to host |
| 479 notification contents. | 445 notification contents. |
| 480 </description> | 446 </description> |
| 481 | 447 |
| 482 <request name="destroy" type="destructor"> | 448 <request name="destroy" type="destructor"> |
| 483 <description summary="Destroy the notification_surface"> | 449 <description summary="Destroy the notification_surface"> |
| 484 Unmap and destroy the notification surface. | 450 Unmap and destroy the notification surface. |
| 485 </description> | 451 </description> |
| 486 </request> | 452 </request> |
| 487 </interface> | 453 </interface> |
| 488 | 454 |
| 489 </protocol> | 455 </protocol> |
| OLD | NEW |