昇腾社区首页
中文
注册

hi_isp_wdr_exposure_attr

说明

定义WDR模式下的曝光属性。

定义

typedef struct { 
    hi_op_mode  exp_ratio_type; 
    hi_u32 exp_ratio[HI_ISP_EXP_RATIO_NUM]; 
    hi_u32 exp_ratio_max; 
    hi_u32 exp_ratio_min; 
    hi_u16 tolerance; 
    hi_u16 speed;  
    hi_u16 ratio_bias;  
    hi_u16 high_light_target; 
    hi_u16 exp_coef_min;
} hi_isp_wdr_exposure_attr;

成员

成员名称

描述

exp_ratio_type

仅在多帧合成WDR模式下有效。

exp_ratio[HI_ISP_EXP_RATIO_NUM]

仅在多帧合成WDR模式下有效。

  • 当exp_ratio_type为HI_OP_MODE_AUTO时, exp_ratio无效。
  • 当exp_ratio_type为HI_OP_MODE_MANUAL时,exp_ratio为可读写,表示多帧合成 WDR相邻2帧曝光比期望值。其中exp_ratio[0]作为S/VS曝光比,exp_ratio[1]作为M/S 曝光比,exp_ratio[2]作为L/M曝光比。

上述VS,S,M,L分别表示极短帧,短帧,中帧和长帧的曝光时间,2帧合成时只有VS和S;3 帧合成时采用VS,S和M; 4帧合成时采用VS,S,M和L。6bit小数精度,0x40表示曝光比为1倍。

取值范围:[0x40, 0xFFF]

#define HI_ISP_EXP_RATIO_NUM 3

exp_ratio_max

仅在多帧合成WDR模式下有效。

  • 当exp_ratio_type为HI_OP_MODE_AUTO时, exp_ratio_max表示最长帧与最短帧曝光时间比值的最大值。即2帧合成时表示S/VS曝光比的最大值,3帧合成时表示M/VS曝光比的最大值,4帧合成时表示L/VS曝光比的最大值。
  • 当exp_ratio_type为HI_OP_MODE_MANUAL时, exp_ratio_max无效。

6bit小数精度,0x40表示曝光比为1倍。

取值范围:[0x40, 0x4000]

exp_ratio_min

仅在多帧合成WDR模式下有效。

  • 当exp_ratio_type为HI_OP_MODE_AUTO时, exp_ratio_min表示长帧曝光时间与短帧曝光时间比值的最小值。
  • 当exp_ratio_type为HI_OP_MODE_MANUAL时,exp_ratio_min无效。

    格式为无符号6.6bit定点,0x40表示长帧曝光时间与短帧曝光时间的比值为1倍。默认值为0x40。

    取值范围:[0x40, exp_ratio_max]

tolerance

曝光比容忍值,仅在两帧合成WDR模式下有效。

当exp_ratio_type为HI_OP_MODE_AUTO时,该值越大,表示场景动态范围变化在一定范围内时,曝光比保持不变。默认值为0xC。

取值范围:[0x0, 0xFF]

speed

自动曝光比调节速度,仅在两帧合成WDR模式下有效。

当exp_ratio_type为HI_OP_MODE_AUTO时,该值越大,自动曝光比调节速度越快。默认值为 0x20。

取值范围:[0x0, 0xFF]

ratio_bias

曝光比偏差值,仅在多帧合成WDR模式下有效。

当exp_ratio_type为HI_OP_MODE_AUTO时,该值越大,自动曝光比越大。默认值为0x400,表示不对自动曝光比算法的计算结果进行调整。经过该值调整的曝光比会受到曝光比最大/最小值的限制。

取值范围:[0x0, 0xFFFF]

high_light_target

图像过曝程度的目标值,仅在使能Advance ae时有效。该值越大,图像过曝程度越大。默认值为 0x30。

取值范围:[0x0, 0x400]

exp_coef_min

曝光系数最小值,仅在使能advance ae时有效。

10bit小数精度,0x400表示曝光系数最小值为1倍,默认值为0x400。

取值范围:[0x0, 0x400]

注意事项

  • 建议tolerance不要设置为太大的值,避免曝光比不能正确的反映场景动态范围变化。
  • 针对某些对短帧最大曝光时间有限制的sensor,曝光比较小时,长帧最大曝光时间较短,图像动态范围及噪声表现较差,导致自动曝光比计算不准确,此时建议限制最小曝光比,保证长帧最大曝光时间至少达到3ms。如SonyIMX274@30fps,短帧最大曝光时间为680us,此时建议限制最小曝光比为1:5,即设置exp_ratio_min为0x140,以保证图像质量。
  • 建议speed不要设置小于0x8,避免某些场景由于计算精度不足导致曝光比调节太慢甚至不调。speed过大可能导致曝光比变化太快,造成画面亮度出现振荡。
  • 建议手动模式下exp_ratio不要设置大于0x400。如果曝光比大于0x400,在较亮的超宽动态场景,适当调高曝光比会优化长帧图像噪声表现。但是在较暗或低宽动态场景,如果曝光比过大,由于短帧最大曝光时间会被压缩,导致图像噪声表现会变差,而且会出现明显的噪声不连续,运动表现也会变差。
  • 使能Advance ae,当曝光比达到设置的最大曝光比,图像过曝程度仍未达到目标值时,会适当降低AE亮度目标值,以换取图像整体过曝程度的降低。通过合理设置exp_coef_min,可使AE亮度目标值最多可以下降到compensation * exp_coef_min/1024。