wlr output management

创建一个新的输出配置对象。这允许更新 head 属性。

表示客户端不再希望接收输出配置更改的事件。但是 compositor 可能会发出更多事件，直到发出 finished 事件。

客户端在此请求之后不得发送任何更多请求。

此事件引入一个新的 head。每当新的 head 出现时（例如插入监视器）或在绑定输出管理器之后会发生这种情况。

在绑定到输出管理器对象之后以及任何后续更改之后，所有信息发送完毕后发送此事件。这也适用于子 head 和 mode 对象。换句话说，每当 head 或 mode 被创建或销毁以及它们的属性之一被更改时，都会发送此事件。并非每次当前配置更改时都会重新发送所有状态：只发送实际的更改。

这使得输出配置的更改可以被视为原子操作，即使它们通过多个事件发生。

发送一个序列号以供将来在 create_configuration 请求中使用。

此事件表示 compositor 已完成发送管理器事件。compositor 将在此事件发送后立即销毁该对象，因此它将变为无效，客户端应释放与其关联的任何资源。

此请求表示客户端将不再使用此 head 对象。

此事件描述 head 名称。

命名约定由 compositor 定义，但仅限于字母数字字符和连字符 (-)。每个名称在所有 wlr_output_head 对象中是唯一的，但如果 wlr_output_head 对象被销毁，相同的名称可能会在以后被重用。在具有相同硬件和软件配置的会话中，名称也将保持一致。

名称的示例包括 'HDMI-A-1'、'WL-1'、'X11-1' 等。但是，不要假设名称是底层 DRM 连接器、X11 连接等的反映。

如果此 head 匹配 wl_output，则 wl_output.name 事件必须报告相同的名称。

name 事件在创建 wlr_output_head 对象之后发送。此事件每个对象只发送一次，并且在 wlr_output_head 对象的生命周期内名称不会更改。

此事件描述 head 的人类可读描述。

description 是一个 UTF-8 字符串，其内容没有定义的约定。示例可能包括 'Foocorp 11" Display' 或 'Virtual X11 output via :1'。但是，不要假设名称是底层 DRM 连接器的品牌、型号、序列号或底层 X11 连接的显示名称等的反映。

如果此 head 匹配 wl_output，则 wl_output.description 事件必须报告相同的名称。

description 事件在创建 wlr_output_head 对象之后发送。此事件每个对象只发送一次，并且在 wlr_output_head 对象的生命周期内描述不会更改。

此事件描述 head 的物理尺寸。仅当 head 具有物理尺寸时（例如不是投影仪或虚拟设备），才会发送此事件。

physical_size 事件在创建 wlr_output_head 对象之后发送。此事件每个对象只发送一次，并且在 wlr_output_head 对象的生命周期内物理尺寸不会更改。

此事件为此 head 引入一个模式。每个支持的模式发送一次。

此事件描述 head 是否已启用。禁用的 head 不会映射到全局 compositor 空间的某个区域。

当 head 被禁用时，某些属性（current_mode、position、transform 和 scale）将无关紧要。

此事件描述此 head 当前使用的模式。仅在输出已启用时才会发送。

此事件描述 head 在全局 compositor 空间中的位置。仅在输出已启用时才会发送。

此事件描述当前应用于 head 的变换。仅在输出已启用时才会发送。

此事件描述 head 在全局 compositor 空间中的缩放比例。仅在输出已启用时才会发送。

此事件表示 head 不再可用。head 对象变为无效。客户端应发送销毁请求并释放与其关联的任何资源。

此事件描述 head 的制造商。

与 model 和 serial_number 事件一起，其目的是允许客户端识别来自以前会话的 head，并例如加载特定于 head 的配置。

不保证此事件会被发送。原因可能是 compositor 没有关于 head 制造商的信息，或者在当前设置中制造商的定义不合理，例如在虚拟会话中。客户端仍然可以尝试通过其他事件的可用信息来识别 head，但应注意误报的风险增加。

如果发送，make 事件在创建 wlr_output_head 对象之后发送，并且每个对象只发送一次。在 wlr_output_head 对象的生命周期内，制造商不会更改。

不建议在 UI 中向用户显示 make 字符串。为此，应优先使用 description 事件提供的字符串。

此事件描述 head 的型号。

与 make 和 serial_number 事件一起，其目的是允许客户端识别来自以前会话的 head，并例如加载特定于 head 的配置。

不保证此事件会被发送。原因可能是 compositor 没有关于 head 型号的信息，或者在当前设置中型号的定义不合理，例如在虚拟会话中。客户端仍然可以尝试通过其他事件的可用信息来识别 head，但应注意误报的风险增加。

如果发送，model 事件在创建 wlr_output_head 对象之后发送，并且每个对象只发送一次。在 wlr_output_head 对象的生命周期内，型号不会更改。

不建议在 UI 中向用户显示 model 字符串。为此，应优先使用 description 事件提供的字符串。

此事件描述 head 的序列号。

与 make 和 model 事件一起，其目的是允许客户端识别来自以前会话的 head，并例如加载特定于 head 的配置。

不保证此事件会被发送。原因可能是 compositor 没有关于 head 序列号的信息，或者在当前设置中序列号的定义不合理。客户端仍然可以尝试通过其他事件的可用信息来识别 head，但应注意误报的风险增加。

如果发送，serial_number 事件在创建 wlr_output_head 对象之后发送，并且每个对象只发送一次。在 wlr_output_head 对象的生命周期内，序列号不会更改。

不建议在 UI 中向用户显示 serial_number 字符串。为此，应优先使用 description 事件提供的字符串。

此事件描述 head 当前是否启用了 adaptive sync。Adaptive sync 也称为可变刷新率 (Variable Refresh Rate) 或 VRR。

此请求表示客户端将不再使用此 mode 对象。

此事件描述模式的尺寸。尺寸以输出设备的物理硬件单位给出。这不一定与全局 compositor 空间中的输出尺寸相同。例如，输出可能被缩放或变换。

此事件描述模式的固定垂直刷新率。仅在模式具有固定刷新率时才会发送。

此事件将此模式通告为首选模式。

此事件表示模式不再可用。mode 对象变为无效。客户端应发送销毁请求并释放与其关联的任何资源。

启用 head。此请求创建一个 head 配置对象，可用于更改 head 的属性。

禁用 head。

应用新的输出配置。

如果配置成功应用，不保证新的输出状态与请求的配置完全匹配。例如，如果 compositor 不支持分数缩放，它可能会四舍五入缩放值。

发送此请求后，compositor 必须以 succeeded、failed 或 cancelled 事件进行响应。发送不是析构器的请求是协议错误。

测试新的输出配置。配置不会被应用，只会被验证。

即使 compositor 成功测试了配置，应用它也可能失败。

发送此请求后，compositor 必须以 succeeded、failed 或 cancelled 事件进行响应。发送不是析构器的请求是协议错误。

使用此请求，客户端可以告知 compositor 它不再使用配置对象。任何未应用的输出更改将被丢弃。

此请求还会销毁通过此对象创建的 wlr_output_configuration_head 对象。

在 compositor 成功应用更改或测试更改后发送。

收到此事件后，客户端应销毁此对象。

如果当前配置已更改，将发送描述更改的事件，然后发送 wlr_output_manager.done 事件。

如果 compositor 拒绝更改或应用更改失败，则发送。compositor 应恢复由触发此事件的 apply 请求所做的任何更改。

收到此事件后，客户端应销毁此对象。

如果 compositor 因为输出状态发生变化且客户端信息过时（例如在输出热插拔之后）而取消配置，则发送。

客户端可以使用更新的序列号创建新配置并重试。

收到此事件后，客户端应销毁此对象。

此请求设置 head 的模式。

此请求为 head 分配自定义模式。尺寸以输出设备的物理硬件单位给出。如果设置为零，则刷新率未指定。

同时设置 mode 和 custom mode 是协议错误。

此请求设置 head 在全局 compositor 空间中的位置。

此请求设置 head 的变换。

此请求设置 head 的缩放比例。

此请求启用/禁用 adaptive sync。Adaptive sync 也称为可变刷新率 (Variable Refresh Rate) 或 VRR。