7. BlackLevel

7.1. 功能描述

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

7.2. API 参考

7.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

【注意】

无。

【举例】

无。

【相关主题】

7.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

【注意】

无。

【举例】

无。

【相关主题】

7.3. 数据类型

7.3.1. ISP_BlACK_LEVEL_MANUAL_ATTR_S

【说明】

定义黑电平手动属性

【定义】

typedef struct _ISP_BLACK_LEVEL_MANUAL_ATTR_S {
  CVI_U16 OffsetR;
  CVI_U16 OffsetGr;
  CVI_U16 OffsetGb;
  CVI_U16 OffsetB;
  CVI_U16 OffsetR2;
  CVI_U16 OffsetGr2;
  CVI_U16 OffsetGb2;
  CVI_U16 OffsetB2;
} ISP_BLACK_LEVEL_MANUAL_ATTR_S;

【成员】

成员名称

描述

OffsetR

BLC R 像素暗电流值返回值

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

数据类型： CVI_U16返回值

OffsetGr

BLC GR 像素暗电流值

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

数据类型： CVI_U16

OffsetGb

BLC GB 像素暗电流值

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

数据类型： CVI_U16

OffsetB

BLC B 像素暗电流值返回值

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

数据类型： CVI_U16

OffsetR2

BLC 第二级R 像素暗电流值

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

数据类型： CVI_U16返回值

OffsetGr2

BLC 第二级GR 像素暗电流值

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

数据类型： CVI_U16

OffsetGb2

BLC 第二级GB 像素暗电流值

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

数据类型： CVI_U16

OffsetB2

BLC 第二级B 像素暗电流值

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

数据类型： CVI_U16

【注意事项】

无。

【相关数据类型及接口】

7.3.2. ISP_BLACK_LEVEL_AUTO_ATTR_S

【说明】

定义黑电平自动属性

【定义】

typedef struct _ISP_BLACK_LEVEL_AUTO_ATTR_S {
  CVI_U16 OffsetR[ISP_AUTO_ISO_STRENGTH_NUM];
  CVI_U16 OffsetGr[ISP_AUTO_ISO_STRENGTH_NUM];
  CVI_U16 OffsetGb[ISP_AUTO_ISO_STRENGTH_NUM];
  CVI_U16 OffsetB[ISP_AUTO_ISO_STRENGTH_NUM];
  CVI_U16 OffsetR2[ISP_AUTO_ISO_STRENGTH_NUM];
  CVI_U16 OffsetGr2[ISP_AUTO_ISO_STRENGTH_NUM];
  CVI_U16 OffsetGb2[ISP_AUTO_ISO_STRENGTH_NUM];
  CVI_U16 OffsetB2[ISP_AUTO_ISO_STRENGTH_NUM];
} ISP_BLACK_LEVEL_AUTO_ATTR_S;

【成员】

成员名称

描述

OffsetR

BLC R 像素暗电流值返回值

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

数据类型： CVI_U16

OffsetGr

BLC GR 像素暗电流值

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

数据类型： CVI_U16

OffsetGb

BLC GB 像素暗电流值

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

数据类型： CVI_U16

OffsetB

BLC B 像素暗电流值返回值

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

数据类型： CVI_U16

OffsetR2

BLC 第二级R 像素暗电流值

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

数据类型： CVI_U16返回值

OffsetGr2

BLC 第二级GR 像素暗电流值

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

数据类型： CVI_U16

OffsetGb2

BLC 第二级GB 像素暗电流值

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

数据类型： CVI_U16

OffsetB2

BLC 第二级B 像素暗电流值

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

数据类型： CVI_U16

【注意事项】

无。

【相关数据类型及接口】

7.3.3. ISP_BLACK_LEVEL_ATTR_S

【说明】

定义黑电平属性

【定义】

typedef struct _ISP_BLACK_LEVEL_ATTR_S {
  CVI_U8 Enable;
  ISP_OP_TYPE_E enOpType;
  CVI_U8 UpdateInterval;
  ISP_BLACK_LEVEL_MANUAL_ATTR_S stManual;
  ISP_BLACK_LEVEL_AUTO_ATTR_S stAuto;
} ISP_BLACK_LEVEL_ATTR_S;

【成员】

成员名称

描述

Enable

BLC 模块使能

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

数据类型： CVI_U8

enOpType

选择手动或自动模式返回值

UpdateInterval

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

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

数据类型： CVI_U8

stManual

手动参数

stAuto

自动参数

【注意事项】

无。

【相关数据类型及接口】