Function: set_aipp_csc_params

Applicability

Product	Supported (√/x)
Atlas A3 training products / Atlas A3 inference products	√
Atlas A2 training products / Atlas A2 inference products	√
Atlas training products	√
Atlas inference products	√
Atlas 200I/500 A2 inference products	√

Function Usage

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

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

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

Prototype

C Prototype

        
             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)

Python Function

        
             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)

Parameter Description

Parameter	Description
aipp_parms_set	Int, pointer address of the dynamic AIPP configuration object. The aclmdlAIPP data must be created by the acl.mdl.create_aipp call in advance.
csc_switch	Int, CSC switch. 0 (default): disabled 1: enabled
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].

Return Value Description

Return Value	Description
ret	Int, error code. 0: success. Other values: failure.

Restrictions

If the original image format is set to YUV400 by the acl.mdl.set_aipp_input_format call, it is not supported to set the CSC attributes by this API.

Parent topic: Dynamic AIPP Parameter Settings