acldvppVpcBatchCropAndPasteAsync

函数功能

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

当pasteArea的宽高与cropArea的宽高不一致时会对图片做一次缩放操作。

默认缩放算法为“业界通用的Bilinear算法”。

约束说明

昇腾AI处理器	约束
Atlas 200/500 A2推理产品	关于图片分辨率、图片格式、宽高对齐、内存等总体约束，请参见图片格式、宽高对齐、内存约束。由于YUV格式图像下采样约束，当输出图片格式为YUV420SP或YUV422SP格式时，贴图的顶部偏移、左侧偏移建议为偶数。

函数原型

aclError acldvppVpcBatchCropAndPasteAsync (acldvppChannelDesc *channelDesc,

acldvppBatchPicDesc *srcBatchPicDescs,

uint32_t *roiNums,

uint32_t size,

acldvppBatchPicDesc *dstBatchPicDescs,

acldvppRoiConfig *cropAreas[],

acldvppRoiConfig *pasteAreas[],

aclrtStream stream)

参数说明

参数名	输入/输出	说明
channelDesc	输入	通道描述信息的指针。与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。
srcBatchPicDescs	输入	指定批量输入图片描述信息的指针。调用acldvppCreateBatchPicDesc接口创建批量图片描述信息。调用acldvppGetPicDesc接口获取指定图片的图片描述信息。调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。
roiNums	输入	每个输入图片抠图数量的指针，当前最大抠图数量为256。 roiNums为数组，数组总和小于等于256，与dstBatchPicDescs结构体中的batchSize值保持一致。 roiNums[0]+...+roiNums[size-1] <= 256
size	输入	表示roiNums数组中的元素个数，个数小于等于256。
dstBatchPicDescs	输入&输出	批量输出图片描述信息的指针。 dstBatchPicDescs参数作为输入时，需要用户调用如下接口：调用acldvppCreateBatchPicDesc接口创建批量图片描述信息。调用acldvppGetPicDesc接口获取指定图片的图片描述信息。调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。
cropAreas	输入	抠图区域位置的指针数组。调用acldvppCreateRoiConfig接口创建区域位置数据。 cropAreas、pasteAreas数组中的元素个数与dstBatchPicDescs结构体中的batchSize值相等。
pasteAreas	输入	贴图区域位置的指针数组。调用acldvppCreateRoiConfig接口创建区域位置数据。贴图区域左偏移需要16对齐。 cropAreas、pasteAreas数组中的元素个数与dstBatchPicDescs参数中的batchSize值相等。
stream	输入	指定Stream。

返回值说明

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

参考资源

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

父主题： VPC功能