昇腾社区首页
中文
注册

函数:set_aipp_crop_params

产品支持情况

产品

是否支持

Atlas A3 训练系列产品 / Atlas A3 推理系列产品

Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件

Atlas 训练系列产品

Atlas 推理系列产品

Atlas 200I/500 A2 推理产品

Atlas 200/300/500 推理产品

功能说明

动态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表示成功。
  • 返回其它值表示失败。

约束说明

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

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