Changeset View
Changeset View
Standalone View
Standalone View
src/client/protocols/outputdevice.xml
| Show First 20 Lines • Show All 369 Lines • ▼ Show 20 Line(s) | 334 | <description summary="let this output replicate another output"> | |||
|---|---|---|---|---|---|
| 370 | change was carried out on some compositor's internal logic. | 370 | change was carried out on some compositor's internal logic. | ||
| 371 | </description> | 371 | </description> | ||
| 372 | <arg name="source_uuid" type="string" | 372 | <arg name="source_uuid" type="string" | ||
| 373 | summary="the output uuid this output is a replica for" | 373 | summary="the output uuid this output is a replica for" | ||
| 374 | allow-null="true"/> | 374 | allow-null="true"/> | ||
| 375 | <arg name="trigger" type="uint" enum="trigger_reason"/> | 375 | <arg name="trigger" type="uint" enum="trigger_reason"/> | ||
| 376 | <arg name="direction" type="uint" enum="trigger_direction"/> | 376 | <arg name="direction" type="uint" enum="trigger_direction"/> | ||
| 377 | </event> | 377 | </event> | ||
| 378 | | ||||
| 379 | <event name="presenting" since="3"> | ||||
| 380 | <description summary="informs about the device presenting or being omitted"> | ||||
| 381 | This event indicates a change to the output being part of the overall presentation by | ||||
| 382 | the compositor as in presenting content. | ||||
| 383 | | ||||
| 384 | A compositor might reposition outputs on such an event to fill the compositor space | ||||
| 385 | again without gaps between the outputs and to move the origin relatively. | ||||
| 386 | | ||||
| 387 | There might be different reasons for such an event and the trigger argument provides | ||||
| 388 | more information on that: | ||||
| 389 | | ||||
| 390 | * enablement flag is sent when the device is removed from the overall presentation | ||||
| 391 | because it was disabled. Note that a compositor might want to keep a disabled output | ||||
| 392 | as a space consuming part of the overall compositor space although it is disabled. In | ||||
| 393 | this case the event should not be sent. | ||||
| 394 | * hotplug flag is sent after the device gets connected or disconnected. As long as no | ||||
| 395 | other information is available this flag should be sent after the device was connected | ||||
| 396 | and clients are binding for the first time to the device. | ||||
| 397 | * dpms flag is sent after the device was turned off via hardware key or through other | ||||
| 398 | means changing its DPMS state. When the session in general suspends or shut downs it | ||||
| 399 | should the compositor should not send the event since the the session can continue | ||||
| 400 | later on in the same overall compositor space state as before. | ||||
| 401 | | ||||
| 402 | The direction argument indicates that the output device is presenting from now on if it | ||||
| 403 | is set to the up value and that it is not presenting any longer when set to down. | ||||
| 404 | </description> | ||||
| 405 | <arg name="trigger" type="uint" enum="trigger_reason"/> | ||||
| 406 | <arg name="direction" type="uint" enum="trigger_direction"/> | ||||
| 407 | </event> | ||||
| 378 | </interface> | 408 | </interface> | ||
| 379 | 409 | | |||
| 380 | 410 | | |||
| 381 | 411 | | |||
| 382 | </protocol> | 412 | </protocol> | ||