KDE external brightness

kde_external_brightness_v1

版本 3

外部亮度控制

某些亮度控制机制不太稳定，或者需要 root 权限，因此不希望将它们放在合成器内部。此协议用于将实际的亮度设置外包给合成器外部的进程。

类型: destructor

destroy()

销毁对象。

create_brightness_control(id: new_id<kde_external_brightness_device_v1>)

参数	类型	描述
id	new_id<kde_external_brightness_device_v1>

向合成器注册亮度设备

版本 3

亮度控制设备

创建此对象后，客户端应发出所有相关的设置请求（set_internal、set_edid、set_max_brightness，可选 set_observed_brightness）并使用 commit 结束序列。之后，对于值的每次更改，客户端必须再次调用 commit。

类型: destructor

destroy()

销毁对象并注销亮度控制设备

set_internal(internal: uint)

参数	类型	描述
internal	uint	1 if it's an internal panel, 0 if not

设置亮度设备是否属于内置显示器

set_edid(string: string)

参数	类型	描述
string	string	base-64 encoded string of the first 128 bytes of the EDID

设置用于识别显示器的 EDID 数据

set_max_brightness(value: uint)

参数	类型	描述
value	uint	the maximum value that can be set

通知合成器此设备可设置的最大亮度

commit()

通知合成器所有相关标识符和值已发送

起始版本 2

set_observed_brightness(value: uint)

参数	类型	描述
value	uint	the observed value that was read

通知合成器从此设备读取的亮度

客户端可以设置此项以通知合成器设备的初始亮度。它还可以在初始提交后再次设置此项，以通知合成器亮度级别因外部因素而发生变化。合成器可以自由使用或忽略此值。

起始版本 3

set_uses_ddc_ci(value: uint)

参数	类型	描述
value	uint	1 if it uses DDC/CI, 0 if not (assumed by default)

通知合成器使用 DDC/CI 控制亮度等

合成器可以使用此信息在其命令暴露监视器问题时忽略此对象。合成器还可以减少亮度请求的数量，考虑到潜在的缓慢响应时间和对监视器 EEPROM 寿命/磨损的担忧。

requested_brightness(value: uint)

参数	类型	描述
value	uint	the value to set the device to

请求客户端将亮度更改为此值

客户端必须确保如果亮度级别因外部因素而发生变化，它要么用合成器最后请求的值覆盖这些更改，要么再次提交并使用 set_observed_brightness 指定更改后的亮度。

	Cage 0.2.0	COSMIC 1.0.0~beta.8	GameScope 3.15.14	Hyprland 0.52.1	Jay 1.12.0	KWin 6.6	Labwc 0.9.2	Louvre 2.14.1	Mir 2.26	Muffin 6.6.0	Mutter 49.2	niri 25.11	phoc 0.52	river 0.3.13	Sway 1.11	Treeland 0.8.0	Wayfire 0.9.0	Weston 14.0.2
kde_external_brightness_v1	x	x	x	x	x	3	x	x	x	x	x	x	x	x	x	x	x	x

SPDX-FileCopyrightText: 2024 Xaver Hugl <xaver.hugl@gmail.com>

SPDX-License-Identifier: MIT-CMU