acldvppVpcCropAndPasteAsync
acldvppVpcBatchCropAsync
函数功能
对于一张或多张输入图片，支持从每个输入图片中抠出一张或多张子图并一一对应存放到多个输出区域，输出图片区域与抠图区域不一致时会对图片再做一次缩放操作。异步接口。
Atlas 200/500 A2推理产品，默认缩放算法为“业界通用的Bilinear算法”。
约束说明
| 版本 | 约束 |
|---|---|
| Atlas 200/500 A2推理产品 | - 关于输入、输出图片分辨率： - 输入图片分辨率：10*6 - 输出图片分辨率：10*6 - 关于图片格式、宽高对齐、内存等总体约束，请参见图片格式、宽高对齐、内存约束。 |
函数原型
aclError acldvppVpcBatchCropAsync(acldvppChannelDesc *channelDesc,
acldvppBatchPicDesc *srcBatchPicDescs,
uint32_t *roiNums,
uint32_t size,
acldvppBatchPicDesc *dstBatchPicDescs,
acldvppRoiConfig *cropAreas[],
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接口创建区域位置数据。 |
| stream | 输入 | 指定Stream。 |
返回值说明
返回0表示任务下发成功，返回非0表示任务下发失败。
父主题： VPC功能
acldvppVpcBatchCropResizeAsync
函数功能
对于一张或多张输入图片，支持从每个输入图片中抠出一张或多张子图并一一对应存放到多个输出区域，输出图片区域与抠图区域不一致时会对图片再做一次缩放操作，按照resizeConfig处配置的缩放算法。异步接口。
约束说明
| 版本 | 约束 |
|---|---|
| Atlas 200/500 A2推理产品 | - 关于输入、输出图片分辨率： - 输入图片分辨率：10*6 - 输出图片分辨率：10*6 - 关于图片格式、宽高对齐、内存等总体约束，请参见图片格式、宽高对齐、内存约束。 - 当输入、输出图片格式都为ARGB8888、ABGR8888、RGBA8888、BGRA8888格式时，在经过本接口缩放处理后，A分量值会变为0。 |
函数原型
aclError acldvppVpcBatchCropResizeAsync(****acldvppChannelDesc *channelDesc,
acldvppBatchPicDesc *srcBatchPicDescs,
uint32_t *roiNums,
uint32_t size,
acldvppBatchPicDesc *dstBatchPicDescs,
acldvppRoiConfig *cropAreas[],
acldvppResizeConfig *resizeConfig,
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接口创建区域位置数据。 |
| resizeConfig | 输入 | 图片缩放配置数据的指针。 需提前调用acldvppCreateResizeConfig接口创建图片缩放配置数据。 |
| stream | 输入 | 指定Stream。 |
返回值说明
返回0表示任务下发成功，返回非0表示任务下发失败。
父主题： VPC功能
acldvppVpcCropAndPasteAsync
函数功能
按指定区域从一个输入图片中抠出一张子图，再将抠的子图贴到目标图片的指定位置，作为输出图片。异步接口。
当pasteArea的宽高与cropArea的宽高不一致时会对图片做一次缩放操作。
Atlas 200/500 A2推理产品，默认缩放算法为“业界通用的Bilinear算法”。
约束说明
| 版本 | 约束 |
|---|---|
| Atlas 200/500 A2推理产品 | - 关于图片分辨率、图片格式、宽高对齐、内存等总体约束，请参见图片格式、宽高对齐、内存约束。 - 由于YUV格式图像下采样约束，当输出图片格式为YUV420SP或YUV422SP格式时，贴图的顶部偏移、左侧偏移建议为偶数。 |
函数原型
aclError acldvppVpcCropAndPasteAsync(acldvppChannelDesc *channelDesc,
acldvppPicDesc *inputDesc,
acldvppPicDesc *outputDesc,
acldvppRoiConfig *cropArea,
acldvppRoiConfig *pasteArea,
aclrtStream stream)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| channelDesc | 输入 | 通道描述信息的指针。 与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。 |
| inputDesc | 输入 | 输入图片信息的指针。 - 调用acldvppCreatePicDesc接口创建图片描述信息。 - 调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。 |
| outputDesc | 输入&输出 | 输出图片信息的指针。 outputDesc参数作为输入时，需要用户调用如下接口： - 调用acldvppCreatePicDesc接口创建图片描述信息。 - 调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。 |
| cropArea | 输入 | 抠图区域位置的指针。 调用acldvppCreateRoiConfig接口创建区域位置数据。 |
| pasteArea | 输入 | 贴图区域位置的指针。 - 调用acldvppCreateRoiConfig接口创建区域位置数据。 - 贴图区域左偏移需要16对齐。 |
| stream | 输入 | 指定Stream。 |
返回值说明
返回0表示任务下发成功，返回非0表示任务下发失败。
父主题： VPC功能
acldvppVpcCropResizePasteAsync
函数功能
按指定区域从一个输入图片中抠出一张子图，再将抠的子图贴到目标图片的指定位置，作为输出图片。异步接口。
当pasteArea的宽高与cropArea的宽高不一致时会对图片做一次缩放操作，按照resizeConfig处配置的缩放算法。
约束说明
| 版本 | 约束 |
|---|---|
| Atlas 200/500 A2推理产品 | - 关于图片分辨率、图片格式、宽高对齐、内存等总体约束，请参见图片格式、宽高对齐、内存约束。 - 由于YUV格式图像下采样约束，当输出图片格式为YUV420SP或YUV422SP格式时，贴图的顶部偏移、左侧偏移建议为偶数。 - 当输入、输出图片格式都为ARGB8888、ABGR8888、RGBA8888、BGRA8888格式时，在经过本接口缩放处理后，A分量值会变为0。 |
函数原型
aclError acldvppVpcCropResizePasteAsync(****acldvppChannelDesc *channelDesc,
acldvppPicDesc *inputDesc,
acldvppPicDesc *outputDesc,
acldvppRoiConfig *cropArea,
acldvppRoiConfig *pasteArea,
acldvppResizeConfig *resizeConfig,
aclrtStream stream)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| channelDesc | 输入 | 通道描述信息的指针。 与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。 |
| inputDesc | 输入 | 输入图片信息的指针。 - 调用acldvppCreatePicDesc接口创建图片描述信息。 - 调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。 |
| outputDesc | 输入&输出 | 输出图片信息的指针。 outputDesc参数作为输入时，需要用户调用如下接口： - 调用acldvppCreatePicDesc接口创建图片描述信息。 - 调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。 |
| cropArea | 输入 | 抠图区域位置的指针。 调用acldvppCreateRoiConfig接口创建区域位置数据。 |
| pasteArea | 输入 | 贴图区域位置的指针。 - 调用acldvppCreateRoiConfig接口创建区域位置数据。 - 贴图区域左偏移需要16对齐。 |
| resizeConfig | 输入 | 图片缩放配置数据的指针。 需提前调用acldvppCreateResizeConfig接口创建图片缩放配置数据。 |
| stream | 输入 | 指定Stream。 |
返回值说明
返回0表示任务下发成功，返回非0表示任务下发失败。
参考资源
接口调用示例，参见抠图缩放（一图一框）示例代码。
父主题： VPC功能
acldvppVpcBatchCropAndPasteAsync
函数功能
按指定区域从一张或多张输入图片中抠出一个或多个子图，再将抠的子图贴到目标图片的指定位置，作为输出图片。异步接口。
当pasteArea的宽高与cropArea的宽高不一致时会对图片做一次缩放操作。
Atlas 200/500 A2推理产品，默认缩放算法为“业界通用的Bilinear算法”。
约束说明
| 版本 | 约束 |
|---|---|
| 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功能
acldvppVpcBatchCropResizePasteAsync
函数功能
按指定区域从一张或多张输入图片中抠出一个或多个子图，再将抠的子图贴到目标图片的指定位置，作为输出图片。异步接口。
当pasteArea的宽高与cropArea的宽高不一致时会对图片做一次缩放操作，按照resizeConfig处配置的缩放算法。
约束说明
| 版本 | 约束 |
|---|---|
| Atlas 200/500 A2推理产品 | - 关于图片分辨率、图片格式、宽高对齐、内存等总体约束，请参见图片格式、宽高对齐、内存约束。 - 由于YUV格式图像下采样约束，当输出图片格式为YUV420SP或YUV422SP格式时，贴图的顶部偏移、左侧偏移建议为偶数。 - 当输入、输出图片格式都为ARGB8888、ABGR8888、RGBA8888、BGRA8888格式时，在经过本接口缩放处理后，A分量值会变为0。 |
函数原型
aclError acldvppVpcBatchCropResizePasteAsync(****acldvppChannelDesc *channelDesc,
acldvppBatchPicDesc *srcBatchPicDescs,
uint32_t *roiNums,
uint32_t size,
acldvppBatchPicDesc *dstBatchPicDescs,
acldvppRoiConfig *cropAreas[],
acldvppRoiConfig *pasteAreas[],
acldvppResizeConfig *resizeConfig,
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值相等。 |
| resizeConfig | 输入 | 图片缩放配置数据的指针。 需提前调用acldvppCreateResizeConfig接口创建图片缩放配置数据。 |
| stream | 输入 | 指定Stream。 |
返回值说明
返回0表示任务下发成功，返回非0表示任务下发失败。
父主题： VPC功能
在线提单