8. BLC¶

8.1. 功能描述¶

BLC 为当外界没有任何光线照入时，Sensor 仍然输出的亮度值。ISP 需要扣除，以使亮度、颜色正常。

8.2. API 参考¶

CVI_ISP_SetBlackLevelAttr ：设置黑电平属性参数
CVI_ISP_GetBlackLevelAttr ：获取黑电平属性参数

8.2.1. CVI_ISP_SetBlackLevelAttr¶

【描述】

设置黑电平属性参数

【语法】

CVI_S32 CVI_ISP_SetBlackLevelAttr(VI_PIPE ViPipe, const ISP_BLACK_LEVEL_ATTR_S *pstBlackLevelAttr);

【参数】

参数名称	描述	输入/输出
ViPipe	VI_PIPE 号	输入
pstBlackLevelAttr	黑电平属性参数	输入

【返回值】

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

【需求】

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

【注意】

无

【举例】

VI_PIPE ViPipe = 0;
ISP_BLACK_LEVEL_ATTR_S stAttr;
CVI_ISP_GetBlackLevelAttr(ViPipe, &stAttr);
stAttr.enOpType = OP_TYPE_AUTO;
CVI_ISP_SetBlackLevelAttr(ViPipe, &stAttr);

【相关主题】

CVI_ISP_GetBlackLevelAttr

8.2.2. CVI_ISP_GetBlackLevelAttr¶

【描述】

获取黑电平属性参数

【语法】

CVI_S32 CVI_ISP_GetBlackLevelAttr(VI_PIPE ViPipe, ISP_BLACK_LEVEL_ATTR_S *pstBlackLevelAttr);

【参数】

参数名称	描述	输入/输出
ViPipe	VI_PIPE 号	输入
pstBlackLevelAttr	黑电平属性参数	输出

【返回值】

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

【需求】

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

【注意】

无

【举例】

无

【相关主题】

CVI_ISP_SetBlackLevelAttr

8.3. 数据类型¶

ISP_BLACK_LEVEL_MANUAL_ATTR_S ：定义手动黑电平属性参数
ISP_BLACK_LEVEL_AUTO_ATTR_S ：定义自动黑电平属性参数
ISP_BLACK_LEVEL_ATTR_S ：定义黑电平属性参数

8.3.1. ISP_BLACK_LEVEL_MANUAL_ATTR_S¶

【说明】

定义手动黑电平属性参数

【定义】

typedef struct _ISP_BLACK_LEVEL_MANUAL_ATTR_S {
        CVI_U16 OffsetR; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetGr; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetGb; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetB; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetR2; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetGr2; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetGb2; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetB2; /*Rw; Range:[0, 4095]*/
} ISP_BLACK_LEVEL_MANUAL_ATTR_S;

【成员】

成员名称	描述
OffsetR	R 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetGr	Gr 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetGb	Gb 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetB	B 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetR2	第二级 R 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetGr2	第二级 Gr 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetGb2	第二级 Gb 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetB2	第二级 B 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16

【注意事项】

无

【相关数据类型及接口】

8.3.2. ISP_BLACK_LEVEL_AUTO_ATTR_S¶

【说明】

定义自动黑电平属性参数

【定义】

typedef struct _ISP_BLACK_LEVEL_AUTO_ATTR_S {
        CVI_U16 OffsetR[ISP_AUTO_ISO_STRENGTH_NUM]; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetGr[ISP_AUTO_ISO_STRENGTH_NUM]; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetGb[ISP_AUTO_ISO_STRENGTH_NUM]; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetB[ISP_AUTO_ISO_STRENGTH_NUM]; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetR2[ISP_AUTO_ISO_STRENGTH_NUM]; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetGr2[ISP_AUTO_ISO_STRENGTH_NUM]; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetGb2[ISP_AUTO_ISO_STRENGTH_NUM]; /*Rw; Range:[0, 4095]*/
        CVI_U16 OffsetB2[ISP_AUTO_ISO_STRENGTH_NUM]; /*Rw; Range:[0, 4095]*/
} ISP_BLACK_LEVEL_AUTO_ATTR_S;

【成员】

成员名称	描述
OffsetR	R 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetGr	Gr 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetGb	Gb 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetB	B 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetR2	第二级 R 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetGr2	第二级 Gr 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetGb2	第二级 Gb 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16
OffsetB2	第二级 B 像素暗电流值取值范围： [0, 4095] 数据类型： CVI_U16

【注意事项】

无

【相关数据类型及接口】

8.3.3. ISP_BLACK_LEVEL_ATTR_S¶

【说明】

定义黑电平属性参数

【定义】

typedef struct _ISP_BLACK_LEVEL_ATTR_S {
        CVI_BOOL Enable; /*Rw; Range:[0, 1]*/
        ISP_OP_TYPE_E enOpType;
        CVI_U8 UpdateInterval; /*Rw; Range:[0, 255]*/
        ISP_BLACK_LEVEL_MANUAL_ATTR_S stManual;
        ISP_BLACK_LEVEL_AUTO_ATTR_S stAuto;
} ISP_BLACK_LEVEL_ATTR_S;

【成员】

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

【注意事项】

无

【相关数据类型及接口】