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 168 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 179 It provides requests to treat surfaces like windows, allowing to set | 179 It provides requests to treat surfaces like windows, allowing to set |
| 180 properties like app id and geometry. | 180 properties like app id and geometry. |
| 181 | 181 |
| 182 The client must call wl_surface.commit on the corresponding wl_surface | 182 The client must call wl_surface.commit on the corresponding wl_surface |
| 183 for the remote_surface state to take effect. | 183 for the remote_surface state to take effect. |
| 184 | 184 |
| 185 For a surface to be mapped by the compositor the client must have | 185 For a surface to be mapped by the compositor the client must have |
| 186 committed both an remote_surface state and a buffer. | 186 committed both an remote_surface state and a buffer. |
| 187 </description> | 187 </description> |
| 188 | 188 |
| 189 <enum name="systemui_autohide_state"> | |
|
oshima
2017/03/28 23:54:47
it's probably better to call this systemui_visibil
yorkelee
2017/03/29 00:15:09
Done.
| |
| 190 <description summary="systemui autohide behavior"> | |
| 191 Determine the autohide behavior of the system UI. | |
| 192 </description> | |
| 193 <entry name="visible" value="1" summary="system ui is visible"/> | |
| 194 <entry name="autohide_non_sticky" value="2" summary="system ui autohides a nd is not sticky"/> | |
| 195 <entry name="autohide_sticky" value="3" summary="system ui autohides and i s sticky"/> | |
| 196 </enum> | |
| 197 | |
| 189 <request name="destroy" type="destructor"> | 198 <request name="destroy" type="destructor"> |
| 190 <description summary="Destroy the remote_surface"> | 199 <description summary="Destroy the remote_surface"> |
| 191 Unmap and destroy the window. The window will be effectively | 200 Unmap and destroy the window. The window will be effectively |
| 192 hidden from the user's point of view, and all state will be lost. | 201 hidden from the user's point of view, and all state will be lost. |
| 193 </description> | 202 </description> |
| 194 </request> | 203 </request> |
| 195 | 204 |
| 196 <request name="set_app_id"> | 205 <request name="set_app_id"> |
| 197 <description summary="set application ID"> | 206 <description summary="set application ID"> |
| 198 Set an application identifier for the surface. | 207 Set an application identifier for the surface. |
| (...skipping 224 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 423 specifies inner bounds of the shadow. Specifying zero width and height | 432 specifies inner bounds of the shadow. Specifying zero width and height |
| 424 will disable the shadow. | 433 will disable the shadow. |
| 425 </description> | 434 </description> |
| 426 <arg name="x" type="int"/> | 435 <arg name="x" type="int"/> |
| 427 <arg name="y" type="int"/> | 436 <arg name="y" type="int"/> |
| 428 <arg name="width" type="int"/> | 437 <arg name="width" type="int"/> |
| 429 <arg name="height" type="int"/> | 438 <arg name="height" type="int"/> |
| 430 </request> | 439 </request> |
| 431 | 440 |
| 432 <!-- Version 3 additions --> | 441 <!-- Version 3 additions --> |
| 442 <request name="set_autohide_systemui" since="3"> | |
|
oshima
2017/03/28 23:54:47
set_systemui_visibility
yorkelee
2017/03/29 00:15:09
Done.
| |
| 443 <description summary="requests the system ui autohide behavior for the sur face"> | |
| 444 Requests how the surface will autohide the system UI when it is made act ive. | |
| 445 </description> | |
| 446 <arg name="autohide" type="uint"/> | |
| 447 </request> | |
| 433 | 448 |
| 434 <event name="configure" since="3"> | 449 <!-- Version 4 additions --> |
| 450 | |
| 451 <event name="configure" since="4"> | |
| 435 <description summary="suggest a surface change"> | 452 <description summary="suggest a surface change"> |
| 436 The configure event asks the client to change surface state. | 453 The configure event asks the client to change surface state. |
| 437 | 454 |
| 438 The client must apply the origin offset to window positions in | 455 The client must apply the origin offset to window positions in |
| 439 set_window_geometry requests. | 456 set_window_geometry requests. |
| 440 | 457 |
| 441 The states listed in the event are state_type values, and might change | 458 The states listed in the event are state_type values, and might change |
| 442 due to a client request or an event directly handled by the compositor. | 459 due to a client request or an event directly handled by the compositor. |
| 443 | 460 |
| 444 Clients should arrange their surface for the new state, and then send an | 461 Clients should arrange their surface for the new state, and then send an |
| 445 ack_configure request with the serial sent in this configure event at | 462 ack_configure request with the serial sent in this configure event at |
| 446 some point before committing the new surface. | 463 some point before committing the new surface. |
| 447 | 464 |
| 448 If the client receives multiple configure events before it can respond | 465 If the client receives multiple configure events before it can respond |
| 449 to one, it is free to discard all but the last event it received. | 466 to one, it is free to discard all but the last event it received. |
| 450 </description> | 467 </description> |
| 451 <arg name="origin_offset_x" type="int"/> | 468 <arg name="origin_offset_x" type="int"/> |
| 452 <arg name="origin_offset_y" type="int"/> | 469 <arg name="origin_offset_y" type="int"/> |
| 453 <arg name="states" type="array"/> | 470 <arg name="states" type="array"/> |
| 454 <arg name="serial" type="uint"/> | 471 <arg name="serial" type="uint"/> |
| 455 </event> | 472 </event> |
| 456 | 473 |
| 457 <request name="ack_configure" since="3"> | 474 <request name="ack_configure" since="4"> |
| 458 <description summary="ack a configure event"> | 475 <description summary="ack a configure event"> |
| 459 When a configure event is received, if a client commits the | 476 When a configure event is received, if a client commits the |
| 460 surface in response to the configure event, then the client | 477 surface in response to the configure event, then the client |
| 461 must make an ack_configure request sometime before the commit | 478 must make an ack_configure request sometime before the commit |
| 462 request, passing along the serial of the configure event. | 479 request, passing along the serial of the configure event. |
| 463 | 480 |
| 464 For instance, the compositor might use this information during display | 481 For instance, the compositor might use this information during display |
| 465 configuration to change its coordinate space for set_window_geometry | 482 configuration to change its coordinate space for set_window_geometry |
| 466 requests only when the client has switched to the new coordinate space. | 483 requests only when the client has switched to the new coordinate space. |
| 467 | 484 |
| 468 If the client receives multiple configure events before it | 485 If the client receives multiple configure events before it |
| 469 can respond to one, it only has to ack the last configure event. | 486 can respond to one, it only has to ack the last configure event. |
| 470 | 487 |
| 471 A client is not required to commit immediately after sending | 488 A client is not required to commit immediately after sending |
| 472 an ack_configure request - it may even ack_configure several times | 489 an ack_configure request - it may even ack_configure several times |
| 473 before its next surface commit. | 490 before its next surface commit. |
| 474 | 491 |
| 475 A client may send multiple ack_configure requests before committing, but | 492 A client may send multiple ack_configure requests before committing, but |
| 476 only the last request sent before a commit indicates which configure | 493 only the last request sent before a commit indicates which configure |
| 477 event the client really is responding to. | 494 event the client really is responding to. |
| 478 </description> | 495 </description> |
| 479 <arg name="serial" type="uint" summary="the serial from the configure even t"/> | 496 <arg name="serial" type="uint" summary="the serial from the configure even t"/> |
| 480 </request> | 497 </request> |
| 481 | 498 |
| 482 <request name="move" since="3"> | 499 <request name="move" since="4"> |
| 483 <description summary="start an interactive move"> | 500 <description summary="start an interactive move"> |
| 484 Start an interactive, user-driven move of the surface. | 501 Start an interactive, user-driven move of the surface. |
| 485 | 502 |
| 486 The compositor responds to this request with a configure event that | 503 The compositor responds to this request with a configure event that |
| 487 transitions to the "moving" state. The client must only initiate motion | 504 transitions to the "moving" state. The client must only initiate motion |
| 488 after acknowledging the state change. The compositor can assume that | 505 after acknowledging the state change. The compositor can assume that |
| 489 subsequent set_window_geometry requests are position updates until the | 506 subsequent set_window_geometry requests are position updates until the |
| 490 next state transition is acknowledged. | 507 next state transition is acknowledged. |
| 491 | 508 |
| 492 The compositor may ignore move requests depending on the state of the | 509 The compositor may ignore move requests depending on the state of the |
| (...skipping 10 matching lines...) Expand all Loading... | |
| 503 </description> | 520 </description> |
| 504 | 521 |
| 505 <request name="destroy" type="destructor"> | 522 <request name="destroy" type="destructor"> |
| 506 <description summary="Destroy the notification_surface"> | 523 <description summary="Destroy the notification_surface"> |
| 507 Unmap and destroy the notification surface. | 524 Unmap and destroy the notification surface. |
| 508 </description> | 525 </description> |
| 509 </request> | 526 </request> |
| 510 </interface> | 527 </interface> |
| 511 | 528 |
| 512 </protocol> | 529 </protocol> |
| OLD | NEW |