KDE output management v2

请求一个 outputconfiguration 对象，客户端可以通过它配置输出设备。

有关详细信息，请参阅 kde_mode_list_v2 和 kde_output_configuration_v2.set_custom_modes 的描述。

将输出标记为启用或禁用。

为给定输出设置模式。

为给定输出设置变换。

设置此输出设备的位置。(x,y) 描述输出在全局空间中的左上角，其中全局空间的原点 (0,0) 必须与最左侧输出的左上角对齐，如果这不能定义唯一的输出，则与顶部输出对齐。

输出之间不能有间隙或重叠，即输出在水平、垂直或两个方向上堆叠。

设置此输出设备的缩放因子。

请求服务器在服务器端将通过此 outputconfiguration 对象请求的属性更改应用到所有输出。

输出配置只能应用一次。如果第二次调用 apply 请求，将发布 already_applied 协议错误。

以百分比值设置此输出设备的过扫描值。

设置合成器在使用可变刷新率时应采用的策略。

应使用全范围还是有限范围的颜色。

设置输出在输出顺序列表中的位置，较小的值排在前面。列表没有特定的起始值，此值仅用于排序输出。

输出顺序可用于将桌面环境组件分配到特定屏幕，详见 kde_output_order_v1 和 kde_output-device-v2。请注意，为了行为一致，priority 值在所有已启用的输出中必须是唯一的。

设置输出是否应设置为 HDR 模式。

以 nits 为单位设置标准动态范围内容的亮度。仅在输出处于 HDR 模式时有效。请注意，虽然值以 nits 为单位，但这不一定转化为屏幕上相同的亮度。

输出是否应使用广色域。

这可用于提供用户基于许多现代 sRGB 屏幕上的默认体验所期望的 sRGB 应用程序应有的颜色。

设置输出的亮度调节器。它不指定任何绝对值，而只是其他亮度值（如 sdr_brightness 和 brightness_metadata）之上的乘数。0 是最小亮度（不是完全黑暗），10000 是最大亮度。 在版本 8 及以下的 HDR 激活时支持，在版本 9 及以上时在设备支持 "brightness" 能力时支持。

设置输出的调光乘数。这类似于亮度设置，但它仅用于临时设置，不是持久的，并且可能因显示器而有不同的实现方式。0 是最小调光因子（不是完全黑暗），10000 表示输出未被调光。

仅在同时支持 "brightness" 能力时才支持此功能。

设置输出设备应镜像其视口的源输出。

这限制了发送到显示器的每种颜色的位数。

当 EDR 启用时，合成器可以将背光提高到用户指定设置之上，以便在没有原生 HDR 支持的显示器上呈现 HDR 内容。这通常会带来更好的视觉效果，但也会增加电池使用量。

这是输出的锐度调节器。0 表示禁用锐度，10000 表示最大锐度。

设置此输出的自定义模式列表。合成器将响应生成请求的模式并将其添加到输出（或删除不再在列表中的模式）。这对于超频显示器或解决损坏的 EDID 很有用。 请注意，不保证任何自定义模式实际上能工作，甚至不保证不会损坏显示器（对于 CRT）。确保每个添加的模式适合其显示器完全是用户的责任。

在服务器成功应用更改后发送。

如果服务器拒绝更改或应用失败则发送。

描述应用输出配置失败的原因。仅在 failure 事件之前发送。

这些错误可以在响应 kde_output_configuration_v2 请求时发出。

描述合成器何时可以使用可变刷新率。

此输出应使用全范围还是有限范围的 RGB。

合成器可以在性能、功耗和颜色准确性之间做很多事情。此设置描述了用户关于应在哪个方向进行权衡的高级偏好。

减少消隐是一种优化，可以通过减少 vblank 所需的时间来降低显示模式的带宽/时序要求。由于并非所有显示器都支持它，可能仍需要关闭它（如 CRT 需要完全消隐）。

这些错误可以在响应 add_mode 请求时发出。