---
title: 函数：dvpp_vpc_crop_and_paste_async
description: "| C函数原型 | aclError acldvppVpcCropAndPasteAsync(acldvppChannelDesc \*channelDesc, acldvppPicDesc \*inputDesc, acldvppPicDesc \*outputDesc, acldvppRoiConfig \*cropArea, acldvppRoiConfig \*pasteArea, aclrtStream stream) |"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgp/aclpythondevg_01_0290.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgp/aclpythondevg_01_0290.html
indexId: 9624c26368cfd882182e0885f70765485fee5494f38579eb3fcfa1d79d2c82f2108
---
# 函数：dvpp_vpc_crop_and_paste_async

| C函数原型 | aclError acldvppVpcCropAndPasteAsync(acldvppChannelDesc \*channelDesc, acldvppPicDesc \*inputDesc, acldvppPicDesc \*outputDesc, acldvppRoiConfig \*cropArea, acldvppRoiConfig \*pasteArea, aclrtStream stream) |
| --- | --- |
| Python函数 | ret = acl.media.dvpp\_vpc\_crop\_and\_paste\_async(dvpp\_channel\_desc, input\_dvpp\_pic\_desc, output\_dvpp\_pic\_desc, crop\_area, paste\_area, stream) |
| 函数功能 | 按指定区域从一个输入图片中抠出一张子图，再将抠的子图贴到目标图片的指定位置，作为输出图片。异步接口。 当paste\_area的宽高与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，输出图片信息。 调用acl.media.dvpp\_create\_pic\_desc接口创建图片描述信息。 调用acl.media.dvpp\_set\_pic\_desc系列接口设置图片描述参数（例如，图片格式、宽、高等）。 crop\_area：int，抠图区域位置。 调用acl.media.dvpp\_create\_roi\_config接口创建区域位置数据。 paste\_area：int，贴图区域位置。 调用acl.media.dvpp\_create\_roi\_config接口创建区域位置数据。 贴图区域左偏移需要16对齐。 stream：int，指定Stream对象的。 |
| 返回值说明 | ret：int，错误码。 返回0，表示任务下发成功。 返回非0，表示任务下发失败。 |


#### 约束说明

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