34. YCONTRAST

34.1. Function Overview

Y domain linear contrast.

34.2. API Reference

34.2.1. CVI_ISP_SetYContrastAttr

【Description】

Set Y range contrast attribute parameter

【Syntax】

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

【Parameter】

Parameter

Description

Input/Output

ViPipe

VI_PIPE number

Input

pstYContrastAttr

Y domain contrast attribute parameter

Input

【Return Value】

return value

Description

0

Success

Non 0

Failure. An error code is returned. For details, see chapter Error Codes.

【Requirement】

  • Header files: cvi_isp.h, cvi_comm_isp.h

  • Library files: libisp.so

【Note】

None.

【Example】

None.

【Related Topic】

34.2.2. CVI_ISP_GetYContrastAttr

【Description】

Get Y range contrast attribute parameter

【Syntax】


【Parameter】

Parameter

Description

Input/Output

ViPipe

VI_PIPE number

Input

pstYContrastAttr

Y domain contrast attribute parameter

Output

【Return Value】

return value

Description

0

Success

Non 0

Failure. An error code is returned. For details, see chapter Error Codes.

【Requirement】

  • Header files: cvi_isp.h, cvi_comm_isp.h

  • Library files: libisp.so

【Note】

None.

【Example】

None.

【Related Topic】

34.3. Data Types

34.3.1. ISP_YCONTRAST_MANUAL_ATTR_S

【Description】

Gamma attribute manual parameter

【Syntax】

 typedef struct _ISP_YCONTRAST_MANUAL_ATTR_S {
  CVI_U8 ContrastLow;
  CVI_U8 ContrastHigh;
  CVI_U8 CenterLuma;
} ISP_YCONTRAST_MANUAL_ATTR_S;

【Member】

Member

Description

ContrastLow

Contrast strength of areas smaller than the center point. The larger the value, the stronger the contrast.

Value range: [0x0, 0x64]

Data type: CVI_U8

ContrastHigh

The contrast strength of the area greater than the center point position. The larger the value, the stronger the contrast.

Value range: [0x0, 0x64]

Data type: CVI_U8

CenterLuma

The position of the center point will strengthen the contrast from the center point to both sides.

Value range: [0x0, 0x40]

Data type: CVI_U8

【Note】

None.

【Related Data Type and Interface】

34.3.2. ISP_YCONTRAST_AUTO_ATTR_S

【Description】

gamma attribute automatic parameter

【Syntax】

 typedef struct _ISP_YCONTRAST_AUTO_ATTR_S {
  CVI_U8 ContrastLow[ISP_AUTO_LV_NUM];
  CVI_U8 ContrastHigh[ISP_AUTO_LV_NUM];
  CVI_U8 CenterLuma[ISP_AUTO_LV_NUM];
} ISP_YCONTRAST_AUTO_ATTR_S;

【Member】

Member

Description

ContrastLow

Contrast strength of areas smaller than the center point. The larger the value, the stronger the contrast.

Value range: [0x0, 0x64]

Data type: CVI_U8

ContrastHigh

The contrast strength of the area greater than the center point position. The larger the value, the stronger the contrast.

Value range: [0x0, 0x64]

Data type: CVI_U8

CenterLuma

The position of the center point will strengthen the contrast from the center point to both sides.

Value range: [0x0, 0x40]

Data type: CVI_U8

【Note】

None.

【Related Data Type and Interface】

34.3.3. ISP_YCONTRAST_ATTR_S

【Description】

gamma attribute parameter

【Syntax】

 typedef struct _ISP_YCONTRAST_ATTR_S {
  CVI_BOOL Enable;
  ISP_OP_TYPE_E enOpType;
  CVI_U8 UpdateInterval;
  ISP_YCONTRAST_MANUAL_ATTR_S stManual;
  ISP_YCONTRAST_AUTO_ATTR_S stAuto;
} ISP_YCONTRAST_ATTR_S;

【Member】

Member

Description

Enable

The YCONTRAST module is enabled.

0: off.

1: Enabled.

Value range: [0, 1]

Data type: CVI_BOOL

enOpType

job type

OP_TYPE_AUTO: automatic mode

OP_TYPE_MANUAL: manual mode

UpdateInterval

Affects the parameter update interval, the larger the value, the slower the screen changes and the better the performance.

Value range: [0x0, 0xff]

Data type: CVI_U8

stManual

Manual Mode Parameter Properties

stAuto

Auto Mode Parameter Properties

【Note】

None.

【Related Data Type and Interface】