---
title: hi_isp_wdr_exposure_attr
description: "定义WDR模式下的曝光属性。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0199.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0199.html
indexId: c1716673b6da8f9c9df24591aefa488ae04a83a083e434849bb8c2e2687f2c9e65
---
# 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。