UVC 颜色匹配描述符

颜色匹配描述符是一个可选描述符，这是一个与图像成像时色域相关的参数。

对于未压缩的视频格式，必须使用颜色匹配描述符

bt709是srgb色域。色域是对一种颜色进行编码的方法，也指一个技术系统能够产生的颜色的总和。在计算机图形处理中，色域是颜色的某个完全的子集。颜色子集最常见的应用是用来精确地代表一种给定的情况。例如一个给定的色彩空间或是某个输出装置的呈色范围。

UINT8 bLength;
UINT8 bDescriptorType;
UINT8 bDescriptorSubtype;
UINT8 bColorPrimaries;
UINT8 bTransferCharacteristics;
UINT8 bMatrixCoefficients;

• bLength:描述符长度，固定为6.
• bDescriptorType：描述符类型CS_INTERFACE，值为0x24。
• bDescriptorSubtype:描述符子类型，VS_COLORFORMAT，值为0x0d.

• bColorPrimaries：颜色类型

  • 0:未指定（图像特性未知）
  • 1： BT.709，sRGB（默认）
  • 2： BT.470-2（M）
  • 3： BT.470-2（B、G）
  • 4： SMPTE 170M
  • 5： SMPTE 240M
  • 6-255:保留

• bTransferCharacteristics：转换特性

  • 0：未定义
  • 1： BT.709（默认）
  • 2： BT.470-2M
  • 3： BT.470-2 B，G
  • 4： SMPTE 170M
  • 5： SMPTE 240M
  • 6： 线性（V=Lc）
  • 7： sRGB（非常类似于BT.709）
  • 8-255:保留

• bMatrixCoefficients: 用于计算原色亮度和色度值。

  • 0: Unspecified (Image characteristics unknown)
  • 1: BT. 709
  • 2: FCC
  • 3: BT.470-2 B, G
  • 4: SMPTE 170M (BT.601, default)
  • 5: SMPTE 240M
  • 6-255: Reserved

颜色匹配描述符示例：

        ------- VS Color Matching Descriptor Descriptor -------
bLength                  : 0x06 (6 bytes)
bDescriptorType          : 0x24 (Video Streaming Interface)
bDescriptorSubtype       : 0x0D (Color Matching)
bColorPrimaries          : 0x01 (BT.709, sRGB)
bTransferCharacteristics : 0x01 (BT.709)
bMatrixCoefficients      : 0x04 (SMPTE 170M)
Data (HexDump)           : 06 24 0D 01 01 04

A.6. Video Class-Specific VS Interface Descriptor Subtypes

/* A.6. Video Class-Specific VS Interface Descriptor Subtypes */
#define UVC_VS_UNDEFINED                0x00
#define UVC_VS_INPUT_HEADER                0x01
#define UVC_VS_OUTPUT_HEADER                0x02
#define UVC_VS_STILL_IMAGE_FRAME            0x03
#define UVC_VS_FORMAT_UNCOMPRESSED            0x04
#define UVC_VS_FRAME_UNCOMPRESSED            0x05
#define UVC_VS_FORMAT_MJPEG                0x06
#define UVC_VS_FRAME_MJPEG                0x07
#define UVC_VS_FORMAT_MPEG2TS                0x0a
#define UVC_VS_FORMAT_DV                0x0c
#define UVC_VS_COLORFORMAT                0x0d
#define UVC_VS_FORMAT_FRAME_BASED            0x10
#define UVC_VS_FRAME_FRAME_BASED            0x11
#define UVC_VS_FORMAT_STREAM_BASED            0x12