---
title: hi_isp_color_matrix_auto
description: "定义自动颜色校正矩阵属性。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0251.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0251.html
indexId: 179abb44bc9c6aa0a53a3f2b887d676797c3981b583faa4714adf3c9ea47f3bd65
---
# hi_isp_color_matrix_auto

#### 说明

定义自动颜色校正矩阵属性。


#### 定义

```
typedef struct {
hi_bool
iso_act_en;
hi_bool
temp_act_en;
hi_u16
ccm_tab_num;
hi_isp_color_matrix_param
ccm_tab[HI_ISP_CCM_MATRIX_NUM];
} hi_isp_color_matrix_auto;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| iso\_act\_en | 是否使能低照度下CCM Bypass功能。 取值范围：[0,1]。 |
| temp\_act\_en | 是否使能高、低色温下CCM Bypass功能。 取值范围：[0,1]。 |
| ccm\_tab\_num | 当前配置的CCM的组数。 取值范围：[3,7]。 |
| ccm\_tab[HI\_ISP\_CCM\_MATRIX\_NUM] | 不同色温下的颜色校正矩阵和对应的色温值。 \#define HI\_ISP\_CCM\_MATRIX\_NUM 7 |


#### 注意事项

- 当hi_isp_saturation_attr中的op_type为HI_OP_MODE_AUTO，使用自动饱和度调节功能时，iso_act_en和temp_act_en功能生效。当op_type为HI_OP_MODE_MANUAL，使用手动饱和度调节功能时，iso_act_en和temp_act_en功能不生效。
- iso_act_en功能指的是极低照度下（ISO大于12800）逐渐Bypass CCM，将由饱和度数组sat[16]控制得到的CCM矩阵逐渐调向接近单位阵，这时CCM的实际饱和度会和饱和度数组中设定的不一致。用户关闭该功能后，极低照度下，饱和度数组仍生效。
- temp_act_en功能指的是在高色温（大于8000K）和低色温场景（小于2500K）， AWB可能未完全恢复，此时采用高饱和度CCM矩阵，会加剧AWB的偏色程度。比如钠灯场景，AWB校正后白色区域蓝色稍有不足，采用高饱和度CCM矩阵，白色区域的蓝色分量可能为0，图像整体偏黄。使能temp_act_en，在高低色温下逐渐BypassCCM，将由饱和度数组sat[16]控制得到的CCM矩阵逐渐调向接近单位阵，优化类似场景颜色表现。
- 颜色校正矩阵的数据格式，应与校正工具提供的保持一致。