函数:dvpp_vpc_crop_async

C函数原型

aclError acldvppVpcCropAsync(acldvppChannelDesc *channelDesc, acldvppPicDesc *inputDesc, acldvppPicDesc *outputDesc, acldvppRoiConfig *cropArea, aclrtStream stream)

Python函数

ret = acl.media.dvpp_vpc_crop_async(dvpp_channel_desc, input_dvpp_pic_desc, output_dvpp_pic_desc, crop_area, stream)

函数功能

按指定区域从输入图片中抠图,再将抠的图片存放到输出内存中,作为输出图片,异步接口。

输出图片区域与crop_area不一致时会对图片再做一次缩放操作。

Atlas 200/500 A2推理产品,默认缩放算法为“业界通用的Bilinear算法”。

输入说明

dvpp_channel_desc:int,指定通道描述信息的指针地址,与调用acl.media.dvpp_create_channel接口创建通道时指定的dvpp_channel_desc保持一致。

input_dvpp_pic_desc:int,输入图片信息的指针地址。
  • 调用acl.media.dvpp_create_pic_desc接口创建图片描述信息。
  • 调用acl.media.dvpp_set_pic_desc系列接口设置图片描述参数(例如,图片格式、宽、高等)。

output_dvpp_pic_desc:int,输出图片信息的指针地址。

outputDesc参数作为输入时,需要用户调用如下接口:

  • 调用acl.media.dvpp_create_pic_desc接口创建图片描述信息。
  • 调用acl.media.dvpp_set_pic_desc系列接口设置图片描述参数(例如,内存地址、内存大小、图片格式、宽、高等)。

crop_area:int,抠图区域位置的指针地址。调用acl.media.dvpp_create_roi_config接口创建区域位置数据。

stream:int,指定Stream对象。

返回值说明

ret:int,错误码。

  • 返回0,表示任务下发成功。
  • 返回非0,表示任务下发失败。

约束说明

昇腾AI处理器

约束

Atlas 200/500 A2推理产品

  • 关于输入、输出图片分辨率:
    • 输入图片分辨率:10*6~16384*16384

      当输出图片宽度大于4096时,输入图片最小分辨率为128*16。

    • 输出图片分辨率:10*6~16384*16384
  • 关于图片格式、宽高对齐、内存等总体约束,请参见图片格式、宽高对齐、内存约束
  • 由于通过本接口抠的图直接作为输出图片,所以需满足输出图片最大分辨率4096*4096的限制,因此本接口中抠图区域最大分辨率为4096*4096。