下载
中文
注册

acl.himpi.sys_set_chn_csc_matrix

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)

函数功能

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

输入说明

  • 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,表示失败,参见公共返回码

约束说明

  • 如果不调用本接口设置色域转换参数,默认使用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(等待缩放任务结束)