8. BLC

8.1. Functional Description

BLC iswhenoutsideboundarynohaveanylightlineincident lightwhen, Sensor stillthenoutput brightnessvalue. ISP need tosubtract, usingmakebrightness, colornormal.

8.2. API Reference

8.2.1. CVI_ISP_SetBlackLevelAttr

[Description]

Setblackelectricalflatattribute parameters

[Syntax]

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

[Parameters]

Parameter Name

Description

Input/Output

ViPipe

VI_PIPE No.

Input

pstBlackLevelAttr

blackelectricalflatattribute parameters

Input

[Return Value]

Return Value

Description

0

Success

Non-zero

Failure, whose value is Error Code.

[Requirements]

  • Header File: cvi_isp.h, cvi_comm_isp.h

  • Library File: libisp.so

[Note]

None

[Example]

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);

[Related Topics]

8.2.2. CVI_ISP_GetBlackLevelAttr

[Description]

Getblackelectricalflatattribute parameters

[Syntax]

CVI_S32 CVI_ISP_GetBlackLevelAttr(VI_PIPE ViPipe, ISP_BLACK_LEVEL_ATTR_S *pstBlackLevelAttr);

[Parameters]

Parameter Name

Description

Input/Output

ViPipe

VI_PIPE No.

Input

pstBlackLevelAttr

blackelectricalflatattribute parameters

output

[Return Value]

Return Value

Description

0

Success

Non-zero

Failure, whose value is Error Code.

[Requirements]

  • Header File: cvi_isp.h, cvi_comm_isp.h

  • Library File: libisp.so

[Note]

None

[Example]

None

[Related Topics]

8.3. Data Types

8.3.1. ISP_BLACK_LEVEL_MANUAL_ATTR_S

[Description]

Manual Definitionblackelectricalflatattribute parameters

[Definition]

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;

[Members]

Member Name

Description

OffsetR

R pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetGr

Gr pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetGb

Gb pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetB

B pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetR2

secondlevel R pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetGr2

secondlevel Gr pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetGb2

secondlevel Gb pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetB2

secondlevel B pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

[Precautions]

None

[Related Data Types and Interfaces]

8.3.2. ISP_BLACK_LEVEL_AUTO_ATTR_S

[Description]

Automatic Definitionblackelectricalflatattribute parameters

[Definition]

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;

[Members]

Member Name

Description

OffsetR

R pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetGr

Gr pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetGb

Gb pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetB

B pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetR2

secondlevel R pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetGr2

secondlevel Gr pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetGb2

secondlevel Gb pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

OffsetB2

secondlevel B pixel dark current value

Value Range: [0, 4095]

Data Types: CVI_U16

[Precautions]

None

[Related Data Types and Interfaces]

8.3.3. ISP_BLACK_LEVEL_ATTR_S

[Description]

Define blackelectricalflatattribute parameters

[Definition]

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;

[Members]

Member Name

Description

Enable

module enable switch

Value Range: [0, 1]

Data Types: CVI_BOOL

enOpType

operation type

OP_TYPE_AUTO: automatic mode

OP_TYPE_MANUAL: manual mode

Data Types: ISP_OP_TYPE_E

UpdateInterval

affects the parameter update interval,the larger the value, the slower the image changes,the better the performance.

Value Range: [0, 255]

Data Types: CVI_U8

stManual

manual parameters

stAuto

automatic parameters

[Precautions]

None

[Related Data Types and Interfaces]