Chromium color management

从 ICC 配置文件创建色彩空间对象。此请求返回一个 zcr_color_space_creator_v1 对象，该对象将返回错误 或成功创建的 zcr_color_space_v1 对象。

要创建的色彩空间描述以 ICC 配置文件的形式，通过参数 icc 中的文件描述符发送。

fd 必须可寻址，ICC 配置文件的最大大小为 4 MB。 违反这些要求将引发 icc_fd 协议错误。 合成器不得修改文件内容，fd 可被密封以防止写入和大小更改。

文件内容必须代表有效的 ICC 配置文件。 ICC 配置文件版本必须为 2 或 4，必须是 3 通道配置文件， 类别必须为 'input'、'output'、'abstract' 或 'display'。 违反这些要求不会导致协议错误，但会触发 zcr_color_space_creator_v1.error 事件。

有关创建对象的更多详细信息，请参阅 zcr_color_space_v1 和 zcr_color_space_creator_v1 接口。

有关 ICC 配置文件的更多详细信息，请参阅 International Color Consortium 的规范（也称为 ISO 15076-1:2010）。

[已弃用] 从已知名称创建色彩空间对象。此请求返回一个 zcr_color_space_creator_v1 对象，该对象将返回错误 或成功创建的 zcr_color_space_v1 对象。

EOTF、色度和白点不得为 unknown。否则，或给定值 未列在枚举中时，将引发 bad_enum 协议错误。

有关创建对象的更多详细信息，请参阅 zcr_color_space_v1 和 zcr_color_space_creator_v1 接口。请改用 create_color_space_from_complete_names。

[已弃用] 从参数创建色彩空间对象。此请求返回一个 zcr_color_space_creator_v1 对象，该对象将返回错误 或成功创建的 zcr_color_space_v1 对象。

EOTF 不得为 unknown。否则，或给定的 EOTF 未列在 枚举中时，将引发 bad_enum 协议错误。

白点必须位于红、绿、蓝三基色构成的三角形内部。 否则将引发 bad_param 协议错误。

所有色度值乘以 10000 以产生协议传输的整数值。

有关创建对象的更多详细信息，请参阅 zcr_color_space_v1 和 zcr_color_space_creator_v1 接口。请改用 create_color_space_from_complete_params。

为给定的 wl_output 创建一个新的 zcr_color_management_output_v1 对象。

有关更多详细信息，请参阅 zcr_color_management_output_v1 接口。

为给定的 wl_surface 创建一个新的 zcr_color_management_surface_v1 对象。

有关更多详细信息，请参阅 zcr_color_management_surface_v1 接口。

销毁 zcr_color_manager_v1 对象。这不会以任何方式 影响任何其他对象。

从已知名称创建色彩空间对象。此请求返回一个 zcr_color_space_creator_v1 对象，该对象将返回错误 或成功创建的 zcr_color_space_v1 对象。

EOTF、色度和白点不得为 unknown。否则，或给定值 未列在枚举中时，将引发 bad_enum 协议错误。

此请求还包含矩阵和范围信息。

有关创建对象的更多详细信息，请参阅 zcr_color_space_v1 和 zcr_color_space_creator_v1 接口。

从参数创建色彩空间对象。此请求返回一个 zcr_color_space_creator_v1 对象，该对象将返回错误 或成功创建的 zcr_color_space_v1 对象。

EOTF 不得为 unknown。否则，或给定的 EOTF 未列在 枚举中时，将引发 bad_enum 协议错误。

白点必须位于红、绿、蓝三基色构成的三角形内部。 否则将引发 bad_param 协议错误。

所有色度值乘以 10000 以产生协议传输的整数值。

此请求还包含矩阵和范围信息。

有关创建对象的更多详细信息，请参阅 zcr_color_space_v1 和 zcr_color_space_creator_v1 接口。

描述已知 EOTF 的名称。

合成器必须根据协议接口版本支持所有这些名称。

描述已知色度的名称。

合成器必须根据协议接口版本支持所有这些名称。

描述已知白点的名称。

合成器必须根据协议接口版本支持所有这些名称。

描述典型色彩空间矩阵 ID 的名称

描述典型 RGB 值范围的名称。

为输出设备的当前色彩空间创建一个新的 zcr_color_space_v1 对象。 输出设备始终恰好有一个活动色彩空间，因此客户端应销毁 先前调用此请求创建的色彩空间。此请求通常作为对 color_space_changed 事件的响应或在创建 zcr_color_management_output_v1 对象时发送。

创建的 zcr_color_space_v1 对象保存对象创建时 输出设备的色彩空间。

生成的色彩空间对象允许 get_information 请求。

有关更多详细信息，请参阅 zcr_color_space_v1 接口。

销毁 zcr_color_management_output_v1 对象。这不会影响 任何剩余的协议对象。

当输出设备的色彩空间发生变化时发送 color_space_changed 事件， 随后是所有扩展共用的 wl_output.done 事件。

这不是初始事件。

这既是初始事件，也会在值发生变化时发送。 当值发生变化时，此事件之后是所有扩展共用的 wl_output.done 事件。

扩展动态范围值描述相对于 SDR 最大白色的可用动态范围。 EDR 值与亮度成正比，黑色亮度作为零电平。 值为 1.0 表示显示器无法显示比 SDR 最大白色更亮的内容。 值为 3.0 表示 SDR 最大白色为显示器可产生的最高亮度的 三分之一。

SDR 最大白色的绝对亮度取决于显示器功能、观看条件 和观看者的个人偏好。因此，无法给出以 cd/m² 为单位的 单一值。使用 HDR 视频模式的合成器应允许用户控制 用于计算输出 EDR 值的 SDR 最大白色电平。

SDR 最大白色是一个相对参考亮度，允许将来自不同动态范围 的内容色调映射到单一的公共动态范围进行显示。

EDR 值乘以 1000 以产生协议传输的整数值。

假设 alpha 通道存在，它始终是线性的。alpha 模式决定 色彩通道是否包含预乘 alpha。使用直接 alpha 可能具有 性能优势。

Alpha 模式是双缓冲的，将在调用相应 wl_surface 的 wl_surface.commit 时应用。

默认情况下，surface 被假定为具有预乘 alpha。

设置底层 surface 的扩展动态范围（EDR）值。 EDR 值是双缓冲的，将在调用相应 wl_surface 的 wl_surface.commit 时应用。

EDR 值描述相对于 SDR 最大白色编码了多少动态范围。 EDR 值与亮度成正比，使用黑色亮度作为零电平。 值为 1.0 表示 SDR 最大白色是 surface 的最高可能亮度。 值为 3.0 表示 SDR 最大白色是 surface 最高可能亮度的 三分之一。

附加到 surface 的色彩空间可以使缓冲区中的代码值 在亮度方面呈非线性。因此，产生最大代码值三分之一亮度 的代码值可能不是最大代码值的三分之一。

有关输出设备上 SDR 最大白色的定义，请参阅 zcr_color_management_output_v1.extended_dynamic_range。 内容制作商可以自由选择其 SDR 最大白色电平。 如何显示取决于显示器功能和输出 EDR 值。

默认情况下 EDR 值为 1.0。合成器将对图像进行色调映射 以匹配 surface 所显示的每个输出设备的 EDR。 EDR 到 EDR 映射的目标是产生一种相对亮度映射， 无论观看条件和显示器功能如何，都能呈现同样良好的效果， 前提是输出 EDR 值已根据输出功能和观看环境进行了调整。 提供已色调映射到 surface 所显示输出设备 EDR 值的内容， 可能在性能和图像质量方面具有优势。

EDR 值乘以 1000 以产生协议传输的整数值。

设置底层 surface 的色彩空间。色彩空间和渲染意图 是双缓冲的，将在调用相应 wl_surface 的 wl_surface.commit 时应用。

渲染意图为合成器提供提示，说明在色彩空间转换中 应优化什么。

默认情况下，surface 被假定为具有 sRGB 色彩空间和 任意渲染意图。

如果 surface 的色彩空间与其所显示的输出设备的色彩空间 匹配，性能和色彩准确性可能会提高。要查找这些色彩空间， 客户端可以监听 preferred_color_space 或 wl_surface.enter/leave 事件。此改进可能需要使用 zcr_color_management_output_v1.get_color_space 创建的 色彩空间对象。

此请求将 surface 的色彩空间设置为默认值，请参阅 set_color_space。设置将在调用相应 wl_surface 的 wl_surface.commit 时应用。

销毁 zcr_color_management_surface_v1 对象。

当 wl_surface 的最后一个 zcr_color_management_surface_v1 对象被销毁时，销毁将挂起取消设置 wl_surface 的色彩空间、 渲染意图和 alpha 模式，类似于 set_color_space 将挂起设置。

当合成器确定或切换到暗示首选色彩空间的输出设备时， 发送 preferred_color_space 事件。首选色彩空间是客户端 用于其 surface 内容时可能获得最佳性能和质量的色彩空间。

此事件不携带 zcr_color_space_v1 而是 wl_output 对象。 具体的 zcr_color_space_v1 可以通过在输出设备上调用 zcr_color_management_output_v1.get_color_space 并监听 zcr_color_management_output_v1.color_space_changed 事件来创建。

由于客户端可能多次绑定到同一全局 wl_output， 此事件将发送给与首选色彩空间输出设备匹配的每个绑定实例。 如果客户端根本没有绑定到正确的 wl_output 全局对象， 则不会发送此事件。

这只是一个提示，客户端可以使用 set_color_space 设置 任何有效的色彩空间，但提供首选色彩空间中的 surface 可能会提高性能和色彩准确性。

渲染意图允许客户端提示如何执行色彩空间转换。

有关渲染意图的更多详细信息，请参阅 ICC 规范。

指定 alpha 是否预乘到色彩通道中。如果预乘， 线性 alpha 值已与色彩通道中的（非线性）色彩通道 代码值相乘。

交付成功创建的色彩空间。

生成的色彩空间对象不允许 get_information 请求。

如果色彩空间创建失败，则发送此事件。

尝试创建色彩空间时发生的错误位掩码

作为对此请求的响应，合成器将发送描述此色彩空间对象的 所有可用信息事件，最后发送 'done' 事件。 其他扩展可以定义在 'done' 之前发送的更多事件。

此请求仅允许在创建对象的消息指定允许 get_information 的 zcr_color_space_v1 对象上调用。否则将引发 no_information 协议错误。

同一对象上的每个 get_information 请求将始终返回完全相同的数据。

请参阅 zcr_color_management_output_v1.get_color_space 和 zcr_color_space_creator_v1.created。

销毁 zcr_color_space_v1 对象。

销毁在 surface 或输出设备上处于活动状态的 zcr_color_space_v1 不会更改这些对象的色彩空间。

此事件仅可作为 zcr_color_space_v1.get_information 的 响应发送。

icc 参数向客户端提供一个文件描述符，可以内存映射 以获取描述色彩空间的 ICC 配置文件。 客户端必须使用 MAP_PRIVATE 且只读方式映射 fd。

合成器应在请求信息时始终发送此事件。 ICC 配置文件提供了所有色彩管理客户端可以依赖的共同基础。

[已弃用] 此事件仅可作为 zcr_color_space_v1.get_information 的 响应发送。

EOTF、色度和白点包含这些属性的已知名称（如果可用）， 否则为 unknown。

合成器不应假设所有客户端都能理解这些名称。 这些名称是为客户端方便而提供的。如果客户端理解名称三元组， 它可以忽略关于色彩空间的其他信息，例如 ICC 配置文件。 请改用 complete_names。

[已弃用] 此事件仅可作为 zcr_color_space_v1.get_information 的 响应发送。

RGB 三基色值参数连同白点值参数和 eotf 可用于定义 任意或自定义色彩空间。

eotf 枚举包含该属性的已知名称，但合成器不应假设 所有客户端都能理解这些名称。请改用 complete_params。

此事件仅可作为 zcr_color_space_v1.get_information 的 响应发送。

这表示该对象的所有色彩空间信息事件已全部交付。

此事件仅可作为 zcr_color_space_v1.get_information 的 响应发送。

EOTF、色度、矩阵、范围和白点包含这些属性的已知名称 （如果可用），否则为 unknown。

合成器不应假设所有客户端都能理解这些名称。 这些名称是为客户端方便而提供的。如果客户端理解名称三元组， 它可以忽略关于色彩空间的其他信息，例如 ICC 配置文件。

此事件仅可作为 zcr_color_space_v1.get_information 的 响应发送。

RGB 三基色值参数连同白点值参数和 eotf 可用于定义 任意或自定义色彩空间。

eotf 枚举包含该属性的已知名称，但合成器不应假设 所有客户端都能理解这些名称。