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="5"> | 41 <interface name="zwp_remote_shell_v1" version="6"> |
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. |
52 </description> | 52 </description> |
53 <entry name="default" value="1" summary="default container"/> | 53 <entry name="default" value="1" summary="default container"/> |
54 <entry name="overlay" value="2" summary="system modal container"/> | 54 <entry name="overlay" value="2" summary="system modal container"/> |
55 </enum> | 55 </enum> |
56 | 56 |
57 <enum name="error"> | 57 <enum name="error"> |
58 <entry name="role" value="0" summary="given wl_surface has another role"/> | 58 <entry name="role" value="0" summary="given wl_surface has another role"/> |
| 59 <entry name="invalid_notification_id" value="1" |
| 60 summary="invalid notification id"/> |
59 </enum> | 61 </enum> |
60 | 62 |
61 <request name="destroy" type="destructor"> | 63 <request name="destroy" type="destructor"> |
62 <description summary="destroy remote_shell"> | 64 <description summary="destroy remote_shell"> |
63 Destroy this remote_shell object. | 65 Destroy this remote_shell object. |
64 | 66 |
65 Destroying a bound remote_shell object while there are surfaces | 67 Destroying a bound remote_shell object while there are surfaces |
66 still alive created by this remote_shell object instance is illegal | 68 still alive created by this remote_shell object instance is illegal |
67 and will result in a protocol error. | 69 and will result in a protocol error. |
68 </description> | 70 </description> |
(...skipping 27 matching lines...) Expand all Loading... |
96 <arg name="work_area_inset_bottom" type="int"/> | 98 <arg name="work_area_inset_bottom" type="int"/> |
97 </event> | 99 </event> |
98 | 100 |
99 <event name="activated"> | 101 <event name="activated"> |
100 <description summary="activated surface changed"> | 102 <description summary="activated surface changed"> |
101 Notifies client that the activated surface changed. | 103 Notifies client that the activated surface changed. |
102 </description> | 104 </description> |
103 <arg name="gained_active" type="object" interface="wl_surface" allow-null=
"true"/> | 105 <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"/> | 106 <arg name="lost_active" type="object" interface="wl_surface" allow-null="t
rue"/> |
105 </event> | 107 </event> |
| 108 |
| 109 <!-- Version 6 additions --> |
| 110 |
| 111 <request name="get_notification_surface" since="6"> |
| 112 <description summary="create a notification surface from a surface"> |
| 113 Creates a notification_surface for the given surface, gives it the |
| 114 notification_surface role and associated it with a notification id. |
| 115 </description> |
| 116 <arg name="id" type="new_id" interface="zwp_notification_surface_v1"/> |
| 117 <arg name="surface" type="object" interface="wl_surface"/> |
| 118 <arg name="notification_id" type="string" /> |
| 119 </request> |
106 </interface> | 120 </interface> |
107 | 121 |
108 <interface name="zwp_remote_surface_v1" version="5"> | 122 <interface name="zwp_remote_surface_v1" version="6"> |
109 <description summary="A desktop window"> | 123 <description summary="A desktop window"> |
110 An interface that may be implemented by a wl_surface, for | 124 An interface that may be implemented by a wl_surface, for |
111 implementations that provide a desktop-style user interface | 125 implementations that provide a desktop-style user interface |
112 and allows for remotely managed windows. | 126 and allows for remotely managed windows. |
113 | 127 |
114 It provides requests to treat surfaces like windows, allowing to set | 128 It provides requests to treat surfaces like windows, allowing to set |
115 properties like app id and geometry. | 129 properties like app id and geometry. |
116 | 130 |
117 The client must call wl_surface.commit on the corresponding wl_surface | 131 The client must call wl_surface.commit on the corresponding wl_surface |
118 for the remote_surface state to take effect. | 132 for the remote_surface state to take effect. |
(...skipping 271 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
390 <request name="set_top_inset" since="5"> | 404 <request name="set_top_inset" since="5"> |
391 <description summary="set top inset for surface"> | 405 <description summary="set top inset for surface"> |
392 Set distance from the top of the surface to the contents. | 406 Set distance from the top of the surface to the contents. |
393 | 407 |
394 This distance typically represents the size of the window caption. | 408 This distance typically represents the size of the window caption. |
395 </description> | 409 </description> |
396 <arg name="height" type="int"/> | 410 <arg name="height" type="int"/> |
397 </request> | 411 </request> |
398 </interface> | 412 </interface> |
399 | 413 |
| 414 <!-- Version 6 additions --> |
| 415 |
| 416 <interface name="zwp_notification_surface_v1" version="6"> |
| 417 <description summary="A notification window"> |
| 418 An interface that may be implemented by a wl_surface to host |
| 419 notification contents. |
| 420 </description> |
| 421 |
| 422 <request name="destroy" type="destructor"> |
| 423 <description summary="Destroy the notification_surface"> |
| 424 Unmap and destroy the notification surface. |
| 425 </description> |
| 426 </request> |
| 427 </interface> |
| 428 |
400 </protocol> | 429 </protocol> |
OLD | NEW |