30. YCONTRAST¶

30.1. 功能描述¶

Y值域线性对比度。

30.2. API 参考¶

CVI_ISP_SetYContrastAttr ：设置Y Contrast 参数属性
CVI_ISP_GetYContrastAttr ：获取Y Contrast 参数属性

30.2.1. CVI_ISP_SetYContrastAttr¶

【描述】

设置Y Contrast 参数属性

【语法】

CVI_S32 CVI_ISP_SetYContrastAttr(VI_PIPE ViPipe, const ISP_YCONTRAST_ATTR_S *pstYContrastAttr);

【参数】

参数名称	描述	输入/输出
ViPipe	VI_PIPE 号	输入
pstYContrastAttr	Y Contrast 参数属性	输入

【返回值】

返回值	描述
0	成功
非 0	失败，其值为错误码。

【需求】

头文件: cvi_isp.h, cvi_comm_isp.h
库文件: libisp.so

【注意】

无

【举例】

VI_PIPE ViPipe = 0;
ISP_YCONTRAST_ATTR_S stAttr;
CVI_ISP_GetYContrastAttr(ViPipe, &stAttr);
stAttr.enOpType = OP_TYPE_AUTO;
CVI_ISP_SetYContrastAttr(ViPipe, &stAttr);

【相关主题】

CVI_ISP_GetYContrastAttr

30.2.2. CVI_ISP_GetYContrastAttr¶

【描述】

获取Y Contrast 参数属性

【语法】

CVI_S32 CVI_ISP_GetYContrastAttr(VI_PIPE ViPipe, ISP_YCONTRAST_ATTR_S *pstYContrastAttr);

【参数】

参数名称	描述	输入/输出
ViPipe	VI_PIPE 号	输入
pstYContrastAttr	Y Contrast 参数属性	输出

【返回值】

返回值	描述
0	成功
非 0	失败，其值为错误码。

【需求】

头文件: cvi_isp.h, cvi_comm_isp.h
库文件: libisp.so

【注意】

无

【举例】

无

【相关主题】

CVI_ISP_SetYContrastAttr

30.3. 数据类型¶

ISP_YCONTRAST_MANUAL_ATTR_S ：定义手动Y Contrast 参数属性
ISP_YCONTRAST_AUTO_ATTR_S ：定义自动Y Contrast 参数属性
ISP_YCONTRAST_ATTR_S ：定义Y Contrast 参数属性

30.3.1. ISP_YCONTRAST_MANUAL_ATTR_S¶

【说明】

定义手动Y Contrast 参数属性

【定义】

typedef struct _ISP_YCONTRAST_MANUAL_ATTR_S {
        CVI_U8 ContrastLow; /*Rw; Range:[0, 100]*/
        CVI_U8 ContrastHigh; /*Rw; Range:[0, 100]*/
        CVI_U8 CenterLuma; /*Rw; Range:[0, 64]*/
} ISP_YCONTRAST_MANUAL_ATTR_S;

【成员】

成员名称

描述

ContrastLow

小于中心点位置的区域对比度强度。值越大，对比越强。

取值范围： [0, 100]

数据类型： CVI_U8

ContrastHigh

大于中心点位置的区域对比度强度。值越大，对比越强。

取值范围： [0, 100]

数据类型： CVI_U8

CenterLuma

中心点位置，会以中心点往两边加强对比。

取值范围： [0, 64]

数据类型： CVI_U8

【注意事项】

无

【相关数据类型及接口】

30.3.2. ISP_YCONTRAST_AUTO_ATTR_S¶

【说明】

定义自动Y Contrast 参数属性

【定义】

typedef struct _ISP_YCONTRAST_AUTO_ATTR_S {
        CVI_U8 ContrastLow[ISP_AUTO_LV_NUM]; /*Rw; Range:[0, 100]*/
        CVI_U8 ContrastHigh[ISP_AUTO_LV_NUM]; /*Rw; Range:[0, 100]*/
        CVI_U8 CenterLuma[ISP_AUTO_LV_NUM]; /*Rw; Range:[0, 64]*/
} ISP_YCONTRAST_AUTO_ATTR_S;

【成员】

成员名称

描述

ContrastLow

小于中心点位置的区域对比度强度。值越大，对比越强。

取值范围： [0, 100]

数据类型： CVI_U8

ContrastHigh

大于中心点位置的区域对比度强度。值越大，对比越强。

取值范围： [0, 100]

数据类型： CVI_U8

CenterLuma

中心点位置，会以中心点往两边加强对比。

取值范围： [0, 64]

数据类型： CVI_U8

【注意事项】

无

【相关数据类型及接口】

30.3.3. ISP_YCONTRAST_ATTR_S¶

【说明】

定义Y Contrast 参数属性

【定义】

typedef struct _ISP_YCONTRAST_ATTR_S {
        CVI_BOOL Enable; /*Rw; Range:[0, 1]*/
        ISP_OP_TYPE_E enOpType;
        CVI_U8 UpdateInterval; /*Rw; Range:[1, 255]*/
        ISP_YCONTRAST_MANUAL_ATTR_S stManual;
        ISP_YCONTRAST_AUTO_ATTR_S stAuto;
} ISP_YCONTRAST_ATTR_S;

【成员】

成员名称	描述
Enable	模块使能开关取值范围： [0, 1] 数据类型： CVI_BOOL
enOpType	工作类型 OP_TYPE_AUTO：自动模式 OP_TYPE_MANUAL：手动模式数据类型： ISP_OP_TYPE_E
UpdateInterval	影响参数更新间隔,值越大画面变化越慢,效能越好。取值范围： [1, 255] 数据类型： CVI_U8
stManual	手动参数
stAuto	自动参数

【注意事项】

无

【相关数据类型及接口】