---
title: 函数：set_aipp_crop_params
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendgraphapi/aclpythondevg_01_0178.html
sourcePath: /source/zh/canncommercial/900/API/ascendgraphapi/aclpythondevg_01_0178.html
indexId: 5859a28e87d28cb26a7bb7a0306b2b84bb94563ca85827992afd2c98ec72f6a675
---
# 函数：set_aipp_crop_params

#### 产品支持情况

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


#### 功能说明

动态AIPP场景下，设置缩放相关的参数。


#### 函数原型

- C函数原型
  1 aclError aclmdlSetAIPPCropParams(aclmdlAIPP *aippParmsSet, int8_t cropSwitch,int32_t cropStartPosW, int32_t cropStartPosH, int32_t cropSizeW, int32_t cropSizeH,uint64_t batchIndex)

- python函数
  1 ret = acl.mdl.set_aipp_crop_params(aipp_parms_set, crop_switch, crop_start_pos_w, crop_start_pos_h, crop_size_w, crop_size_h, batch_index)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| aipp\_parms\_set | int，动态AIPP参数对象的指针地址，需提前调用acl.mdl.create\_aipp接口创建aclmdlAIPP类型的数据。 |
| crop\_switch | int，是否对图片执行抠图操作。取值范围： 0：不执行抠图操作，设置为0时，则设置cropStartPosW、cropStartPosH、cropSizeW、cropSizeH参数无效。 1：执行抠图操作。 |
| crop\_start\_pos\_w | int，抠图时，坐标点起始位置在图中横向的坐标。对于YUV420SP\_U8格式的图像，参数取值要求是偶数，取值范围：[0, 4095]。 |
| crop\_start\_pos\_h | int，抠图时，坐标点起始位置在图中纵向的坐标。对于YUV420SP\_U8格式的图像，参数取值要求是偶数，取值范围：[0, 4095]。 |
| crop\_size\_w | int，抠图区域的宽度。取值范围：[1, 4096]。 |
| crop\_size\_h | int，抠图区域的高度。取值范围：[1, 4096]。 |
| batch\_index | int，指定对第几个Batch上的图片执行抠图操作，默认为0，取值范围：[0, batch\_size)，batch\_size是在调用acl.mdl.create\_aipp接口创建aclmdlAIPP类型的数据时设置。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| ret | int，错误码 返回0表示成功。 返回其它值(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclpythondevg\_01\_0911.html)表示失败。 |


#### 约束说明

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

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