1.23. 色度控制参考¶

色度类包含用于高动态范围成像的控件，用于在数字图像和视频中表示颜色。这些控件应用于视频和图像的编码和解码，以及 HDMI 接收器和发射器。

1.23.1. 色度控制 ID¶

V4L2_CID_COLORIMETRY_CLASS (类): 色度类描述符。为此控件调用 ioctls VIDIOC_QUERYCTRL、VIDIOC_QUERY_EXT_CTRL 和 VIDIOC_QUERYMENU 将返回此控制类的描述。
V4L2_CID_COLORIMETRY_HDR10_CLL_INFO (结构体): 内容光照水平定义了画面标称目标亮度光照水平的上限。

struct v4l2_ctrl_hdr10_cll_info¶
__u16	`max_content_light_level`	视频序列的所有单个样本中最大光照水平的上限，单位为 cd/m²。当等于 0 时，不存在此类上限。
__u16	`max_pic_average_light_level`	视频序列的任何单个画面的样本中最大平均光照水平的上限，单位为 cd/m²。当等于 0 时，不存在此类上限。

V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY (结构体): 母带显示定义了当前视频内容的母带显示器的色域（色度原色、白点和亮度范围）。

struct v4l2_ctrl_hdr10_mastering_display¶
__u16	`display_primaries_x[3]`	以 0.00002 的增量指定母带显示器的色度原色分量 c 的归一化 x 色度坐标。为了描述使用红色、绿色和蓝色色度原色的母带显示器，索引值 c 等于 0 对应于绿色原色，c 等于 1 对应于蓝色原色，c 等于 2 对应于红色色度原色。
__u16	`display_primaries_y[3]`	以 0.00002 的增量指定母带显示器的色度原色分量 c 的归一化 y 色度坐标。为了描述使用红色、绿色和蓝色色度原色的母带显示器，索引值 c 等于 0 对应于绿色原色，c 等于 1 对应于蓝色原色，c 等于 2 对应于红色色度原色。
__u16	`white_point_x`	以 0.00002 的增量指定母带显示器白点的归一化 x 色度坐标。
__u16	`white_point_y`	以 0.00002 的增量指定母带显示器白点的归一化 y 色度坐标。
__u32	`max_luminance`	指定母带显示器的标称最大显示亮度，单位为 0.0001 cd/m²。
__u32	`min_luminance`	指定母带显示器的标称最小显示亮度，单位为 0.0001 cd/m²。