---
title: hi_isp_awb_in_out_attr
description: "定义对场景做室内外判断的参数。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0238.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0238.html
indexId: 266d26cbe7349368305d5a6712c49856a2ff8439839e48e6298a3fc7018c54ff65
---
# hi_isp_awb_in_out_attr

#### 说明

定义对场景做室内外判断的参数。


#### 定义

```
typedef struct {
hi_bool
enable;
hi_op_mode
op_type;
hi_isp_awb_indoor_outdoor_status
outdoor_status;
hi_u32
out_thresh;
hi_u16
low_start;
hi_u16
low_stop;
hi_u16
high_start;
hi_u16
high_stop;
hi_bool
green_enhance_en;
hi_u8
out_shift_limit;
} hi_isp_awb_in_out_attr;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| enable | 对场景做室内外判断开关。 取值范围： HI\_FALSE: 关闭 HI\_TRUE: 开启 |
| op\_type | 对场景做室内外判断类型(自动或手动)。 取值范围： HI\_ISP\_OP\_TYPE\_AUTO：自动模式 HI\_ISP\_OP\_TYPE\_MANUAL：手动模式 |
| outdoor\_status | 手动模式下，用户输入室内外状态信息。 取值范围： AWB\_INDOOR\_MODE：室内模式 AWB\_OUTDOOR\_MODE：室外模式 |
| out\_thresh | 室内外场景判定设置的阈值，以单位为us的曝光时间，小于该阈值则认为是室外。 |
| low\_start | 将位于低色温范围内的像素权重调低，低色温区起始值，建议5000K。 |
| low\_stop | 将位于低色温范围内的像素权重调低，低色温区终止值，建议4500K。 取值范围：(0, low\_start)。 |
| high\_start | 将位于高色温范围内的像素权重调低，高色温区起始值，建议6500K。 取值范围：(low\_start, 0xFFFF]。 |
| high\_stop | 将位于高色温范围内的像素权重调低，高色温区终止值，建议8000K。 取值范围：(high\_start, 0xFFFF]。 |
| green\_enhance\_en | 在绿色植物场景下是否对绿色通道增强。 取值范围： HI\_FALSE: 关闭 HI\_TRUE: 开启 |
| out\_shift\_limit | 判断为室外场景时，AWB算法的白点范围限制shift= out\_shift\_limit。取值范围：[0x0, 0xFF]。 |


#### 注意事项

- out_thresh需要根据sensor的感光特性进行调整。等效曝光时间=曝光时间*模拟增益*数字增益*ISP数字增益。
- 用户调用自己的AE库，且室内外判断类型为自动时，请务必将当前曝光时间和ISO传递给AWB库。
- 设置色温范围的low_start、low_stop、high_start、high_stop等4个参数，和sensor校正相关，建议用户针对sensor做微调。四个参数的取值范围要求：low_stop<low_start<high_start<high_stop。如果设置的室外色温范围[low_start, high_start]较宽，室外的大面积纯色场景颜色表现可能会稍差；如果设置的室外色温范围[low_start, high_start]较窄，在日落前等高低色温场景，AWB不能完全恢复，低色温下稍微偏黄，高色温下稍微偏蓝。
- AWB校正参数调整后，low_start、low_stop、high_start、high_stop等4个参数要再次进行调整，以达到最佳效果。
- shift取值影响AWB算法表现。普通场景shift_limit、out_shift_limit两个参数的取值大小对AWB结果影响不大。特殊光源、大面积单色场景，shift_limit、 out_shift_limit两个参数的取值大小对AWB结果影响较大。
  − 两个Shift参数取值较小时，单色表现好，但特殊光源下容易偏色；

  − 两个shift参数取值较大时，AWB表现稳定性好，但大面积绿色、黄色等场景可能偏色。


图1 室外色温范围参数的意义