aclmdlAIPP

aclError aclmdlSetAIPPInputFormat(aclmdlAIPP *aippParmsSet, AippInputFormat inputFormat)

ret = acl.mdl.set_aipp_input_format(aipp_parms_set, input_format)

Sets the input format of the source image in dynamic AIPP scenarios. It is a synchronous interface.

aipp_parms_set: int, pointer to the dynamic AIPP parameter object.

acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

input_format: int, format of the original input image.

Values:

• 1: ACL_YUV420SP_U8
• 2: ACL_XRGB8888_U8
• 3: ACL_RGB888_U8
• 4: ACL_YUV400_U8

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None

aclError aclmdlSetAIPPCscParams(aclmdlAIPP *aippParmsSet, int8_t csc_switch,

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)

ret = acl.mdl.set_aipp_csc_params(aipp_parms_set, csc_switch, csc_matrix_R0C0, csc_matrix_R0C1, csc_matrix_R0C2,csc_matrix_R1C0, csc_matrix_R1C1, csc_matrix_R1C2, csc_matrix_R2C0, csc_matrix_R2C1, csc_matrix_R2C2, csc_output_bias_R0, csc_output_bias_R1, csc_output_bias_R2, csc_input_bias_R0, csc_input_bias_R1, csc_input_bias_R2)

Sets CSC parameters in dynamic AIPP scenarios. If the CSC switch is disabled, parameters set by calling this interface are invalid. It is a synchronous interface.

• YUV2BGR conversion:

  | B | | csc_matrix_R0C0 csc_matrix_R0C1 csc_matrix_R0C2 | | Y - csc_input_bias_R0 |

  | G | = | csc_matrix_R1C0 csc_matrix_R1C1 csc_matrix_R1C2 | | U - csc_input_bias_R1 | >> 8

  | R | | csc_matrix_R2C0 csc_matrix_R2C1 csc_matrix_R2C2 | | V - csc_input_bias_R2 |

• BGR2YUV conversion:

  | Y | | csc_matrix_R0C0 csc_matrix_R0C1 csc_matrix_R0C2 | | B | | csc_output_bias_R0 |

  | U | = | csc_matrix_R1C0 csc_matrix_R1C1 csc_matrix_R1C2 | | G | >> 8 + | csc_output_bias_R1 |

  | V | | csc_matrix_R2C0 csc_matrix_R2C1 csc_matrix_R2C2 | | R | | csc_output_bias_R2 |

CSC parameters are closely related to the formats of the source and destination images. You can refer to the CSC configuration description in ATC Tool Instructions for CSC parameter settings. Configure CSC parameters as required if the listed image formats do not meet your requirements.

aipp_parms_set: int, pointer to the dynamic AIPP parameter object.

acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

csc_matrix_R0C0: int, CSC matrix parameter.

• Value range: [–32677, +32676]

csc_matrix_R0C1: int, CSC matrix parameter.

• Value range: [–32677, +32676]

csc_matrix_R0C2: int, CSC matrix parameter.

• Value range: [–32677, +32676]

csc_matrix_R1C0: int, CSC matrix parameter.

• Value range: [–32677, +32676]

csc_matrix_R1C1: int, CSC matrix parameter.

• Value range: [–32677, +32676]

csc_matrix_R1C2: int, CSC matrix parameter.

• Value range: [–32677, +32676]

csc_matrix_R2C0: int, CSC matrix parameter.

• Value range: [–32677, +32676]

csc_matrix_R2C1: int, CSC matrix parameter.

• Value range: [–32677, +32676]

csc_matrix_R2C2: int, CSC matrix parameter.

• Value range: [–32677, +32676]

csc_output_bias_R0: int, output bias during RGB2YUV conversion. The default value is 0.

• Value range: [0, 255]

csc_output_bias_R1: int, output bias during RGB2YUV conversion. The default value is 0.

• Value range: [0, 255]

csc_output_bias_R2: int, output bias during RGB2YUV conversion. The default value is 0.

• Value range: [0, 255]

csc_input_bias_R0: int, input bias during YUV2RGB conversion. The default value is 0.

• Value range: [0, 255]

csc_input_bias_R1: int, input bias during YUV2RGB conversion. The default value is 0.

• Value range: [0, 255]

csc_input_bias_R2: int, input bias during YUV2RGB conversion. The default value is 0.

• Value range: [0, 255]

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None

aclError aclmdlSetAIPPRbuvSwapSwitch(aclmdlAIPP *aippParmsSet, int8_t rbuvSwapSwitch)

ret = acl.mdl.set_aipp_rbuv_swap_switch(aipp_parms_set, rbuv_swap_switch)

Sets the RB or UV channel swap switch before CSC in dynamic AIPP scenarios. It is a synchronous interface.

aipp_parms_set: int, pointer to the dynamic AIPP parameter object.

• acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

rbuv_swap_switch: int, RB or UV channel swap switch. Values:

• 0 (default): disabled
• 1: enabled

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None

aclError aclmdlSetAIPPAxSwapSwitch(aclmdlAIPP *aippParmsSet, int8_t axSwapSwitch)

ret = acl.mdl.set_aipp_ax_swap_switch(aipp_parms_set, ax_swap_switch)

Sets the RB or UV channel swap switch before CSC in dynamic AIPP scenarios. It is a synchronous interface.

aipp_parms_set: int, pointer to the dynamic AIPP parameter object.

• acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

ax_swap_switch: int, GBA->ARGB or YUVA->AYUV switch. Values:

• 0 (default): disabled
• 1: enabled

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None

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

ret = acl.mdl.set_aipp_src_image_size(aipp_parms_set, src_image_size_w, src_image_size_h)

Sets the size of the source image in dynamic AIPP scenarios. It is a synchronous interface.

aipp_parms_set: int, dynamic AIPP parameter object.

• acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

src_image_size_w: int, source image width. For the YUV420SP_U8 format, the value must be an even number.

• Value range: [1, 4096]

src_image_size_h: int, source image height. For the YUV420SP_U8 format, the value must be an even number.

• Value range: [1, 4096]

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None

aclError aclmdlSetAIPPScfParams(aclmdlAIPP *aippParmsSet, int8_t scfSwitch, int32_t scfInputSizeW, int32_t scfInputSizeH, int32_t scfOutputSizeW, int32_t scfOutputSizeH, uint64_t batchIndex)

ret = acl.mdl.set_aipp_scf_params(aipp_parms_set, scf_switch, scf_input_size_w, scf_input_size_h, scf_output_size_w, scf_output_size_h, batch_index)

Sets resizing parameters in dynamic AIPP scenarios. It is a synchronous interface. This reserved interface is not supported currently.

aipp_parms_set: int, dynamic AIPP parameter object.

• acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

scf_switch: int, whether to zoom in or out the image. Values:

• 0 (default): disabled
• 1: enabled

scf_input_size_w: int, source image width.

• Value range: [0, 4096]

scf_input_size_h: int, source image height.

• Value range: [0, 4096]

scf_output_size_w: int, destination image width.

• Value range: [0, 4096]

scf_output_size_h: int, destination image height.

• Value range: [0, 4096]

batch_index: int, index of batch for image resizing. The default value is 0.

• The value range is [0, batch_size). batch_size is set when acl.mdl.create_aipp is called to create data of the aclmdlAIPP type.

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None

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

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)

Sets cropping parameters in dynamic AIPP scenarios. It is a synchronous interface.

aipp_parms_set: int, pointer to the dynamic AIPP parameter object.

• acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

crop_switch: int, whether to crop an image. Values:

• 0 (default): disabled
• 1: enabled

crop_start_pos_w: int, horizontal coordinate of the crop start. For YUV420SP_U8, the value must be an even number.

• Value range: [0, 4096]

crop_start_pos_h: int, vertical coordinate of the crop start. For YUV420SP_U8, the value must be an even number.

• Value range: [0, 4096]

crop_size_w: int, crop size width. For YUV420SP_U8, the value must be an even number.

• Value range: [0, 4096]

crop_size_h: int, crop size height. For YUV420SP_U8, the value must be an even number.

• Value range: [0, 4096]

batch_index: int, index of batch for image cropping. The default value is 0.

• The value range is [0, batch_size). batch_size is set when acl.mdl.create_aipp is called to create data of the aclmdlAIPP type.

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

If the cropping function is enabled, the following conditions must be met for the arguments passed to the acl.mdl.set_aipp_src_image_size call and acl.mdl.set_aipp_crop_params call:

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

None

aclError aclmdlSetAIPPPaddingParams(aclmdlAIPP *aippParmsSet, int8_t paddingSwitch,int32_t paddingSizeTop, int32_t paddingSizeBottom,int32_t paddingSizeLeft, int32_t paddingSizeRight,uint64_t batchIndex)

ret = acl.mdl.set_aipp_padding_params(aipp_parms_set, padding_switch, padding_size_top, padding_size_bottom, padding_size_left, padding_size_right, batch_index)

Sets padding parameters in dynamic AIPP scenarios. It is a synchronous interface.

aipp_parms_set: int, pointer to the dynamic AIPP parameter object.

• acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

padding_switch: int, whether to perform padding on the image. Values:

• 0 (default): disabled
• 1: enabled

padding_size_top: int, top padding size.

• Value range: [0, 32]

padding_size_bottom: int, bottom padding size.

• Value range: [0, 32]

padding_size_left: int, left padding size.

• Value range: [0, 32]

padding_size_right: int, right padding size.

• Value range: [0, 32]

batch_index: int, index of batch for image padding. The default value is 0.

• The value range is [0, batch_size). batch_size is set when acl.mdl.create_aipp is called to create data of the aclmdlAIPP type.

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None

aclError aclmdlSetAIPPDtcPixelMean(aclmdlAIPP *aippParmsSet, int16_t dtcPixelMeanChn0, int16_t dtcPixelMeanChn1, int16_t dtcPixelMeanChn2, int16_t dtcPixelMeanChn3, uint64_t batchIndex)

ret = acl.mdl.set_aipp_dtc_pixel_mean(aipp_parms_set, dtc_pixel_mean_chn0, dtc_pixel_mean_chn1, dtc_pixel_mean_chn2, dtc_pixel_mean_chn3, batch_index)

Sets the mean value of each channel in dynamic AIPP scenarios. It is a synchronous interface.

aipp_parms_set: int, pointer to the dynamic AIPP parameter object.

• acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

dtc_pixel_mean_chn0: int, mean value of channel 0.

• Value range: [0, 255]

dtc_pixel_mean_chn1: int, mean value of channel 1.

• Value range: [0, 255]

dtc_pixel_mean_chn2: int, mean value of channel 2.

• Value range: [0, 255]

dtc_pixel_mean_chn3: int, mean value of channel 3. If there are only three channels, the default value is 0.

• Value range: [0, 255]

batch_index: int, index of batch for channel mean value setting. The default value is 0.

• The value range is [0, batch_size). batch_size is set when acl.mdl.create_aipp is called to create data of the aclmdlAIPP type.

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None

aclError aclmdlSetAIPPDtcPixelMin(aclmdlAIPP *aippParmsSet, float dtcPixelMinChn0, float dtcPixelMinChn1, float dtcPixelMinChn2, float dtcPixelMinChn3, uint64_t batchIndex)

ret = acl.mdl.set_aipp_dtc_pixel_min(aipp_parms_set, dtc_pixel_mean_chn0, dtc_pixel_mean_chn1, dtc_pixel_mean_chn2, dtc_pixel_mean_chn3, batch_index)

Sets the minimum value of each channel in dynamic AIPP scenarios. It is a synchronous interface.

aipp_parms_set: int, pointer to the dynamic AIPP parameter object.

• acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

dtc_pixel_mean_chn0: int, mean value of channel 0.

• Value range: [0, 255]

dtc_pixel_mean_chn1: int, mean value of channel 1.

• Value range: [0, 255]

dtc_pixel_mean_chn2: int, mean value of channel 2.

• Value range: [0, 255]

dtc_pixel_mean_chn3: int, mean value of channel 3. If there are only three channels, the default value is 0.

• Value range: [0, 255]

batch_index: int, index of batch for channel mean value setting. The default value is 0.

• The value range is [0, batch_size). batch_size is set when acl.mdl.create_aipp is called to create data of the aclmdlAIPP type.

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None

aclError aclmdlSetAIPPPixelVarReci(aclmdlAIPP *aippParmsSet, float dtcPixelVarReciChn0, float dtcPixelVarReciChn1, float dtcPixelVarReciChn2, float dtcPixelVarReciChn3, uint64_t batchIndex)

ret = acl.mdl.set_aipp_pixel_var_reci(aipp_parms_set, dtc_pixel_var_reci_chn0, dtc_pixel_var_reci_chn1, dtc_pixel_var_reci_chn2, dtc_pixel_var_reci_chn3, batch_index)

Sets the variance of each channel in dynamic AIPP scenarios. It is a synchronous interface.

aipp_parms_set: int, pointer to the dynamic AIPP parameter object.

• acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

dtc_pixel_var_reci_chn0: int, variance of channel 0.

• Value range: [–65504, +65504]

dtc_pixel_var_reci_chn1: int, variance of channel 1.

• Value range: [–65504, +65504]

dtc_pixel_var_reci_chn2: int, variance of channel 2.

• Value range: [–65504, +65504]

dtc_pixel_var_reci_chn3: int, variance of channel 3. If there are only three channels, the default value is 1.0.

• Value range: [–65504, +65504]

batch_index: int, index of batch for channel variance setting. The default value is 0.

• The value range is [0, batch_size). batch_size is set when acl.mdl.create_aipp is called to create data of the aclmdlAIPP type.

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None

aclError aclmdlSetInputAIPP(uint32_t modelId, aclmdlDataset *dataset, size_t index, const aclmdlAIPP *aippParmsSet)

ret = acl.mdl.set_input_aipp(model_id, dataset, index, aipp_parms_set)

Sets AIPP parameters for model inference in dynamic AIPP scenarios. It is a synchronous interface.

model_id: int, ID of a model.

• acl.mdl.load_from_file, acl.mdl.load_from_mem, acl.mdl.load_from_file_with_mem, and acl.mdl.load_from_mem_with_mem are called to load the model. After the model is successfully loaded, the model ID is returned.

dataset: int, input data of a model.

• Data of type acl.model_dataset is used to describe input data for model inference, while data of type aclDataBuffer is used to describe input memory size and address.

index: int, index of the input AIPP. Index is obtained by calling acl.mdl.get_input_index_by_name. For dynamic AIPP, the input name is fixed to ascend_dynamic_aipp_data.

aipp_parms_set: int, pointer to the dynamic AIPP parameter object.

• acl.mdl.create_aipp is called in advance to create data of the aclmdlAIPP type.

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

None

None