昇腾社区首页
中文
注册

hi_mpi_isp_cal_gain_by_temp

产品支持情况

产品

是否支持

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

x

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

x

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

x

Atlas 训练系列产品

x

Atlas 200/300/500 推理产品

x

功能说明

计算特定色温下的白平衡增益系数。

函数原型

hi_s32 hi_mpi_isp_cal_gain_by_temp(hi_vi_pipe vi_pipe, const hi_isp_wb_attr *wb_attr, hi_u16 color_temp, hi_s16 shift, hi_u16 *awb_gain)

参数说明

参数名称

输入/输出

描述

vi_pipe

输入

vi_pipe号。

取值范围:[0, 12)。

wb_attr

输入

白平衡的参数属性。需要用到hi_isp_awb_attr中的static_wb,curve_para两组标定参数。

color_temp

输入

色温值,单位为Kelvin。

取值范围:[1500, 15000]

shift

输入

白点与Planckian曲线的位置和距离。取值范围:[-64, 64]

awb_gain

输出

预设色温下的R、Gr、Gb、B四个通道增益。

返回值说明

约束说明

  • 白平衡标定参数决定预设色温增益计算的准确性,因此,在调用该接口前,必须完成标定,且标定参数配置到ISP。用户先通过hi_mpi_isp_set_wb_attr接口设置标定结果,再调用hi_mpi_isp_cal_gain_by_temp接口计算预设色温的增益,过程中不能再修改标定结果。
  • hi_mpi_isp_cal_gain_by_temp功能基于AWB标定参数实现,因此,该接口仅对hi_isp_awb_attr结构体的标定参数static_wb,curve_para做有效范围检查,不对其他参数做约束。
  • shift参数决定光源点与Planckian曲线的位置关系,shift为负数时,光源点位于Planckian曲线左侧,计算的白平衡增益在预设色温下会稍微偏红;shift为正数时,光源点位于Planckian曲线右侧,计算的白平衡增益在预设色温下会稍微偏绿。