---
title: aclmdlSetAIPPCropParams
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendgraphapi/aclcppdevg_03_1420.html
sourcePath: /source/zh/canncommercial/900/API/ascendgraphapi/aclcppdevg_03_1420.html
indexId: dddeaee1ba61b776bf6ff062a199941f7ad22d899b3334ea1b2b93bbc0075e8d72
---
# aclmdlSetAIPPCropParams

#### 产品支持情况

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


#### 功能说明

动态AIPP场景下，设置抠图相关的参数。


#### 函数原型

```
aclError aclmdlSetAIPPCropParams(aclmdlAIPP *aippParmsSet, int8_t cropSwitch,
int32_t cropStartPosW, int32_t cropStartPosH,
int32_t cropSizeW, int32_t cropSizeH,
uint64_t batchIndex)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| aippParmsSet | 输出 | 动态AIPP参数对象的指针。 需提前调用aclmdlCreateAIPP接口创建aclmdlAIPP类型的数据。 |
| cropSwitch | 输入 | 是否对图片执行抠图操作，取值范围： 0：不执行抠图操作，设置为0时，则设置cropStartPosW、cropStartPosH、cropSizeW、cropSizeH参数无效 1：执行抠图操作 |
| cropStartPosW | 输入 | 抠图时，坐标点起始位置在图中横向的坐标。 对于YUV420SP\_U8格式的图像，参数取值要求是偶数。 取值范围：[0,4095] |
| cropStartPosH | 输入 | 抠图时，坐标点起始位置在图中纵向的坐标。 对于YUV420SP\_U8格式的图像，参数取值要求是偶数。 取值范围：[0,4095] |
| cropSizeW | 输入 | 抠图区域的宽度。 取值范围：[1,4096] |
| cropSizeH | 输入 | 抠图区域的高度。 取值范围：[1,4096] |
| batchIndex | 输入 | 指定对第几个Batch上的图片执行抠图操作。 取值范围：[0,batchSize) batchSize是在调用aclmdlCreateAIPP接口创建aclmdlAIPP类型的数据时设置。 |


#### 返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。


#### 约束说明

若开启抠图功能，则通过aclmdlSetAIPPSrcImageSize接口设置的参数与通过aclmdlSetAIPPCropParams接口设置的参数之间必须满足以下公式：

- cropSizeW+cropStartPosW ≤ srcImageSizeW
- cropSizeH+cropStartPosH ≤ srcImageSizeH