下载
中文
注册

hi_mpi_isp_cal_gain_by_temp

函数功能

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

函数原型

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)

约束说明

  • 白平衡标定参数决定预设色温增益计算的准确性,因此,在调用该接口前,必须完成标定,且标定参数配置到 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 曲线右侧,计算的白平衡增益在预设色温下会稍微偏绿。

参数说明

参数名称

输入/输出

描述

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 四个通道增益。

返回值说明