fdo-mirrors/wlr-protocols
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wlroots/wlr-protocols.git synced 2026-05-06 03:28:01 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

output-management: add port_path and device_tag

Browse source 
See:

- https://gitlab.freedesktop.org/emersion/libdisplay-info/-/merge_requests/188
- https://gitlab.freedesktop.org/wlroots/wlroots/-/merge_requests/3979
This commit is contained in:
Simon Ser 2025-06-05 17:58:07 +02:00
parent 2ec67ebd26
commit d31186a325
1 changed files with 49 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

54
unstable/wlr-output-management-unstable-v1.xml
View file

@ -39,7 +39,7 @@
interface version number is reset.
</description>
<interface name="zwlr_output_manager_v1" version="4">
<interface name="zwlr_output_manager_v1" version="5">
<description summary="output device configuration manager">
This interface is a manager that allows reading and writing the current
output device configuration.
@ -125,7 +125,7 @@
</event>
</interface>
<interface name="zwlr_output_head_v1" version="4">
<interface name="zwlr_output_head_v1" version="5">
<description summary="output device">
A head is an output device. The difference between a wl_output object and
a head is that heads are advertised even if they are turned off. A head
@ -370,9 +370,53 @@
</description>
<arg name="state" type="uint" enum="adaptive_sync_state"/>
</event>
<!-- Version 5 additions -->
<event name="port_path">
<description summary="port path">
This event describes a stable port path for the head.
The port is an arbitrary string identifying the port of the head, ie.
the physical connector the head is connected to. The port must be
stable across reboots and software upgrades, thus must not contain
runtime-allocated numbers (such as KMS connector names). The port must
be globally unique for the Wayland connection.
This event is optional and might not be sent, e.g. if the head is
virtual or if the compositor doesn't have enough information to provide
a stable port path for this head.
If sent, the make event is sent after a wlr_output_head object is
created and only sent once per object. The port path does not change
over the lifetime of the wlr_output_head object.
</description>
<arg name="port_path" type="string"/>
</event>
<event name="device_tag">
<description summary="device tag">
This event describes a stable device tag for the head.
The device tag is an arbitrary string identifying the device the head
represents. The device tag must be stable across reboots and software
upgrades, thus must not contain e.g. data coming from manufacturer code
databases. The device tag is not unique: two heads may share the same
device tag. Compositors should do their best to avoid collisions as
much as possible.
This event is optional and might not be sent, e.g. if the head is
virtual or if the compositor doesn't have enough information to provide
a stable device tag for this head.
If sent, the make event is sent after a wlr_output_head object is
created and only sent once per object. The device tag does not change
over the lifetime of the wlr_output_head object.
</description>
</event>
</interface>
<interface name="zwlr_output_mode_v1" version="3">
<interface name="zwlr_output_mode_v1" version="5">
<description summary="output mode">
This object describes an output mode.
@ -427,7 +471,7 @@
</request>
</interface>
<interface name="zwlr_output_configuration_v1" version="4">
<interface name="zwlr_output_configuration_v1" version="5">
<description summary="output configuration">
This object is used by the client to describe a full output configuration.
@ -545,7 +589,7 @@
</request>
</interface>
<interface name="zwlr_output_configuration_head_v1" version="4">
<interface name="zwlr_output_configuration_head_v1" version="5">
<description summary="head configuration">
This object is used by the client to update a single head's configuration.