acl.himpi.vpc_convert_color

c函数原型

hi_s32 hi_mpi_vpc_convert_color (hi_vpc_chn chn, const hi_vpc_pic_info *source_pic, hi_vpc_pic_info *dest_pic, hi_u32 *task_id, hi_s32 milli_sec);

Python函数

task_id, ret = acl.himpi.vpc_convert_color(chn, source_pic, dest_pic, milli_sec)

函数功能

将source_pic图片的格式转换为dest_pic格式。

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

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

输入说明

chn:图片处理通道号,取值范围:[0, 255]。

source_pic:原始图片信息。输入分辨率为10*6~4096*4096(包括4096)。

dest_pic:目标图片信息。

milli_sec:超时时间配置,单位是毫秒,取值范围如下:
  • -1:阻塞方式
  • 0:非阻塞方式
  • >0:超时方式,配置具体的超时时间。超时时间受操作系统影响,一般偏差在操作系统的一个时间片内,例如,操作系统的一个时间片为4ms,用户设置的milli_sec参数值为1,则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下,超时时间仍可能存在波动。

返回值说明

ret

task_id:此次任务分配的ID,用来区分任务。

使用说明

  • 输出图片的信息,仅需要指定图片的存放地址、大小和存放格式即可。
  • 输出图片的宽、高、stride不允许改变。配置0即可。
  • 输入、输出图片的格式请参见VPC功能。当输入格式是YUV400时,输出格式只能是YUV400。

注意事项

  • 接口是异步接口
  • 配置输出格式为YUV420 NV12/NV21的图片与acl.himpi.vpc_convert_color_to_yuv420接口两者图片不一致。使用此接口进行色域转换与OpenCV保持一致。
  • 用户必须保证输入的缓存区buffer足够存下色域转换之后的图片大小。例如,YUV420sp 1080P图片转成RGB之后图片会变大。
  • 增采样算法默认采用双线性插值。

使用场景

改变输入图片的格式。