Expand description
configuration of server outputs through clients
This interface enables clients to set properties of output devices for screen configuration purposes via the server. To this end output devices are referenced by global kde_output_device_v2 objects.
§outputmanagement (wl_global)
request:
- create_configuration -> outputconfiguration (wl_resource)
§outputconfiguration (wl_resource)
requests:
- enable(outputdevice, bool)
- mode(outputdevice, mode)
- transformation(outputdevice, flag)
- position(outputdevice, x, y)
- apply
events:
- applied
- failed
The server registers one outputmanagement object as a global object. In order to configure outputs a client requests create_configuration, which provides a resource referencing an outputconfiguration for one-time configuration. That way the server knows which requests belong together and can group them by that.
On the outputconfiguration object the client calls for each output whether the output should be enabled, which mode should be set (by referencing the mode from the list of announced modes) and the output’s global position. Once all outputs are configured that way, the client calls apply. At that point and not earlier the server should try to apply the configuration. If this succeeds the server emits the applied signal, otherwise the failed signal, such that the configuring client is noticed about the success of its configuration request.
Through this design the interface enables atomic output configuration changes if internally supported by the server.
Warning! The protocol described in this file is a desktop environment implementation detail. Regular clients must not use this protocol. Backward incompatible changes may be added without bumping the major version of the extension.
Structs§
- KdeOutput
Management V2 - configuration of server outputs through clients
Enums§
Constants§
- REQ_
CREATE_ CONFIGURATION_ OPCODE - The wire opcode for this request
- REQ_
CREATE_ CONFIGURATION_ SINCE - The minimal object version supporting this request