sys_set_chn_csc_matrix

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 训练系列产品	x
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	x

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

C函数原型

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

python函数

ret = acl.himpi.sys_set_chn_csc_matrix(mode, chn, csc_matrix, csc_coefficient)

参数名	说明
mode	int，模块ID，当前只支持“HI_ID_VDEC”和“HI_ID_VPC”。
chn	int，通道号。当“mode”设置为“HI_ID_VDEC”时，通道号范围请参见vdec_create_chn处“chn”参数的取值范围。当“mode”设置为“HI_ID_VPC”时，通道号范围请参见vpc_create_chn处“chn”参数的取值范围。
csc_matrix	int，色域转换矩阵的数据标准，具体请参见hi_csc_matrix。
csc_coefficient	dict，色域转换矩阵参数值字典，具体请参见hi_csc_coefficient。如果将“csc_matrix”参数设置为“HI_CSC_MATRIX_USER”，则需要使用“csc_coefficient”参数设置色域转换矩阵参数，否则，此处传任意值。

返回值	说明
ret	int，错误码，返回0表示成功，返回其它值表示失败。

如果不调用本接口设置色域转换参数，默认使用BT601 wide标准的色域转换矩阵参数值。
如果默认的色域转换参数不适用，仅需修改一次，该通道内的其它任务都使用修改后的色域转换参数，则在创建对应图像或视频处理通道后，可调用本接口设置色域转换参数，再调用具体的图像或视频处理接口，然后再调用对应的图像或视频处理结果获取接口。
如果默认的色域转换参数不适用，不同任务使用不同的色域转换参数，需多次修改，则在创建对应图像或视频处理通道后，在上一次任务执行结束后、下一次任务执行前调用本接口设置色域转换参数（如果上一次任务没有执行结束，就再次调用本接口设置色域转换参数，可能会导致任务处理的结果不正确），再调用具体的图像或视频处理接口，然后再调用对应的图像或视频处理结果获取接口。
调用顺序示例如下：
1. acl.himpi.sys_set_chn_csc_matrix（第一次修改色域转换参数）
2. acl.himpi.vpc_crop（抠图）
3. acl.himpi.vpc_get_process_result（等待抠图任务结束）
4. acl.himpi.sys_set_chn_csc_matrix（第二次修改色域转换参数）
5. acl.himpi.vpc_resize（缩放）
6. acl.himpi.vpc_get_process_result（等待缩放任务结束）

父主题： 公共接口