下载
中文
注册

acl.himpi.vpc_convert_color_v2

c函数原型

hi_s32 hi_mpi_vpc_convert_color_v2(hi_vpc_chn chn, const hi_vpc_pic_info *source_pic, hi_vpc_pic_info *dest_pic, hi_csc_conf *conf, hi_u32 *task_id, hi_s32 milli_sec)

Python函数

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

函数功能

转换图片的格式,在acl.himpi.vpc_convert_color接口的基础上扩展功能,支持设置RGBA格式图片的透明度。异步接口。

Atlas 200/300/500 推理产品,当前版本不支持该接口。

Atlas 训练系列产品,当前版本不支持该接口。

输入说明

chn:int,图片处理通道号。

  • Atlas 推理系列产品,该参数的取值范围:[0, 256),通道总数最多256。
  • Atlas A2训练系列产品/Atlas 800I A2推理产品,该参数的取值范围:[0, 256),通道总数最多256。
  • Atlas 200I/500 A2推理产品,该参数的取值范围:[0, 128),通道总数最多128。

source_pic:dict,原始图片信息,具体请参见hi_vpc_pic_info,相关约束请参见约束说明

dest_pic:dict,目标图片信息,具体请参见hi_vpc_pic_info

需指定输出图片的宽、高、宽Stride、高Stride、内存地址、内存大小、格式等。

  • 配置输出图片的宽、高时,需与输入图片的宽、高保持一致,否则会返回报错。

    如果将输出图片的宽或高配置为0,则VPC内部会将输入图片的宽、高分别作为输出图片的宽、高;同时,VPC内部会按对齐要求计算宽Stride、高Stride,不同图片格式的对齐要求不同,请参见图片格式、宽高对齐、内存约束

  • 配置输出图片的宽Stride、高Stride时,满足对齐要求即可,不同图片格式的对齐要求不同,请参见图片格式、宽高对齐、内存约束

conf:int,输出图片透明度值。

透明度只针对以下图像格式有效:

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

返回值说明

ret:int,错误码。

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

约束说明

版本

约束

Atlas 推理系列产品

  • 输入、输出图片分辨率:10 * 6 ~ 4096 * 4096(包括4096 * 4096)。
  • 输入图片格式、输出图片格式、宽高对齐约束、内存约束请参见图片格式、宽高对齐、内存约束。当输入格式是YUV400时,输出格式只能是YUV400。

Atlas 200I/500 A2推理产品

Atlas A2训练系列产品/Atlas 800I A2推理产品