---
title: acldvppVpcCropResizeAsync
description: "按指定区域从一张输入图片中抠出一张子图，再将抠的图片存放到输出内存中，作为输出图片，异步接口。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_0677.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_0677.html
indexId: 0106021fcf756dee7986b573509b4200b7665742addf0984c01f8ec0662b9907105
---
# acldvppVpcCropResizeAsync

#### 函数功能

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

输出图片区域与cropArea不一致时会对图片再做一次缩放操作，按照resizeConfig处配置的缩放算法。


#### 约束说明

| 版本 | 约束 |
| --- | --- |
| Atlas 200/500 A2推理产品 | 关于输入、输出图片分辨率： 输入图片分辨率：10\*6~8192\*8192 输出图片分辨率：10\*6~4096\*8192 关于图片格式、宽高对齐、内存等总体约束，请参见图片格式、宽高对齐、内存约束。 当输入、输出图片格式都为ARGB8888、ABGR8888、RGBA8888、BGRA8888格式时，在经过本接口缩放处理后，A分量值会变为0。 |


#### 函数原型

aclError acldvppVpcCropResizeAsync(acldvppChannelDesc *channelDesc,

acldvppPicDesc *inputDesc,

acldvppPicDesc *outputDesc,

acldvppRoiConfig *cropArea,

acldvppResizeConfig *resizeConfig,

aclrtStream stream)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| channelDesc | 输入 | 通道描述信息的指针。 与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。 |
| inputDesc | 输入 | 输入图片信息的指针。 调用acldvppCreatePicDesc接口创建图片描述信息。 调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。 |
| outputDesc | 输入&输出 | 输出图片信息的指针。 outputDesc参数作为输入时，需要用户调用如下接口： 调用acldvppCreatePicDesc接口创建图片描述信息。 调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。 |
| cropArea | 输入 | 抠图区域位置的指针。 调用acldvppCreateRoiConfig接口创建区域位置数据。 |
| resizeConfig | 输入 | 图片缩放配置数据的指针。 需提前调用acldvppCreateResizeConfig接口创建图片缩放配置数据。 |
| stream | 输入 | 指定Stream。 |


#### 返回值说明

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


#### 参考资源

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