d5b140e5创建于 2025年12月26日历史提交

aclmdlSetAIPPCropParams

产品支持情况

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√

功能说明

动态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