35. CA¶
35.1. 功能描述¶
调整UV domain饱和度, 此模组分为CA 模式与CP (热成像)模式, 同时间只能选一个开启。
CA模式: 根据input Y来调整饱和度, 因此可以局部调整饱和度。
CP模式: 因为热成像模式只有Y值, 会根据Y值查找预先调试的颜色模板, 查找对应的YUV值, 使其上色。
35.2. API 参考¶
CVI_ISP_SetCAAttr : 设置饱和度属性参数
CVI_ISP_GetCAAttr : 获取饱和度属性参数
35.2.1. CVI_ISP_SetCAAttr¶
【描述】
设置饱和度属性参数
【语法】
CVI_S32 CVI_ISP_SetCAAttr(VI_PIPE ViPipe, const ISP_CA_ATTR_S *pstCAAttr);
【参数】
参数名称 |
描述 |
输入/输出 |
|---|---|---|
ViPipe |
VI_PIPE 号 |
输入 |
pstCAAttr |
饱和度属性参数 |
输入 |
【返回值】
返回值 |
描述 |
|---|---|
0 |
成功。 |
非 0 |
失败, 其值为 错误码。 |
【需求】
头文件: cvi_isp.h, cvi_comm_isp.h
库文件: libisp.so
【注意】
无。
【举例】
无。
【相关主题】
35.2.2. CVI_ISP_GetCAAttr¶
【描述】
获取饱和度属性参数
【语法】
CVI_S32 CVI_ISP_GetCAAttr(VI_PIPE ViPipe, ISP_CA_ATTR_S *pstCAAttr);
【参数】
参数名称 |
描述 |
输入/输出 |
|---|---|---|
ViPipe |
VI_PIPE 号 |
输入 |
pstCAAttr |
饱和度属性参数 |
输出 |
【返回值】
返回值 |
描述 |
|---|---|
0 |
成功。 |
非 0 |
失败, 其值为 错误码。 |
【需求】
头文件: cvi_isp.h, cvi_comm_isp.h
库文件: libisp.so
【注意】
无。
【举例】
无。
【相关主题】
35.3. 数据类型¶
ISP_CA_MANUAL_ATTR_S : 饱和度属性手动参数
ISP_CA_AUTO_ATTR_S : 饱和度属性自动参数
ISP_CA_ATTR_S : 饱和度属性参数
35.3.1. ISP_CA_MANUAL_ATTR_S¶
【说明】
饱和度属性手动参数
【定义】
typedef struct _ISP_CA_MANUAL_ATTR_S {
CVI_U16 ISORatio;
CVI_U16 YRatioLut[CA_LUT_NUM];
} ISP_CA_MANUAL_ATTR_S;
【成员】
成员名称 |
描述 |
|---|---|
ISORatio |
CA模式, 根据ISO值查找UV的增益。所有像素点的UV调整增益都是相同的, 建议在低ISO的时候此 增益可以设置大一些, 而高ISO时此增益 值可以设定小一些, 来抑制暗区的色噪。 取值范围: [0x0, 0x7ff] 数据类型: CVI_U16 |
YRatioLut[CA_LUT_NUM] |
CA模式, 根据亮度Y查找UV的增益。此值根据不同亮度等级可设置不同的UV增益, 建议在亮区的增益可以设置大一些, 颜色会较为鲜艳, 而暗区的增益可以设置小一些, 来抑制暗区色噪。 取值范围: [0x0, 0x7ff] 数据类型: CVI_U16 |
【注意事项】
无。
【相关数据类型及接口】
35.3.2. ISP_CA_AUTO_ATTR_S¶
【说明】
饱和度属性自动参数
【定义】
typedef struct _ISP_CA2_AUTO_ATTR_S {
CVI_U16 ISORatio[ISP_AUTO_ISO_STRENGTH_NUM];
CVI_U16 YRatioLut[CA_LUT_NUM][ISP_AUTO_ISO_STRENGTH_NUM];
} ISP_CA2_AUTO_ATTR_S;
【成员】
成员名称 |
描述 |
|---|---|
ISORatio |
CA模式, 根据ISO值查找UV的增益。所有像素点的UV调整增益都是相同的, 建议在低ISO的时候此 增益可以设置大一些, 而高ISO时此增益 值可以设定小一些, 来抑制暗区的色噪。 取值范围: [0x0, 0x7ff] 数据类型: CVI_U16 |
YRatioLut[CA_LUT_NUM] |
CA模式, 根据亮度Y查找UV的增益。此值根据不同亮度等级可设置不同的UV增益, 建议在亮区的增益可以设置大一些, 颜色会较为鲜艳, 而暗区的增益可以设置小一些, 来抑制暗区色噪。 取值范围: [0x0, 0x7ff] 数据类型: CVI_U16 |
【注意事项】
无。
【相关数据类型及接口】
35.3.3. ISP_CA_ATTR_S¶
【说明】
饱和度属性参数
【定义】
typedef struct _ISP_CA_ATTR_S {
CVI_BOOL Enable;
ISP_OP_TYPE_E enOpType;
CVI_U8 UpdateInterval;
CVI_BOOL CaCpMode;
CVI_U8 CPLutY[CA_LUT_NUM];
CVI_U8 CPLutU[CA_LUT_NUM];
CVI_U8 CPLutV[CA_LUT_NUM];
ISP_CA_MANUAL_ATTR_S stManual;
ISP_CA_AUTO_ATTR_S stAuto;
} ISP_CA_ATTR_S;
【成员】
成员名称 |
描述 |
|---|---|
Enable |
CA模块使能。 0: 关闭。 1: 使能。 取值范围: [0, 1] 数据类型: CVI_BOOL |
UpdateInterval |
影响参数更新间隔, 值越大画面变化越慢, 效能越好。 取值范围: [0x0, 0xff] 数据类型: CVI_U8 |
CaCpMode |
CA 模式选择: 0: CA 模式。 1: CP 模式。 取值范围: [0, 1]| 数据类型: CVI_BOOL |
CPLutY |
CP模式, 根据亮度Y查找LUT对应的Y值。 取值范围: [0, 0xff] 数据类型: CVI_U8 |
CPLutU |
CP模式, 根据亮度Y查找LUT对应的U值。 取值范围: [0, 0xff] 数据类型: CVI_U8 |
CPLutV |
CP模式, 根据亮度Y查找LUT对应的V值。 取值范围: [0, 0xff] 数据类型: CVI_U8 |
stManual |
手动模式参数属性 |
stAuto |
自动模式参数属性 |
【注意事项】
无。
【相关数据类型及接口】
CVI_ISP_SetCA2Attr
CVI_ISP_GetCA2Attr