hi_isp_csc_attr

Defines the CSC attribute in the ISP.

Definition

typedef struct {
    hi_bool enable;               
    hi_color_gamut color_gamut;      
    hi_u8   hue;             
    hi_u8   luma;                
    hi_u8   contr;              
    hi_u8   satu;            
    hi_bool limited_range_en;     
    hi_bool ext_csc_en;       
    hi_bool ct_mode_en;       
    hi_isp_csc_matrix csc_magtrx;    
} hi_isp_csc_attr;

Members

Member

Description

enable

CSC enable

The options are as follows:

  • HI_FALSE: disabled
  • HI_TRUE: enabled

color_gamut

Type enumeration of color gamut

hue

Hue of the target YUV space

Value range: [0, 100]

luma

Luminance of the target YUV space

Value range: [0, 100]

contr

Contrast of the target YUV space

Value range: [0, 100]

satu

Saturation of the target YUV space

Value range: [0, 100]

limited_range_en

Dynamic range of the target YUV space

The options are as follows:

  • HI_FALSE: The output is Full Range.
  • HI_TRUE: The output is Limited Range.

ext_csc_en

Luminance adjustment mode (used together with luma)

  • HI_FALSE: The luminance cannot be adjusted to a wider range.
  • HI_TRUE: The luminance can be adjusted to a wider range.

ct_mode_en

Output contrast adjustment mode

  • HI_FALSE: The image luminance changes when contr is changed.
  • HI_TRUE: The image luminance does not change when contr is changed.

csc_magtrx

CSC matrix coefficient

Restrictions

  • color_gamut can be set to HI_COLOR_GAMUT_BT601, HI_COLOR_GAMUT_BT709, or HI_COLOR_GAMUT_USER. In HI_COLOR_GAMUT_BT601 and HI_COLOR_GAMUT_BT709 modes, the CSC module uses a specific csc_magtrx, which cannot be modified. Only in HI_COLOR_GAMUT_USER mode can csc_magtrx be set as required to implement CSC.
  • If the value of contr is decreased to about 20, contours are likely to occur in the flat region. This is because decreasing the value of contr affects the dynamic range of the image. As a result, the dynamic range of 0–255 (or 0–1023 in 10-bit mode) is reduced to about 20% of the original dynamic range. Therefore, if the luminance of the flat region changes, quantization errors and contours are likely to occur.