---
title: hi_isp_csc_attr
description: "说明定义ISP色彩空间转换模块属性。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0281.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0281.html
indexId: 0c33c569c5d760f5e610c7737826811959e3a142b66be484c49571568fb1948f65
---
# hi_isp_csc_attr

说明定义ISP色彩空间转换模块属性。

定义

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

#### 成员

| 成员名称 | 描述 |
| --- | --- |
| enable | 是否使能CSC功能。 取值范围： HI\_FALSE：否 HI\_TRUE：是 |
| color\_gamut | 色彩空间类型枚举。 |
| hue | 目标YUV空间色调。 取值范围：[0,100]。 |
| luma | 目标YUV空间亮度。 取值范围：[0,100]。 |
| contr | 目标YUV空间对比度。 取值范围：[0,100]。 |
| satu | 目标YUV空间饱和度。 取值范围：[0,100]。 |
| limited\_range\_en | 目标YUV空间动态范围选择。 取值范围： HI\_FALSE：输出为Full Range HI\_TRUE：输出为Limited Range |
| ext\_csc\_en | 选择亮度调整模式（与luma配合）。 HI\_FALSE：表示luma不可以调节更宽的亮度变化 HI\_TRUE：表示luma可以调节更宽的亮度变化 |
| ct\_mode\_en | 选择输出的对比度调整模式。 HI\_FALSE：改变contr画面亮度会变化 HI\_TRUE：改变contr画面亮度不会变化 |
| csc\_magtrx | 色彩空间转换矩阵系数。 |


#### 注意事项

- color_gamut中可选择HI_COLOR_GAMUT_BT601，HI_COLOR_GAMUT_BT709，HI_COLOR_GAMUT_USER三种模式。在HI_COLOR_GAMUT_BT601和HI_COLOR_GAMUT_BT709模式下，csc模块采用特定的csc_magtrx，用户无法在这两个模式下修改csc_magtrx；只有在HI_COLOR_GAMUT_USER模式下，用户可根据实际情况自由设定csc_magtrx的参数来进行色彩空间转换
- 如果将contr值调小（20左右）时，在平坦区域容易出现等高线，出现的原因是因为contr值调小后，会影响画面的动态范围，导致原本0~255（或者10bit 0~1023）的动态范围缩小到原来的20%左右，因此在平坦区域如果有亮度变化，则非常容易产生量化误差出现等高线。