函数：dvpp_vpc_batch_crop_and_paste_async

产品支持情况

产品	是否支持
Atlas 350 加速卡	x
Atlas A3 训练系列产品 / Atlas A3 推理系列产品	√
Atlas A2 训练系列产品 / Atlas A2 推理系列产品	√
Atlas 训练系列产品	√
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√

功能说明

按指定区域从一张或多张输入图片中抠出一个或多个子图，再将抠的子图贴到目标图片的指定位置，作为输出图片。异步接口。

函数原型

C函数原型

        
             aclError acldvppVpcBatchCropAndPasteAsync(acldvppChannelDesc *channelDesc, acldvppBatchPicDesc *srcBatchPicDesc, uint32_t *roiNums, uint32_t size, acldvppBatchPicDesc *dstBatchPicDesc, acldvppRoiConfig *cropAreas[], acldvppRoiConfig *pasteAreas[], aclrtStream stream)

python函数

        
             dst_batch_pic_descs, ret = acl.media.dvpp_vpc_batch_crop_and_paste_async(dvpp_channel_desc, src_batch_pic_descs, roi_nums_list, dst_batch_pic_descs, crop_area_list，paste_area_list, stream)

参数说明

参数名	说明
dvpp_channel_desc	int，指定通道描述信息的指针地址，与调用acl.media.dvpp_create_channel接口创建通道时指定的“dvpp_channel_desc”保持一致。
src_batch_pic_descs	int，指定批量输入图片描述信息的指针地址。调用acl.media.dvpp_create_batch_pic_desc接口创建批量图片描述信息。调用acl.media.dvpp_get_pic_desc接口获取指定图片的图片描述信息。调用acl.media.dvpp_set_pic_desc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。
roi_nums_list	list，表示抠图的数量的列表，当前最大抠图数量为256。 “roi_nums_list”总和小于等于256，与“dst_batch_pic_descs”中的“batch_size”值保持一致。（roi_nums_list[0] + ... + roi_nums_list[size - 1] <= 256）
dst_batch_pic_descs	int，指定批量输出图片描述信息的指针地址。调用acl.media.dvpp_create_batch_pic_desc接口创建批量图片描述信息。调用acl.media.dvpp_get_pic_desc接口获取指定图片的图片描述信息。调用acl.media.dvpp_set_pic_desc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。
crop_area_list	list，抠图区域位置列表。调用acl.media.dvpp_create_roi_config接口创建区域位置数据。 “crop_area”、“paste_area”中元素个数与“dst_batch_pic_descs”中的“batch_size”值相等。
paste_area_list	list，贴图区域位置列表。调用acl.media.dvpp_create_roi_config接口创建区域位置数据。贴图区域左偏移需要16对齐。 “crop_area”、“paste_area”中元素个数与“dst_batch_pic_descs”中的“batch_size”值相等。
stream	int，指定Stream对象。

返回值说明

返回值	说明
dst_batch_pic_descs	int，批量输出图片描述信息的指针地址。
ret	int，错误码，返回0表示成功，返回其它值表示失败。

资源参考

接口调用示例，参见抠图贴图（一图一框）示例代码。

父主题： VPC功能