---
title: hi_isp_awb_extra_light_source_info
description: "定义独立光源点的信息。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0237.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0237.html
indexId: 87872d355df34b155a3f390eafa5927eb76cb0e9516dc98e8fca9c3c7184553b65
---
# hi_isp_awb_extra_light_source_info

#### 说明

定义独立光源点的信息。


#### 定义

```
typedef struct {
hi_u16
white_r_gain;
hi_u16
white_b_gain;
hi_u16
exp_quant;
hi_u8
light_status;
hi_u8
radius;
} hi_isp_awb_extra_light_source_info;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| white\_r\_gain | 增加或删除区域的中心Cr坐标，8bit小数精度。 取值范围：[0x0, 0xFFF] |
| white\_b\_gain | 增加或删除区域的中心Cb坐标，8bit小数精度。 取值范围：[0x0, 0xFFF] |
| exp\_quant | 对外界环境亮度做判断，暂不支持，不需要配置。 |
| light\_status | 光源点状态。 0：不使能； 1：增加光源点； 2：删除干扰色； |
| radius | 增加或删除区域的半径。 取值范围：[0x0, 0xFF] |


注意事项

- 独立光源点实现以下功能：用户设定CbCr坐标的某个区域，指定该区域为特殊光源下的白色表现，增加为独立光源点；或指定该区域为特定光源下的干扰色，进行删除。
- 通过light_status参数的设置实现功能选择。light_status设置为1时，在用户校正的Planckian曲线外，增加特殊光源点，以优化该光源下颜色表现，不影响设备在其它光源下的表现；light_status设置为2时，支持用户删除特定光源的某个干扰色（肤色、绿色、蓝天等）。
- 建议删除干扰色仅用来优化特定环境的颜色表现，否则会影响其它光源的表现。在CbCr坐标，5500K光源下的肤色与3500K光源的白色重合度很高，在5500K环境删除肤色的干扰，会导致3500K光源下偏色。
- white_r_gain、white_b_gain的取值。在该光源下捕获ColorChecker Raw数据，通过Calibration Tool Static WB选项校准得到的Rgain、Bgain即white_r_gain、white_b_gain坐标值。删除干扰色，可选择干扰色区域进行静态白平衡校正，来确定white_r_gain、white_b_gain坐标值。
- radius取值由用户设置，增加光源点，建议取值在[0x8, 0x10]范围内，删除干扰色，尽量避免[white_r_gain、white_b_gain]为中心，radius为半径的圆形区域与Planckian曲线重合。增加光源点或删除干扰色， 设置radius半径太大时（覆盖场景内大多数统计块），会导致功能失效，甚至起反作用。

- 当前支持定义最多4个光源色，4个相互独立。4个光源点需要避免交集，特别需要避免以下情况：CbCr坐标的单个点，既指定为增加的独立光源点，又指定为删除的干扰色。