acl.himpi.vpc_convert_color_to_yuv420

c函数原型

hi_s32 hi_mpi_vpc_convert_color_to_yuv420 (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_to_yuv420(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,用来区分任务。

使用说明

  • 输入图片格式支持:
    • YUV444 packed/YUV444 semi-planar/YVU444 semi-planar
    • YUV420 semi-planar/YVU420 semi-planar
    • YUV422 semi-planar/YVU422 semi-planar
    • YUYV422 packed/YVYU422 packed/UYVY422 packed/VYUY422 packed
    • RGB888/BGR888/ARGB8888/ABGR8888/RGBA8888/BRGA8888
    • YUV440 semi-planar/YVU440 semi-planar
  • 输出图片格式支持:
    • YUV420 semi-planar 8bit
    • YVU420 semi-planar 8bit
  • 输出图片的信息,仅需要指定图片的存放地址、大小。
  • 输出图片的宽、高、stride不允许改变。配置0即可。

注意事项

  • 接口是异步接口。
  • 用户必须保证输入的缓存区buffer足够存下色域转换之后的图片大小。例如,YUV420sp 1080P图片转成RGB之后图片会变大;
  • 目标图片的格式仅能够是YUV420SP,设置其他格式为无效,返回失败。
  • 此接口通过改变 milli_sec 值支持阻塞方式(-1)、非阻塞方式(0)、超时方式(>0)发送处理图像。

使用场景

兼容的输入格式包括:yuv420sp/yuv422sp/yuv444sp/yuv444packed,其它输入格式不能兼容,输出的二进制文件可能存在差异。