跳到主要内容

aclmdlSetAIPPAxSwapSwitch

aclmdlSetAIPPCscParams​

函数功能​

动态AIPP场景下，设置CSC色域转换相关的参数，若色域转换开关关闭，则调用该接口设置以下参数无效。同步接口。

YUV转BGR：
| B |   | cscMatrixR0C0 cscMatrixR0C1 cscMatrixR0C2 | | Y - cscInputBiasR0 |
| G | = | cscMatrixR1C0 cscMatrixR1C1 cscMatrixR1C2 | | U - cscInputBiasR1 | >> 8
| R |   | cscMatrixR2C0 cscMatrixR2C1 cscMatrixR2C2 | | V - cscInputBiasR2 |
BGR转YUV：
| Y |   | cscMatrixR0C0 cscMatrixR0C1 cscMatrixR0C2 | | B |        | cscOutputBiasR0 |
| U | = | cscMatrixR1C0 cscMatrixR1C1 cscMatrixR1C2 | | G | >> 8 + | cscOutputBiasR1 |
| V |   | cscMatrixR2C0 cscMatrixR2C1 cscMatrixR2C2 | | R |        | cscOutputBiasR2 |

色域转换参数值与转换前图片的格式、转换后图片的格式强相关，您可以参考《ATC工具使用指南》中的“色域转换配置说明”，根据转换前图片格式、转换后图片格式来配置色域转换参数。如果手册中列举的图片格式不满足要求，您需自行根据实际需求配置色域转换参数。

约束说明​

如果通过aclmdlSetAIPPInputFormat接口设置的原始图像格式为YUV400，则不支持通过本接口设置色域转换参数。

函数原型​

aclError aclmdlSetAIPPCscParams(****aclmdlAIPP *aippParmsSet, int8_t cscSwitch,

int16_t cscMatrixR0C0, int16_t cscMatrixR0C1, int16_t cscMatrixR0C2,

int16_t cscMatrixR1C0, int16_t cscMatrixR1C1,int16_t cscMatrixR1C2,

int16_t cscMatrixR2C0, int16_t cscMatrixR2C1, int16_t cscMatrixR2C2,

uint8_t cscOutputBiasR0, uint8_t cscOutputBiasR1, uint8_t cscOutputBiasR2,

uint8_t cscInputBiasR0, uint8_t cscInputBiasR1, uint8_t cscInputBiasR2)

参数说明​

参数名输入/输出说明
aippParmsSet输出动态AIPP参数对象的指针。 需提前调用aclmdlCreateAIPP接口创建aclmdlAIPP类型的数据。
csc_switch输入色域转换开关，取值范围：
- 0：关闭色域转换开关，设置为0时，则设置以下参数无效
- 1：打开色域转换开关
cscMatrixR0C0输入色域转换矩阵参数。 取值范围：[-32677 ,32676]
cscMatrixR0C1输入色域转换矩阵参数。 取值范围：[-32677 ,32676]
cscMatrixR0C2输入色域转换矩阵参数。 取值范围：[-32677 ,32676]
cscMatrixR1C0输入色域转换矩阵参数。 取值范围：[-32677 ,32676]
cscMatrixR1C1输入色域转换矩阵参数。 取值范围：[-32677 ,32676]
cscMatrixR1C2输入色域转换矩阵参数。 取值范围：[-32677 ,32676]
cscMatrixR2C0输入色域转换矩阵参数。 取值范围：[-32677 ,32676]
cscMatrixR2C1输入色域转换矩阵参数。 取值范围：[-32677 ,32676]
cscMatrixR2C2输入色域转换矩阵参数。 取值范围：[-32677 ,32676]
cscOutputBiasR0输入RGB转YUV时的输出偏移。 取值范围：[0, 255]
cscOutputBiasR1输入RGB转YUV时的输出偏移。 取值范围：[0, 255]
cscOutputBiasR2输入RGB转YUV时的输出偏移。 取值范围：[0, 255]
cscInputBiasR0输入YUV转RGB时的输入偏移。 取值范围：[0, 255]
cscInputBiasR1输入YUV转RGB时的输入偏移。 取值范围：[0, 255]
cscInputBiasR2输入YUV转RGB时的输入偏移。 取值范围：[0, 255]

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： aclmdlAIPP

aclmdlSetAIPPInputFormat​

函数功能​

动态AIPP场景下，必须设置原始输入图像的格式，同步接口。

函数原型​

aclError aclmdlSetAIPPInputFormat(aclmdlAIPP *aippParmsSet, aclAippInputFormat inputFormat)

参数说明​

参数名输入/输出说明
aippParmsSet输出动态AIPP参数对象的指针。 需提前调用aclmdlCreateAIPP接口创建aclmdlAIPP类型的数据。
inputFormat输入表示原始输入图像的格式。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： aclmdlAIPP

aclmdlSetAIPPRbuvSwapSwitch​

函数功能​

动态AIPP场景下，设置是否交换R通道与B通道、或者是否交换U通道与V通道，同步接口。

函数原型​

aclError aclmdlSetAIPPRbuvSwapSwitch(****aclmdlAIPP *aippParmsSet, int8_t rbuvSwapSwitch)

参数说明​

参数名输入/输出说明
aippParmsSet输出动态AIPP参数对象的指针。 需提前调用aclmdlCreateAIPP接口创建aclmdlAIPP类型的数据。
rbuvSwapSwitch输入表示是否交换R通道与B通道、或者是否交换U通道与V通道的开关，取值范围：
- 0：不交换
- 1：交换

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： aclmdlAIPP

aclmdlSetAIPPAxSwapSwitch​

函数功能​

动态AIPP场景下，设置RGBA->ARGB或者YUVA->AYUV的交换开关，同步接口。

函数原型​

aclError aclmdlSetAIPPAxSwapSwitch(****aclmdlAIPP *aippParmsSet, int8_t axSwapSwitch)

参数说明​

参数名输入/输出说明
aippParmsSet输出动态AIPP参数对象的指针。 需提前调用aclmdlCreateAIPP接口创建aclmdlAIPP类型的数据。
axSwapSwitch输入表示RGBA->ARGB或者YUVA->AYUV的交换开关，取值范围：
- 0：不交换
- 1：交换

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： aclmdlAIPP

aclmdlSetAIPPSrcImageSize​

函数功能​

动态AIPP场景下，必须设置原始图片的宽和高，同步接口。

函数原型​

aclError aclmdlSetAIPPSrcImageSize(****aclmdlAIPP *aippParmsSet, int32_t srcImageSizeW, int32_t srcImageSizeH)

参数说明​

参数名输入/输出说明
aippParmsSet输出动态AIPP参数对象的指针。 需提前调用aclmdlCreateAIPP接口创建aclmdlAIPP类型的数据。
srcImageSizeW输入原始图片的宽，对于YUV420SP_U8或YUV422SP_U8或YUYV_U8类型的图像，要求srcImageSizeW取值是偶数。 取值范围： [2,4096]
srcImageSizeH输入原始图片的高，对于YUV420SP_U8类型的图像，要求srcImageSizeH取值是偶数。 取值范围： [1,4096]

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： aclmdlAIPP

aclmdlSetAIPPScfParams​

函数功能​

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

Atlas 200/500 A2推理产品，不支持该接口。

函数原型​

aclError aclmdlSetAIPPScfParams(****aclmdlAIPP *aippParmsSet, int8_t scfSwitch,

int32_t scfInputSizeW, int32_t scfInputSizeH,

int32_t scfOutputSizeW, int32_t scfOutputSizeH,

uint64_t batchIndex)

约束说明​

缩放比例scfOutputSizeW/scfInputSizeW∈[1/16,16]、scfOutputSizeH/scfInputSizeH∈[1/16,16]。

参数说明​

参数名输入/输出说明
aippParmsSet输出动态AIPP参数对象的指针。 需提前调用aclmdlCreateAIPP接口创建aclmdlAIPP类型的数据。
scfSwitch输入是否对图片执行缩放操作，取值范围：
- 0：不执行缩放操作，设置为0时，则设置scfInputSizeW、scfInputSizeH、scfOutputSizeW、scfOutputSizeH参数无效
- 1：执行缩放操作
scfInputSizeW输入缩放前图片的宽。 取值范围：[16,4096] 若开启了抠图功能，则缩放前图片的宽与抠图区域的宽度保持一致；若未开启抠图功能，则缩放前图片的宽与原始图片的宽保持一致。
scfInputSizeH输入缩放前图片的高。 取值范围：[16,4096] 若开启了抠图功能，则缩放前图片的高与抠图区域的高度保持一致；若未开启抠图功能，则缩放前图片的高与原始图片的高保持一致。
scfOutputSizeW输入缩放后图片的宽。 取值范围：[16,1920]
scfOutputSizeH输入缩放后图片的高。 取值范围：[16,4096]
batchIndex输入指定对第几个Batch上的图片执行缩放操作。 取值范围：[0,batchSize) batchSize是在调用aclmdlCreateAIPP接口创建aclmdlAIPP类型的数据时设置。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： aclmdlAIPP

aclmdlSetAIPPCropParams​

函数功能​

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

函数原型​

aclError aclmdlSetAIPPCropParams(****aclmdlAIPP *aippParmsSet, int8_t cropSwitch,

int32_t cropStartPosW, int32_t cropStartPosH,

int32_t cropSizeW, int32_t cropSizeH,

uint64_t batchIndex)

约束说明​

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

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

参数说明​

参数名输入/输出说明
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表示成功，返回其它值表示失败。

父主题： aclmdlAIPP

在线提单