---
title: hi_isp_awb_info
description: "定义ISP提供给AWB的统计信息结构体。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0152.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0152.html
indexId: 6f821b8bca651f918e9bc2b12470da34f3762e0bb89efb3a10f0c386128b5ff365
---
# hi_isp_awb_info

#### 说明

定义ISP提供给AWB的统计信息结构体。


#### 定义

```
typedef struct {
hi_u32
frame_cnt;
hi_isp_awb_stat_1
*awb_stat1;
hi_isp_awb_stat_result
awb_stat2;
hi_u8
awb_gain_switch;
hi_u8
awb_stat_switch;
hi_bool
wb_gain_in_sensor;
hi_u32
wdr_wb_gain[HI_ISP_BAYER_CHN_NUM];
} hi_isp_awb_info;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| frame\_cnt | 帧的累加计数。 取值范围为[0, 0xFFFFFFFF]。 |
| awb\_stat1 | Awb统计信息 1 |
| awb\_stat2 | Awb统计信息 2 |
| awb\_gain\_switch | 白平衡增益在ISP的位置。取值范围为[0,1]。 0：白平衡增益配置在WDR合成前的DG1处。 1：白平衡增益配置在WB处。 |
| awb\_stat\_switch | 白平衡统计模块在ISP的位置。取值范围为[0, 1, 2]。 0：白平衡统计模块在DG后。 1：白平衡统计模块在EXPANDER后。 2：白平衡统计模块在DRC后。 |
| wb\_gain\_in\_sensor | 白平衡增益是否在sensor配置。取值范围为[0, 1]。 0：白平衡增益在ISP配置。 1：白平衡增益在sensor配置。 |
| wdr\_wb\_gain | 在WDR合成前的DG1处配置的白平衡增益值。 \#define HI\_ISP\_BAYER\_CHN\_NUM 4 |


#### 注意事项

- AWB库可以根据frame_cnt控制运算频率，例如两帧运算一次。
- hi_isp_awb_info提供了全局统计信息和分块统计信息，不同模式下水平、垂直分块个数不固定，可通过hi_isp_awb_param的awb_zone_row、awb_zone_col两个参数获取。AWB分块个数 = awb_zone_row* awb_zone_col。
- 切换白平衡统计模块位置，会导致 2 帧统计信息错误，建议在启动时配置合理值，避免切换。如果必须进行位置切换，建议切换后，AWB算法冻结 2 帧以上， 待统计信息正确后，再重新计算。
- 通过hi_mpi_isp_set_stats_cfg接口配置白平衡统计模块位置在DRC后，通过hi_mpi_isp_set_wb_attr接口关闭亮度对白平衡权重的影响，可以优化WDR模式下暗区偏红问题。