昇腾社区首页
中文
注册

hi_isp_awb_in_out_attr

说明

定义对场景做室内外判断的参数。

定义

typedef struct { 
    hi_bool enable; 
    hi_op_mode op_type; 
    hi_isp_awb_indoor_outdoor_status outdoor_status; 
    hi_u32 out_thresh;  
    hi_u16 low_start; 
    hi_u16 low_stop;
    hi_u16 high_start;      
    hi_u16 high_stop;      
    hi_bool green_enhance_en;      
    hi_u8 out_shift_limit; 
} hi_isp_awb_in_out_attr;

成员

成员名称

描述

enable

对场景做室内外判断开关。

取值范围:

  • HI_FALSE: 关闭
  • HI_TRUE: 开启

op_type

对场景做室内外判断类型(自动或手动)。

取值范围:

  • HI_ISP_OP_TYPE_AUTO:自动模式
  • HI_ISP_OP_TYPE_MANUAL:手动模式

outdoor_status

手动模式下,用户输入室内外状态信息。

取值范围:

  • AWB_INDOOR_MODE:室内模式
  • AWB_OUTDOOR_MODE:室外模式

out_thresh

室内外场景判定设置的阈值,以单位为us的曝光时间,小于该阈值则认为是室外。

low_start

将位于低色温范围内的像素权重调低,低色温区起始值,建议5000K。

low_stop

将位于低色温范围内的像素权重调低,低色温区终止值,建议4500K。

取值范围:(0, low_start)。

high_start

将位于高色温范围内的像素权重调低,高色温区起始值,建议6500K。

取值范围:(low_start, 0xFFFF]。

high_stop

将位于高色温范围内的像素权重调低,高色温区终止值,建议8000K。

取值范围:(high_start, 0xFFFF]。

green_enhance_en

在绿色植物场景下是否对绿色通道增强。

取值范围:

  • HI_FALSE: 关闭
  • HI_TRUE: 开启

out_shift_limit

判断为室外场景时,AWB算法的白点范围限制shift= out_shift_limit。取值范围:[0x0, 0xFF]。

注意事项

  • out_thresh需要根据sensor的感光特性进行调整。等效曝光时间=曝光时间*模拟增益*数字增益*ISP数字增益。
  • 用户调用自己的AE库,且室内外判断类型为自动时,请务必将当前曝光时间和ISO传递给AWB库。
  • 设置色温范围的low_start、low_stop、high_start、high_stop等4个参数,和sensor校正相关,建议用户针对sensor做微调。四个参数的取值范围要求:low_stop<low_start<high_start<high_stop。如果设置的室外色温范围[low_start, high_start]较宽,室外的大面积纯色场景颜色表现可能会稍差;如果设置的室外色温范围[low_start, high_start]较窄,在日落前等高低色温场景,AWB不能完全恢复,低色温下稍微偏黄,高色温下稍微偏蓝。
  • AWB校正参数调整后,low_start、low_stop、high_start、high_stop等4个参数要再次进行调整,以达到最佳效果。
  • shift取值影响AWB算法表现。普通场景shift_limit、out_shift_limit两个参数的取值大小对AWB结果影响不大。特殊光源、大面积单色场景,shift_limit、 out_shift_limit两个参数的取值大小对AWB结果影响较大。

    − 两个Shift参数取值较小时,单色表现好,但特殊光源下容易偏色;

    − 两个shift参数取值较大时,AWB表现稳定性好,但大面积绿色、黄色等场景可能偏色。

图 室外色温范围参数的意义