---
title: hi_mpi_isp_set_ccm_attr
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0244.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0244.html
indexId: d604d902029c61255ded8edc84bf407d119d1a059e5527f94f9d7eaeccfaf82f65
---
# hi_mpi_isp_set_ccm_attr

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | ☓ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | ☓ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | ☓ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | ☓ |
| Atlas 训练系列产品 | ☓ |


#### 功能说明

设置颜色矩阵。


#### 函数原型

```
hi_s32
hi_mpi_isp_set_ccm_attr(
hi_vi_pipe
vi_pipe, const
hi_isp_color_matrix_attr
*ccm_attr)
```


#### 参数说明

| 参数名称 | 输入/输出 | 描述 |
| --- | --- | --- |
| vi\_pipe | 输入 | VI PIPE号。 取值范围：[0, 12)。 |
| ccm\_attr | 输入 | 颜色矩阵。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  ISP返回码
。


#### 约束说明

- 颜色校正矩阵的数据格式，应与校正工具提供的保持一致。
- 可根据当前色温，设置不同的CCM，从而在高低色温下都达到较好的颜色还原。
- 该MPI支持最大七个最小三个不同色温下的色彩还原矩阵，要按照色温递减的方式配置CCM，即0-6组CCM矩阵由高色温到低色温。典型的三组CCM为
  D50，TL84，A三个光源下的CCM。典型的五组CCM为10K，D65，D50，TL84，A五个光源下的CCM。前一组的色温值与后一组的色温值需符合如下规则：Tpre * (100 – 6.25) > Tpost * (100 + 6.25)。

- 手动模式下，ISP系统生效的CCM即用户手动配置的CCM，有利于CCM精调，因此建议在手动模式下校正不同色温光源下的CCM矩阵，得到多组CCM矩阵后再通过MPI写入，验证多个光源下的CCM组合效果。手动CCM模式下，饱和度调整有效。在特定光源下做CCM精调时，需要先确认饱和度是否期望值。