acl.himpi.sys_set_chn_csc_matrix

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

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

设置通道的色域转换矩阵参数。

昇腾310 AI处理器，当前版本该接口预留。

昇腾910 AI处理器，当前版本该接口预留。

mode：模块ID，当前只支持HI_ID_VDEC和HI_ID_VPC。

chn：通道号。当mode设置为HI_ID_VDEC时，通道号范围请参见acl.himpi.vdec_create_chn处chn参数的取值范围；当mode设置为HI_ID_VPC时，通道号范围请参见acl.himpi.vpc_create_chn处chn参数的取值范围。

csc_matrix：色域转换矩阵的数据标准。

csc_coefficient：如果将csc_matrix参数设置为HI_CSC_MATRIX_USER，则需要使用csc_coefficient参数设置色域转换矩阵参数；否则，此处传任意值。

ret：int，错误码。

• 返回0表示成功。
• 返回非0表示失败。参见公共返回码

在处理图像或视频前，用户如果需要调整色域转换参数时，在创建对应图像或视频处理通道后，可调用该接口设置色域转换参数，再调用具体的图像或视频处理接口，然后再调用对应的图像或视频处理结果获取接口。

调用本接口设置色域转换参数时，需关注以下事项：

• 推荐的接口调用流程（以VPC缩放功能为例）：acl.himpi.vpc_create_chn--> acl.himpi.sys_set_chn_csc_matrix --> acl.himpi.vpc_resize --> acl.himpi.vpc_get_process_result--> acl.himpi.sys_set_chn_csc_matrix--> acl.himpi.vpc_resize--> acl.himpi.vpc_get_process_result
• 在图像或视频任务执行过程中，不支持调用本接口重复设置色域转换参数。

  以图像处理任务为例，如果在调用acl.himpi.vpc_get_process_result接口获取图片处理结果前，图片缩放任务还在执行过程中，就重复调用了两次acl.himpi.sys_set_chn_csc_matrix，这时图片缩放任务不确定使用哪一次设置的色域转换系数，这种情况会导致图片处理的结果可能不正确。

  错误的接口调用流程示例：acl.himpi.vpc_create_chn--> acl.himpi.sys_set_chn_csc_matrix --> acl.himpi.vpc_resize --> acl.himpi.sys_set_chn_csc_matrix--> acl.himpi.vpc_get_process_result

无

无