---
title: hi_isp_wb_info
description: "定义白平衡，饱和度，颜色校正信息。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0239.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0239.html
indexId: c17a175c906f45b63610315595bfdaf0bd1a99771d1267c88f6f642dd99668b565
---
# hi_isp_wb_info

#### 说明

定义白平衡，饱和度，颜色校正信息。


#### 定义

```
typedef struct {
hi_u16
r_gain;
hi_u16
gr_gain;
hi_u16
gb_gain;
hi_u16
b_gain;
hi_u16
saturation;
hi_u16
color_temp;
hi_u16
ccm[HI_ISP_CCM_MATRIX_SIZE];
hi_u16
ls0_ct;
hi_u16
ls1_ct;
hi_u16
ls0_area;
hi_u16
ls1_area;
hi_u8
multi_degree;
hi_u16
active_shift;
hi_u32
first_stable_time;
hi_isp_awb_indoor_outdoor_status
in_out_status;
hi_s16
bv;
} hi_isp_wb_info;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| r\_gain | 当前R通道增益值，8bit小数精度。 取值范围：[0x0, 0xFFF]。 |
| gr\_gain | 当前Gr通道增益值，8bit小数精度。 取值范围：[0x0, 0xFFF]。 |
| gb\_gain | 当前Gb通道增益值，8bit小数精度。 取值范围：[0x0, 0xFFF]。 |
| b\_gain | 当前B通道增益值，8bit小数精度。 取值范围：[0x0, 0xFFF]。 |
| saturation | 当前饱和度值，有效范围为[0x0, 0xFF]。 |
| color\_temp | 当前色温值。 取值范围：[0x0, 0xFFFF]。 |
| ccm[HI\_ISP\_CCM\_MATRIX\_SIZE] | 当前颜色校正矩阵值，8bit小数精度。bit 15是符号位，0表示正数，1 表示负数，例如0x8010表示\-16。 取值范围：[0x0, 0xFFFF]。 \#define HI\_ISP\_CCM\_MATRIX\_NUM 7 |
| ls0\_ct | 混合光源场景，主光源色温。 取值范围：[0x0, 0xFFFF]。 |
| ls1\_ct | 混合光源场景，次要光源色温。 取值范围：[0x0, 0xFFFF]。 |
| ls0\_area | 混合光源场景，主光源面积。取值范围为[0x0,0xFF]。 |
| ls1\_area | 混合光源场景，次要光源面积。取值范围为[0x0, 0xFF]。 |
| multi\_degree | 当前场景是混合光源的概率。取值范围为[0x0, 0xFF]。 |
| first\_stable\_time | 首次AWB收敛稳定的时间，以帧为计数单位。取值范围为[0x0, 0xFFFFFFFF]。 |
| active\_shift | 当前场景最终生效的白点范围限制shift值。取值范围为[0x0,0xFF]。 |
| in\_out\_status | 室内外检测结果。取值范围：AWB\_INDOOR\_MODE、AWB\_OUTDOOR\_MODE |
| bv | 当前环境bv值。取值范围为[\-32768, 32767]。 |


#### 注意事项

- multi_degree非0时，表示场景是混合光源。该值越大，场景为混合光源的概率越大。
- ls0_ct、ls1_ct、ls0_area、ls1_area等查询结果仅在multi_degree非 0 时有效。
- 混合光源检测仅在室内场景打开，AWB判断为室外场景后，逐渐减弱混合光源检测的强度，以避免饱和度降低。
- 混合光源概率说明：主光源和次要光源的亮度、色温差等条件影响混合光源的概率计算。检测到场景内存在主光源和次要光源两种光源后，主光源和次要光源的色温差异越大、亮度差异越小，混合光源概率越大。
- ls0_area和ls1_area之和有可能大于白平衡分区个数，原因是部分区域可能受到两种光源的影响，算法不将重叠区域严格识别，会叠加到主光源、次要光源。
- first_stable_time是AWB首次收敛稳定后所对应的帧数，非0表示AWB已稳定。ISP系统启动后，1-64帧AWB固定每帧执行一次，以加速AWB收敛。