--- title: 函数：set_aipp_csc_params description: "| 产品 | 是否支持 |" url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendgraphapi/aclpythondevg_01_0173.html sourcePath: /source/zh/canncommercial/900/API/ascendgraphapi/aclpythondevg_01_0173.html indexId: f8c2221abfc67fbfffbc97621ba555251920c65879c8635a398a1c52315d9fc075 --- # 函数：set_aipp_csc_params #### 产品支持情况 | 产品 | 是否支持 | | --- | --- | | Atlas 350 加速卡 | x | | Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ | | Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ | | Atlas 训练系列产品 | √ | | Atlas 推理系列产品 | √ | | Atlas 200I/500 A2 推理产品 | √ | #### 功能说明 动态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离线模型编译工具(https://www.hiascend.com/document/detail/zh/canncommercial/900/devaids/atctool/atlasatc_16_0001.html)》下的色域转换配置说明，按照转换前图片格式、转换后图片格式来配置色域转换参数。如果手册中列举的图片格式不满足要求，您需自行根据实际需求配置色域转换参数。 #### 函数原型 - C函数原型 1 2 3 4 5 6 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函数 1 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) #### 参数说明 | 参数名 | 说明 | | --- | --- | | aipp\_parms\_set | int，动态AIPP参数对象的指针地址，需提前调用acl.mdl.create\_aipp接口创建aclmdlAIPP类型的数据。 | | csc\_switch | int，色域转换开关，取值范围： 0：关闭色域转换开关，默认为0。 1：打开色域转换开关。 | | csc\_matrix\_R0C0 | int，色域转换矩阵参数，取值范围：[\-32677, 32676]。 | | csc\_matrix\_R0C1 | int，色域转换矩阵参数，取值范围：[\-32677, 32676]。 | | csc\_matrix\_R0C2 | int，色域转换矩阵参数，取值范围：[\-32677, 32676]。 | | csc\_matrix\_R1C0 | int，色域转换矩阵参数，取值范围：[\-32677, 32676]。 | | csc\_matrix\_R1C1 | int，色域转换矩阵参数，取值范围：[\-32677, 32676]。 | | csc\_matrix\_R1C2 | int，色域转换矩阵参数，取值范围：[\-32677, 32676]。 | | csc\_matrix\_R2C0 | int，色域转换矩阵参数，取值范围：[\-32677, 32676]。 | | csc\_matrix\_R2C1 | int，色域转换矩阵参数，取值范围：[\-32677, 32676]。 | | csc\_matrix\_R2C2 | int，色域转换矩阵参数，取值范围：[\-32677, 32676]。 | | csc\_output\_bias\_R0 | int，RGB转YUV时的输出偏移，默认值为0，取值范围：[0, 255]。 | | csc\_output\_bias\_R1 | int，RGB转YUV时的输出偏移，默认值为0，取值范围：[0, 255]。 | | csc\_output\_bias\_R2 | int，RGB转YUV时的输出偏移，默认值为0，取值范围：[0, 255]。 | | csc\_input\_bias\_R0 | int，YUV转RGB时的输入偏移，默认值为0，取值范围：[0, 255]。 | | csc\_input\_bias\_R1 | int，YUV转RGB时的输入偏移，默认值为0，取值范围：[0, 255]。 | | csc\_input\_bias\_R2 | int，YUV转RGB时的输入偏移，默认值为0，取值范围：[0, 255]。 | #### 返回值说明 | 返回值 | 说明 | | --- | --- | | ret | int，错误码 返回0表示成功。 返回其它值(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclpythondevg\_01\_0911.html)表示失败。 | #### 约束说明 如果通过acl.mdl.set_aipp_input_format接口设置的原始图像格式为YUV400，则不支持通过本接口设置色域转换参数。