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="6"> | 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 58 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
110 | 110 |
111 <request name="get_notification_surface" since="6"> | 111 <request name="get_notification_surface" since="6"> |
112 <description summary="create a notification surface from a surface"> | 112 <description summary="create a notification surface from a surface"> |
113 Creates a notification_surface for the given surface, gives it the | 113 Creates a notification_surface for the given surface, gives it the |
114 notification_surface role and associated it with a notification id. | 114 notification_surface role and associated it with a notification id. |
115 </description> | 115 </description> |
116 <arg name="id" type="new_id" interface="zwp_notification_surface_v1"/> | 116 <arg name="id" type="new_id" interface="zwp_notification_surface_v1"/> |
117 <arg name="surface" type="object" interface="wl_surface"/> | 117 <arg name="surface" type="object" interface="wl_surface"/> |
118 <arg name="notification_id" type="string" /> | 118 <arg name="notification_id" type="string" /> |
119 </request> | 119 </request> |
120 | |
121 <!-- Version 7 additions --> | |
122 <enum name="shell_mode"> | |
123 <description summary="the mode of the shell"> | |
124 Determine how a remote surface should be stacked relative to other | |
125 shell surfaces. | |
126 </description> | |
127 <entry name="windowed" value="1" summary="mulitple windows"/> | |
128 <entry name="tablet" value="2" summary="restricted mode for table"/> | |
129 </enum> | |
130 | |
131 <event name="shell_mode_changed" since="7"> | |
132 <description summary="desktop mode changed"> | |
133 The shell_mode_changed event is sent by the compositor when | |
134 the shell mode was changed. | |
135 | |
136 This is an event to notify that the shell mode has switched. | |
137 </description> | |
138 <arg name="shell_mode" type="uint"/> | |
139 </event> | |
120 </interface> | 140 </interface> |
121 | 141 |
122 <interface name="zwp_remote_surface_v1" version="6"> | 142 <interface name="zwp_remote_surface_v1" version="7"> |
123 <description summary="A desktop window"> | 143 <description summary="A desktop window"> |
124 An interface that may be implemented by a wl_surface, for | 144 An interface that may be implemented by a wl_surface, for |
125 implementations that provide a desktop-style user interface | 145 implementations that provide a desktop-style user interface |
126 and allows for remotely managed windows. | 146 and allows for remotely managed windows. |
127 | 147 |
128 It provides requests to treat surfaces like windows, allowing to set | 148 It provides requests to treat surfaces like windows, allowing to set |
129 properties like app id and geometry. | 149 properties like app id and geometry. |
130 | 150 |
131 The client must call wl_surface.commit on the corresponding wl_surface | 151 The client must call wl_surface.commit on the corresponding wl_surface |
132 for the remote_surface state to take effect. | 152 for the remote_surface state to take effect. |
(...skipping 269 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
402 </request> | 422 </request> |
403 | 423 |
404 <request name="set_top_inset" since="5"> | 424 <request name="set_top_inset" since="5"> |
405 <description summary="set top inset for surface"> | 425 <description summary="set top inset for surface"> |
406 Set distance from the top of the surface to the contents. | 426 Set distance from the top of the surface to the contents. |
407 | 427 |
408 This distance typically represents the size of the window caption. | 428 This distance typically represents the size of the window caption. |
409 </description> | 429 </description> |
410 <arg name="height" type="int"/> | 430 <arg name="height" type="int"/> |
411 </request> | 431 </request> |
432 | |
433 <!-- Version 7 additions --> | |
434 <request name="set_system_modal" since="7"> | |
435 <description summary="suggests a re-layout of remote shell input area"> | |
436 Suggests a surface should become system modal. | |
437 </description> | |
438 </request> | |
oshima
2016/06/27 19:25:54
This could be just one request with enum/bool but
| |
439 | |
440 <request name="unset_system_modal" since="7"> | |
441 <description summary="suggests a re-layout of remote shell input area"> | |
442 Suggests a surface should become non system modal. | |
443 </description> | |
444 </request> | |
412 </interface> | 445 </interface> |
413 | 446 |
414 <!-- Version 6 additions --> | 447 <!-- Version 6 additions --> |
415 | 448 |
416 <interface name="zwp_notification_surface_v1" version="6"> | 449 <interface name="zwp_notification_surface_v1" version="6"> |
417 <description summary="A notification window"> | 450 <description summary="A notification window"> |
418 An interface that may be implemented by a wl_surface to host | 451 An interface that may be implemented by a wl_surface to host |
419 notification contents. | 452 notification contents. |
420 </description> | 453 </description> |
421 | 454 |
422 <request name="destroy" type="destructor"> | 455 <request name="destroy" type="destructor"> |
423 <description summary="Destroy the notification_surface"> | 456 <description summary="Destroy the notification_surface"> |
424 Unmap and destroy the notification surface. | 457 Unmap and destroy the notification surface. |
425 </description> | 458 </description> |
426 </request> | 459 </request> |
427 </interface> | 460 </interface> |
428 | 461 |
429 </protocol> | 462 </protocol> |
OLD | NEW |