1.23. 色彩控制参考¶

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

1.23.1. 色彩控制 ID¶

V4L2_CID_COLORIMETRY_CLASS (class): 色彩类描述符。调用 ioctl VIDIOC_QUERYCTRL、VIDIOC_QUERY_EXT_CTRL 和 VIDIOC_QUERYMENU 获取此控件将返回对此控件类的描述。
V4L2_CID_COLORIMETRY_HDR10_CLL_INFO (struct): 内容亮度级别定义了画面标称目标亮度级别的上限。

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): 母带显示器定义了当前视频内容的母带显示器的颜色容量（颜色原色、白点和亮度范围）。

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