---
title: hi_isp_sharpen_auto_attr
description: "定义图像锐化的自动属性。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0422.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0422.html
indexId: 3a3f523fca76b6dd2e831e42fcb850f9b2ca5c58d450b14eb44c595baf3f0e3b65
---
# hi_isp_sharpen_auto_attr

#### 说明

定义图像锐化的自动属性。


#### 定义

```
typedef struct {
hi_u8
luma_wgt[HI_ISP_SHARPEN_LUMA_NUM][HI_ISP_AUTO_ISO_NUM];
hi_u16
texture_strength[HI_ISP_SHARPEN_GAIN_NUM][HI_ISP_AUTO_ISO_NUM];
hi_u16
edge_strength[HI_ISP_SHARPEN_GAIN_NUM][HI_ISP_AUTO_ISO_NUM];
hi_u16
texture_freq[HI_ISP_AUTO_ISO_NUM];
hi_u16
edge_freq[HI_ISP_AUTO_ISO_NUM];
hi_u8
over_shoot[HI_ISP_AUTO_ISO_NUM];
hi_u8
under_shoot[HI_ISP_AUTO_ISO_NUM];
hi_u8
shoot_sup_strength[HI_ISP_AUTO_ISO_NUM];
hi_u8
shoot_sup_adj[HI_ISP_AUTO_ISO_NUM];
hi_u8
detail_ctrl[HI_ISP_AUTO_ISO_NUM];
hi_u8
detail_ctrl_threshold[HI_ISP_AUTO_ISO_NUM];
hi_u8
edge_filt_strength[HI_ISP_AUTO_ISO_NUM];
hi_u8
edge_filt_max_cap[HI_ISP_AUTO_ISO_NUM];
hi_u8
r_gain[HI_ISP_AUTO_ISO_NUM];
hi_u8
g_gain[HI_ISP_AUTO_ISO_NUM];
hi_u8
b_gain[HI_ISP_AUTO_ISO_NUM];
hi_u8
skin_gain[HI_ISP_AUTO_ISO_NUM];
hi_u16
max_sharp_gain[HI_ISP_AUTO_ISO_NUM];
} hi_isp_sharpen_auto_attr;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| luma\_wgt[HI\_ISP\_SHARPEN\_LUMA\_NUM][HI\_ISP\_AUTO\_ISO\_NUM] | 亮度锐化权重。 满量程0\-255的亮度被32个等分点平均分为32段亮度区间，每一段亮度区间对应一个亮度权重。比如0\-7的亮度区间的权重是luma\_wgt[0]，8\-15的亮度区间的权重是luma\_wgt[1]，依次类推。如图1所示。值越大，图像锐化程度越高，反之，越弱。 取值范围：[0, 127]，建议值127。 \#define HI\_ISP\_AUTO\_ISO\_NUM 16 \#define HI\_ISP\_SHARPEN\_LUMA\_NUM 32 |
| texture\_strength[HI\_ISP\_SHARPEN\_GAIN\_NUM][HI\_ISP\_AUTO\_ISO\_NUM] | 该参数用于设置图像无方向的细节纹理的锐度。 该值越大，无方向的细节纹理的清晰度越高。该参数是一个HI\_ISP\_SHARPEN\_GAIN\_NUM=32的数组，是一个32段的连续的强度曲线，如图2所示。 取值范围：[0, 4095]，建议值300。 \#define HI\_ISP\_SHARPEN\_GAIN\_NUM 32 |
| edge\_strength[HI\_ISP\_SHARPEN\_GAIN\_NUM][HI\_ISP\_AUTO\_ISO\_NUM] | 该参数用于设置图像带方向的边缘的锐度。 该值越大，带方向的边缘的锐度越高。该参数是一个HI\_ISP\_SHARPEN\_GAIN\_NUM=32 的数组，是一个32段的连续的强度曲线，如图3所示。取值范围：[0, 4095]，建议值400。 |
| texture\_freq[HI\_ISP\_AUTO\_ISO\_NUM] | 该参数用于设置图像的无方向细节纹理的增强频率。 该值越大，细节纹理的增强就越偏向于高频增强，细节纹理就越细碎。反之，该值越小，细节纹理就越粗越圆润。 texture\_freq对应于强度参数texture\_strength。texture\_freq越大，图像的细节纹理就越细碎，该值过大，会导致图像的细节纹理过于细碎而不自然，甚至感觉模糊。 取值范围：[0, 4095]，建议值128。 |
| edge\_freq[HI\_ISP\_AUTO\_ISO\_NUM] | 该参数用于控制图像的带方向的边缘增强频段。 该值越大，边缘的增强就越偏向于高频增强，图像的边缘就越纤薄越窄。反之，该值越小，边缘就越粗越圆润。 edge\_freq对应于强度参数edge\_strength。edge\_freq越大，图像的边缘就越纤薄越窄，该值过大，会导致图像的边缘过于纤薄而出现虚边现象。 取值范围：[0, 4095]，建议值96。 |
| over\_shoot[HI\_ISP\_AUTO\_ISO\_NUM] | 设置图像的overshoot（锐化后的白边白点）的强度。 该值越小，锐化后的白边白点越弱，清晰度也会下降。该值过小，图像会呈油画效果。 取值范围：[0, 127]，建议值100。 |
| under\_shoot[HI\_ISP\_AUTO\_ISO\_NUM] | 设置图像的undershoot（锐化后的黑边黑点）的强度。 该值越小，锐化后的黑边黑点越弱，清晰度也会下降。该值过小，图像会呈油画效果。 取值范围：[0, 127]，建议值127。 |
| shoot\_sup\_strength[HI\_ISP\_AUTO\_ISO\_NUM] | 该参数用于设置图像锐化后的overshoot和undershoot的抑制强度。用于在保证清晰度不明显下降的前提下，抑制锐化后的图像的overshoot和undershoot的宽度和幅度。 该值越大，锐化后的图像的overshoot和undershoot的宽度越窄、强度越小。该值变大，理论上不会影响图像的清晰度，只是黑白边变窄以后，会减弱人眼的锐度感受。 该参数需要和shoot\_sup\_adj配合使用。 取值范围：[0, 255]，建议值8。 |
| shoot\_sup\_adj[HI\_ISP\_AUTO\_ISO\_NUM] | 该参数用于对图像锐化后的overshoot和undershoot的抑制强度进行调节。 该参数配合shoot\_sup\_strength使用，用于调节shoot\_sup\_strength作用的区域范围。该值越小，则越多的纹理区域的shoot会被shoot\_sup\_strength抑制；该值越大，则只有很强的边缘的shoot会被shoot\_sup\_strength抑制，纹理区域的shoot不会被抑制。 取值范围：[0, 15]，建议值9。 |
| detail\_ctrl[HI\_ISP\_AUTO\_ISO\_NUM] | 该参数用于控制图像的细节纹理区域的shoot强度，shoot越大，细节纹理区的清晰度越高。 若该值等于128，则图像的细节纹理区域的shoot强度和大边缘的shoot强度一致，都分别等于over\_shoot和under\_shoot。 若该值大于128，则图像的细节纹理的shoot强度大于大边缘，大边缘的shoot强度分别等于over\_shoot和under\_shoot。 若该值小于128，则图像的细节纹理的shoot强度小于大边缘，大边缘的shoot强度分别等于over\_shoot和under\_shoot。 取值范围：[0, 255]。 |
| detail\_ctrl\_threshold[HI\_ISP\_AUTO\_ISO\_NUM] | 图像的细节纹理区的shoot强度的控制阈值。 该值配合 detail\_ctrl使用，用于区分detail\_ctrl所控制shoot的纹理区和边缘，也即纹理区和边缘的区分阈值。小于该值的区域为纹理区，该纹理区域的shoot会被detail\_ctrl单独控制，而大于该阈值的边缘区域的shoot依然等于over\_shoot和under\_shoot。 取值范围：[0, 0xFF]，建议值0xA0。 |
| edge\_filt\_strength[HI\_ISP\_AUTO\_ISO\_NUM] | 边缘滤波强度调试参数：实现图像锐化边缘的范围和边缘平滑强度的控制。 该值越大，判为边缘的区域越多、也越宽，edge\_strength起作用的图像边缘就越多，而且，该值越大，沿着边缘方向的平滑滤波强度也越大，边缘就越平滑。反之，判为边缘的区域越少、也越窄，edge\_strength起作用的图像区域越少，边缘平滑就越弱。 取值范围：[0, 63]，建议值 53。 |
| edge\_filt\_max\_cap[HI\_ISP\_AUTO\_ISO\_NUM] | 边缘滤波强度范围的调试参数：该值越大，边缘滤波的最大强度也最大，edge\_filt\_strength的可调试范围也越大；一般建议该值大小控制30以内。 取值范围：[0, 47]；建议值 18。 |
| r\_gain[HI\_ISP\_AUTO\_ISO\_NUM] | 深红色区域的锐化增益控制参数。该值越大，则深红色区域的锐化强度越大。 取值范围：[0, 31]；建议值 28。 |
| g\_gain[HI\_ISP\_AUTO\_ISO\_NUM] | 绿色区域的锐化增益控制参数。该值越大，则绿色区域的锐化强度越大。 取值范围：[0, 255]；建议值 32。 |
| b\_gain[HI\_ISP\_AUTO\_ISO\_NUM] | 深蓝色区域的锐化增益控制参数。该值越大，则深蓝色区域的锐化强度越大。 取值范围：[0, 31]；建议值 28。 |
| skin\_gain[HI\_ISP\_AUTO\_ISO\_NUM] | 肤色区域的锐化增益控制参数。该值越大，则肤色区域的锐化强度越大。 取值范围：[0, 31]；建议值 23。 |
| max\_sharp\_gain[HI\_ISP\_AUTO\_ISO\_NUM] | 图像锐化的最大增益限制值。该值越大，图像的锐化幅度越大，反之，锐化幅度越小。适当的调小该参数，可以减少图像的过锐化，可以减少图像锐化后的黑白点。 取值范围：[0, 0x7FF]，建议值 0xA0。 |


#### 注意事项

Auto档参数分别对应sensor在16种不同增益（a_gain*d_gain* isp_d_gain(times)）情况下的设置值，成员参数的含义与Manual档cmos成员参数一致。

16 种增益为：100、200、400、800、1600、3200、6400、12800、25600、51200、102400、204800、409600、819200、1638400、 3276800。