---
title: hi_isp_exposure_attr
description: "定义ISP曝光属性。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0198.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0198.html
indexId: 949982f2a43063b7d979d56bdcb064fbc7af6bccff8c65d51ce0f2ada2e085ef65
---
# hi_isp_exposure_attr

#### 说明

定义ISP曝光属性。


#### 定义

```
typedef struct {
hi_bool
bypass;
hi_op_mode
op_type;
hi_u8
ae_run_interval;
hi_bool
hist_stat_adjust;
hi_bool
ae_route_ex_valid;
hi_isp_me_attr
manual_attr;
hi_isp_ae_attr
auto_attr;
hi_isp_prior_frame
prior_frame;
hi_bool
ae_gain_sep_cfg;
hi_bool
advance_ae;
} hi_isp_exposure_attr;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| bypass | AE模块bypass功能使能，默认为HI\_FALSE。 |
| op\_type | 自动曝光或手动曝光开关，默认为HI\_OP\_MODE\_AUTO。 |
| ae\_run\_interval | AE算法运行的间隔，取值范围为[1, 255]。 取值为1时表示每帧都运行AE算法； 取值为2时表示每2帧运行1次AE算法，依此类推。建议该值设置不要大于2，否则AE调节速度会受到影响。 WDR模式时，该值建议设置为1，这样AE收敛会更加平滑。 该值默认为1。 |
| hist\_stat\_adjust | 1024段直方图统计方式是否根据场景进行调整开关，默认为HI\_TRUE。 |
| ae\_route\_ex\_valid | AE扩展分配路线是否生效开关，HI\_TRUE时使用AE扩展分配路线，否则使用普通AE分配路线。默认为HI\_FALSE。 |
| manual\_attr | 手动曝光属性结构体。 |
| auto\_attr | 自动曝光属性结构体。 |
| prior\_frame | WDR模式下曝光路线生效的优先帧，线性模式下此参数需配置为LONG\_FRAME。 |
| ae\_gain\_sep\_cfg | 长短帧增益是否分开分配。 |
| advance\_ae | 是否使能advance AE。 |


#### 注意事项

- AE bypass为HI_TRUE时，AE模块被bypass，任何AE配置都不会对图像亮度产生影响。hi_isp_ae_result保持为AE bypass前一帧的值。
- AE主要基于全局1024段直方图信息进行亮度调整，正常场景1024段直方图只统计Gb或Gr分量。hist_stat_adjust为HI_TRUE时，若进入了大面积单色场景（如大面积红色或蓝色），AE算法会根据全局平均值信息对1024段直方图统计方式进行调整，把R分量或B分量也考虑进来，如此可以防止大面积红色或蓝色场景画面亮度偏高。hist_stat_adjust为HI_FALSE时，AE算法不会调整1024段直方图统计方式。红外场景建议将hist_stat_adjust设置为HI_FALSE。
- WDR/线性模式切换时，ae_run_interval会重置为1，用户可以在切换完成后，根据需要修改该值。
- ae_gain_sep_cfg仅在 2to1WDR模式下配置生效。
- 手动模式不支持长短帧增益分开分配。
- 曝光比变化过程中切换ae_gain_sep_cfg会交叉影响长短帧的曝光时间限制，可能会导致图像亮度突变，建议在曝光比收敛状态下切换ae_gain_sep_cfg。
- Advance AE目前可在正常FSWDR模式下生效（长帧模式不生效），使能advance_ae，可使图像暗区和亮区的曝光更加合理、准确，当场景发生亮暗比例变化时，图像亮暗区曝光更加稳定，在其他模式下advance_ae使能与否效果无差异。