昇腾社区首页
中文
注册

hi_mpi_vpc_crop_resize_resize_paste

产品支持情况

产品

是否支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品

x

Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

x

Atlas 200I/500 A2 推理产品

x

Atlas 推理系列产品

Atlas 训练系列产品

x

Atlas 200/300/500 推理产品

x

功能说明

从输入图片中抠图,对抠出的子图进行两次缩放后,贴在用户输出图片的指定区域。异步接口。

函数原型

hi_s32 hi_mpi_vpc_crop_resize_resize_paste(hi_vpc_chn chn, const hi_vpc_pic_info *source_pic, hi_vpc_crop_resize_resize_paste_region crop_resize_resize_paste_info[], hi_u32 count, hi_u32 *task_id, hi_s32 milli_sec)

参数说明

参数名

输入/输出

说明

chn

输入

图片处理通道号。

Atlas 推理系列产品,该参数的取值范围:[0, 256),通道总数最多256。

source_pic

输入

原始图片信息的指针。

输入图片分辨率在10*6~4096*4096(包括4096)范围内时,支持图片格式、宽高对齐、内存约束处说明的输入图片格式。

crop_resize_resize_paste_info

输入

抠图缩放并贴图的图片信息数组,该数组长度与count参数值保持一致。

count

输入

抠图缩放贴图的图片数量,取值范围[1,256]。

task_id

输出

任务ID的指针,用来区分任务。

milli_sec

输入

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

返回值说明

约束说明

  • 输出图片的数量最多等于抠图区域的数量,最少是一张图片。也就是说,如果从输入图片中抠n张子图,那么贴图的目标图片可以是同一张大图,也可以是多张大图。取决于hi_vpc_crop_resize_resize_paste_region结构体中指定的地址。
  • 当输入、输出图片格式都为ARGB8888、ABGR8888、RGBA8888、BGRA8888格式时,在经过本接口缩放处理后,A分量值会变为0。
  • 每次缩放后的图片的分辨率必须在[10*6, 4096*4096]范围内、宽高缩放比例在[1/32, 32]范围内。
  • 两次缩放配置的缩放算法需保持一致。
  • VPC功能的约束请参见约束说明
  • 由于YUV格式图像下采样约束,当输出图片格式为YUV420SP或YUV422SP格式时,贴图的顶部偏移、左侧偏移建议为偶数。