11. CCM

11.1. 功能描述

CCM 为 Color Correction Matrix 的简称。因为 Sensor 在 RGB 的响应与人眼不同，所以需要使用此矩阵做转换，让前端捕获的图片亮度与人眼一致。

11.2. API 参考

11.2.1. CVI_ISP_SetCCMAttr

【描述】

设置色彩校正矩阵属性参数

【语法】

CVI_S32 CVI_ISP_SetCCMAttr(VI_PIPE ViPipe, const ISP_CCM_ATTR_S *pstCCMAttr);

【参数】

参数名称

描述

输入/输出

ViPipe

VI_PIPE 号

输入

pstCCMAttr

色彩校正矩阵属性参数

输入

【返回值】

返回值

描述

0

成功

非 0

失败，其值为 错误码。

【需求】

  • 头文件: cvi_isp.h, cvi_comm_isp.h

  • 库文件: libisp.so

【注意】

无

【举例】

无

【相关主题】

11.2.2. CVI_ISP_GetCCMAttr

【描述】

获取色彩校正矩阵属性参数

【语法】

CVI_S32 CVI_ISP_GetCCMAttr(VI_PIPE ViPipe, ISP_CCM_ATTR_S *pstCCMAttr);

【参数】

参数名称

描述

输入/输出

ViPipe

VI_PIPE 号

输入

pstCCMAttr

色彩校正矩阵属性参数

输出

【返回值】

返回值

描述

0

成功

非 0

失败，其值为 错误码。

【需求】

  • 头文件: cvi_isp.h, cvi_comm_isp.h

  • 库文件: libisp.so

【注意】

无

【举例】

无

【相关主题】

11.2.3. CVI_ISP_SetCCMSaturationAttr

【描述】

设置色彩饱和度属性参数

【语法】

CVI_S32 CVI_ISP_SetCCMSaturationAttr (VI_PIPE ViPipe, const ISP_CCM_SATURATION_ATTR_S * pstCCMSaturationAttr);

【参数】

参数名称

描述

输入/输出

ViPipe

VI_PIPE 号

输入

pstCCMSaturationAttr

色彩饱和度属性参数

输入

【返回值】

返回值

描述

0

成功

非 0

失败，其值为 错误码。

【需求】

  • 头文件: cvi_isp.h, cvi_comm_isp.h

  • 库文件: libisp.so

【注意】

无

【举例】

无

【相关主题】

11.2.4. CVI_ISP_GetCCMSaturationAttr

【描述】

获取色彩饱和度属性参数

【语法】

CVI_S32 CVI_ISP_GetCCMSaturationAttr (VI_PIPE ViPipe, const ISP_CCM_SATURATION_ATTR_S *pstCCMSaturationAttr);

【参数】

参数名称

描述

输入/输出

ViPipe

VI_PIPE 号

输入

pstCCMSaturationAttr

色彩饱和度属性参数

输入

【返回值】

返回值

描述

0

成功

非 0

失败，其值为 错误码。

【需求】

  • 头文件: cvi_isp.h, cvi_comm_isp.h

  • 库文件: libisp.so

【注意】

无

【举例】

无

【相关主题】

11.3. 数据类型

11.3.1. ISP_COLORMATRIX_ATTR_S

【说明】

色彩校正矩阵

【定义】

typedef struct _ISP_COLORMATRIX_ATTR_S {
   CVI_U16 ColorTemp;
   CVI_S16 CCM[9];
} ISP_COLORMATRIX_ATTR_S;

【成员】

成员名称

描述

ColorTemp

此色彩校正矩阵适用的色温

取值范围： [0x1f4, 0x7530]

数据类型： CVI_U16

CCM[9]

3x3色彩校正矩阵实际内容

取值范围： [0x-2000, 0x1fff]

数据类型： CVI_S16

【注意事项】

无

【相关数据类型及接口】

11.3.2. ISP_CCM_MANUAL_ATTR_S

【说明】

色彩校正矩阵属性手动参数

【定义】

typedef struct _ISP_CCM_MANUAL_ATTR_S {
   CVI_U8 SatEnable;
   CVI_S16 CCM[9];
} ISP_CCM_MANUAL_ATTR_S;

【成员】

成员名称

描述

SatEnable

手动模式下，饱和度是否生效。

取值范围： [0, 1]

数据类型： CVI_BOOL

CCM[9]

取值范围： [0x-2000, 0x1fff]

数据类型： CVI_S16

【注意事项】

无

【相关数据类型及接口】

11.3.3. ISP_CCM_AUTO_ATTR_S

【说明】

色彩校正矩阵属性自动参数

【定义】

typedef struct _ISP_CCM_AUTO_ATTR_S {
   CVI_U8 ISOActEnable;
   CVI_U8 TempActEnable;
   CVI_U8 CCMTabNum;
   ISP_COLORMATRIX_ATTR_S CCMTab[7];
} ISP_CCM_AUTO_ATTR_S;

【成员】

成员名称

描述

ISOActEnable

低照度下CCM Bypass功能使能。

0: 关闭。

1: 使能。

取值范围： [0, 1]

数据类型： CVI_BOOL

TempActEnable

高低色温下CCM Bypass功能使能。

0: 关闭。

1: 使能。

取值范围： [0, 1]

数据类型： CVI_BOOL

CCMTabNum

当前配置的CCM矩阵个数。

取值范围： [0x3, 0x7]

数据类型： CVI_U8

CCMTab

不同色温下的颜色校正矩阵

【注意事项】

无

【相关数据类型及接口】

11.3.4. ISP_CCM_ATTR_S

【说明】

色彩校正矩阵属性参数

【定义】

typedef struct _ISP_CCM_ATTR_S {
   CVI_BOOL Enable;
   ISP_OP_TYPE_E enOpType;
   CVI_U8 UpdateInterval;
   ISP_CCM_MANUAL_ATTR_S stManual;
   ISP_CCM_AUTO_ATTR_S stAuto;
} ISP_CCM_ATTR_S;

【成员】

成员名称

描述

Enable

CCM模块使能。

0: 关闭。

1: 使能。取值范围： [0, 1]

数据类型： CVI_BOOL

enOpType

选择手动或自动模式

UpdateInterval

影响参数更新间隔,值越大画面变化越慢, 效能越好。

取值范围： [0x0, 0xff]

数据类型： CVI_U8

stAuto

自动参数

stManual

手动参数

【注意事项】

无

【相关数据类型及接口】

11.3.5. ISP_CCM_SATURATION_MANUAL_ATTR_S

【说明】

色彩饱和度属性手动参数

【定义】

typedef struct _ISP_CCM_SATURATION_MANUAL_ATTR_S {
   CVI_U8 SaturationLE;
   CVI_U8 SaturationSE;
} ISP_CCM_SATURATION_MANUAL_ATTR_S;

【成员】

成员名称

描述

SaturationLE

长曝饱和度

取值范围： [0, 0xff]

数据类型： CVI_U8

SaturationSE

短曝饱和度

取值范围： [0, 0xff]

数据类型： CVI_U8

【注意事项】

无

【相关数据类型及接口】

11.3.6. ISP_CCM_SATURATION_AUTO_ATTR_S

【说明】

色彩饱和度属性自动参数

【定义】

typedef struct _ISP_CCM_SATURATION_AUTO_ATTR_S {
   CVI_U8 SaturationLE[ISP_AUTO_ISO_STRENGTH_NUM];
   CVI_U8 SaturationSE[ISP_AUTO_ISO_STRENGTH_NUM];
} ISP_CCM_SATURATION_AUTO_ATTR_S;

【成员】

成员名称

描述

SaturationLE

长曝饱和度

取值范围： [0, 0xff]

数据类型： CVI_U8

SaturationSE

短曝饱和度

取值范围： [0, 0xff]

数据类型： CVI_U8

【注意事项】

无

【相关数据类型及接口】

11.3.7. ISP_CCM_SATURATION_ATTR_S

【说明】

色彩饱和度属性参数

【定义】

typedef struct _ISP_CCM_SATURATION_ATTR_SS {
   ISP_CCM_SATURATION_MANUAL_ATTR_S stManual;
   ISP_CCM_SATURATION_AUTO_ATTR_S stAuto;
} ISP_CCM_SATURATION_ATTR_S;

【成员】

成员名称

描述

stManual

手动参数

stAuto

自动参数

【注意事项】

无

【相关数据类型及接口】