---
title: hi_isp_awb_ct_limit_attr
description: "定义白平衡的增益范围限制属性。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0231.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0231.html
indexId: 478214367adc2226a3201f9ec121efd03b4f85d2f60d3fb31cf326dc8437aca365
---
# hi_isp_awb_ct_limit_attr

#### 说明

定义白平衡的增益范围限制属性。


#### 定义

```
typedef struct {
hi_bool
enable;
hi_op_mode
op_type;
hi_u16
high_rg_limit;
hi_u16
high_bg_limit;
hi_u16
low_rg_limit;
hi_u16
low_bg_limit;
} hi_isp_awb_ct_limit_attr;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| enable | 白平衡的增益范围限制开关。 取值范围： HI\_FALSE:关闭 HI\_TRUE:开启 |
| op\_type | 自动或手动设定白平衡的增益限制。 取值范围： HI\_ISP\_OP\_TYPE\_AUTO：自动模式 HI\_ISP\_OP\_TYPE\_MANUAL：手动模式 |
| high\_rg\_limit | 手动模式下用户设定高色温下的最大R增益，8bit小数精度，取值范围：[0x0, 0xFFF]。 |
| high\_bg\_limit | 手动模式下用户设定高色温下的最小B增益，8bit小数精度，取值范围：[0x0, 0xFFF]。 |
| low\_rg\_limit | 手动模式下用户设定低色温下的最小R增益，8bit小数精度，取值范围：[0x0, high\_rg\_limit)。 |
| low\_bg\_limit | 手动模式下用户设定低色温下的最大B增益，8bit小数精度，取值范围：(high\_bg\_limit, 0xFFF] |


#### 注意事项

- hi_isp_awb_ct_limit_attr结构体定义环境色温超过用户设定的色温范围时，AWB应采取的动作。AWB检测到环境色温超过用户设置的上下限时，相关参数才会生效。
- 支持自动模式和手动模式选择。自动模式下，AWB根据用户校正的色温曲线计算色温上下限色温的AWB增益，以限制R、B通道增益；手动模式下，高色温时，AWB调用high_rg_limit、high_bg_limit参数限制R、B通道增益，低色温时，AWB调用low_rg_limit、low_bg_limit参数限制R、B通道增益。

- 建议用户在进行AWB色温曲线校正时，确定了AWB工作的色温范围后，再确定high_rg_limit、high_bg_limit、low_rg_limit、low_bg_limit四个参数取值。Rg对应Planckian曲线的横坐标值，Bg对应Planckian曲线的纵坐标值。