# hi_mpi_sys_set_chn_csc_matrix

#### 函数功能

在处理图像或视频前，YUV与RGB之间格式转换场景下，如果需要调整色域转换参数时，在创建对应图像或视频处理通道后，可调用该接口设置色域转换参数。


#### 约束说明

如果不调用本接口设置色域转换参数，默认使用BT601 wide标准的色域转换矩阵参数值。

如果默认的色域转换参数不适用，仅需修改一次，该通道内的其它任务都使用修改后的色域转换参数，则在创建对应图像或视频处理通道后，可调用本接口设置色域转换参数，再调用具体的图像或视频处理接口，然后再调用对应的图像或视频处理结果获取接口。

如果默认的色域转换参数不适用，不同任务使用不同的色域转换参数，需多次修改，则在创建对应图像或视频处理通道后，在上一次任务执行结束后、下一次任务执行前调用本接口设置色域转换参数（如果上一次任务没有执行结束，就再次调用本接口设置色域转换参数，可能会导致任务处理的结果不正确），再调用具体的图像或视频处理接口，然后再调用对应的图像或视频处理结果获取接口。

调用顺序示例如下：

1.   hi_mpi_sys_set_chn_csc_matrix
（第一次修改色域转换参数）
2.   hi_mpi_vpc_crop
（抠图）
3.   hi_mpi_vpc_get_process_result
（等待抠图任务结束）
4.   hi_mpi_sys_set_chn_csc_matrix
（第二次修改色域转换参数）
5.   hi_mpi_vpc_resize
（缩放）
6.   hi_mpi_vpc_get_process_result
（等待缩放任务结束）


#### 函数原型

hi_s32 hi_mpi_sys_set_chn_csc_matrix(hi_mod_id mode, hi_s32 chn, hi_csc_matrix csc_matrix, hi_csc_coefficient *csc_coefficient)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| mode | 输入 | 模块ID，当前只支持HI\_ID\_VDEC和HI\_ID\_VPC。 |
| chn | 输入 | 通道号。当mode设置为HI\_ID\_VDEC时，通道号范围请参见hi\_mpi\_vdec\_create\_chn处chn参数的取值范围；当mode设置为HI\_ID\_VPC时，通道号范围请参见hi\_mpi\_vpc\_create\_chn处chn参数的取值范围。 |
| csc\_matrix | 输入 | 色域转换矩阵的数据标准。 |
| csc\_coefficient | 输入 | 色域转换矩阵参数值的指针。 如果将csc\_matrix参数设置为HI\_CSC\_MATRIX\_USER，则需要使用csc\_coefficient参数设置色域转换矩阵参数；否则，此处传任意值。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  公共返回码