ISP软件开发参考

1. 概述¶

1.1. 模块说明¶

ISP模块是对Video source输入的数据进行分析、处理，设定相关视频参数以及进行Camera的调整，以实现黑电平校正、镜头校正、3A、2D/3D降噪、CCM、Gamma等功能。

1.2. 流程框图¶

Figure 1：ISP Block Diagram

1.3. 关键词说明¶

ISP

Image Signal Processing缩写。图像信号处理单元，负责图像降噪／颜色渲染／亮度调整等功能。
NR

Noise reduction缩写，包含3D降噪、2D降噪。

2D降噪：对一个像素将其与周围像素平均，平均后噪声降低，但缺点是会造成画面模糊。

3D降噪：增添了时域处理，2D降噪只考虑一帧图像，而3D降噪进一步考虑帧与帧之间的时域关系，对每个像素进行时域上的平均。
Lens shading

包含LSC、ALSC，对暗角进行补偿。
SDC

Static Defect Correction，固定位置坏点补偿。
FPN

Fixed Pattern Noise，消除画面出现固定直条纹。
STA

Statistics缩写。
HDR

High Dynamic Range缩写，双帧合成的高动态范围影像。
WDR

Wide Dynamic Range缩写，单帧处理的高动态范围影响。

1.4. YUV Path IQ Description¶

若使用YUV data输入，则只有部分API能使用，如下：

MI_ISP_IQ_SetSharpness

MI_ISP_IQ_SetShpEx

MI_ISP_IQ_SetColorTrans

MI_ISP_IQ_SetNr3d

MI_ISP_IQ_SetNr3dEx

MI_ISP_IQ_SetNrLumaAdv

MI_ISP_IQ_SetNrChromaPre

MI_ISP_IQ_SetNrChromaAdv

MI_ISP_IQ_SetDarkShading

MI_ISP_IQ_SetPfc

MI_ISP_IQ_SetPfcEx

MI_ISP_IQ_SetYuvGamma

MI_ISP_IQ_SetSaturation

MI_ISP_IQ_SetColorToGray

MI_ISP_IQ_GetTempInfo

注意事项：

此应用没有motion信息，所以若API内有根据motion调整的功能，在此应用下会失效，motion信息停留在最动的地方。

举例：

参数	描述
u8GainByMot[SHARPNESS_EX_BY_MOT_NUM]	SHARPNESS_EX_BY_MOT_NUM = 16。依据motion调整最终edge强度增益，值域范围：0 ~ 255，横轴为motion，越右边越偏静，纵轴为edge增益（128 = 1x），值越大则edge越强。

以sharpness的API内的这个参数为例，此功能只会作用在横轴的最左边，也就是index = 0的地方（u8GainByMot[0]）。

AE、AWB、AF都不会作用，所以IQ根据ISO做查表的动作也不会有，IQ API建议设为Manual mode。

2. MI ISP API参考¶

2.1. MI_ISP_IQ_GetVersionInfo¶

目的

取得IQ版本号信息。

语法

MI_S32 MI_ISP_IQ_GetVersionInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_VersionInfoType_t *data);

描述

调用此函式取得IQ版本号信息。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data IQ版本号信息的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.2. MI_ISP_IQ_SetVersionInfo¶

目的

设定IQ版本号信息。

语法

MI_S32 MI_ISP_IQ_SetVersionInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_VersionInfoType_t *data);

描述

调用此函式设定IQ版本号信息。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 彩色转灰阶影像参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.3. MI_ISP_IQ_GetParaInitStatus¶

目的

取得ISP初始化ready状态的参数值。

语法

MI_S32 MI_ISP_IQ_GetParaInitStatus(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ParamInitInfoType_t *data);

描述

调用此函式取得ISP初始化ready状态的参数值，只有查询到状态为ready (1)时，才能进行load ISP API bin file或者call ISP API function。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data ISP初始化参数值的指标。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

举例

MI_SYS_INIT();
While(1)
{
    MI_ISP_IQ_GetParaInitStatus (0, &FLAG);
    If(FLAG ==1)
    {
        break;
    }
}

2.4. MI_ISP_IQ_SetColorToGray¶

目的

设定彩色转灰阶影像参数值。

语法

MI_S32 MI_ISP_IQ_SetColorToGray(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ColorToGrayType_t *data);

描述

调用此函式设定彩色转灰阶影像参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 彩色转灰阶影像参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.5. MI_ISP_IQ_GetColorToGray¶

目的

取得彩色转灰阶影像参数值。

语法

MI_S32 MI_ISP_IQ_GetColorToGray(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ColorToGrayType_t *data);

描述

调用此函式取得彩色转灰阶影像参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 彩色转灰阶影像参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.6. MI_ISP_IQ_SetContrast¶

目的

设定对比度参数值。

语法

MI_S32 MI_ISP_IQ_SetContrast(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ContrastType_t *data);

描述

调用此函式设定对比度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 对比度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.7. MI_ISP_IQ_GetContrast¶

目的

取得对比度参数值。

语法

MI_S32 MI_ISP_IQ_GetContrast(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ContrastType_t *data);

描述

调用此函式取得对比度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 对比度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.8. MI_ISP_IQ_SetBrightness¶

目的

设定亮度参数值。

语法

MI_S32 MI_ISP_IQ_SetBrightness(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_BrightnessType_t *data);

描述

调用此函式设定亮度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 亮度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.9. MI_ISP_IQ_GetBrightness¶

目的

取得亮度参数值。

语法

MI_S32 MI_ISP_IQ_GetBrightness(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_BrightnessType_t *data);

描述

调用此函式取得亮度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 亮度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.10. MI_ISP_IQ_SetLightness¶

目的

设定灰度参数值。

语法

MI_S32 MI_ISP_IQ_SetLightness(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_LightnessType_t *data);

描述

调用此函式设定灰度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 灰度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.11. MI_ISP_IQ_GetLightness¶

目的

取得灰度参数值。

语法

MI_S32 MI_ISP_IQ_GetLightness(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_LightnessType_t *data);

描述

调用此函式取得灰度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 灰度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.12. MI_ISP_IQ_SetRgbGamma¶

目的

设定RGB Gamma curve参数值。

语法

MI_S32 MI_ISP_IQ_SetRgbGamma(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_RgbGammaType_t *data);

描述

调用此函式设定RGB Gamma curve参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data RGB Gamma curve参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.13. MI_ISP_IQ_GetRgbGamma¶

目的

取得RGB Gamma curve参数值。

语法

MI_S32 MI_ISP_IQ_GetRgbGamma(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_RgbGammaType_t *data);

描述

调用此函式取得RGB Gamma curve参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data RGB Gamma curve参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.14. MI_ISP_IQ_SetYuvGamma¶

目的

设定YUV Gamma curve参数值。

语法

MI_S32 MI_ISP_IQ_SetYuvGamma(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_YuvGammaType_t *data);

描述

调用此函式设定YUV Gamma curve参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data YUV Gamma curve参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.15. MI_ISP_IQ_GetYuvGamma¶

目的

取得YUV Gamma curve参数值。

语法

MI_S32 MI_ISP_IQ_GetYuvGamma(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_YuvGammaType_t *data);

描述

调用此函式取得YUV Gamma curve参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data YUV Gamma curve参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.16. MI_ISP_IQ_SetSaturation¶

目的

设定饱和度参数值。

语法

MI_S32 MI_ISP_IQ_SetSaturation(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_SaturationType_t *data);

描述

调用此函式设定饱和度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 饱和度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.17. MI_ISP_IQ_GetSaturation¶

目的

取得饱和度参数值。

语法

MI_S32 MI_ISP_IQ_GetSaturation(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_SaturationType_t *data);

描述

调用此函式取得饱和度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 饱和度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.18. MI_ISP_IQ_SetDefog¶

目的

设定Defog参数值。

语法

MI_S32 MI_ISP_IQ_SetDefog(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DefogType_t *data);

描述

调用此函式设定Defog参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Defog参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.19. MI_ISP_IQ_GetDefog¶

目的

取得Defog参数值。

语法

MI_S32 MI_ISP_IQ_GetDefog(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DefogType_t *data);

描述

调用此函式取得Defog参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Defog参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.20. MI_ISP_IQ_SetRgbMatrix¶

目的

设定色彩校正矩阵参数值。

语法

MI_S32 MI_ISP_IQ_SetRgbMatrix(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_RgbMatrixType_t *data);

描述

调用此函式设定色彩校正矩阵参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 色彩校正矩阵参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.21. MI_ISP_IQ_GetRgbMatrix¶

目的

取得色彩校正矩阵参数值。

语法

MI_S32 MI_ISP_IQ_GetRgbMatrix(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_RgbMatrixType_t *data);

描述

调用此函式取得色彩校正矩阵参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 色彩校正矩阵参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.22. MI_ISP_IQ_SetFalseColor¶

目的

设定去伪彩参数值。

语法

MI_S32 MI_ISP_IQ_SetFalseColor(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_FalseColorType_t *data);

描述

调用此函式设定去伪彩参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 去伪彩参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.23. MI_ISP_IQ_GetFalseColor¶

目的

取得去伪彩参数值。

语法

MI_S32 MI_ISP_IQ_GetFalseColor(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_FalseColorType_t *data);

描述

调用此函式取得去伪彩参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 去伪彩参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.24. MI_ISP_IQ_SetNr3d¶

目的

设定3D降噪参数值。

语法

MI_S32 MI_ISP_IQ_SetNr3d(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_Nr3dType_t *data);

描述

调用此函式设定3D降噪参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 3D降噪参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.25. MI_ISP_IQ_GetNr3d¶

目的

取得3D降噪参数值。

语法

MI_S32 MI_ISP_IQ_GetNr3d(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_Nr3dType_t *data);

描述

调用此函式取得3D降噪参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 3D降噪参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.26. MI_ISP_IQ_SetNr3dEx¶

目的

设定NR3D_EX参数值，包含一些较少调适或是不用by iso调整的参数。

语法

MI_S32 MI_ISP_IQ_SetNr3dEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_Nr3dExType_t *data);

描述

调用此函式设定NR3D_EX参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data NR3D_EX参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.27. MI_ISP_IQ_GetNr3dEx¶

目的

取得NR3D_EX参数值，包含一些较少调适或是不用by iso调整的参数。

语法

MI_S32 MI_ISP_IQ_GetNr3dEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_Nr3dExType_t *data);

描述

调用此函式取得NR3D_EX参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data NR3D_EX参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.28. MI_ISP_IQ_SetNrDeSpike¶

目的

设定DeSpike降噪参数值。

语法

MI_S32 MI_ISP_IQ_SetNrDeSpike(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrDespikeType_t *data);

描述

调用此函式设定DeSpike降噪参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data DeSpike降噪参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.29. MI_ISP_IQ_GetNrDeSpike¶

目的

取得DeSpike降噪参数值。

语法

MI_S32 MI_ISP_IQ_GetNrDeSpike(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrDespikeType_t *data);

描述

调用此函式取得DeSpike降噪参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data DeSpike降噪参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.30. MI_ISP_IQ_SetSharpness¶

目的

设定锐度参数值。

语法

MI_S32 MI_ISP_IQ_SetSharpness(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ShapnessType_t *data);

描述

调用此函式设定锐度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 锐度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.31. MI_ISP_IQ_GetSharpness¶

目的

取得锐度参数值。

语法

MI_S32 MI_ISP_IQ_GetSharpness(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ShapnessType_t *data);

描述

调用此函式取得锐度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 锐度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.32. MI_ISP_IQ_SetShpEx¶

目的

设定锐度参数值。

语法

MI_S32 MI_ISP_IQ_SetShpEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ShapnessExType_t *data);

描述

调用此函式设定锐度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 锐度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.33. MI_ISP_IQ_GetShpEx¶

目的

取得锐度参数值。

语法

MI_S32 MI_ISP_IQ_GetShpEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ShapnessExType_t *data);

描述

调用此函式取得锐度参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 锐度参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.34. MI_ISP_IQ_SetCrossTalk¶

目的

设定串扰参数值。

语法

MI_S32 MI_ISP_IQ_SetCrossTalk(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_CrosstalkType_t *data);

描述

调用此函式设定串扰参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 串扰参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.35. MI_ISP_IQ_GetCrossTalk¶

目的

取得串扰参数值。

语法

MI_S32 MI_ISP_IQ_GetCrossTalk(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_CrosstalkType_t *data);

描述

调用此函式取得串扰参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 串扰参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.36. MI_ISP_IQ_SetObc¶

目的

设定黑电平参数值。

语法

MI_S32 MI_ISP_IQ_SetObc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ObcType_t *data);

描述

调用此函式设定黑电平参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 黑电平参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.37. MI_ISP_IQ_GetObc¶

目的

取得黑电平参数值。

语法

MI_S32 MI_ISP_IQ_GetObc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ObcType_t *data);

描述

调用此函式取得黑电平参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 黑电平参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.38. MI_ISP_IQ_SetObcP1¶

目的

设定Pipeline 1黑电平参数值。

语法

MI_S32 MI_ISP_IQ_SetObcP1(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ObcType_t *data);

描述

调用此函式设定Pipeline 1黑电平参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Pipeline 1黑电平参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.39. MI_ISP_IQ_GetObcP1¶

目的

取得Pipeline 1黑电平参数值。

语法

MI_S32 MI_ISP_IQ_GetObcP1(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ObcType_t *data);

描述

调用此函式取得Pipeline 1黑电平参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Pipeline 1黑电平参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.40. MI_ISP_IQ_SetWdr¶

目的

设定宽动态参数值。

语法

MI_S32 MI_ISP_IQ_SetWdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrType_t *data);

描述

调用此函式设定宽动态参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 宽动态参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.41. MI_ISP_IQ_GetWdr¶

目的

取得宽动态参数值。

语法

MI_S32 MI_ISP_IQ_GetWdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrType_t *data);

描述

调用此函式取得宽动态参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 宽动态参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.42. MI_ISP_IQ_SetWdrLtm¶

目的

设定宽动态LTM（Local Tone Mapping）参数值。

语法

MI_S32 MI_ISP_IQ_SetWdrLtm(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrLtmType_t *data);

描述

调用此函式设定宽动态LTM参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 宽动态LTM参数值的指标。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.43. MI_ISP_IQ_GetWdrLtm¶

目的

取得宽动态LTM（Local Tone Mapping）参数值。

语法

MI_S32 MI_ISP_IQ_GetWdrLtm(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrLtmType_t *data);

描述

调用此函式取得宽动态LTM参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 宽动态LTM参数值的指标。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.44. MI_ISP_IQ_SetWdrNr¶

目的

设定宽动态降噪参数值。

语法

MI_S32 MI_ISP_IQ_SetWdrNr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrNrType_t *data);

描述

调用此函式设定宽动态降噪参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 宽动态降噪参数值的指标。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.45. MI_ISP_IQ_GetWdrNr¶

目的

取得宽动态降噪参数值。

语法

MI_S32 MI_ISP_IQ_GetWdrNr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrNrType_t *data);

描述

调用此函式取得宽动态参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 宽动态降噪参数值的指标。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.46. MI_ISP_IQ_SetWdrCurveFull¶

目的

设定WDRCurveFull参数值。

语法

MI_S32 MI_ISP_IQ_SetWdrCurveFull(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrCurveFullType_t *data);

描述

调用此函式设定WDRCurveFull参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data WDRCurveFull参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.47. MI_ISP_IQ_GetWdrCurveFull¶

目的

取得WDRCurveFull参数值。

语法

MI_S32 MI_ISP_IQ_GetWdrCurveFull(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrCurveFullType_t *data);

描述

调用此函式取得WDRCurveFull参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data WDRCurveFull参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.48. MI_ISP_IQ_SetDynamicDp¶

目的

设定动态补偿坏点参数值。

语法

MI_S32 MI_ISP_IQ_SetDynamicDp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DynamicDpType_t *data);

描述

调用此函式设定动态补偿坏点参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 动态补偿坏点参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.49. MI_ISP_IQ_GetDynamicDp¶

目的

取得动态补偿坏点参数值。

语法

MI_S32 MI_ISP_IQ_GetDynamicDp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DynamicDpType_t *data);

描述

调用此函式取得动态补偿坏点参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 动态补偿坏点参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.50. MI_ISP_IQ_SetDynamicDpCluster¶

目的

设定动态补偿坏点参数值。

语法

MI_S32 MI_ISP_IQ_SetDynamicDpCluster(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DynamicDpClusterType_t *data);

描述

调用此函式设定动态补偿坏点参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 动态补偿坏点参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.51. MI_ISP_IQ_GetDynamicDpCluster¶

目的

取得动态补偿坏点参数值。

语法

MI_S32 MI_ISP_IQ_GetDynamicDpCluster(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DynamicDpClusterType_t *data);

描述

调用此函式取得动态补偿坏点参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 动态补偿坏点参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.52. MI_ISP_IQ_SetHsv¶

目的

设定HSV参数值，可做局部色相的旋转与饱和度的增减。

语法

MI_S32 MI_ISP_IQ_SetHsv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HsvType_t *data);

描述

调用此函式设定HSV参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data HSV参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.53. MI_ISP_IQ_GetHsv¶

目的

取得HSV参数值。

语法

MI_S32 MI_ISP_IQ_GetHsv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HsvType_t *data);

描述

调用此函式取得HSV参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data HSV参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.54. MI_ISP_IQ_SetRgbir¶

目的

设定RGB-IR参数值。

语法

MI_S32 MI_ISP_IQ_SetRgbir(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_RgbirType_t *data);

描述

调用此函式设定RGB-IR参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data RGB-IR参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.55. MI_ISP_IQ_GetRgbir¶

目的

取得RGB-IR参数值。

语法

MI_S32 MI_ISP_IQ_GetRgbir(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_RgbirType_t *data);

描述

调用此函式取得RGB-IR参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data RGB-IR参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.56. MI_ISP_IQ_SetFpn¶

目的

消除画面出现固定直条纹（Fixed Pattern Noise），设定固定直条纹参数值。

语法

MI_S32 MI_ISP_IQ_SetFpn(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_FpnType_t *data);

描述

调用此函式设定固定直条纹参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 固定直条纹参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.57. MI_ISP_IQ_GetFpn¶

目的

消除画面出现固定直条纹（Fixed Pattern Noise），取得固定直条纹参数值。

语法

MI_S32 MI_ISP_IQ_GetFpn(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_FpnType_t *data);

描述

调用此函式取得固定直条纹参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 固定直条纹参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 函式庫：libmi_isp.so

2.58. MI_ISP_IQ_SetPfc¶

目的

设定PFC参数值。

语法

MI_S32 MI_ISP_IQ_SetPfc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_PfcType_t *data);

描述

调用此函式设定PFC参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data PFC参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.59. MI_ISP_IQ_GetPfc¶

目的

取得PFC参数值。

语法

MI_S32 MI_ISP_IQ_GetPfc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_PfcType_t *data);

描述

调用此函式取得PFC参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data PFC参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.60. MI_ISP_IQ_SetPfcEx¶

目的

设定PFC_EX参数值，包含一些较少调适或是不用by iso调整的参数。

语法

MI_S32 MI_ISP_IQ_SetPfcEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_PfcExType_t *data);

描述

调用此函式设定PFC_EX参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data PFC_EX参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.61. MI_ISP_IQ_GetPfcEx¶

目的

取得PFC_EX参数值，包含一些较少调适或是不用by iso调整的参数。

语法

MI_S32 MI_ISP_IQ_GetPfcEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_PfcExType_t *data);

描述

调用此函式取得PFC_EX参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data PFC_EX参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.62. MI_ISP_IQ_SetDemosaic¶

目的

设定去马赛克参数值。

语法

MI_S32 MI_ISP_IQ_SetDemosaic(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DemosaicType_t *data);

描述

调用此函式设定去马赛克参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 去马赛克参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.63. MI_ISP_IQ_GetDemosaic¶

目的

取得去马赛克参数值。

语法

MI_S32 MI_ISP_IQ_GetDemosaic(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DemosaicType_t *data);

描述

调用此函式取得去马赛克参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 去马赛克参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.64. MI_ISP_IQ_SetR2Y¶

目的

设定色彩转换参数值。

语法

MI_S32 MI_ISP_IQ_SetR2Y(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_R2YType_t *data);

描述

调用此函式设定色彩转换参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 色彩转换参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.65. MI_ISP_IQ_GetR2Y¶

目的

取得色彩转换参数值。

语法

MI_S32 MI_ISP_IQ_GetR2Y(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_R2YType_t *data);

描述

调用此函式取得色彩转换参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 色彩转换参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 函式庫：libmi_isp.so

2.66. MI_ISP_IQ_SetColorTrans¶

目的

设定色彩转换参数值。

语法

MI_S32 MI_ISP_IQ_SetColorTrans(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ColorTransType_t *data);

描述

调用此函式设定色彩转换参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 色彩转换参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.67. MI_ISP_IQ_GetColorTrans¶

目的

取得色彩转换参数值。

语法

MI_S32 MI_ISP_IQ_GetColorTrans(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ColorTransType_t *data);

描述

调用此函式取得色彩转换参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 色彩转换参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.68. MI_ISP_IQ_SetColorTrans_EX¶

目的

设定色彩转换参数值。

语法

MI_S32 MI_ISP_IQ_SetColorTrans_EX(MI_U32 DevId, 
MI_U32 Channel, MI_ISP_IQ_CTExType_t *data);

描述

调用此函式设定色彩转换参数值。
参数

参数名称描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 色彩转换参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so
注意

相较于ColorTrans可以弹性的设置RGB to YUV的转换矩阵，ColorTrans_EX仅提供0~5种公定的转换类型可以选择。若有将ColorTrans_EX开启，ColorTrans则失效。

2.69. MI_ISP_IQ_GetColorTrans_EX¶

目的

取得色彩转换参数值。

语法

MI_S32 MI_ISP_IQ_GetColorTrans(MI_U32 DevId, 
MI_U32 Channel, MI_ISP_IQ_CTExType_t *data);

描述

调用此函式取得色彩转换参数值。
参数

参数名称描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 色彩转换参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so
注意

相较于ColorTrans可以弹性的设置RGB to YUV的转换矩阵，ColorTrans_EX仅提供0~5种公定的类型可以选择。若有将ColorTrans_EX开启，ColorTrans则失效。

2.70. MI_ISP_IQ_SetHdr¶

目的

设定高动态范围（High Dynamic Range）参数值。

语法

MI_S32 MI_ISP_IQ_SetHdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HdrType_t *data);

描述

调用此函式设定高动态范围（High Dynamic Range）参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 高动态范围（High Dynamic Range）参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.71. MI_ISP_IQ_GetHdr¶

目的

取得高动态范围（High Dynamic Range）参数值。

语法

MI_S32 MI_ISP_IQ_GetHdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HdrType_t *data);

描述

调用此函式取得高动态范围（High Dynamic Range）参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 高动态范围（High Dynamic Range）参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.72. MI_ISP_IQ_SetHdrEx¶

目的

设定HDR_EX参数值，包含一些较少调适或是不用by iso调整的参数。

语法

MI_S32 MI_ISP_IQ_SetHdrEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HdrExType_t *data);

描述

调用此函式设定HDR_EX参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data HDR_EX参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.73. MI_ISP_IQ_GetHdrEx¶

目的

取得HDR_EX参数值，包含一些较少调适或是不用by iso调整的参数。

语法

MI_S32 MI_ISP_IQ_GetHdrEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HdrExType_t *data);

描述

调用此函式取得HDR_EX参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data HDR_EX参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.74. MI_ISP_IQ_SetLsc¶

目的

设定LSC参数值。

语法

MI_S32 MI_ISP_IQ_SetLsc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_LscType_t *data);

描述

调用此函式设定LSC参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data LSC参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.75. MI_ISP_IQ_GetLsc¶

目的

取得LSC参数值。

语法

MI_S32 MI_ISP_IQ_GetLsc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_LscType_t *data);

描述

调用此函式取得LSC参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data LSC参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.76. MI_ISP_IQ_SetLscCtrl¶

目的

设定LSC CTRL参数值。

语法

MI_S32 MI_ISP_IQ_SetLscCtrl(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_LscCtrlType_t *data);

描述

调用此函式设定LSC CTRL参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data LSC CTRL参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.77. MI_ISP_IQ_GetLscCtrl¶

目的

取得LSC CTRL参数值。

语法

MI_S32 MI_ISP_IQ_GetLscCtrl(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_LscCtrlType_t *data);

描述

调用此函式取得LSC CTRL参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data LSC CTRL参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.78. MI_ISP_IQ_SetAlsc¶

目的

设定ALSC参数值。

语法

MI_S32 MI_ISP_IQ_SetAlsc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_AlscType_t *data);

描述

调用此函式设定ALSC参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data ALSC参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.79. MI_ISP_IQ_GetAlsc¶

目的

取得ALSC参数值。

语法

MI_S32 MI_ISP_IQ_GetAlsc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_AlscType_t *data);

描述

调用此函式取得ALSC参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data ALSC参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.80. MI_ISP_IQ_SetAlscCtrl¶

目的

设定ALSC CTRL参数值。

语法

MI_S32 MI_ISP_IQ_SetAlscCtrl(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_AlscCtrlType_t *data);

描述

调用此函式设定ALSC CTRL参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data ALSC CTRL参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.81. MI_ISP_IQ_GetAlscCtrl¶

目的

取得ALSC CTRL参数值。

语法

MI_S32 MI_ISP_IQ_GetAlscCtrl(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_AlscCtrlType_t *data);

描述

调用此函式取得ALSC参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data ALSC参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.82. MI_ISP_IQ_SetDarkShading¶

目的

设定Dark Shading参数值。

语法

MI_S32 MI_ISP_IQ_SetDarkShading(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DarkShadingType_t *data);

描述

调用此函式设定Dark Shading参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data DarkShading参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.83. MI_ISP_IQ_GetDarkShading¶

目的

取得Dark Shading参数值。

语法

MI_S32 MI_ISP_IQ_GetDarkShading(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DarkShadingType_t *data);

描述

调用此函式取得Dark Shading参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data DarkShading参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.84. MI_ISP_IQ_SetNrLumaAdv¶

目的

设定NRLuma_Adv参数值。

语法

MI_S32 MI_ISP_IQ_SetNrLumaAdv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrLumaAdvType_t *data);

描述

调用此函式设定NRLuma_Adv参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data NRLumaAdv参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.85. MI_ISP_IQ_GetNrLumaAdv¶

目的

取得NRLuma_Adv参数值。

语法

MI_S32 MI_ISP_IQ_GetNrLumaAdv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrLumaAdvType_t *data);

描述

调用此函式取得NRLuma_Adv参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data NRLumaAdv参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.86. MI_ISP_IQ_SetNrChromaAdv¶

目的

设定NRChroma_Adv参数值。

语法

MI_S32 MI_ISP_IQ_SetNrChromaAdv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrChromaAdvType_t *data);

描述

调用此函式设定NRChroma_Adv参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data NRChromaAdv参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.87. MI_ISP_IQ_GetNrChromaAdv¶

目的

取得NRChroma_Adv参数值。

语法

MI_S32 MI_ISP_IQ_GetNrChromaAdv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrChromaAdvType_t *data);

描述

调用此函式取得NRChroma_Adv参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data NRChromaAdv参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.88. MI_ISP_IQ_SetNrChromaPre¶

目的

设定NRChroma_Pre参数值。

语法

MI_S32 MI_ISP_IQ_SetNrChromaPre(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrChromaPreType_t *data);

描述

调用此函式设定NRChroma_Pre参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data NRChroma_Pre参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.89. MI_ISP_IQ_GetNrChromaPre¶

目的

取得NRChroma_Pre参数值。

语法

MI_S32 MI_ISP_IQ_GetNrChromaPre(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrChromaPreType_t *data);

描述

调用此函式取得NRChroma_Pre参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data NRChroma_Pre参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.90. MI_ISP_IQ_SetDummy¶

目的

设定DUMMY参数值，开一个空的通道，必要时再串接起来，减少进板不兼容或是需要进版的问题。

语法

MI_S32 MI_ISP_IQ_SetDummy(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DummyType_t *data);

描述

调用此函式设定DUMMY参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data DUMMY参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.91. MI_ISP_IQ_GetDummy¶

目的

取得DUMMY参数值，开一个空的通道，必要时再串接起来，减少进板不兼容或是需要进版的问题。

语法

MI_S32 MI_ISP_IQ_GetDummy(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DummyType_t *data);

描述

调用此函式取得DUMMY参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data DUMMY参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.92. MI_ISP_IQ_SetDummyEx¶

目的

设定DUMMY_EX参数值，开一个空的通道，必要时再串接起来，减少进板不兼容或是需要进版的问题。

语法

MI_S32 MI_ISP_IQ_SetDummyEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DummyExType_t *data);

描述

调用此函式设定DUMMY_EX参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data DUMMY_EX参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.93. MI_ISP_IQ_GetDummyEx¶

目的

取得DUMMY_EX参数值，开一个空的通道，必要时再串接起来，减少进板不兼容或是需要进版的问题。

语法

MI_S32 MI_ISP_IQ_GetDummyEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DummyExType_t *data);

描述

调用此函式取得DUMMY_EX参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data DUMMY_EX参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.94. MI_ISP_IQ_SetIqMode¶

目的

设定IQ模式参数值，目前仅提供Day/Night Mode，只适用于RGB-IR夜视。

语法

MI_S32 MI_ISP_IQ_SetIqMode(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ParamMode_e *data);

描述

调用此函式设定IQ模式参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data IQ模式参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.95. MI_ISP_IQ_GetIqMode¶

目的

取得IQ模式参数值，目前仅提供Day/Night Mode，只适用于RGB-IR夜视。

语法

MI_S32 MI_ISP_IQ_GetIqMode(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ParamMode_e *data);

描述

调用此函式取得IQ模式参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data IQ模式参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.96. MI_ISP_IQ_GetIqInd¶

目的

取得曝光指数（ISO index）参数值。

语法

MI_S32 MI_ISP_IQ_GetIqInd(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_Index_e *data);

描述

调用此函式取得曝光指数（ISO index）参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光指数（ISO index）参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.97. MI_ISP_IQ_SetApiBypassMode¶

目的

设定ISP对应IP模块的略过模式（Bypass Mode）参数值。

语法

MI_S32 MI_ISP_IQ_SetApiBypassMode(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ApiBypassType_t *data);

描述

调用此函式设定ISP对应IP模块的略过模式参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data ISP对应IP模块的略过模式参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.98. MI_ISP_IQ_GetApiBypassMode¶

目的

取得ISP对应IP模块的略过模式（Bypass Mode）参数值。

语法

MI_S32 MI_ISP_IQ_GetApiBypassMode(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ApiBypassType_t *data);

描述

调用此函式取得ISP对应IP模块的略过模式参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data ISP对应IP模块的略过模式参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.99. MI_ISP_IQ_QueryCcmInfo¶

目的

取得当前色温的CCM参数值。

语法

MI_S32 MI_ISP_IQ_QueryCcmInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_CcmInfoType_t *data);

描述

调用此函式取得当前色温的CCM参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 当前色温的CCM参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.100. MI_ISP_IQ_SetAdaptiveGamma¶

目的

此功能需搭配StrategyEx，让Gamma可以根据AE SceneTarget做动态的调整，以达到增加动态范围的效果。

语法

MI_S32 MI_ISP_IQ_SetAdaptiveGamma(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_AdaptiveGammaType_t *data);

描述

调用此函式设定Adaptive Gamma curve参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Adaptive Gamma curve参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.101. MI_ISP_IQ_GetAdaptiveGamma¶

目的

取得Adaptive Gamma curve参数值。

语法

MI_S32 MI_ISP_IQ_GetAdaptiveGamma(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_AdaptiveGammaType_t *data);

描述

调用此函式取得Adaptive Gamma curve参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Adaptive Gamma curve参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.102. MI_ISP_IQ_SetTemp¶

目的

设定Temperature参数值。

语法

MI_S32 MI_ISP_IQ_SetTemp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_TempType_t *data);

描述

调用此函式设定Temperature参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Temperature参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.103. MI_ISP_IQ_GetTemp¶

目的

取得Temperature参数值。

语法

MI_S32 MI_ISP_IQ_GetTemp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_TempType_t *data);

描述

调用此函式取得Temperature参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Temperature参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.104. MI_ISP_IQ_GetTempInfo¶

目的

取得 Temperature Info参数值。

语法

MI_S32 MI_ISP_IQ_GetTempInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_TempInfoType_t *data);

描述

调用此函式取得Temperature Info参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Temperature Info参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.105. MI_ISP_IQ_SetDayNightDetection¶

目的

设定Day/Night侦测数值。

语法

MI_S32 MI_ISP_IQ_SetDayNightDetection(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DaynightDetectionType_t *data);

描述

调用此函式设定Day/Night侦测数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.106. MI_ISP_IQ_GetDayNightDetection¶

目的

取得Day/Night侦测数值。

语法

MI_S32 MI_ISP_IQ_GetDayNightDetection(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DaynightDetectionType_t *data);

描述

调用此函式取得Day/Night侦测数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.107. MI_ISP_IQ_QueryDayNightInfo¶

目的

取得Day/Night侦测结果。

语法

MI_ISP_IQ_QueryDayNightInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DaynightInfoType_t *data);

描述

调用此函式取得Day / Night侦测结果。要注意此API只是显示侦测结果，用户仍须自行根据侦测结果做对应的动作，例如load Day bin file或Night bin file，IR灯的控制等等。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_iq.h
- 库文件：libmi_isp.so

2.108. MI_ISP_AE_QueryExposureInfo¶

目的

取得自动曝光参数值。

语法

MI_S32 MI_ISP_AE_QueryExposureInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoInfoType_t *data);

描述

调用此函式取得自动曝光参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动曝光参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.109. MI_ISP_AE_GetHistoWghtY¶

目的

取得当前画面亮度及直方图统计资料数值。

语法

MI_S32 MI_ISP_AE_GetHistoWghtY(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_HistWeightYType_t *data);

描述

调用此函式取得当前画面亮度及直方图统计资料数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 当前画面亮度及直方图统计资料数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.110. MI_ISP_AE_SetEvComp¶

目的

设定曝光补偿参数值。

语法

MI_S32 MI_ISP_AE_SetEvComp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_EvCompType_t *data);

描述

调用此函式设定曝光补偿参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光补偿参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.111. MI_ISP_AE_GetEvComp¶

目的

取得曝光补偿参数值。

语法

MI_S32 MI_ISP_AE_GetEvComp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_EvCompType_t *data);

描述

调用此函式取得曝光补偿参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光补偿参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.112. MI_ISP_AE_SetExpoMode¶

目的

设定曝光模式参数值。

语法

MI_S32 MI_ISP_AE_SetExpoMode(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ModeType_e *data);

描述

调用此函式设定曝光模式参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光模式参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.113. MI_ISP_AE_GetExpoMode¶

目的

取得曝光模式参数值。

语法

MI_S32 MI_ISP_AE_GetExpoMode(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ModeType_e *data);

描述

调用此函式取得曝光模式参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光模式参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.114. MI_ISP_AE_SetManualExpo¶

目的

设定手动曝光参数值。

语法

MI_S32 MI_ISP_AE_SetManualExpo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoValueType_t *data);

描述

调用此函式设定手动曝光参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 手动曝光参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.115. MI_ISP_AE_GetManualExpo¶

目的

取得手动曝光参数值。

语法

MI_S32 MI_ISP_AE_GetManualExpo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoValueType_t *data);

描述

调用此函式取得手动曝光参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 手动曝光参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.116. MI_ISP_AE_SetManualShortExpo¶

目的

设定手动短曝曝光参数值。

语法

MI_S32 MI_ISP_AE_SetManualShortExpo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoValueType_t *data);

描述

调用此函式设定手动短曝曝光参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 手动短曝曝光参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.117. MI_ISP_AE_GetManualShortExpo¶

目的

取得手动短曝曝光参数值。

语法

MI_S32 MI_ISP_AE_GetManualShortExpo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoValueType_t *data);

描述

调用此函式取得手动短曝曝光参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 手动短曝曝光参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.118. MI_ISP_AE_SetState¶

目的

设定自动曝光运作状态参数值。

语法

MI_S32 MI_ISP_AE_SetState(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_SmStateType_e *data);

描述

调用此函式设定自动曝光运作状态参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动曝光运作状态参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.119. MI_ISP_AE_GetState¶

目的

取得自动曝光运作状态参数值。

语法

MI_S32 MI_ISP_AE_GetState(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_SmStateType_e *data);

描述

调用此函式取得自动曝光运作状态参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动曝光运作状态参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.120. MI_ISP_AE_SetTarget¶

目的

设定不同环境亮度（BV）值下的画面曝光目标参数值。

语法

MI_S32 MI_ISP_AE_SetTarget(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_IntpLutType_t *data);

描述

调用此函式设定曝光目标参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光目标参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.121. MI_ISP_AE_GetTarget¶

目的

取得不同环境亮度（BV）值下的画面曝光目标参数值。

语法

MI_S32 MI_ISP_AE_GetTarget(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_IntpLutType_t *data);

描述

调用此函式取得曝光目标参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光目标参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.122. MI_ISP_AE_SetConverge¶

目的

设定曝光收敛参数值。

语法

MI_S32 MI_ISP_AE_SetConverge(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ConvConditonType_t *data);

描述

调用此函式设定曝光收敛参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光收敛参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.123. MI_ISP_AE_GetConverge¶

目的

取得曝光收敛参数值。

语法

MI_S32 MI_ISP_AE_GetConverge(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ConvConditonType_t *data);

描述

调用此函式取得曝光收敛参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光收敛参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.124. MI_ISP_AE_SetExposureLimit¶

目的

设定自动曝光变化范围限制参数值。

语法

MI_S32 MI_ISP_AE_SetExposureLimit(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoLimitType_t *data);

描述

调用此函式设定自动曝光变化范围限制参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动曝光变化范围限制参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.125. MI_ISP_AE_GetExposureLimit¶

目的

取得自动曝光变化范围限制参数值。

语法

MI_S32 MI_ISP_AE_GetExposureLimit(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoLimitType_t *data);

描述

调用此函式取得自动曝光变化范围限制参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动曝光变化范围限制参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.126. MI_ISP_AE_SetPlainLongExpoTable¶

目的

设定长曝曝光表参数值。

语法

MI_S32 MI_ISP_AE_SetPlainLongExpoTable(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoTableType_t *data);

描述

调用此函式设定长曝曝光表参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 长曝曝光表参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.127. MI_ISP_AE_GetPlainLongExpoTable¶

目的

取得长曝曝光表参数值。

语法

MI_S32 MI_ISP_AE_GetPlainLongExpoTable(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoTableType_t *data);

描述

调用此函式取得长曝曝光表参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 长曝曝光表参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.128. MI_ISP_AE_SetPlainShortExpoTable¶

目的

设定短曝曝光表参数值。

语法

MI_S32 MI_ISP_AE_SetPlainShortExpoTable(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoTableType_t *data);

描述

调用此函式设定短曝曝光表参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 短曝曝光表参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.129. MI_ISP_AE_GetPlainShortExpoTable¶

目的

取得短曝曝光表参数值。

语法

MI_S32 MI_ISP_AE_GetPlainShortExpoTable(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoTableType_t *data);

描述

调用此函式取得短曝曝光表参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 短曝曝光表参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.130. MI_ISP_AE_SetWinWgtType¶

目的

设定曝光权重表种类参数值。

语法

MI_S32 MI_ISP_AE_SetWinWgtType(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_WinWeightModeType_e *data);

描述

调用此函式设定曝光权重表种类参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光权重表种类参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.131. MI_ISP_AE_GetWinWgtType¶

目的

取得曝光权重表种类参数值。

语法

MI_S32 MI_ISP_AE_GetWinWgtType(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_WinWeightModeType_e *data);

描述

调用此函式取得曝光权重表种类参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光权重表种类参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.132. MI_ISP_AE_SetWinWgt¶

目的

设定曝光权重表参数值。

语法

MI_S32 MI_ISP_AE_SetWinWgt(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_WinWeightType_t *data);

描述

调用此函式设定曝光权重表参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光权重表参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.133. MI_ISP_AE_GetWinWgt¶

目的

取得曝光权重表参数值。

语法

MI_S32 MI_ISP_AE_GetWinWgt(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_WinWeightType_t *data);

描述

调用此函式取得曝光权重表参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光权重表参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.134. MI_ISP_AE_SetFlicker¶

目的

设定抗闪烁参数值。

语法

MI_S32 MI_ISP_AE_SetFlicker(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_FlickerType_e *data);

描述

调用此函式设定抗闪烁参数值，支持50Hz和60Hz抗闪烁。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 抗闪烁参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so
注意

支持50Hz和60Hz抗闪烁。

2.135. MI_ISP_AE_GetFlicker¶

目的

取得抗闪烁参数值。

语法

MI_S32 MI_ISP_AE_GetFlicker(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_FlickerType_e *data);

描述

调用此函式取得抗闪烁参数值，支持50Hz和60Hz抗闪烁。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 抗闪烁参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.136. MI_ISP_AE_SetFlickerEx¶

目的

设定侦测抗闪烁参数值。

语法

MI_S32 MI_ISP_AE_SetFlickerEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_FlickerExType_t *data);

描述

调用此函式设定侦测抗闪烁参数值，支持50Hz和60Hz抗闪烁。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 侦测抗闪烁参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so
注意

支持50Hz和60Hz抗闪烁。

2.137. MI_ISP_AE_GetFlickerEx¶

目的

取得侦测抗闪烁参数值。

语法

MI_S32 MI_ISP_AE_GetFlickerEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_FlickerExType_t *data);

描述

调用此函式取得侦测抗闪烁参数值，支持50Hz和60Hz抗闪烁。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 侦测抗闪烁参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.138. MI_ISP_AE_QueryFlickerInfo¶

目的

取得抗闪烁参数值的相关信息。

语法

MI_S32 MI_ISP_AE_QueryFlickerInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_FlickerExInfoType_tkerExType_t *data);

描述

调用此函式取得侦测抗闪烁参数值，分别为抗闪烁的有效状态、抗闪烁模式（50/60Hz）、抗闪烁模式的有效分数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 侦测抗闪烁相关参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.139. MI_ISP_AE_SetStrategy¶

目的

设定曝光策略参数值。

语法

MI_S32 MI_ISP_AE_SetStrategy(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyType_t *data);

描述

调用此函式设定曝光策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.140. MI_ISP_AE_GetStrategy¶

目的

取得曝光策略参数值。

语法

MI_S32 MI_ISP_AE_GetStrategy(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyType_t*data);

描述

调用此函式取得曝光策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.141. MI_ISP_AE_SetStrategyEx¶

目的

设定曝光策略参数值。

语法

MI_S32 MI_ISP_AE_SetStrategyEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyExType_t *data);

描述

调用此函式设定曝光策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.142. MI_ISP_AE_GetStrategyEx¶

目的

取得曝光策略参数值。

语法

MI_S32 MI_ISP_AE_GetStrategyEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyExType_t *data);

描述

调用此函式取得曝光策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.143. MI_ISP_AE_SetStrategyExAdv¶

目的

设定HDR_Auto模式的曝光策略参数值。

语法

MI_S32 MI_ISP_AE_SetStrategyExAdv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyExAdvType_t *data);

描述

调用此函式设定HDR_Auto模式的曝光策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.144. MI_ISP_AE_GetStrategyExAdv¶

目的

取得HDR_Auto模式的曝光策略参数值。

语法

MI_S32 MI_ISP_AE_GetStrategyExAdv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyExAdvType_t *data);

描述

调用此函式取得HDR_Auto模式的曝光策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.145. MI_ISP_AE_QueryStrategyExInfo¶

目的

取得曝光策略信息。

语法

MI_S32 MI_ISP_AE_QueryStrategyExInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyExInfoType_t *data);

描述

调用此函式取得曝光策略信息。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 曝光策略信息的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.146. MI_ISP_AE_SetRgbirAe¶

目的

设定RGB-IR mode曝光策略参数值。

语法

MI_S32 MI_ISP_AE_SetRgbirAe(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_RgbirAeType_t *data);

描述

调用此函式设定RGB-IR mode曝光策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data RGB-IR mode曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.147. MI_ISP_AE_GetRgbirAe¶

目的

取得RGB-IR mode曝光策略参数值。

语法

MI_S32 MI_ISP_AE_GetRgbirAe(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_RgbirAeType_t *data);

描述

调用此函式取得RGB-IR mode曝光策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data RGB-IR mode曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.148. MI_ISP_AE_SetHdr¶

目的

设定HDR mode曝光策略参数值。

语法

MI_S32 MI_ISP_AE_SetHdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_HdrType_t *data);

描述

调用此函式设定HDR mode曝光策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data HDR mode曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.149. MI_ISP_AE_GetHdr¶

目的

取得HDR mode曝光策略参数值。

语法

MI_S32 MI_ISP_AE_GetHdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_HdrType_t *data);

描述

调用此函式取得HDR mode曝光策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data HDR mode曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.150. MI_ISP_AE_SetStabilizer¶

目的

设置Stabilizer策略参数值。此功能可降低AE受画面局部变化的影响而被触发，让画面亮度更稳定。

语法

MI_S32 MI_ISP_AE_SetStabilizer(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StabilizerType_t *data);

描述

调用此函式设置Stabilizer策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Stabilizer策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.151. MI_ISP_AE_GetStabilizer¶

目的

取得Stabilizer策略参数值。

语法

MI_S32 MI_ISP_AE_GetStabilizer(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StabilizerType_t *data);

描述

调用此函式取得Stabilizer策略参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Stabilizer策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.152. MI_ISP_AE_SetPowerLine¶

目的

设置PowerLine Flicker参数值。此功能可推迟Flicker现象发生。

语法

MI_S32 MI_ISP_AE_SetPowerLine(MI_U32 DevId, 
MI_U32 Channel, MI_ISP_AE_PowerLineType_t *data);

描述

调用此函式设置PowerLine Flicker参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data PowerLine Flicker参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so
2.153. MI_ISP_AE_GetPowerLine¶
目的

取得PowerLine Flicker参数值。

语法

MI_S32 MI_ISP_AE_GetPowerLine(MI_U32 DevId, 
MI_U32 Channel, MI_ISP_AE_PowerLineType_t *data);

描述

调用此函式取得PowerLine Flicker参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data PowerLine Flicker参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so
2.154. MI_ISP_AE_QueryPowerLineInfo¶
目的

取得PowerLine Flicker信息。

语法

MI_S32 MI_ISP_AE_QueryPowerLineInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_PowerLineInfoType_t *data);

描述

调用此函式取得PowerLine Flicker信息。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data PowerLine Flicker参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.155. MI_ISP_AE_SetLumaWgt¶

目的

设置Weight by luminance参数值。此功能适用调整AE受画面局部亮度的权重，让画面目标亮度有更佳适应性。

语法

MI_S32 MI_ISP_AE_SetLumaWgt(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_LumaWgtType_t *data);

描述

调用此函式设置Weight by luminance参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Weight by luminance参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.156. MI_ISP_AE_GetLumaWgt¶

目的

取得Weight by luminance参数值。此功能适用调整AE受画面局部亮度的权重，让画面目标亮度有更佳适应性。

语法

MI_S32 MI_ISP_AE_GetLumaWgt(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_LumaWgtType_t *data);

描述

调用此函式取得Weight by luminance参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data Weight by luminance参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.157. MI_ISP_AE_GetVersionInfo¶

目的

取得AE版本信息参数值。

语法

MI_S32 MI_ISP_AE_GetVersionInfo(MI_U32 DevId, 
MI_U32 Channel, MI_ISP_AE_VerInfoType_t *data);

描述

调用此函式取得AE版本信息参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AE版本信息参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_ae.h
- 库文件：libmi_isp.so

2.158. MI_ISP_AWB_QueryInfo¶

目的

取得自动白平衡参数值。

语法

MI_S32 MI_ISP_AWB_QueryInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_QueryInfoType_t *data);

描述

调用此函式取得自动白平衡参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.159. MI_ISP_AWB_GetCtStats¶

目的

取得自动白平衡校正统计值。

语法

MI_S32 MI_ISP_AWB_GetCtStats(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_CtStatisticsType_t *data);

描述

调用此函式取得自动白平衡校正统计值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡校正统计值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.160. MI_ISP_AWB_SetAttr¶

目的

设定自动白平衡属性参数值。

语法

MI_S32 MI_ISP_AWB_SetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_AttrType_t *data);

描述

调用此函式设定自动白平衡属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.161. MI_ISP_AWB_GetAttr¶

目的

取得自动白平衡属性参数值。

语法

MI_S32 MI_ISP_AWB_GetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_AttrType_t *data);

描述

调用此函式取得自动白平衡属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.162. MI_ISP_AWB_SetAttrEx¶

目的

设定自动白平衡增强属性参数值。

语法

MI_S32 MI_ISP_AWB_SetAttrEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_AttrExType_t *data);

描述

调用此函式设定自动白平衡增强属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡增强属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so
注意

只有当MI_ISP_AWB_AttrParam_t中的eAlgType = SS_AWB_ALG_ADVANCE时，此函式设定的参数才会生效。

2.163. MI_ISP_AWB_GetAttrEx¶

目的

取得自动白平衡增强属性参数值。

语法

MI_S32 MI_ISP_AWB_GetAttrEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_AttrExType_t *data);

描述

调用此函式取得自动白平衡增强属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡增强属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.164. MI_ISP_AWB_SetMultiLsAttr¶

目的

设定自动白平衡混光偏校正参数值。

语法

MI_S32 MI_ISP_AWB_SetMultiLsAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_MultiLsType_t *data);

描述

调用此函式设定自动白平衡混光偏校正参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡混光偏校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so
注意

只有当MI_ISP_AWB_AttrParam_t中的bWpWeightEnable = 1时，此函式设定的参数才会生效。

2.165. MI_ISP_AWB_GetMultiLsAttr¶

目的

取得自动白平衡混光偏校正参数值。

语法

MI_S32 MI_ISP_AWB_GetMultiLsAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_MultiLsType_t *data);

描述

调用此函式取得自动白平衡混光偏校正参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡混光偏校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.166. MI_ISP_AWB_SetCtCaliAttr¶

目的

设定自动白平衡校正参数值。

语法

MI_S32 MI_ISP_AWB_SetCtCaliAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_CtCaliType_t *data);

描述

调用此函式设定自动白平衡校正参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.167. MI_ISP_AWB_GetCtCaliAttr¶

目的

取得自动白平衡校正参数值。

语法

MI_S32 MI_ISP_AWB_GetCtCaliAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_CtCaliType_t *data);

描述

调用此函式取得自动白平衡校正参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.168. MI_ISP_AWB_GetCurCtCaliAttr¶

目的

取得自动白平衡套用校正数据后的色温框数据。

语法

MI_S32 MI_ISP_AWB_GetCurCtCaliAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_CurCtCaliType_t *data);

描述

调用此函式取得自动白平衡校正参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.169. MI_ISP_AWB_SetCtMwbAttr¶

目的

手动选择色温来套用对应的WB gain，需在AwbMode为CT Manual时才有效。

语法

MI_S32 MI_ISP_AWB_SetCtMwbAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_CtmwbParam_t *data);

描述

调用此函式设定手动色温白平衡的色温设定。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.170. MI_ISP_AWB_GetCtMwbAttr¶

目的

取得手动色温白平衡的色温设定。

语法

MI_S32 MI_ISP_AWB_GetCtMwbAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_CtmwbParam_t *data);

描述

调用此函式取得手动色温白平衡色温设定。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data 自动白平衡校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.171. MI_ISP_AWB_SetStabilizer¶

目的

当环境稳定下，却发现AWB一直不断被trigger，导致画面颜色不断来回变化时，建议可以开启此功能来让AWB变化更稳定。

语法

MI_S32 MI_ISP_AWB_SetStabilizer(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StabilizerType_t *data);

描述

调用此函式设定AWB stabilizer的设定。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AWB Stabilizer参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.172. MI_ISP_AWB_GetStabilizer¶

目的

取得AWB stabilizer的设定。

语法

MI_S32 MI_ISP_AWB_GetStabilizer(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StabilizerType_t *data);

描述

调用此函式取得AWB stabilizer的设定。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AWB stabilizer参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.173. MI_ISP_AWB_SetSpecialCase¶

目的

此功能提供用者使用三个条件定义case，并可决定case达成时AWB对应要的行为，用来提升特定场景AWB的准确性。总共可定义四种case，每种case的效果会迭加。

语法

MI_S32 MI_ISP_AWB_SetSpecialCase(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SpecialCaseType_t *data);

描述

调用此函式设定AWB SpecialCase的设定。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AWB SpecialCase参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.174. MI_ISP_AWB_GetSpecialCase¶

目的

取得AWB SpecialCase的设定。

语法

MI_S32 MI_ISP_AWB_GetSpecialCase(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SpecialCaseType_t *data);

描述

调用此函式取得AWB SpecialCase的设定。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AWB SpecialCase参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.175. MI_ISP_AWB_QuerySpecialCaseInfo¶

目的

取得AWB SpecialCase各项统计信息。

语法

MI_S32 MI_ISP_AWB_QuerySpecialCaseInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SpecialCaseInfoType_t *data);

描述

调用此函式取得AWB SpecialCase各项统计信息。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AWB QuerySpecialCase参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.176. MI_ISP_AWB_SetStatisFilter¶

目的

此功能可根据BV设定统计值有效亮度区间来排除过暗或过亮的统计值，避免AWB受到noise或过曝区域影响。

语法

MI_S32 MI_ISP_AWB_SetStatisfilter(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StatisFilterType_t *data);

描述

调用此函式设定AWB StatisFilter的设定。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AWB StatisFilter参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.177. MI_ISP_AWB_GetStatisFilter¶

目的

取得AWB StatisFilter 的设定。

语法

MI_S32 MI_ISP_AWB_GetStatisFilter(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StatisFilterType_t *data);

描述

调用此函式取得AWB StatisFilter的设定。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AWB StatisFilter参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.178. MI_ISP_AWB_GetVersionInfo¶

目的

取得AWB版本信息参数值。

语法

MI_S32 MI_ISP_AWB_GetVersionInfo(MI_U32 DevId, 
MI_U32 Channel, MI_ISP_AWB_VerInfoType_t *data);

描述

调用此函式取得AWB版本信息参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AWB版本信息参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_awb.h
- 库文件：libmi_isp.so

2.179. MI_ISP_AF_QueryInfo¶

目的

取得AF参数值。

语法

MI_S32 MI_ISP_AF_QueryInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_QueryInfoType_t *data);

描述

调用此函式取得AF参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF ROI mode属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.180. MI_ISP_AF_SetHwWin¶

目的

设定AF win。

语法

MI_S32 MI_ISP_AF_SetHwWin(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwWinType_t *data);

描述

调用此函式设定AF win。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF win属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.181. MI_ISP_AF_GetHwWin¶

目的

取得AF win。

语法

MI_S32 MI_ISP_AF_GetHwWin(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwWinType_t *data);

描述

调用此函式取得AF win。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF win属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.182. MI_ISP_AF_SetHwFilterAttr¶

目的

设定AF filter系数。

语法

MI_S32 MI_ISP_AF_SetHwFilterAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwFilterAttrType_t *data);

描述

调用此函式设定AF filter系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.183. MI_ISP_AF_GetHwFilterAttr¶

目的

取得AF filter系数。

语法

MI_S32 MI_ISP_AF_GetHwFilterAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwFilterAttrType_t *data);

描述

调用此函式取得AF filter系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter 属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.184. MI_ISP_AF_SetHwFilterSq¶

目的

设定AF filter square系数。

语法

MI_S32 MI_ISP_AF_SetHwFilterSq(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwFilterSqType_t *data);

描述

调用此函式设定AF filter square系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter square属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.185. MI_ISP_AF_GetHwFilterSq¶

目的

取得AF filter square系数。

语法

MI_S32 MI_ISP_AF_GetHwFilterSq(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwFilterSqType_t *data);

描述

调用此函式取得filter square系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter square属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.186. MI_ISP_AF_SetHwBnr¶

目的

设定AF Bayer降噪系数。

语法

MI_S32 MI_ISP_AF_SetHwBnr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwBnrType_t *data);

描述

调用此函式设定AF Bayer降噪系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF Bayer降噪属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so
注意

AF Bayer降噪必须在AF source 设置在E_IQ_AF_SOURCE_BF_3DNR_AF_HDR时才有作用。

2.187. MI_ISP_AF_GetHwBnr¶

目的

取得AF Bayer降噪系数。

语法

MI_S32 MI_ISP_AF_GetHwBnr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwBnrType_t *data);

描述

调用此函式取得AF Bayer降噪系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF Bayer降噪属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so
注意

AF Bayer降噪必须在AF source 设置在E_IQ_AF_SOURCE_BF_3DNR_AF_HDR时才有作用。

2.188. MI_ISP_AF_SetHwYParam¶

目的

设定AF filter Bayer to Y的RGB比例系数。

语法

MI_S32 MI_ISP_AF_SetHwYParam(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwYParamType_t *data);

描述

调用此函式设定AF filter Bayer to Y的RGB比例系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter Bayer to Y属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.189. MI_ISP_AF_GetHwYParam¶

目的

取得AF filter Bayer to Y的RGB比例系数。

语法

MI_S32 MI_ISP_AF_GetHwYParam(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwYParamType_t *data);

描述

调用此函式取得AF filter Bayer to Y的RGB比例系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter Bayer to Y属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.190. MI_ISP_AF_SetHwSource¶

目的

设定AF filter抽取统计值位置。

语法

MI_S32 MI_ISP_AF_SetHwSource(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwSourceType_e *data);

描述

调用此函式设定AF filter抽取统计值位置。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter抽取统计值位置属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.191. MI_ISP_AF_GetHwSource¶

目的

取得AF filter抽取统计值位置。

语法

MI_S32 MI_ISP_AF_GetHwSource(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwSourceType_e *data);

描述

调用此函式取得AF filter抽取统计值位置。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter抽取统计值位置属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.192. MI_ISP_AF_SetHwPreFilter¶

目的

设定AF filter pre-filter系数。

语法

MI_S32 MI_ISP_AF_SetHwPreFilter(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwPrefilterType_t *data);

描述

调用此函式设定AF filter pre-filter系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter pre-filter属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.193. MI_ISP_AF_GetHwPreFilter¶

目的

取得AF filter pre-filter系数。

语法

MI_S32 MI_ISP_AF_GetHwPreFilter(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwPrefilterType_t *data);

描述

调用此函式取得AF filter pre-filter系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter pre-filter属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.194. MI_ISP_AF_SetHwYMap¶

目的

设定AF filter y mapping系数。

语法

MI_S32 MI_ISP_AF_SetHwYMap(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwYMapType_t *data);

描述

调用此函式设定AF filter y mapping系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter y mapping属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.195. MI_ISP_AF_GetHwYMap¶

目的

取得AF filter y mapping系数。

语法

MI_S32 MI_ISP_AF_GetHwYMap(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwYMapType_t *data);

描述

调用此函式取得AF filter y mapping系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter y mapping属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.196. MI_ISP_AF_SetHwLdg¶

目的

设定AF filter LDG系数。

语法

MI_S32 MI_ISP_AF_SetHwLdg(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwLdgType_t *data);

描述

调用此函式设定AF filter LDG系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter ldg属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.197. MI_ISP_AF_GetHwLdg¶

目的

取得AF filter LDG系数。

语法

MI_S32 MI_ISP_AF_GetHwLdg(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwLdgType_t *data);

描述

调用此函式取得AF filter LDG系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter ldg属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.198. MI_ISP_AF_SetHwPeakMode¶

目的

设定AF filter peak mode系数。

语法

MI_S32 MI_ISP_AF_SetHwPeakMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwPeakModeType_t *data);

描述

调用此函式设定AF filter peak mode系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter peak mode属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.199. MI_ISP_AF_GetHwPeakMode¶

目的

取得AF filter peak mode系数。

语法

MI_S32 MI_ISP_AF_GetHwPeakMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwPeakModeType_t *data);

描述

调用此函式取得AF filter peak mode系数。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF filter peak mode属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.200. MI_ISP_AF_SetAttr¶

目的

设定AF属性参数值。

语法

MI_S32 MI_ISP_AF_SetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_AttrType_t *data);

描述

调用此函式设定AF属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.201. MI_ISP_AF_GetAttr¶

目的

取得AF属性参数值。

语法

MI_S32 MI_ISP_AF_GetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_AttrType_t *data);

描述

调用此函式取得AF属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.202. MI_ISP_AF_SetMotor¶

目的

设定AF Motor属性参数值。

语法

MI_S32 MI_ISP_AF_SetMotor(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_MotorType_t *data);

描述

调用此函式设定AF Motor属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF Motor属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.203. MI_ISP_AF_GetMotor¶

目的

取得AF Motor属性参数值。

语法

MI_S32 MI_ISP_AF_GetMotor(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_MotorType_t *data);

描述

调用此函式取得AF Motor属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF Motor属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.204. MI_ISP_AF_SetAccWeight¶

目的

设定AF Acc Weight属性参数值。

语法

MI_S32 MI_ISP_AF_SetAccWeight(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AccWeightType_t *data);

描述

调用此函式设定AF Acc Weight属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF Acc Weight属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.205. MI_ISP_AF_GetAccWeight¶

目的

取得AF Acc Weight属性参数值。

语法

MI_S32 MI_ISP_AF_GetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_AccWeightType_t *data);

描述

调用此函式取得AF Acc Weight属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF Acc Weight属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.206. MI_ISP_AF_SetOneShot¶

目的

设定AF OneShot属性参数值。

语法

MI_S32 MI_ISP_AF_SetOneShot(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_OneShotType_t *data);

描述

调用此函式设定AF OneShot属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF OneShot属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.207. MI_ISP_AF_GetOneShot¶

目的

取得AF OneShot属性参数值。

语法

MI_S32 MI_ISP_AF_GetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_OneShotType_t *data);

描述

调用此函式取得AF OneShot属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF OneShot属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.208. MI_ISP_AF_SetSceneChange¶

目的

设定AF Scene Change属性参数值。

语法

MI_S32 MI_ISP_AF_SetSceneChange(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_SceneChangeType_t *data);

描述

调用此函式设定AF Scene Change属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF Scene Change属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.209. MI_ISP_AF_GetSceneChange¶

目的

取得AF Scene Change属性参数值。

语法

MI_S32 MI_ISP_AF_GetSceneChange(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_SceneChangeType_t *data);

描述

调用此函式取得AF Scene Change属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF Scene Change属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.210. MI_ISP_AF_SetSearchStart¶

目的

设定AF SearchStart属性参数值。

语法

MI_S32 MI_ISP_AF_SetSearchStart(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_SearchStartType_t *data);

描述

调用此函式设定AF SearchStart属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF SearchStart属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.211. MI_ISP_AF_GetSearchStart¶

目的

取得AF SearchStart属性参数值。

语法

MI_S32 MI_ISP_AF_GetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_SearchStartType_t *data);

描述

调用此函式取得AF SearchStart属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF SearchStart属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.212. MI_ISP_AF_SetSearch¶

目的

设定AF Search属性参数值。

语法

MI_S32 MI_ISP_AF_SetSearch(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_SearchType_t *data);

描述

调用此函式设定AF Search属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF Search属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.213. MI_ISP_AF_GetSearch¶

目的

取得AF Search属性参数值。

语法

MI_S32 MI_ISP_AF_GetSearch(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_SearchType_t *data);

描述

调用此函式取得AF Search属性参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF Search属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.214. MI_ISP_AF_GetVersionInfo¶

目的

取得AF版本信息参数值。
语法

MI_S32 MI_ISP_AF_GetVersionInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_VerInfoType_t *data);
描述

调用此函式取得AF版本信息参数值。
参数

参数名称 描述

DevId ISP设备号（目前chip设置为0）。

Channel 影像输入的信道号（一般为0）。

*data AF版本信息参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.h
- 库文件：libmi_isp.so

2.215. MI_ISP_ApiCmdLoadBinFile¶

目的

载入cmd load bin file，于使用者在IQ Tool调校好的IQ参数后tunnel到客户应用程序中。

语法

MI_S32 MI_ISP_ApiCmdLoadBinFile(MI_U32 DevId, MI_U32 Channel, 
char *filepath, MI_U32 user_key);

描述

调用此函式载入IQ Tool调校好之后的api cmd bin档案，那么客户在app中直接load此bin file，就与IQ Tool调校效果一样。

参数

参数名称	描述
DevId	ISP设备号（目前chip设置为0）。
Channel	影像输入的信道号（一般为0）。
filepath	ISP API bin档案的路径位置。
user_key	User key与magic key必须一致。magic key可由IQ Tool内的Setting字段来修改值。

返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_cus3a_api.h
- 库文件：libmi_isp.so
举例

Filepath是ISP API bin文件的路径，此user_key值会去比对magic key，而IQ Tool保存magic key至ISP API bin里面，透过函式调用ISP API bin时会判断ISP API bin里面的magic key与函式传进去的user_key是否一致。magic key值可以在工具的Setting里面设定，如Figure 2所示。

Figure 2：IQTool接口设定Magic key示意图

2.216. MI_ISP_ApiCmdLoadCaliData¶

目的

载入offline calibration data file，于用户在脱机版校正程序的参数档案（*.data）后tunnel到客户应用程序中呼叫此API function。

语法

MI_S32 MI_ISP_ApiCmdLoadCaliData(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_CaliItem_e eCaliItem, char *filepath);

描述

调用此函式加载脱机版校正程序的参数档案（*.data），那么客户在应用程序中直接load此data file。

参数

参数名称	描述
DevId	ISP设备号（目前chip设置为0）。
Channel	影像输入的信道号（一般为0）。
eCaliItem	校正项目的列举结构体。
filepath	校正参数档案的路径位置。

返回值

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_cus3a_api.h
- 库文件：libmi_isp.so

3. MI ISP API数据类型¶

3.1. MI_ISP_IQ_Bool结构体¶

3.1.1. 列举结构体（Enum Structure）

说明

布尔值的列举结构体。

定义

typedef enum

{

    E_SS_IQ_FALSE = 0,

    E_SS_IQ_TRUE = !E_SS_IQ_FALSE,

    E_SS_IQ_BOOL_MAX

} MI_ISP_IQ_Bool_e;

名称

变量名称 描述

E_SS_IQ_FALSE 布尔值等于0。

E_SS_IQ_TRUE 布尔值等于1。

E_SS_IQ_BOOL_MAX 判断布尔值列举列表的最大值。
相关结构类型与函式

MI_ISP_IQ_ParamInitInfoParam_t

3.2. MI_ISP_IQ_OpType结构体¶

3.2.1. 列举结构体（Enum Structure）

说明

工作模式的列举结构体。

定义

typedef enum

{

    E_SS_IQ_OP_TYP_AUTO = 0,

    E_SS_IQ_OP_TYP_MANUAL = !E_SS_IQ_OP_TYP_AUTO,

    E_SS_IQ_OP_TYP_MODE_MAX

} MI_ISP_IQ_OpType_e;

名称

变量名称 描述

E_SS_IQ_OP_TYP_AUTO 自动工作模式。

E_SS_IQ_OP_TYP_MANUAL 手动工作模式。

E_SS_IQ_OP_TYP_MODE_MAX 判断工作模式列举列表的最大值。

3.3. MI_ISP_IQ_ParamMode结构体¶

3.3.1. 列举结构体（Enum Structure）

说明

IQ特殊模式的列举结构体。

定义

typedef enum

{

    E_SS_IQ_PARAM_MODE_NORMAL = 0,

    E_SS_IQ_PARAM_MODE_NIGHT = 1,

    E_SS_IQ_PARAM_MODE_MAX

} MI_ISP_IQ_ParamMode_e;

名称

变量名称	描述
E_SS_IQ_PARAM_MODE_NORMAL	IQ白天工作模式。
E_SS_IQ_PARAM_MODE_NIGHT	IQ夜间工作模式。
E_SS_IQ_PARAM_MODE_MAX	判断IQ工作模式列举列表的最大值。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetIqMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ParamMode_e *data);

MI_S32 MI_ISP_IQ_GetIqMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ParamMode_e *data);

3.4. MI_ISP_IQ_BypassMode结构体¶

3.4.1. 列举结构体（Enum Structure）

说明

Bypass工作模式的列举结构体。

定义

typedef enum

{

    E_SS_BYPASS_OFF = 0,

    E_SS_BYPASS_ON,

    E_SS_BYPASS_MAX

} MI_ISP_IQ_BypassMode_e;

名称

变量名称	描述
E_SS_BYPASS_OFF	Bypass工作模式等于Disable。
E_SS_BYPASS_ON	Bypass工作模式等于Enable。
E_SS_ BYPASS_MAX	判断Bypass工作模式列举列表的最大值。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetApiBypassMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ApiBypassType_t *data);

MI_S32 MI_ISP_IQ_GetApiBypassMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ApiBypassType_t *data);

3.5. MI_ISP_IQ_Index结构体¶

3.5.1. 列举结构体（Enum Structure）

说明

IQ曝光指数（ISO index）的列举结构体。

定义

typedef enum
{
    E_SS_IQ_INDEX_0 = 0,
    E_SS_IQ_INDEX_1,
    E_SS_IQ_INDEX_2,
    E_SS_IQ_INDEX_3,
    E_SS_IQ_INDEX_4,
    E_SS_IQ_INDEX_5,
    E_SS_IQ_INDEX_6,
    E_SS_IQ_INDEX_7,
    E_SS_IQ_INDEX_8,
    E_SS_IQ_INDEX_9,
    E_SS_IQ_INDEX_10,
    E_SS_IQ_INDEX_11,
    E_SS_IQ_INDEX_12,
    E_SS_IQ_INDEX_13,
    E_SS_IQ_INDEX_14,
    E_SS_IQ_INDEX_15,
    E_SS_IQ_INDEX_MAX
} MI_ISP_IQ_Index_e;

名称

变量名称	描述
E_SS_IQ_INDEX_0	E_SS_IQ_INDEX_0曝光指数等于0、增益数值等于1倍。
E_SS_IQ_INDEX_1	E_SS_IQ_INDEX_1曝光指数等于1、增益数值等于2倍。
E_SS_IQ_INDEX_2	E_SS_IQ_INDEX_2曝光指数等于2、增益数值等于4倍。
E_SS_IQ_INDEX_3	E_SS_IQ_INDEX_3曝光指数等于3、增益数值等于8倍。
E_SS_IQ_INDEX_4	E_SS_IQ_INDEX_4曝光指数等于4、增益数值等于16倍。
E_SS_IQ_INDEX_5	E_SS_IQ_INDEX_5曝光指数等于5、增益数值等于32倍。
E_SS_IQ_INDEX_6	E_SS_IQ_INDEX_6曝光指数等于6、增益数值等于64倍。
E_SS_IQ_INDEX_7	E_SS_IQ_INDEX_7曝光指数等于7、增益数值等于128倍。
E_SS_IQ_INDEX_8	E_SS_IQ_INDEX_8曝光指数等于8、增益数值等于256倍。
E_SS_IQ_INDEX_9	E_SS_IQ_INDEX_9曝光指数等于9、增益数值等于512倍。
E_SS_IQ_INDEX_10	E_SS_IQ_INDEX_10曝光指数等于10、增益数值等于1024倍。
E_SS_IQ_INDEX_11	E_SS_IQ_INDEX_11曝光指数等于11、增益数值等于2048倍。
E_SS_IQ_INDEX_12	E_SS_IQ_INDEX_12曝光指数等于12、增益数值等于4096倍。
E_SS_IQ_INDEX_13	E_SS_IQ_INDEX_13曝光指数等于13、增益数值等于8192倍。
E_SS_IQ_INDEX_14	E_SS_IQ_INDEX_14曝光指数等于14、增益数值等于16384倍。
E_SS_IQ_INDEX_15	E_SS_IQ_INDEX_15曝光指数等于15、增益数值等于32768倍。

相关结构类型与函式

MI_S32 MI_ISP_IQ_GetIqInd(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_Index_e *data);

3.6. MI_ISP_IQ_ApiId结构体¶

3.6.1. 列举结构体（Enum Structure）

说明

每个API ID的列举结构体。

定义

typedef enum
{
    E_API20_AUTO            = 0,
    E_API20_FPN             = 1,
    E_API20_CCM             = 2,
    E_API20_SAT             = 3,
    E_API20_OBC             = 4,
    E_API20_OBC_P1      = 5,
    E_API20_FCOLOR      = 6,
    E_API20_CR          = 7,
    E_API20_NR_DESPIKE  = 8,
    E_API20_SHP             = 9,
    E_API20_NR_3D       = 10,
    E_API20_BRI             = 11,
    E_API20_LIG             = 12,
    E_API20_CST             = 13,
    E_API20_GMA             = 14,
    E_API20_CTG             = 15,
    E_API20_NR_NLM      = 16,
    E_API20_DEFOG       = 17,
    E_API20_DRC             = 18,
    E_API20_DPC             = 19,
    E_API20_HSV             = 20,
    E_API20_WDR_LOC         = 21,
    E_API20_RGBIR       = 22,
    E_API20_YUVGMA      = 23,
    E_API20_HDR16TO12       = 24,
    E_API20_COLORTRANS  = 25,
    E_API20_HDR             = 26,
    E_API20_EFFECT      = 27,
    E_API20_PFC             = 28,
    E_API20_SIIR            = 29,
    E_API20_DM          = 30,
    E_API20_NR_3D_P1        = 31,
    E_API20_WDR_CURVE_ADV   = 32,
    E_API20_MXNR            = 33,
    E_API20_R2Y             = 34,
    E_API20_LSC             = 35,
    E_API20_LSC_CTRL        = 36,
    E_API20_ALSC            = 37,
    E_API20_ALSC_CTRL       = 38,
    E_API20_DPC_CLUSTER     = 39,
    E_API20_PFC_EX      = 40,
    E_API20_HDR_EX      = 41,
    E_API20_SHP_EX      = 42,
    E_API20_NR_3D_EX        = 43,
    E_API20_GNR             = 44,
    E_API20_DUMMY       = 45,
    E_API20_DUMMY_EX        = 46,
    E_API20_WDR_CURVE_FUL   = 47,
    E_API20_ADAPTIVE_GMA    = 48,
    E_API20_XNR             = 49,
    E_API20_TEMP            = 50,
    E_API20_TEMP_INFO       = 51,
    E_API20_CSA             = 52,
    E_API20_WDR_LCE         = 53,
    E_API20_WDR_NR      = 54,
    E_API20_YCLPF       = 55,
    E_API20_DARKSHADING     = 56,
    E_API20_WDR_LTM         = 57,
    E_API20_MAX             = 58,
} MI_ISP_IQ_ApiId_e;

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetApiBypassMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ApiBypassType_t *data);

MI_S32 MI_ISP_IQ_GetApiBypassMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ApiBypassType_t *data);

3.7. MI_ISP_AWB_AlgoType结构体¶

3.7.1. 列举结构体（Enum Structure）

说明

自动白平衡算法的列举结构体。

定义

typedef enum
{
    E_SS_AWB_ALG_GRAYWORLD = 0,
    E_SS_AWB_ALG_NORMAL = 1,
    E_SS_AWB_ALG_BALANCE = 2,
    E_SS_AWB_ALG_FOCUS = 3,
    E_SS_AWB_ALG_MAX
} MI_ISP_AWB_AlgoType_e;

名称

变量名称	描述
E_SS_AWB_ALG_ GRAYWORLD	以所有统计值来计算WB gain。
E_SS_AWB_ALG_NORMAL	以落点数最高的2 ~ 3个色温框内的统计值来计算WB gain。
E_SS_AWB_ALG_BALANCE	以所有落入有效色温框的统计值来计算WB gain。
E_SS_AWB_ALG_FOCUS	WB gain计算会偏向单一色温为主。
E_SS_AWB_ALG_MAX	判断自动白平衡算法列举列表的最大值。

相关结构类型与函式
```
MI_ISP_AWB_AttrParam_t
```

3.8. MI_ISP_AWB_AdvType结构体¶

3.8.1. 列举结构体（Enum Structure）

说明

自动白平衡进阶算法的列举结构体。

定义

typedef enum

{

    E_SS_AWB_ADV_DEFAULT = 0,

    E_SS_AWB_ADV_ADVANCE = 1,

    E_SS_AWB_ADV_MAX

} MI_ISP_AWB_AdvType_e;

名称

变量名称	描述
E_SS_AWB_ADV_DEFAULT	默认的自动白平衡算法。
E_SS_AWB_ADV_ADVANCE	增强的自动白平衡算法，可以开启MI_ISP_AWB_SetAttrEx的设定功能。
E_SS_AWB_ADV_MAX	判断自动白平衡进阶算法列举列表的最大值。

相关结构类型与函式
```
MI_ISP_AWB_AttrParam_t
```

3.9. MI_ISP_AF_AlgoType结构体¶

3.9.1. 列举结构体（Enum Structure）

说明

自动对焦进阶算法的列举结构体。

定义

typedef enum

{

    E_SS_AF_ALGO_ONESHOT    = 0,

    E_SS_AF_ALGO_CONTINUOUS = 1

} MI_ISP_AF_AlgoType_e;

名称

变量名称	描述
E_SS_AF_ALGO_ONESHOT	将所有位置都走一遍，然后到统计值最大的位置。
E_SS_AF_ALGO_CONTINUOUS	会动态侦测环境变动，若有变化，则会重新对焦。

相关结构类型与函式
```
MI_ISP_AF_AttrType_t
```

3.10. MI_ISP_AF_AccSelType结构体¶

3.10.1. 列举结构体（Enum Structure）

说明

自动对焦统计值的列举结构体。

定义

typedef enum __attribute__ ((aligned (4)))

{

    E_SS_AF_ACC_IIRH = 0,

    E_SS_AF_ACC_IIRL = 1,

    E_SS_AF_ACC_SBLV = 2,

    E_SS_AF_ACC_SBLH = 3,

    E_SS_AF_ACC_LUMA = 4,

    E_SS_AF_ACC_MAX = 0xffffffff

} MI_ISP_AF_AccSelType_e;

名称

变量名称	描述
E_SS_AF_ACC_IIRH	统计值IIRH。
E_SS_AF_ACC_IIRL	统计值IIRL。
E_SS_AF_ACC_SBLV	统计值SBLV。
E_SS_AF_ACC_SBLH	统计值SBLH。
E_SS_AF_ACC_LUMA	统计值LUMA。
E_SS_AF_ACC_MAX	统计值列举清单的最大值。

相关结构类型与函式

MI_ISP_AF_OneShotType_t

MI_ISP_AF_SceneChangeType_t

MI_ISP_AF_SearchStartType_t

3.11. MI_ISP_IQ_CaliItem结构体¶

3.11.1. 列举结构体（Enum Structure）

说明

校正选项的列举结构体。

定义

typedef enum

{

    E_SS_CALI_ITEM_AWB  = 0,

    E_SS_CALI_ITEM_OBC  = 1,

    E_SS_CALI_ITEM_SDC  = 2,

    E_SS_CALI_ITEM_ALSC   = 3,

    E_SS_CALI_ITEM_LSC  = 4,

    E_SS_CALI_ITEM_AWB_EX  = 5,

    E_SS_CALI_ITEM_MAX,

} MI_ISP_IQ_CaliItem_e;

名称

变量名称	描述
E_SS_CALI_ITEM_AWB	白平衡补偿校正（MARUKO不支持）。
E_SS_CALI_ITEM_OBC	黑电平补偿校正。
E_SS_CALI_ITEM_SDC	静态坏点补偿校正。
E_SS_CALI_ITEM_ALSC	镜头补偿校正。
E_SS_CALI_ITEM_LSC	镜头补偿校正。
E_SS_CALI_ITEM_AWB_EX	白平衡补偿校正（MARUKO只能使用此模式）。
E_SS_CALI_ITEM_MAX	判断校正选项列举列表的最大值。

相关结构类型与函式

MI_S32 MI_ISP_ApiCmdLoadCaliData(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_CaliItem_e eCaliItem, char *filepath);

3.12. MI_ISP_IQ_VersionInfo结构体¶

3.12.1. 类型结构体（Type Structure）

说明

取得ISP IQ版本号的类型结构体。

定义

typedef struct MI_ISP_IQ_VersionInfoType_s

{

    MI_ISP_IQ_VersionInfoParam_t stParaAPI;

} MI_ISP_IQ_VersionInfoType_t;

名称

变量名称 描述

stParaAPI 取得ISP IQ版本号的类型结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetVersionInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_VersionInfoType_t *data);

MI_S32 MI_ISP_IQ_GetVersionInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_VersionInfoType_t *data);

3.12.2. 参数结构体（Parameter Structure）

说明

取得IQ版本号的参数结构体。

定义

typedef struct MI_ISP_IQ_VersionInfoParam_s

{

    MI_U32 u32Vendor;

    MI_U32 u32Major;

    MI_U32 u32Minor;

} MI_ISP_IQ_VersionInfoParam_t;

名称

变量名称	描述
u32Vendor	ISP IQ Vendor版本号，提供Get/Set功能。
u32Major	ISP IQ Major版本号，只提供Get功能。
u32Minor	ISP IQ Minor版本号，只提供Get功能。

相关结构类型与函式
```
MI_ISP_IQ_VersionInfoType_t
```

3.13. MI_ISP_IQ_ParamInitInfo结构体¶

3.13.1. 类型结构体（Type Structure）

说明

取得ISP初始化ready状态的类型结构体。

定义

typedef struct MI_ISP_IQ_ParamInitInfoType_s

{

    MI_ISP_IQ_ParamInitInfoParam_t stParaAPI;

} MI_ISP_IQ_ParamInitInfoType_t;

名称

变量名称 描述

stParaAPI 取得ISP初始化ready状态的类型结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_GetParaInitStatus(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ParamInitInfoType_t *data);

3.13.2. 参数结构体（Parameter Structure）

说明

取得ISP初始化ready状态的参数结构体。

定义

typedef struct MI_ISP_IQ_ParamInitInfoParam_s

{

    MI_ISP_IQ_Bool_e bFlag;

} MI_ISP_IQ_ParamInitInfoParam_t;

名称

变量名称 描述

bFlag 取得ISP初始化完毕状态的布尔值。
关闭：E_SS_IQ_FALSE = 0。
开启：E_SS_IQ_TRUE = 1。
相关结构类型与函式
```
MI_ISP_IQ_ParamInitInfoType_t
```

3.14. MI_ISP_IQ_IntpLut结构体¶

3.14.1. 类型结构体（Type Structure）

说明

具结点内插功能的参数数据设定表。

可用于设定随环境亮度变化的画面目标亮度（ex：X轴：BV、Y轴：画面目标亮度）。

或随环境亮度变化的画面目标亮度浮动范围（ex：X轴：BV、Y轴：画面目标亮度的浮动范围）。

定义

typedef struct

{

    MI_U16 u16NumOfPoints;

    MI_S32 s32Y[INTP_LUT_NUM];

    MI_S32 s32X[INTP_LUT_NUM];

} MI_ISP_IQ_IntpLut_t;

名称

变量名称	描述
u16NumOfPoints	实际表中数据的有效节点数，最大支持16个节点，也就是可填入16笔X、Y数据。
u32Y[INTP_LUT_NUM]	对应每一节点的Y 轴参数，如不使用的节点可将参数设0。 INTP_LUT_NUM = 16。
u32X[INTP_LUT_NUM]	对应每一节点的X 轴参数，如不使用的节点可将参数设0。 INTP_LUT_NUM = 16。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetLscCtrl(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_LscCtrlType_t *data);

MI_S32 MI_ISP_IQ_GetLscCtrl(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_LscCtrlType_t *data);

MI_S32 MI_ISP_IQ_SetAlscCtrl(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_AlscCtrlType_t *data);

MI_S32 MI_ISP_IQ_GetAlscCtrl(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_AlscCtrlType_t *data);

3.15. MI_ISP_IQ_ColorToGray结构体¶

3.15.1. 类型结构体（Type Structure）

说明

设定彩色转灰阶影像的类型结构体。

定义

typedef struct MI_ISP_IQ_ColorToGrayType_s

{

    MI_ISP_IQ_Bool_e bEnable;

} MI_ISP_IQ_ColorToGrayType_t;

名称

变量名称 描述

bEnable 设定彩色转灰阶影像功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetColorToGray(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ColorToGrayType_t *data);

MI_S32 MI_ISP_IQ_GetColorToGray(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ColorToGrayType_t *data);

3.16. MI_ISP_IQ_Constrast结构体¶

3.16.1. 类型结构体（Type Structure）

说明

设定对比度的类型结构体。

定义

typedef struct MI_ISP_IQ_ContrastType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_OpType_e     enOpType;

    MI_ISP_IQ_ContrastAutoAttr_t  stAuto;

    MI_ISP_IQ_ContrastManualAttr_t   stManual;

} MI_ISP_IQ_ContrastType_t;

名称

变量名称	描述
bEnable	设定对比度功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定对比度的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定对比度的自动模式属性结构体。
stManual	设定对比度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetContrast(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ContrastType_t *data);

MI_S32 MI_ISP_IQ_GetContrast(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ContrastType_t *data);

3.16.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定对比度的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_ContrastAutoAttr_s

{

    MI_ISP_IQ_LevelBaseParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_ContrastAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.16.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定对比度的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_ContrastManualAttr_s

{

    MI_ISP_IQ_LevelBaseParam_t stParaAPI;

} MI_ISP_IQ_ContrastManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.16.4. 参数结构体（Parameter Structure）

说明

设定对比度、亮度、灰度的参数结构体。

定义

typedef struct MI_ISP_IQ_LevelBaseParam_s

{

    MI_U32 u32Lev;

} MI_ISP_IQ_LevelBaseParam_t;

名称

变量名称描述

u32Lev 设定对比度、亮度、灰度的可变强度数值。值域范围：0 ~ 100。

3.17. MI_ISP_IQ_Brightness结构体¶

3.17.1. 类型结构体（Type Structure）

说明

设定亮度的类型结构体。

定义

typedef struct MI_ISP_IQ_BrightnessType_s

{

    MI_ISP_IQ_Bool_e          bEnable;

    MI_ISP_IQ_OpType_e       enOpType;

    MI_ISP_IQ_BrightnessAutoAttr_t   stAuto;

    MI_ISP_IQ_BrightnessManualAttr_t  stManual;

} MI_ISP_IQ_BrightnessType_t;

名称

变量名称	描述
bEnable	设定亮度功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定亮度的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定亮度的自动模式属性结构体。
stManual	设定亮度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetBrightness(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_BrightnessType_t *data);

MI_S32 MI_ISP_IQ_GetBrightness(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_BrightnessType_t *data);

3.17.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定亮度的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_BrightnessAutoAttr_s

{

    MI_ISP_IQ_LevelBaseParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_BrightnessAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.17.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定亮度的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_BrightnessManualAttr_s

{

    MI_ISP_IQ_LevelBaseParam_t stParaAPI;

} MI_ISP_IQ_BrightnessManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.18. MI_ISP_IQ_Lightness结构体¶

3.18.1. 类型结构体（Type Structure）

说明

设定灰度的类型结构体。

定义

typedef struct MI_ISP_IQ_LightnessType_s

{

    MI_ISP_IQ_Bool_e          bEnable;

    MI_ISP_IQ_OpType_e         enOpType;

    MI_ISP_IQ_LightnessAutoAttr_t   stAuto;

    MI_ISP_IQ_LightnessManualAttr_t    stManual;

} MI_ISP_IQ_LightnessType_t;

名称

变量名称	描述
bEnable	设定灰度功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定灰度的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定灰度的自动模式属性结构体。
stManual	设定灰度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetLightness(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_LightnessType_t *data);

MI_S32 MI_ISP_IQ_GetLightness(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_LightnessType_t *data);

3.18.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定灰度的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_LightnessAutoAttr_s

{

    MI_ISP_IQ_LevelBaseParam_t   stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_LightnessAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.18.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定灰度的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_LightnessManualAttr_s

{

    MI_ISP_IQ_LevelBaseParam_t   stParaAPI;

} MI_ISP_IQ_LightnessManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.19. MI_ISP_IQ_RgbGamma结构体¶

3.19.1. 类型结构体（Type Structure）

说明

设定RGB Gamma curve的类型结构体。

定义

typedef struct MI_ISP_IQ_RgbGammaType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_OpType_e       enOpType;

    MI_ISP_IQ_RgbGammaAutoAttr_t  stAuto;

    MI_ISP_IQ_RgbGammaManualAttr_t stManual;

} MI_ISP_IQ_RgbGammaType_t;

名称

变量名称	描述
bEnable	设定RGB Gamma curve功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定RGB Gamma curve的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定RGB Gamma curve的自动模式属性结构体。
stManual	设定RGB Gamma curve的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetRgbGamma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_RgbGammaType_t *data);

MI_S32 MI_ISP_IQ_GetRgbGamma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_RgbGammaType_t *data);

3.19.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定RGB Gamma curve的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_RgbGammaAutoAttr_s

{

    MI_ISP_IQ_RgbGammaParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_RgbGammaAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.19.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定RGB Gamma curve的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_RgbGammaManualAttr_s

{

    MI_ISP_IQ_RgbGammaParam_t stParaAPI;

} MI_ISP_IQ_RgbGammaManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.19.4. 参数结构体（Parameter Structure）

说明

设定RGB Gamma curve的参数结构体。

定义

typedef struct MI_ISP_IQ_RgbGammaParam_s

{

    MI_U16 u16LutR[RGBGAMMA_NUM];

    MI_U16 u16LutG[RGBGAMMA_NUM];

    MI_U16 u16LutB[RGBGAMMA_NUM];

} MI_ISP_IQ_RgbGammaParam_t;

名称

变量名称	描述
u16LutR[RGBGAMMA_NUM]	R通道分量。值域范围：0 ~ 1023。RGBGAMMA_NUM = 256。
u16LutG[RGBGAMMA_NUM]	G通道分量。值域范围：0 ~ 1023。RGBGAMMA_NUM = 256。
u16LutB[RGBGAMMA_NUM]	B通道分量。值域范围：0 ~ 1023。RGBGAMMA_NUM = 256。

注意事项

支持三个通道的Gamma设定，SigmaStar建议三个通道设定一样，如Figure 3：

Figure 3：RGB Gamma curve

3.20. MI_ISP_IQ_YuvGamma结构体¶

3.20.1. 类型结构体（Type Structure）

说明

设定YUV Gamma curve的类型结构体。

定义

typedef struct MI_ISP_IQ_YuvGammaType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_OpType_e       enOpType;

    MI_ISP_IQ_YuvGammaAutoAttr_t  stAuto;

    MI_ISP_IQ_YuvGammaManualAttr_t stManual;

} MI_ISP_IQ_YuvGammaType_t;

名称

变量名称	描述
bEnable	设定YUV Gamma curve功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定YUV Gamma curve的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定YUV Gamma curve的自动模式属性结构体。
stManual	设定YUV Gamma curve的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetYuvGamma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_YuvGammaType_t *data);

MI_S32 MI_ISP_IQ_GetYuvGamma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_YuvGammaType_t *data);

3.20.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定YUV Gamma curve的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_YuvGammaAutoAttr_s

{

    MI_ISP_IQ_YuvGammaParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_YuvGammaAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.20.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定YUV Gamma curve的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_YuvGammaManualAttr_s

{

    MI_ISP_IQ_YuvGammaParam_t stParaAPI;

} MI_ISP_IQ_YuvGammaManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.20.4. 参数结构体（Parameter Structure）

说明

设定YUV Gamma curve的参数结构体。

定义

typedef struct MI_ISP_IQ_YuvGammaParam_s

{

    MI_U16 u16LutY[YUVGAMMA_Y_NUM];

    MI_U16 u16LutU[YUVGAMMA_U_NUM];

    MI_U16 u16LutV[YUVGAMMA_V_NUM];

} MI_ISP_IQ_YuvGammaParam_t;

名称

变量名称	描述
u16LutY[YUVGAMMA_Y_NUM]	Y通道分量。值域范围：0 ~ 1023。YUVGAMMA_Y_NUM = 256
u16LutU[YUVGAMMA_U_NUM]	U通道分量。值域范围：0 ~ 511。YUVGAMMA_U_NUM = 128
u16LutV[YUVGAMMA_V_NUM]	V通道分量。值域范围：0 ~ 511。YUVGAMMA_V_NUM = 128

3.21. MI_ISP_IQ_AdaptiveGamma结构体¶

3.21.1. 类型结构体（Type Structure）

说明

设定Adaptive Gamma curve的类型结构体。

定义

typedef struct MI_ISP_IQ_AdaptiveGammaType_s

{

    MI_ISP_IQ_Bool_e  bEnable;

    MI_U16     u16BTGamma[ADAPTIVE_GAMMA_NUM];

    MI_U16     u16DTGamma[ADAPTIVE_GAMMA_NUM];

} MI_ISP_IQ_AdaptiveGammaType_t;

名称

变量名称	描述
bEnable	设定Adaptive Gamma curve功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16BTGamma[ADAPTIVE_GAMMA_NUM]	Bright Tone Gamma curve，当StrategyExInfo中的GMBlendRatio小于512，会根据GMBlendRatio来将BTGamma与一般Gamma做混和。 ADAPTIVE_GAMMA_NUM = 256。
u16DTGamma[ADAPTIVE_GAMMA_NUM]	Dark Tone Gamma curve，当StrategyExInfo中的GMBlendRatio大于512，会根据GMBlendRatio来将DTGamma与一般Gamma做混和。 ADAPTIVE_GAMMA_NUM = 256。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetAdaptiveGamma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_AdaptiveGammaType_t *data);

MI_S32 MI_ISP_IQ_GetAdaptiveGamma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_AdaptiveGammaType_t *data);

3.22. MI_ISP_IQ_Saturation结构体¶

3.22.1. 类型结构体（Type Structure）

说明

设定饱和度的类型结构体。

定义

typedef struct MI_ISP_IQ_SaturationType_s

{

    MI_ISP_IQ_Bool_e          bEnable;

    MI_ISP_IQ_OpType_e         enOpType;

    MI_ISP_IQ_SaturationAutoAttr_t   stAuto;

    MI_ISP_IQ_SaturationManualAttr_t  stManual;

} MI_ISP_IQ_SaturationType_t;

名称

变量名称	描述
bEnable	设定饱和度功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定饱和度的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定饱和度的自动模式属性结构体。
stManual	设定饱和度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetSaturation(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SaturationType_t *data);

MI_S32 MI_ISP_IQ_GetSaturation(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SaturationType_t *data);

3.22.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定饱和度的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_SaturationAutoAttr_s

{

    MI_ISP_IQ_SaturationParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_SaturationAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.22.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定饱和度的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_SaturationManualAttr_s

{

    MI_ISP_IQ_SaturationParam_t stParaAPI;

} MI_ISP_IQ_SaturationManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.22.4. 参数结构体（Parameter Structure）

说明

设定饱和度的参数结构体。

定义

typedef struct MI_ISP_IQ_SaturationParam_s

{

    MI_U8 u8SatAllStr;

    MI_U8 u8SatByYSFTAdv[SAT_LUT_X_NUM];

    MI_U8 u8SatByYLUTAdv[SAT_LUT_Y_NUM];

    MI_U8 u8SatBySSFTAdv[SAT_LUT_X_NUM];

    MI_U8 u8SatBySLUTAdv[SAT_LUT_Y_NUM];

    MI_U8 u8SatCoring;

} MI_ISP_IQ_SaturationParam_t;

名称

变量名称	描述
u8SatAllStr	整体饱和度的强度数值。值域范围：0 ~ 127（32等于1倍）。
u8SatByYSFTAdv[SAT_LUT_X_NUM]	调整亮度区间的强度数值。值域范围：0 ~ 8。 SAT_LUT_X_NUM = 5。
u8SatByYLUTAdv[SAT_LUT_Y_NUM]	基于亮度区间调整饱和度的数值。值域范围：0 ~ 128。 SAT_LUT_Y_NUM = 6。
u8SatBySSFTAdv[SAT_LUT_X_NUM]	调整彩度区间的强度数值。值域范围：0 ~ 8。 SAT_LUT_X_NUM = 5。
u8SatBySLUTAdv[SAT_LUT_Y_NUM]	基于彩度区间调整饱和度的数值。值域范围：0 ~ 128。 SAT_LUT_Y_NUM = 6。
u8SatCoring	彩度全部减一个值降低彩度。值域范围：0 ~ 255。

3.23. MI_ISP_IQ_RgbMatrix结构体¶

3.23.1. 类型结构体（Type Structure）

说明

设定色彩校正矩阵的类型结构体。

定义

typedef struct MI_ISP_IQ_RgbMatrixType_s

{

    MI_ISP_IQ_Bool_e          bEnable;

    MI_ISP_IQ_OpType_e         enOpType;

    MI_ISP_IQ_RgbMatrixAutoAttr_t   stAuto;

    MI_ISP_IQ_RgbMatrixManualAttr_t    stManual;

} MI_ISP_IQ_RgbMatrixType_t;

名称

变量名称	描述
bEnable	设定色彩校正矩阵功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定色彩校正矩阵的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定色彩校正矩阵的自动模式属性结构体。
stManual	设定色彩校正矩阵的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetRgbMatrix(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_RgbMatrixType_t *data);

MI_S32 MI_ISP_IQ_GetRgbMatrix(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_RgbMatrixType_t *data);

3.23.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定色彩校正矩阵的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_RgbMatrixAutoAttr_s

{

    MI_ISP_IQ_Bool_e      bISOActEn;

    MI_ISP_IQ_RgbMatrixParam_t   stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_RgbMatrixAutoAttr_t;

名称

变量名称	描述
bISOActEn	设定ISO功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stParaAPI[MI_ISP_AUTO_NUM]	自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.23.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定色彩校正矩阵的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_RgbMatrixManualAttr_s

{

    MI_U16  u16CCM[CCM_COEFF_SUM_INFO_NUM];

    MI_U8  u8CCMSat;

} MI_ISP_IQ_RgbMatrixManualAttr_t;

名称

变量名称	描述
u16CCM[CCM_COEFF_SUM_INFO_NUM]	色彩校正矩阵参数值。值域范围：0 ~ 8191。 CCM_COEFF_SUM_INFO_NUM = 12 u16CCM[3] = mod(u16CCM[0]+u16CCM[1]+u16CCM[2], 1024) u16CCM[7] = mod(u16CCM[4]+u16CCM[5]+u16CCM[6], 1024) u16CCM[11] = mod(u16CCM[8]+u16CCM[9]+u16CCM[10], 1024)
u8CCMSat	透过色彩校正矩阵调整饱和度的数值强度。值域范围：0 ~ 100。

注意事项

u8CCMSat = 0表示为色彩校正的单位矩阵数值。

u8CCMSat = 100表示为色彩校正的矩阵数值。

3.23.4. 参数结构体（Parameter Structure）

说明

设定色彩校正矩阵的参数结构体。

定义

typedef struct MI_ISP_IQ_RgbMatrixParam_s

{

    MI_U16 u16CCTthr;

    MI_U16 u16CCM[CCM_COEFF_SUM_INFO_NUM];

    MI_U8    u8CCMSat;

} MI_ISP_IQ_RgbMatrixParam_t;

名称

变量名称	描述
u16CCTthr	该组CCM的代表色温。值域范围：0 ~ 10000。
u16CCM[CCM_COEFF_SUM_INFO_NUM]	色彩校正矩阵参数值。值域范围：0 ~ 8191。 CCM_COEFF_SUM_INFO_NUM = 12 u16CCM[3] = mod(u16CCM[0]+u16CCM[1]+u16CCM[2], 1024) u16CCM[7] = mod(u16CCM[4]+u16CCM[5]+u16CCM[6], 1024) u16CCM[11] = mod(u16CCM[8]+u16CCM[9]+u16CCM[10], 1024)
u8CCMSat	透过色彩校正矩阵调整饱和度的数值强度。值域范围：0 ~ 100。

注意事项

u8CCMSat = 0表示为色彩校正的单位矩阵数值。

u8CCMSat = 100表示为色彩校正的矩阵数值。

3.24. MI_ISP_IQ_CcmInfo结构体¶

3.24.1. 类型结构体（Type Structure）

说明

取得当前色温的色彩校正矩阵的类型结构体。

定义

typedef struct MI_ISP_IQ_CcmInfoType_s

{

    MI_U16 u16CCM[CCM_COEFF_SUM_INFO_NUM]; //0 ~ 8191（1024 = 1x）

    MI_U16 u16CCT;

} MI_ISP_IQ_CcmInfoType_t;

名称

变量名称	描述
u16CCM[CCM_COEFF_SUM_INFO_NUM]	色彩校正矩阵包含CCM coefficient总和信息的参数值。值域范围：0 ~ 8191。CCM_COEFF_SUM_INFO_NUM = 12。 u16CCM[0 ~ 3] → CCM00, CCM01, CCM02, CCM_R_sum u16CCM[4 ~ 7] → CCM10, CCM11, CCM12, CCM_G_sum u16CCM[8 ~ 11] → CCM20, CCM21, CCM22, CCM_B_sum
u16CCT	获取目前色温数值。

相关结构类型与函式

MI_S32 MI_ISP_IQ_QueryCcmInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_CcmInfoType_t *data);

3.25. MI_ISP_IQ_FalseColor结构体¶

3.25.1. 类型结构体（Type Structure）

说明

设定去伪彩的类型结构体。

定义

typedef struct MI_ISP_IQ_FalseColorType_s

{

    MI_ISP_IQ_Bool_e          bEnable;

    MI_ISP_IQ_OpType_e         enOpType;

    MI_ISP_IQ_FalseColorAutoAttr_t   stAuto;

    MI_ISP_IQ_FalseColorManualAttr_t  stManual;

} MI_ISP_IQ_FalseColorType_t;

名称

变量名称	描述
bEnable	设定去伪彩功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定去伪彩的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定去伪彩的自动模式属性结构体。
stManual	设定去伪彩的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetFalseColor(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_FalseColorType_t *data);

MI_S32 MI_ISP_IQ_GetFalseColor(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_FalseColorType_t *data);

3.25.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定去伪彩的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_FalseColorAutoAttr_s

{

    MI_ISP_IQ_FalseColorParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_FalseColorAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.25.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定去伪彩的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_FalseColorManualAttr_s

{

    MI_ISP_IQ_FalseColorParam_t stParaAPI;

} MI_ISP_IQ_FalseColorManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.25.4. 参数结构体（Parameter Structure）

说明

设定去伪彩的参数结构体。

定义

typedef struct MI_ISP_IQ_FalseColorParam_s

{

    MI_ISP_IQ_Bool_e  bDbgEn;

    MI_U8       u8ColorSpaceSel;

    MI_U8       u8Preserve;

    MI_U8       u8Strength;

} MI_ISP_IQ_FalseColorParam_t;

名称

变量名称	描述
bDbgEn	Debug模式，值域范围：0 ~ 1，影像越亮则去伪彩强度越强。此debug模式和Demosiac的debug模式会有冲突，以最后呼叫的api为主。
u8ColorSpaceSel	去伪彩模式，值域范围：0 ~ 1，0代表在RGB domain做灰，对齐G通道的值，1代表在yuv domain做灰，不会影响到亮度。
u8Preserve	边缘保护强度，值域范围：0 ~ 7，值越大则边缘区域越不容易被判断成moire区域，去伪彩强度越弱。
u8Strength	整体强度，值域范围：0 ~ 31，值越大则moire区域愈容易被降饱和度，去伪彩强度越强。

3.26. MI_ISP_IQ_Nr3d结构体¶

3.26.1. 类型结构体（Type Structure）

说明

设定3D降噪的类型结构体。

定义

typedef struct MI_ISP_IQ_Nr3dType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_OpType_e       enOpType;

    MI_ISP_IQ_Nr3dAutoAttr_t    stAuto;

    MI_ISP_IQ_Nr3dManualAttr_t   stManual;

} MI_ISP_IQ_Nr3dType_t;

名称

变量名称	描述
bEnable	设定3D降噪功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定3D降噪的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定3D降噪的自动模式属性结构体。
stManual	设定3D降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNr3d(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_Nr3dType_t *data);

MI_S32 MI_ISP_IQ_GetNr3d(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_Nr3dType_t *data);

3.26.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定3D降噪的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_Nr3dAutoAttr_s

{

    MI_ISP_IQ_Nr3dParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_Nr3dAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.26.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定3D降噪的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_Nr3dManualAttr_s

{

    MI_ISP_IQ_Nr3dParam_t stParaAPI;

} MI_ISP_IQ_Nr3dManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.26.4. 参数结构体（Parameter Structure）

说明

设定3D降噪的参数结构体。

定义

typedef struct MI_ISP_IQ_Nr3dParam_s
{
    MI_U8       u8TfStrY;
    MI_U8       u8TfStrC;
    MI_U8       u8MdThd;
    MI_U16  u16MdGain;
    MI_U16  u16MotEdgeRefineStr;
    MI_U8       u8MdThdByY[NR3D_BY_Y_NUM];
    MI_U8       u8MdGainByY[NR3D_BY_Y_NUM];
    MI_U8       u8M2SLut[NR3D_BY_MOT_NUM];
    MI_U8       u8M2SHistDelayByDiff[NR3D_BY_MOT_NUM];
    MI_U16  u16TfLut[NR3D_BY_MOT_NUM];
    MI_U8       u8MotShpBlendLut[NR3D_BY_MOT_NUM];
} MI_ISP_IQ_Nr3dParam_t;

名称

变量名称	描述
u8TfStrY	控制去Y noise的temporal denoise 强度，值域0 ~ 127，值越大denoise强度越强。
u8TfStrC	控制去color noise的temporal denoise 强度，值域0 ~ 127，值越大denoise强度越强。
u8MdThd	MD侦测，控制motion阀值，小于此阀值判断为静止物体，值越大3D降噪越强。值域范围：0 ~ 255。
u16MdGain	MD侦测，控制motion程度，值越大越容易判断为静止物体，3D降噪越强。值域范围：0 ~ 10230。
u16MotEdgeRefineStr	抑制移动物体前缘被判定为动态区的强度。值域0 ~ 1023，越大移动物体前缘越不容易被判定为动态区，但须同时注意避免造成严重拖影。
u8MdThdByY[NR3D_BY_Y_NUM]	根据亮度控制motion阀值，值越大3D降噪越强。值域范围：0 ~ 255。NR3D_BY_Y_NUM = 16。
u8MdGainByY[NR3D_BY_Y_NUM]	根据亮度控制motion程度，值越大3D降噪越强。值域范围：0 ~ 255。NR3D_BY_Y_NUM = 16。
u8M2SLut[NR3D_BY_MOT_NUM]	移动到静止过程中，3D降噪的收敛速度，值越小，收敛越慢，可用来避免拖影。值域范围：0 ~ 255。 NR3D_BY_MOT_NUM = 16。
u8M2SHistDelayByDiff[NR3D_BY_MOT_NUM]	Motion信息延迟时间，值域范围：0 ~ 7。横轴为当前帧和前一帧的motion信息差异，纵轴为motion信息往后级传的额外延迟时间，值越大则延迟越久，希望静态的motion信息有延迟，让运动过后的区域的motion信息持续久一些，在3DNR还未收敛前，让后级的2DNR能保持在较强的强度（动区通常强度较强）久一些。
u16TfLut[NR3D_BY_MOT_NUM]	根据移动程度，控制3D降噪的强度。值域范围：0 ~ 4095。 NR3D_BY_MOT_NUM = 16。
u8MotShpBlendLut[NR3D_BY_MOT_NUM]	根据移动程度，控制2D降噪的强度。值域范围：0 ~ 64。 NR3D_BY_MOT_NUM = 16。

3.27. MI_ISP_IQ_NrDespike结构体¶

3.27.1. 类型结构体（Type Structure）

说明

设定DeSpike降噪的类型结构体。

定义

typedef struct MI_ISP_IQ_NrDespikeType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_OpType_e       enOpType;

    MI_ISP_IQ_NrDespikeAutoAttr_t   stAuto;

    MI_ISP_IQ_NrDespikeManualAttr_t  stManual;

} MI_ISP_IQ_NrDespikeType_t;

名称

变量名称	描述
bEnable	设定DeSpike降噪功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定DeSpike降噪的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定DeSpike降噪的自动模式属性结构体。
stManual	设定DeSpike降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNrDeSpike(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrDespikeType_t *data);

MI_S32 MI_ISP_IQ_GetNrDeSpike(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrDespikeType_t *data);

3.27.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定DeSpike降噪的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_NrDespikeAutoAttr_s

{

    MI_ISP_IQ_NrDespikeParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_NrDespikeAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.27.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定DeSpike降噪的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_NrDespikeManualAttr_s

{

    MI_ISP_IQ_NrDespikeParam_t stParaAPI;

} MI_ISP_IQ_NrDespikeManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.27.4. 参数结构体（Parameter Structure）

说明

设定DeSpike降噪的参数结构体。

定义

typedef struct MI_ISP_IQ_NrDespikeParam_s
{
    MI_U8   u8BlendRatio;
    MI_U8   u8StrengthCenterNeighbor;
    MI_U8   u8StrengthMeanStd;
    MI_U8   u8StrengthCornerCross;
    MI_U8   u8DiffGainMeanStd;
    MI_U8   u8DiffGainCenterNeighbor;
    MI_U8       u8DiffThdCornerCross;
    MI_U16      u16BlendLut[NRDESPIKE_BLEND_LUT_NUM];
    MI_U8   u8StrengthByY[NRDESPIKE_BY_Y_NUM];
} MI_ISP_IQ_NrDespikeParam_t;

名称

变量名称	描述
u8BlendRatio	调整NRDeSpike去噪整体强度，此数值越大去噪效果越强。值域范围：0 ~ 15。
u8StrengthMeanStd	调整中心点与周围端点平均差值的强度。值域范围：0 ~ 5。
u8StrengthCenterNeighbor	调整中心点与十字或对角十字端点平均差值的强度。值域范围：0 ~ 5。
u8StrengthCornerCross	调整对角十字和十字端点平均值相减值的强度。值域范围：0 ~ 5。
u8DiffGainMeanStd	调整中心点与周围端点平均差值乘上的Gain值。值域范围：0 ~ 31。
u8DiffThdCenterNeighbor	调整中心点与十字或对角十字端点平均差值的threshold数值。值域范围：0 ~ 255。
u8DiffThdCornerCross	调整对角十字和十字端点平均值相减值的threshold数值。值域范围：0 ~ 255。
u16BlendLut[NRDESPIKE_BLEND_LUT_NUM]	根据亮度选用median/mean的混合比例，值越大越偏向median设定，值越小越偏向mean设定。值域范围：0 ~ 2047。NRDESPIKE_BLEND_LUT_NUM = 5。
u8StrengthByY[NRDESPIKE_BY_Y_NUM]	根据亮度给予不同强度，64为不调整，越小越弱。值域范围：0 ~ 64。NRDESPIKE_BY_Y_NUM = 16。

注意事项
- 根据中心点与周围的端点差异，差异越大，越容易将中心点抹除。
- 当DiffGain设定越小、Strength设定越大，越容易将中心点抹除。

3.28. MI_ISP_IQ_Sharpness结构体¶

3.28.1. 类型结构体（Type Structure）

说明

设定锐度的类型结构体。

定义

typedef struct MI_ISP_IQ_ShapnessType_s

{

    MI_ISP_IQ_Bool_e          bEnable;

    MI_ISP_IQ_OpType_e         enOpType;

    MI_ISP_IQ_ShapnessAutoAttr_t    stAuto;

    MI_ISP_IQ_ShapnessManualAttr_t   stManual;

} MI_ISP_IQ_ShapnessType_t;

名称

变量名称	描述
bEnable	设定锐度功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定锐度的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定锐度的自动模式属性结构体。
stManual	设定锐度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetSharpness(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ShapnessType_t *data);

MI_S32 MI_ISP_IQ_GetSharpness(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ShapnessType_t *data);

3.28.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定锐度的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_ShapnessAutoAttr_s

{

    MI_ISP_IQ_ShapnessParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_ShapnessAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.28.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定锐度的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_ShapnessManualAttr_s

{

    MI_ISP_IQ_ShapnessParam_t stParaAPI;

} MI_ISP_IQ_ShapnessManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.28.4. 参数结构体（Parameter Structure）

说明

设定锐度的参数结构体。

定义

typedef struct MI_ISP_IQ_SharpnessParam_s {
    MI_U8            u8SharpnessUD[SHARPNESS_FREQ_NUM];
    MI_U8            u8SharpnessD[SHARPNESS_FREQ_NUM];
    MI_U8            u8PreCorUD[SHARPNESS_FREQ_NUM];
    MI_U8            u8PreCorD[SHARPNESS_FREQ_NUM];
    MI_U8            u8FilterSel;
    MI_U8            u8StateByGain[SHARPNESS_DA_STATE_NUM];
    MI_U8            u8StateByOffset[SHARPNESS_DA_STATE_NUM];
    MI_U8            u8StdvByY[SHARPNESS_BY_Y_NUM];
    MI_U8            u8StdvByMot[SHARPNESS_BY_MOT_NUM];
    MI_U16           u16UDWeiByState[SHARPNESS_FREQ_WEI_NUM];
    MI_U16           u16DWeiByState[SHARPNESS_FREQ_WEI_NUM];
    MI_U16           u16UDWeiByMot[SHARPNESS_BY_MOT_NUM];
    MI_U16           u16DWeiByMot[SHARPNESS_BY_MOT_NUM];
    MI_U8            u8UDGainByStd[SHARPNESS_LUT_Y_NUM];
    MI_U8            u8DGainByStd[SHARPNESS_LUT_Y_NUM];
    MI_U16           u16UDEdgeKillLutUp[SHARPNESS_LUT_Y_NUM];
    MI_U16           u16UDEdgeKillLutDown[SHARPNESS_LUT_Y_NUM];
    MI_U16           u16DEdgeKillLutUp[SHARPNESS_LUT_Y_NUM];
    MI_U16           u16DEdgeKillLutDown[SHARPNESS_LUT_Y_NUM];
    MI_U16           u16DRatioByState[SHARPNESS_BY_STATE_NUM];
    MI_U16           u16EdgeGain;
    MI_U8            u8GainByStd[SHARPNESS_LUT_Y_NUM];
    MI_U8            u8GainByStdSft[SHARPNESS_LUT_X_NUM];
    MI_U8            u8CorByY[SHARPNESS_BY_Y_NUM];
    MI_U8            u8SclByY[SHARPNESS_BY_Y_NUM];
    MI_U8            u8GainByMot[SHARPNESS_BY_MOT_NUM];
    MI_U8            u8DerRmNRCnt[SHARPNESS_DER_Y_NUM];
    MI_U8            u8DerOverShootGain[SHARPNESS_LUT_Y_NUM];
    MI_U8            u8DerUnderShootGain[SHARPNESS_LUT_Y_NUM];
    MI_U8            u8DerGainByMot[SHARPNESS_BY_MOT_NUM];
    MI_U16           u16DerOverShootLimitByY[SHARPNESS_BY_Y_NUM];
    MI_U16           u16DerUnderShootLimitByY[SHARPNESS_BY_Y_NUM];
    MI_U8            u8StrengthByHue[SHARPNESS_BY_HUE_NUM];
    MI_U8            u8StrengthBySat[SHARPNESS_BY_SAT_NUM];
    MI_U8            u8BranchStrength;
    MI_U8            u8BranchGainByStd[SHARPNESS_LUT_Y_NUM];
    MI_ISP_IQ_Bool_e bDbgEn;
} MI_ISP_IQ_SharpnessParam_t;

名称

变量名称	描述
u8SharpnessUD[SHARPNESS_FREQ_NUM]	无向性edge的强度，用于提高发丝和草地等细小纹理清晰度，值域范围：0 ~ 127。横轴依序为高频/中频/中低频，纵轴为无向性edge的强度增益，值越大则edge越强。SHARPNESS_FREQ_NUM = 3。
u8SharpnessD[SHARPNESS_FREQ_NUM]	方向性edge的强度，用于增强图像边缘，但调的太强会导致锯齿状，值域范围：0 ~ 127。横轴依序为高频/中频/中低频，纵轴为方向性edge的强度增益，值越大则edge越强。SHARPNESS_FREQ_NUM = 3。
u8PreCorUD[SHARPNESS_FREQ_NUM]	无向性edge做coring，值域范围：0 ~ 63。横轴依序为高频/中频/中低频，纵轴为无向性edge的coring值，值越大则edge越弱。SHARPNESS_FREQ_NUM = 3。 [名词解释] coring（简称cor）：单纯做同减的动作。
u8PreCorD[SHARPNESS_FREQ_NUM]	方向性edge做coring，值域范围：0 ~ 63。横轴依序为高频/中频/中低频，纵轴为方向性edge的coring值，值越大则edge越弱。SHARPNESS_FREQ_NUM = 3。
u8FilterSel	提供两种边缘状态（edge state）的滤波器，值域范围：0 ~ 1。
u8StateByGain[SHARPNESS_DA_STATE_NUM]	依据增益量调整滤波器得到边缘数值，增益量越小表示保留较多复杂区/平坦区，值域范围：0 ~ 31。横轴为滤波器得到边缘数值，数值越小判断成复杂区/平坦区、数值越大判断成单纯边缘区。索引0：方向性/无向性的边缘状态、索引1：频率响应的边缘状态。 SHARPNESS_DA_STATE_NUM = 2。 [名词解释] state：使用StateByGain & StateByOffset计算得到边缘状态的分数，来判断单纯边缘区和复杂区，值越小则越偏向单纯边缘区。
u8StateByOffset[SHARPNESS_DA_STATE_NUM]	依据位移量调整滤波器得到边缘数值，位移量越大表示保留较多复杂区/平坦区，值域范围：0 ~ 255。横轴为滤波器得到边缘数值，数值越小判断成复杂区/平坦区、数值越大判断成单纯边缘区。索引0：方向性/无向性的边缘状态、索引1：频率响应的边缘状态。 SHARPNESS_DA_STATE_NUM = 2。
u8StdvByY[SHARPNESS_BY_Y_NUM]	依据亮度调整标准偏差的增益，值域范围：0 ~ 255。横轴为亮度，越右边越偏亮，纵轴为调整标准偏差的增益（64 = 1x），值越大则标准偏差越大。SHARPNESS_BY_Y_NUM = 9。
u8StdvByMot[SHARPNESS_BY_MOT_NUM]	依据motion调整标准偏差的增益，值域范围：0 ~ 63。横轴为motion，越右边越偏静，纵轴为调整标准偏差的增益（16 = 1x），值越大则标准偏差越大。 SHARPNESS_BY_MOT_NUM = 16。
u16UDWeiByState[SHARPNESS_FREQ_WEI_NUM]	依据state调整无向性边缘的中低频/中频/高频edge混合比例，值域范围：0 ~ 256。横轴由左至右依序为静态边缘区（索引0）、静态纹理细节区（索引1）、动态边缘区（索引2）、动态纹理细节区（索引3），纵轴为混合比例的权重数值，当权重值等于0时，则偏向中低频edge、当权重值等于256时，则偏向高频edge。 SHARPNESS_FREQ_WEI_NUM = 4。
u16DWeiByState[SHARPNESS_FREQ_WEI_NUM]	依据state调整方向性边缘的中低频/中频/高频edge混合比例，值域范围：0 ~ 256。横轴由左至右依序为静态边缘区（索引0）、静态纹理细节区（索引1）、动态边缘区（索引2）、动态纹理细节区（索引3），纵轴为混合比例的权重数值，当权重值等于0时，则偏向中低频edge、当权重值等于256时，则偏向高频edge。 SHARPNESS_FREQ_WEI_NUM = 4。
u16UDWeiByMot[SHARPNESS_BY_MOT_NUM]	依据motion调整无向性的权重，值域范围：0 ~ 256。横轴为motion由动至静，越右边越偏静，纵轴为调整无向性的权重，值越大则越偏向静态state。 SHARPNESS_BY_MOT_NUM = 16。
u16DWeiByMot[SHARPNESS_BY_MOT_NUM]	依据motion调整方向性的权重，值域范围：0 ~ 256。横轴为motion由动至静，越右边越偏静，纵轴为调整方向性的权重，值越大则越偏向静态state。 SHARPNESS_BY_MOT_NUM = 16。
u8UDGainByStd[SHARPNESS_LUT_Y_NUM]	依据标准偏差调整无向性的增益，值域范围：0 ~ 255。横轴为经过StdvByY和StdvByMot处理过的标准偏差，越右边标准偏差越大，纵轴为edge增益（64 = 1x），值越大则edge越强。SHARPNESS_LUT_Y_NUM = 7。
u8DGainByStd[SHARPNESS_LUT_Y_NUM]	依据标准偏差调整方向性的增益，值域范围：0 ~ 255。横轴为经过StdvByY和StdvByMot处理过的标准偏差，越右边标准偏差越大，纵轴为edge增益（64 = 1x），值越大则edge越强。SHARPNESS_LUT_Y_NUM = 7。
u16UDEdgeKillLutUp[SHARPNESS_LUT_Y_NUM]	根据edge强度调整无向性白边的edge强度，值域范围：0 ~ 1023。横轴为输入edge，纵轴为输出edge，值越大则edge越强。SHARPNESS_LUT_Y_NUM = 7。
u16UDEdgeKillLutDown[SHARPNESS_LUT_Y_NUM]	根据edge强度调整无向性黑边的edge强度，值域范围：0 ~ 1023。横轴为输入edge，纵轴为输出edge，值越大则edge越强。SHARPNESS_LUT_Y_NUM = 7。
u16DEdgeKillLutUp[SHARPNESS_LUT_Y_NUM]	根据edge强度调整方向性白边的edge强度，值域范围：0 ~ 1023。横轴为输入edge，纵轴为输出edge，值越大则edge越强。SHARPNESS_LUT_Y_NUM = 7。
u16DEdgeKillLutDown[SHARPNESS_LUT_Y_NUM]	根据edge强度调整方向性黑边的edge强度，值域范围：0 ~ 1023。横轴为输入edge，纵轴为输出edge，值越大则edge越强。SHARPNESS_LUT_Y_NUM = 7。
u16DRatioByState[SHARPNESS_BY_STATE_NUM]	依据state调整无向性与方向性edge的混合比例，值域范围：0 ~ 256。横轴越左边越偏单纯边缘区，越右边越偏复杂区/平坦区，纵轴为混合无向性与方向性edge，值越大则越偏向方向性edge。SHARPNESS_BY_STATE_NUM = 9。
u16EdgeGain	整体增益调整，值域范围：0 ~ 1023。 Edge增益（128 = 1x），值越大则edge强度越强。
u8GainByStd[SHARPNESS_LUT_Y_NUM]	依据标准偏差调整整体增益，值域范围：0 ~ 255。横轴为经过StdvByY和StdvByMot处理过的标准偏差，越右边标准偏差越大，纵轴为edge增益（64 = 1x），值越大则edge越强。通常平坦区的标准偏差较小，因此可以降低标准偏差小的区域的edge，让平坦区更平顺。也可以用来降低运动的edge，若将StdvByMot的前几格降低，则GainByStd就会查到前几格，使得运动区降低edge。总共有七个节点，如有需要改变横轴节点，可调整GainByStdSft。 SHARPNESS_LUT_Y_NUM = 7。
u8GainByStdSft[SHARPNESS_LUT_X_NUM]	GainByStd的横轴节点，值域范围：0 ~ 15。有七个断点，横轴依序为0、2^{GainByStdSft[0]、2}GainByStdSft[0] + 2^{GainByStdSft[1]、2}GainByStdSft[0] + 2^GainByStdSft[1] + 2^GainByStdSft[2]、...等等，纵轴依序为GainByStd[0]、GainByStd[1]、GainByStd[2] ...等等。如需调整，建议用Excel画出原本的曲线，调整GainByStdSft将想要细调的区间切细后，找到对应的GainByStd，确认效果和先前一致后，再调整GainByStd。 SHARPNESS_LUT_X_NUM = 6。
u8CorByY[SHARPNESS_BY_Y_NUM]	依据亮度调整coring，值域范围：0 ~ 255。横轴为亮度，越右边越偏亮，纵轴为coring 值，值越大则edge越弱。SHARPNESS_BY_Y_NUM = 9。
u8SclByY[SHARPNESS_BY_Y_NUM]	依据亮度调整edge增益，值域范围：0 ~ 255。横轴为亮度，越右边越偏亮，纵轴为edge增益（64 = 1x），值越大则edge越强。SHARPNESS_BY_Y_NUM = 9。
u8GainByMot[SHARPNESS_BY_MOT_NUM]	依据motion调整最终edge增益，值域范围：0 ~ 255。横轴为motion由动至静，越右边越偏静，纵轴为edge增益（128 = 1x），值越大则edge越强。 SHARPNESS_BY_MOT_NUM = 16。
u8DerRmNRCnt[SHARPNESS_DER_Y_NUM]	排除最小（索引0）、最大（索引1）的去除振铃效应的噪声点数量，值域范围：0 ~ 6。SHARPNESS_DER_Y_NUM = 2。
u8DerOverShootGain[SHARPNESS_LUT_Y_NUM]	白边的强度调整去振铃效应增益，值域范围：0 ~ 255。值越大则白边强度越强。SHARPNESS_LUT_Y_NUM = 7。
u8DerUnderShootGain[SHARPNESS_LUT_Y_NUM]	黑边的强度调整去振铃效应增益，值域范围：0 ~ 255。值越大则黑边强度越强。SHARPNESS_LUT_Y_NUM = 7。
u8DerGainByMot[SHARPNESS_BY_MOT_NUM]	根据motion调整edge去振铃效应强度，值域范围：0 ~ 255，横轴为motion，越右边越偏静，纵轴为去振铃效应强度（64 = 1x），值越大则去振铃效应越强。 SHARPNESS_BY_MOT_NUM = 16。
u16DerOverShootLimitByY[SHARPNESS_BY_Y_NUM]	依据亮度调整去振铃效应，值域范围：0 ~ 1023。横轴为亮度，越右边越偏亮，纵轴为edge强度，值越大代表保留较多白边强度。SHARPNESS_BY_Y_NUM = 9。
u16DerUnderShootLimitByY[SHARPNESS_BY_Y_NUM]	依据亮度调整去振铃效应，值域范围：0 ~ 1023。横轴为亮度，越右边越偏亮，纵轴为edge强度，值越小代表保留较多黑边强度。SHARPNESS_BY_Y_NUM = 9。
u8StrengthByHue[SHARPNESS_BY_HUE_NUM]	根据hue调整edge强度，值域范围：0 ~ 255。横轴为hue（同HSV），纵轴为edge增益（64 = 1x），值越大则edge越强，实际效果受到StrengthBySat影响。 SHARPNESS_BY_HUE_NUM = 24。
u8StrengthBySat[SHARPNESS_BY_SAT_NUM]	根据saturation调整edge强度，值域范围：0 ~ 255。横轴为saturation，当saturation小于StrengthBySat[0]，则StrengthByHue失效，也就是edge强度的调整不受到饱和度太低的hue影响，当saturation大于StrengthBySat[1]，则完全依据StrengthByHue调整edge强度，过度区则线性变化。SHARPNESS_BY_SAT_NUM = 2。
u8BranchStrength	输出Sharpness强度，用于NR3D – MotShpBlendLut，值域范围：0 ~ 255。 Edge强度（64 = 1x），值越大则edge越强。
u8BranchGainByStd[SHARPNESS_LUT_Y_NUM]	依据标准偏差调整增益，值域范围：0 ~ 255。横轴为经过StdvByY和StdvByMot处理过的标准偏差，越右边标准偏差越大，纵轴为Edge增益（128 = 1x），值越大则edge越强。 SHARPNESS_LUT_Y_NUM = 7。
bDbgEn	Debug模式，值域范围：0 ~ 1。灰色代表没上edge，白/黑色分别代表白/黑边。

3.29. MI_ISP_IQ_SharpnessEx结构体¶

3.29.1. 类型结构体（Type Structure）

说明

设定锐度的类型结构体。

定义

typedef struct MI_ISP_IQ_ShapnessExType_s
{
    MI_ISP_IQ_Bool_e                    bEnable;
    MI_ISP_IQ_OpType_e                  enOpType;
    MI_ISP_IQ_ShapnessExAutoAttr_t      stAuto;
    MI_ISP_IQ_ShapnessExManualAttr_t    stManual;
} MI_ISP_IQ_ShapnessExType_t;

名称

变量名称	描述
bEnable	设定锐度功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定锐度的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定锐度的自动模式属性结构体。
stManual	设定锐度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetShpEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ShapnessExType_t *data);

MI_S32 MI_ISP_IQ_GetShpEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ShapnessExType_t *data);

3.29.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定锐度的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_ShapnessExAutoAttr_s
{
    MI_ISP_IQ_ShapnessExParam_t stParaAPI[MI_ISP_AUTO_NUM];
} MI_ISP_IQ_ShapnessExAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.29.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定锐度的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_ShapnessExManualAttr_s
{
    MI_ISP_IQ_ShapnessExParam_t stParaAPI;
} MI_ISP_IQ_ShapnessExManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.29.4. 参数结构体（Parameter Structure）

说明

设定锐度的参数结构体。

定义

typedef struct MI_ISP_IQ_SharpnessExParam_s
{
    MI_U8            u8Sharpness[SHARPNESSEX_FREQ_NUM];
    MI_U8            u8PreCor[SHARPNESSEX_FREQ_NUM];
    MI_U8            u8StateByGain;
    MI_U8            u8StateByOffset;
    MI_U8            u8StdvByY[SHARPNESSEX_BY_Y_NUM];
    MI_U8            u8StdvByMot[SHARPNESSEX_BY_MOT_NUM];
    MI_U16           u16WeiByState[SHARPNESSEX_FREQ_WEI_NUM];
    MI_U16           u16WeiByMot[SHARPNESSEX_BY_MOT_NUM];
    MI_U16           u16EdgeGain;
    MI_U8            u8GainByStd[SHARPNESSEX_LUT_Y_NUM];
    MI_U8            u8GainByStdSft[SHARPNESSEX_LUT_X_NUM];
    MI_U8            u8CorByY[SHARPNESSEX_BY_Y_NUM];
    MI_U8            u8SclByY[SHARPNESSEX_BY_Y_NUM];
    MI_U8            u8GainByMot[SHARPNESSEX_BY_MOT_NUM];
    MI_U8            u8DerOverShootGain[SHARPNESSEX_LUT_Y_NUM];
    MI_U8            u8DerUnderShootGain[SHARPNESSEX_LUT_Y_NUM];
    MI_U8            u8DerGainByMot[SHARPNESSEX_BY_MOT_NUM];
    MI_U16           u16DerOverShootLimitByY[SHARPNESSEX_BY_Y_NUM];
    MI_U16           u16DerUnderShootLimitByY[SHARPNESSEX_BY_Y_NUM];
    MI_U8            u8StrengthByHue[SHARPNESSEX_BY_HUE_NUM];
    MI_U8            u8StrengthBySat[SHARPNESSEX_BY_SAT_NUM];
    MI_ISP_IQ_Bool_e bDbgEn;
} MI_ISP_IQ_SharpnessExParam_t;

名称

变量名称	描述
u8Sharpness[SHARPNESSEX_FREQ_NUM]	无向性edge的强度，用于提高发丝和草地等细小纹理清晰度，值域范围：0 ~ 127。横轴依序为高频/中频，纵轴为无向性edge的强度增益，值越大则edge越强。 SHARPNESSEX_FREQ_NUM = 2。
u8PreCor[SHARPNESSEX_FREQ_NUM]	无向性edge做coring，值域范围：0 ~ 63。横轴依序为高频/中频，纵轴为无向性edge的coring值，值越大则edge越弱。SHARPNESSEX_FREQ_NUM = 2。
u8StateByGain	依据增益量调整滤波器得到边缘数值，增益量越小表示保留较多复杂区/平坦区，值域范围：0 ~ 31。横轴为滤波器得到边缘数值，数值越小判断成复杂区/平坦区、数值越大判断成单纯边缘区。
u8StateByOffset	依据位移量调整滤波器得到边缘数值，位移量越大表示保留较多复杂区/平坦区，值域范围：0 ~ 255。横轴为滤波器得到边缘数值，数值越小判断成复杂区/平坦区、数值越大判断成单纯边缘区。
u8StdvByY[SHARPNESSEX_BY_Y_NUM]	依据亮度调整标准偏差的增益，值域范围：0 ~ 255。横轴为亮度，越右边越偏亮，纵轴为调整标准偏差的增益（64 = 1x），值越大则标准偏差越大。SHARPNESSEX_BY_Y_NUM = 9。
u8StdvByMot[SHARPNESSEX_BY_MOT_NUM]	依据motion调整标准偏差的增益，值域范围：0 ~ 63。横轴为motion，越右边越偏静，纵轴为调整标准偏差的增益（16 = 1x），值越大则标准偏差越大。 SHARPNESSEX_BY_MOT_NUM = 16。
u16WeiByState[SHARPNESSEX_FREQ_WEI_NUM]	依据state调整无向性边缘的中频/高频edge混合比例，值域范围：0 ~ 128。横轴由左至右依序为静态边缘区（索引0）、静态纹理细节区（索引1）、动态边缘区（索引2）、动态纹理细节区（索引3），纵轴为混合比例的权重数值，当权重值等于0时，则偏向中频edge、当权重值等于128时，则偏向高频edge。 SHARPNESSEX_FREQ_WEI_NUM = 4。
u16WeiByMot[SHARPNESSEX_BY_MOT_NUM]	依据motion调整无向性的权重，值域范围：0 ~ 256。横轴为motion由动至静，越右边越偏静，纵轴为调整无向性的权重，值越大则越偏向静态state。 SHARPNESSEX_BY_MOT_NUM = 16。
u16EdgeGain	整体增益调整，值域范围：0 ~ 1023。 Edge增益（128 = 1x），值越大则edge强度越强。
u8GainByStd[SHARPNESSEX_LUT_Y_NUM]	依据标准偏差调整整体增益，值域范围：0 ~ 255。横轴为经过StdvByY和StdvByMot处理过的标准偏差，越右边标准偏差越大，纵轴为edge增益（64 = 1x），值越大则edge越强。通常平坦区的标准偏差较小，因此可以降低标准偏差小的区域的edge，让平坦区更平顺。也可以用来降低运动的edge，若将StdvByMot的前几格降低，则GainByStd就会查到前几格，使得运动区降低edge。总共有七个节点，如有需要改变横轴节点，可调整GainByStdSft。 SHARPNESSEX_LUT_Y_NUM = 7。
u8GainByStdSft[SHARPNESSEX_LUT_X_NUM]	GainByStd的横轴节点，值域范围：0 ~ 15。有七个断点，横轴依序为0、2^{GainByStdSft[0]、2}GainByStdSft[0] + 2^{GainByStdSft[1]、2}GainByStdSft[0] + 2^GainByStdSft[1] + 2^GainByStdSft[2]、...等等，纵轴依序为GainByStd[0]、GainByStd[1]、GainByStd[2] ...等等。如需调整，建议用Excel画出原本的曲线，调整GainByStdSft将想要细调的区间切细后，找到对应的GainByStd，确认效果和先前一致后，再调整GainByStd。 SHARPNESSEX_LUT_X_NUM = 6。
u8CorByY[SHARPNESSEX_BY_Y_NUM]	依据亮度调整coring，值域范围：0 ~ 255。横轴为亮度，越右边越偏亮，纵轴为coring 值，值越大则edge越弱。SHARPNESSEX_BY_Y_NUM = 9。
u8SclByY[SHARPNESSEX_BY_Y_NUM]	依据亮度调整edge增益，值域范围：0 ~ 255。横轴为亮度，越右边越偏亮，纵轴为edge增益（64 = 1x），值越大则edge越强。SHARPNESSEX_BY_Y_NUM = 9。
u8GainByMot[SHARPNESSEX_BY_MOT_NUM]	依据motion调整最终edge增益，值域范围：0 ~ 255。横轴为motion由动至静，越右边越偏静，纵轴为edge增益（128 = 1x），值越大则edge越强。 SHARPNESSEX_BY_MOT_NUM = 16。
u8DerOverShootGain[SHARPNESSEX_LUT_Y_NUM]	白边的强度调整去振铃效应增益，值域范围：0 ~ 255。值越大则白边强度越强。SHARPNESSEX_LUT_Y_NUM = 7。
u8DerUnderShootGain[SHARPNESSEX_LUT_Y_NUM]	黑边的强度调整去振铃效应增益，值域范围：0 ~ 255。值越大则黑边强度越强。SHARPNESSEX_LUT_Y_NUM = 7。
u8DerGainByMot[SHARPNESSEX_BY_MOT_NUM]	根据motion调整edge去振铃效应强度，值域范围：0 ~ 255，横轴为motion，越右边越偏静，纵轴为去振铃效应强度（64 = 1x），值越大则去振铃效应越强。 SHARPNESSEX_BY_MOT_NUM = 16。
u16DerOverShootLimitByY[SHARPNESSEX_BY_Y_NUM]	依据亮度调整去振铃效应，值域范围：0 ~ 1023。横轴为亮度，越右边越偏亮，纵轴为edge强度，值越大代表保留较多白边强度。SHARPNESSEX_BY_Y_NUM = 9。
u16DerUnderShootLimitByY[SHARPNESSEX_BY_Y_NUM]	依据亮度调整去振铃效应，值域范围：0 ~ 1023。横轴为亮度，越右边越偏亮，纵轴为edge强度，值越小代表保留较多黑边强度。SHARPNESSEX_BY_Y_NUM = 9。
u8StrengthByHue[SHARPNESSEX_BY_HUE_NUM]	根据hue调整edge强度，值域范围：0 ~ 255。横轴为hue（同HSV），纵轴为edge增益（64 = 1x），值越大则edge越强，实际效果受到StrengthBySat影响。 SHARPNESSEX_BY_HUE_NUM = 24。
u8StrengthBySat[SHARPNESSEX_BY_SAT_NUM]	根据saturation调整edge强度，值域范围：0 ~ 255。横轴为saturation，当saturation小于StrengthBySat[0]，则StrengthByHue失效，也就是edge强度的调整不受到饱和度太低的hue影响，当saturation大于StrengthBySat[1]，则完全依据StrengthByHue调整edge强度，过度区则线性变化。SHARPNESSEX_BY_SAT_NUM = 2。
bDbgEn	Debug模式，值域范围：0 ~ 1。灰色代表没上edge，白/黑色分别代表白/黑边。

3.30. MI_ISP_IQ_Crosstalk结构体¶

3.30.1. 类型结构体（Type Structure）

说明

设定串扰的类型结构体。

定义

typedef struct MI_ISP_IQ_CrosstalkType_s
{
    MI_ISP_IQ_Bool_e                    bEnable;
    MI_ISP_IQ_OpType_e                  enOpType;
    MI_ISP_IQ_CrosstalkAutoAttr_t       stAuto;
    MI_ISP_IQ_CrosstalkManualAttr_t     stManual;
} MI_ISP_IQ_CrosstalkType_t;

名称

变量名称	描述
bEnable	设定串扰功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定串扰的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定串扰的自动模式属性结构体。
stManual	设定串扰的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetCrossTalk(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_CrosstalkType_t *data);

MI_S32 MI_ISP_IQ_GetCrossTalk(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_CrosstalkType_t *data);

3.30.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定串扰的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_CrosstalkAutoAttr_s

{

    MI_ISP_IQ_CrosstalkParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_CrosstalkAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.30.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定串扰的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_CrosstalkManualAttr_s

{

    MI_ISP_IQ_CrosstalkParam_t stParaAPI;

} MI_ISP_IQ_CrosstalkManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.30.4. 参数结构体（Parameter Structure）

说明

设定串扰的参数结构体。

定义

typedef struct MI_ISP_IQ_CrosstalkParam_s

{

    MI_U8  u8Strength;

    MI_U8  u8StrengthByY[CROSSTALK_BY_Y_NUM];

    MI_U8  u8Threshold;

    MI_U16  u16ThresholdOffset;

} MI_ISP_IQ_CrosstalkParam_t;

名称

变量名称	描述
u8Strength	串扰的可变强度数值。值域范围：0 ~ 31。
u8StrengthByY[CROSSTALK_BY_Y_NUM]	依据亮度调整串扰强度数值。值域范围：0 ~ 127。 CROSSTALK_BY_Y_NUM = 15。
u8Threshold	串扰的阀值比例数值。值域范围：0 ~ 255。
u16ThresholdOffset	串扰的阀值平移数值。值域范围：0 ~ 4095。

注意事项

此功能开强会造成细节损失，因此如果没有串扰问题则不需要开启。

3.31. MI_ISP_IQ_Obc结构体¶

3.31.1. 类型结构体（Type Structure）

说明

设定黑电平的类型结构体。

定义

typedef struct MI_ISP_IQ_ObcType_s

{

    MI_ISP_IQ_Bool_e      bEnable;

    MI_ISP_IQ_OpType_e     enOpType;

    MI_ISP_IQ_ObcAutoAttr_t stAuto;

    MI_ISP_IQ_ObcManualAttr_t stManual;

} MI_ISP_IQ_ObcType_t;

名称

变量名称	描述
bEnable	设定黑电平功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定黑电平的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定黑电平的自动模式属性结构体。
stManual	设定黑电平的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetObc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ObcType_t *data);

MI_S32 MI_ISP_IQ_GetObc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ObcType_t *data);

MI_S32 MI_ISP_IQ_SetObcP1(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ObcType_t *data);

MI_S32 MI_ISP_IQ_GetObcP1(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ObcType_t *data);

3.31.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定黑电平的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_ObcAutoAttr_s

{

    MI_ISP_IQ_ObcParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_ObcAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.31.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定黑电平的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_ObcManualAttr_s

{

    MI_ISP_IQ_ObcParam_t stParaAPI;

} MI_ISP_IQ_ObcManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.31.4. 参数结构体（Parameter Structure）

说明

设定黑电平的参数结构体。

定义

typedef struct MI_ISP_IQ_ObcParam_s

{

    MI_U16 u16ValR;

    MI_U16 u16ValGr;

    MI_U16 u16ValGb;

    MI_U16 u16ValB;

} MI_ISP_IQ_ObcParam_t;

名称

变量名称	描述
u16ValR	R通道黑电平的可控制数值。 Pipeline 0值域范围：0 ~ 65535。 Pipeline 1值域范围：0 ~ 65535。
u16ValGr	Gr通道黑电平的可控制数值。 Pipeline 0值域范围：0 ~ 65535。 Pipeline 1值域范围：0 ~ 65535。
u16ValGb	Gb通道黑电平的可控制数值。 Pipeline 0值域范围：0 ~ 65535。 Pipeline 1值域范围：0 ~ 65535。
u16ValB	B通道黑电平的可控制数值。 Pipeline 0值域范围：0 ~ 65535。 Pipeline 1值域范围：0 ~ 65535。

3.32. MI_ISP_IQ_Wdr结构体¶

3.32.1. 类型结构体（Type Structure）

说明

设定宽动态的类型结构体。

定义

typedef struct MI_ISP_IQ_WdrType_s

{

    MI_ISP_IQ_Bool_e      bEnable;

    MI_ISP_IQ_OpType_e     enOpType;

    MI_ISP_IQ_WdrAutoAttr_t stAuto;

    MI_ISP_IQ_WdrManualAttr_t stManual;

} MI_ISP_IQ_WdrType_t;

名称

变量名称	描述
bEnable	设定宽动态功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定宽动态的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定宽动态的自动模式属性结构体。
stManual	设定宽动态的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetWdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrType_t *data);

MI_S32 MI_ISP_IQ_GetWdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrType_t *data);

3.32.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定宽动态的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_WdrAutoAttr_s

{

    MI_ISP_IQ_WdrParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_WdrAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.32.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定宽动态的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_WdrManualAttr_s

{

    MI_ISP_IQ_WdrParam_t stParaAPI;

} MI_ISP_IQ_WdrManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.32.4. 参数结构体（Parameter Structure）

说明

设定宽动态的参数结构体。

定义

typedef struct MI_ISP_IQ_WdrParam_s
{
    MI_U8               u8GlobalDarkToneEnhance;
    MI_U8               u8WDRStrByY[WDR_BY_Y_NUM];
    MI_U8               u8Strength;
    MI_U8               u8DarkLimit;
    MI_U8               u8BrightLimit;
    MI_U8               u8DeSatSrcSel;
    MI_ISP_IQ_Bool_e    bDeSatCrEn;
    MI_U8               u8DeSatCbLut[WDR_BY_Y_NUM];
    MI_U8               u8DeSatCrLut[WDR_BY_Y_NUM];
} MI_ISP_IQ_WdrParam_t;

名称

变量名称	描述
u8GlobalDarkToneEnhance	控制post global tone mapping，提供16条curve可供选择，值域范围：0 ~ 15。数字越大则暗处会拉越亮。
u8WDRStrByY[WDR_BY_Y_NUM]	依据亮度控制WDR blending强度，值域范围：0 ~ 255，横轴为亮度，越右边越亮，纵轴为WDR blending强度，值越大则WDR越强，blending WDR Curve1越少。 WDR_BY_Y_NUM = 33。
u8Strength	WDR blending整体强度，值域范围：0 ~ 255，值越大则WDR越强，blending WDR Curve1越少。
u8DarkLimit	限制WDR在暗处作用的强度，值域范围：0 ~ 255，值越大则暗处WDR越弱。
u8BrightLimit	限制WDR在亮处作用的强度，值域范围：0 ~ 255，值越大则亮处WDR越弱。
u8DeSatSrcSel	去色彩功能的亮度来源，值域范围：0 ~ 2，0代表过完Curve1的亮度，1代表过完global tone的亮度，2代表未经过WDR处理前的亮度。
bDeSatCrEn	去色彩功能的独立设定Cr色域开关，值域范围：0 ~ 1，0为Cr色域不独立设定，Cb与Cr相同设定，1为Cr色域独立设定。
u8DeSatCbLut[WDR_BY_Y_NUM]	依据亮度调整Cb色域去色彩功能的程度，值域范围：0 ~ 255，横轴为亮度，越右边越偏亮，纵轴为色彩增益（128 = 1x），值越小则去色彩越强，影像越偏灰。 WDR_BY_Y_NUM = 33。
u8DeSatCrLut[WDR_BY_Y_NUM]	依据亮度调整Cr色域去色彩功能的程度，值域范围：0 ~ 255，横轴为亮度，越右边越偏亮，纵轴为色彩增益（128 = 1x），值越小则去色彩越强，影像越偏灰。 WDR_BY_Y_NUM = 33。

3.33. MI_ISP_IQ_WdrLtm结构体¶

3.33.1. 类型结构体（Type Structure）

说明

设定宽动态LTM的类型结构体。

定义

typedef struct MI_ISP_IQ_WdrLtmType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_OpType_e       enOpType;

    MI_ISP_IQ_WdrLtmAutoAttr_t   stAuto;

    MI_ISP_IQ_WdrLtmManualAttr_t  stManual;

} MI_ISP_IQ_WdrLtmType_t;

名称

变量名称	描述
bEnable	设定宽动态功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定宽动态的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定宽动态的自动模式属性结构体。
stManual	设定宽动态的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetWdrLtm(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrLtmType_t *data);

MI_S32 MI_ISP_IQ_GetWdrLtm(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrLtmType_t *data);

3.32.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定宽动态LTM的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_WdrLtmAutoAttr_s

{

    MI_ISP_IQ_WdrLtmParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_WdrLtmAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.32.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定宽动态LTM的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_WdrLtmManualAttr_s

{

    MI_ISP_IQ_WdrLtmParam_t stParaAPI;

} MI_ISP_IQ_WdrLtmManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.33.4. 参数结构体（Parameter Structure）

说明

设定宽动态LTM的参数结构体。

定义

typedef struct MI_ISP_IQ_WdrLtmParam_s

{

    MI_U8    u8LocalStr;

    MI_U8    u8LevelStr;

    MI_U8    u8CoarseBoxNum;

    MI_U8    u8CoarseFltCoef;

    MI_U8    u8CoarseToneMapStr;

    MI_U8    u8FineBoxNum;

    MI_U8    u8FineFltCoef;

    MI_U8    u8FineToneMapStr;

} MI_ISP_IQ_WdrLtmParam_t;

名称

变量名称	描述
u8LocalStr	Local tone mapping kernel强度，值域范围：0 ~ 255，值越大越强。
u8LevelStr	Level强度。值域：0 ~ 255。值越大，亮暗区contrast加强效果越强。
u8CoarseBoxNum	提供4种size，可依据场景要关注的物体尺度大小进行调整，Box Num越大则box size越小，越适合当画面中关注的对象较小的时候，不可by iso变动。Coarse对应的box size会比Fine大。
u8CoarseFltCoef	提供5种filter size，值越大local contrast加强效果越明显，但物体边缘越容易出现光晕。
u8CoarseToneMapStr	Coarse local tone mapping强度。值域：0 ~ 255。值越大，local contrast加强效果越明显，但物体边缘越容易出现光晕。
u8FineBoxNum	提供4种size，可依据场景要关注的物体尺度大小进行调整，Box Num越大则box size越小，越适合当画面中关注的对象较小的时候，不可by iso变动。Fine对应的box size会比Coarse小。
u8FineFltCoef	提供5种filter size，值越大local contrast加强效果越明显，但物体边缘越容易出现光晕。
u8FineToneMapStr	Fine local tone mapping强度。值域：0 ~ 255。值越大，local contrast加强效果越明显，但物体边缘越容易出现光晕。

3.34. MI_ISP_IQ_WdrNr结构体¶

3.34.1. 类型结构体（Type Structure）

说明

设定宽动态降噪的类型结构体。

定义

typedef struct MI_ISP_IQ_WdrNrType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_OpType_e       enOpType;

    MI_ISP_IQ_WdrNrAutoAttr_t   stAuto;

    MI_ISP_IQ_WdrNrManualAttr_t  stManual;

} MI_ISP_IQ_WdrNrType_t;

名称

变量名称	描述
bEnable	设定宽动态功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定宽动态的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定宽动态的自动模式属性结构体。
stManual	设定宽动态的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetWdrNr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrNrType_t *data);

MI_S32 MI_ISP_IQ_GetWdrNr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrNrType_t *data);

3.34.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定宽动态降噪的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_WdrNrAutoAttr_s

{

    MI_ISP_IQ_WdrNrParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_WdrNrAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.34.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定宽动态降噪的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_WdrNrManualAttr_s

{

    MI_ISP_IQ_WdrNrParam_t stParaAPI;

} MI_ISP_IQ_WdrNrManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.34.4. 参数结构体（Parameter Structure）

说明

设定宽动态降噪的参数结构体。

定义

typedef struct MI_ISP_IQ_WdrNrParam_s
{
    MI_U8               u8Strength;
    MI_U16          u16NrThdScl;
    MI_U16          u16NrGainScl;
    MI_U8               u8NrSft[WDR_NR_LUT_X_NUM];
    MI_U16          u16NrRThd[WDR_NR_LUT_Y_NUM];
    MI_U16          u16NrRGain[WDR_NR_LUT_Y_NUM];
    MI_U16          u16NrGThd[WDR_NR_LUT_Y_NUM];
    MI_U16          u16NrGGain[WDR_NR_LUT_Y_NUM];
    MI_U16          u16NrBThd[WDR_NR_LUT_Y_NUM];
    MI_U16          u16NrBGain[WDR_NR_LUT_Y_NUM];
    MI_U8               u8NrStrMot[WDR_BY_MOT_NUM];
    MI_U8               u8NrNosMot[WDR_BY_MOT_NUM];
    MI_U8               u8VNDSft[WDR_VND_LUT_X_NUM];
    MI_U16          u16VNDThd[WDR_VND_LUT_Y_NUM];
    MI_U16          u16VNDGain[WDR_VND_LUT_Y_NUM];
    MI_ISP_IQ_Bool_e    bVNDByPass;
} MI_ISP_IQ_WdrNrParam_t;

名称

变量名称	描述
u8Strength	WDR降噪强度控制。值域范围：0 ~ 255。
u16NrThdScl	WDR降噪阀值，小于此阀值判断为噪声，值越大降噪越强。值域范围：0 ~ 65535。
u16NrGainScl	WDR降噪程度，值越小越容易判断为噪声，值越小降噪越强。值域范围：0 ~ 65535。
u8NrSft[WDR_NR_LUT_X_NUM]	NrXThd，NrXGain的横轴节点，以二的幂次方累加，值域范围：1 ~ 15。WDR_NR_LUT_X_NUM = 12。
u16NrRThd[WDR_NR_LUT_Y_NUM]	根据亮度控制R channel降噪阀值，小于此阀值判断为噪声，值越大降噪越强。值域范围：0 ~ 4095。WDR_NR_LUT_X_NUM = 13。
u16NrRGain[WDR_NR_LUT_Y_NUM]	根据亮度控制R channel降噪程度，值越小越容易判断为噪声，值越小降噪越强。值域范围：0 ~ 4095。WDR_NR_LUT_X_NUM = 13。
u16NrGThd[WDR_NR_LUT_Y_NUM]	根据亮度控制G channel降噪阀值，小于此阀值判断为噪声，值越大降噪越强。值域范围：0 ~ 4095。WDR_NR_LUT_X_NUM = 13。
u16NrGGain[WDR_NR_LUT_Y_NUM]	根据亮度控制G channel降噪程度，值越小越容易判断为噪声，值越小降噪越强。值域范围：0 ~ 4095。WDR_NR_LUT_X_NUM = 13。
u16NrBThd[WDR_NR_LUT_Y_NUM]	根据亮度控制B channel降噪阀值，小于此阀值判断为噪声，值越大降噪越强。值域范围：0 ~ 4095。WDR_NR_LUT_X_NUM = 13。
u16NrBGain[WDR_NR_LUT_Y_NUM]	根据亮度控制B channel降噪程度，值越小越容易判断为噪声，值越小降噪越强。值域范围：0 ~ 4095。WDR_NR_LUT_X_NUM = 13。
u8NrStrMot[WDR_BY_MOT_NUM]	根据motion程度再加一个offset到最终的降噪强度上。值域范围：0 ~ 255。WDR_BY_MOT_NUM = 16。
u8NrNosMot[WDR_BY_MOT_NUM]	根据motion程度对NrXThd做倍率调整。值域范围：0 ~ 255。16为1倍。WDR_BY_MOT_NUM = 16。
u8VNDSft[WDR_VND_LUT_X_NUM]	VNDThd，VNDGain的横轴节点，以二的幂次方累加，值域范围：1 ~ 11。WDR_VND_LUT_X_NUM = 8。
u16VNDThd[WDR_VND_LUT_Y_NUM]	根据亮度控制VND降噪阀值，大于此阀值判断为噪声，值越小降噪越强。值域范围：0 ~ 4095。WDR_VND_LUT_Y_NUM = 9。
u16VNDGain[WDR_VND_LUT_Y_NUM]	根据亮度控制VND降噪程度，值越大降噪越强。值域范围：0 ~ 4095。WDR_VND_LUT_Y_NUM = 9。
bVNDByPass	VND功能开关。1为VND关闭，0为VND开启。

3.35. MI_ISP_IQ_DynamicDp结构体¶

3.35.1. 类型结构体（Type Structure）

说明

设定动态补偿坏点的类型结构体。

定义

typedef struct MI_ISP_IQ_DynamicDpType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_OpType_e       enOpType;

    MI_ISP_IQ_DynamicDpAutoAttr_t stAuto;

    MI_ISP_IQ_DynamicDpManualAttr_t  stManual;

} MI_ISP_IQ_DynamicDpType_t;

名称

变量名称	描述
bEnable	设定动态补偿坏点功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定动态补偿坏点的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定动态补偿坏点的自动模式属性结构体。
stManual	设定动态补偿坏点的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDynamicDp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DynamicDpType_t *data);

MI_S32 MI_ISP_IQ_GetDynamicDp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DynamicDpType_t *data);

3.35.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定动态补偿坏点的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DynamicDpAutoAttr_s

{

    MI_ISP_IQ_DynamicDpParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_DynamicDpAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.35.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定动态补偿坏点的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DynamicDpManualAttr_s

{

    MI_ISP_IQ_DynamicDpParam_t stParaAPI;

} MI_ISP_IQ_DynamicDpManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.35.4. 参数结构体（Parameter Structure）

说明

设定动态补偿坏点的参数结构体。

定义

typedef struct MI_ISP_IQ_DynamicDpParam_s

{

    MI_ISP_IQ_Bool_e  bHotPixEn;

    MI_U16     u16HotPixCompSlpoe;

    MI_ISP_IQ_Bool_e  bDarkPixEn;

    MI_U16     u16DarkPixCompSlpoe;

    MI_U16     u16DPCTH;

    MI_ISP_IQ_Bool_e  bBlendEn;

    MI_U16     u16DiffLut[DYNAMIC_DP_LUT_NUM];

    MI_U16     u16YLut[DYNAMIC_DP_LUT_NUM];

} MI_ISP_IQ_DynamicDpParam_t;

名称

变量名称	描述
bHotPixEn	设定动态补偿hot pixel功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16HotPixCompSlpoe	调整动态补偿hot pixel的阀值。值域范围：0 ~ 255。
bDarkPixEn	设定动态补偿dark pixel功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16DarkPixCompSlpoe	调整动态补偿dark pixel的阀值。值域范围：0 ~ 255。
u16DPCTH	设定动态补偿坏点阀值。值域范围：0 ~ 255。
bBlendEn	设定blending功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16DiffLut[DYNAMIC_DP_LUT_NUM]	依据DPC补偿结果和原来的点的差异来做混和。值域范围：0 ~ 1024。DYNAMIC_DP_LUT_NUM = 6。
u16YLut[DYNAMIC_DP_LUT_NUM]	依据亮度来做混和。值域范围：0 ~ 1024。 DYNAMIC_DP_LUT_NUM = 6。

3.36. MI_ISP_IQ_DynamicDpCluster结构体¶

3.36.1. 类型结构体（Type Structure）

说明

设定动态补偿坏点的类型结构体。

定义

typedef struct MI_ISP_IQ_DynamicDpClusterType_s
{
    MI_ISP_IQ_Bool_e                        bEnable;
    MI_ISP_IQ_OpType_e                      enOpType;
    MI_ISP_IQ_DynamicDpClusterAutoAttr_t    stAuto;
    MI_ISP_IQ_DynamicDpClusterManualAttr_t  stManual;
} MI_ISP_IQ_DynamicDpClusterType_t;

名称

变量名称	描述
bEnable	设定动态补偿坏点功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定动态补偿坏点的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定动态补偿坏点的自动模式属性结构体。
stManual	设定动态补偿坏点的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDynamicDpCluster(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DynamicDpClusterType_t *data);

MI_S32 MI_ISP_IQ_GetDynamicDpCluster (MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DynamicDpClusterType_t *data);

3.36.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定动态补偿坏点的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DynamicDpClusterAutoAttr_s

{

    MI_ISP_IQ_DynamicDpClusterAttr_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_DynamicDpClusterAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.36.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定动态补偿坏点的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DynamicDpClusterManualAttr_s

{

    MI_ISP_IQ_DynamicDpClusterAttr_t stParaAPI;

} MI_ISP_IQ_DynamicDpClusterManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.36.4. 参数结构体（Parameter Structure）

说明

设定动态补偿坏点的参数结构体。

定义

typedef struct MI_ISP_IQ_DynamicDpClusterAttr_s
{
    MI_ISP_IQ_Bool_e    bEdgeMode;
    MI_U16          u16NeiDeltaTh;
    MI_U8               u8NeiSmooth;
    MI_ISP_IQ_Bool_e    bSortEn;
    MI_ISP_IQ_Bool_e    bSortRGGBEn[DYNAMIC_DP_CLUSTER_CH_NUM];
    MI_ISP_IQ_Bool_e    bSort1x3ModeEn;
    MI_U16          u16SortLumTblL[DYNAMIC_DP_CLUSTER_TBL_NUM];
    MI_U16          u16SortLumTblD[DYNAMIC_DP_CLUSTER_TBL_NUM];
    MI_U16          u16SortLumTblS[DYNAMIC_DP_CLUSTER_TBL_NUM];
} MI_ISP_IQ_DynamicDpClusterAttr_t;

名称

变量名称	描述
bEdgeMode	设定Edge Mode功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16NeiDeltaTh	中心点与周围8点的差异阀值。值域范围：0 ~ 4095。
u8NeiSmooth	累计阀值。值域范围：0 ~ 8。
bSortEn	Sort mode总开关
bSortRGGBEn[DYNAMIC_DP_CLUSTER_CH_NUM]	Sort mode各自channel开关。 DYNAMIC_DP_CLUSTER_CH_NUM = 4。
bSort1x3ModeEn	1x3 mode开关。
u16SortLumTblL[DYNAMIC_DP_CLUSTER_TBL_NUM]	最亮点和次亮点阀值。值域范围：0 ~ 4095。 DYNAMIC_DP_CLUSTER_TBL_NUM = 6。
u16SortLumTblD[DYNAMIC_DP_CLUSTER_TBL_NUM]	最暗点和次暗点阀值。值域范围：0 ~ 4095。 DYNAMIC_DP_CLUSTER_TBL_NUM = 6。
u16SortLumTblS[DYNAMIC_DP_CLUSTER_TBL_NUM]	次亮（暗）点和第三亮（暗）点阀值。值域范围：0 ~ 4095。 DYNAMIC_DP_CLUSTER_TBL_NUM = 6。

3.37. MI_ISP_IQ_Hsv结构体¶

3.37.1. 类型结构体（Type Structure）

说明

设定HSV的类型结构体。

定义

typedef struct MI_ISP_IQ_HsvType_s
{
    MI_ISP_IQ_Bool_e            bEnable;
    MI_ISP_IQ_OpType_e          enOpType;
    MI_ISP_IQ_HsvAutoAttr_t stAuto;
    MI_ISP_IQ_HsvManualAttr_t   stManual;
} MI_ISP_IQ_HsvType_t;

名称

变量名称	描述
bEnable	设定HSV功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定HSV的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定HSV的自动模式属性结构体。
stManual	设定HSV的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetHsv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HsvType_t *data);

MI_S32 MI_ISP_IQ_GetHsv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HsvType_t *data);

3.37.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定HSV的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_HsvAutoAttr_s

{

    MI_ISP_IQ_HsvParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_HsvAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.37.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定HSV的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_HsvManualAttr_s

{

    MI_ISP_IQ_HsvParam_t stParaAPI;

} MI_ISP_IQ_HsvManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.37.4. 参数结构体（Parameter Structure）

说明

设定HSV的参数结构体。

定义

typedef struct MI_ISP_IQ_HsvParam_s
{
    MI_S16          s16HueByHueLut[HSV_HUE_NUM];
    MI_U16          u16HueBySatLut[HSV_SAT_NUM];
    MI_U16          u16HueByYLut[HSV_Y_NUM];
    MI_U16          u16SatByHueLut[HSV_HUE_NUM];
    MI_S16          s16SatBySatLut[HSV_SAT_NUM];
    MI_U16          u16SatByYLut[HSV_Y_NUM];
    MI_S16          s16SatBySYLut[HSV_Y_NUM];
    MI_S16          s16YByHueLut[HSV_HUE_NUM];
    MI_U16          u16YBySatLut[HSV_SAT_NUM];
    MI_U16          u16YByYLut[HSV_Y_NUM];
    MI_S16          s16HueByHueLut_ByIso[HSV_HUE_NUM];
    MI_U16          u16HueBySatLut_ByIso[HSV_SAT_NUM];
    MI_U16          u16HueByYLut_ByIso[HSV_Y_NUM];
    MI_U16          u16SatByHueLut_ByIso[HSV_HUE_NUM];
    MI_S16          s16SatBySatLut_ByIso[HSV_SAT_NUM];
    MI_U16          u16SatByYLut_ByIso[HSV_Y_NUM];
    MI_S16          s16SatBySYLut_ByIso[HSV_Y_NUM];
    MI_S16          s16YByHueLut_ByIso[HSV_HUE_NUM];
    MI_U16          u16YBySatLut_ByIso[HSV_SAT_NUM];
    MI_U16          u16YByYLut_ByIso[HSV_Y_NUM];
    MI_ISP_IQ_Bool_e    bVibranceEn;
    MI_U8           u8GrayProtectStrength;
    MI_U16          u16GrayProtectTh;
    MI_U8           u8DebugMode;
} MI_ISP_IQ_HsvParam_t;

名称

变量名称	描述
s16HueByHueLut[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相旋转角度，自动模式下根据色温作切换。值域范围：-127 ~ 127。（0为不调整） HSV_HUE_NUM = 36。
u16HueBySatLut[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的色相旋转角度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_SAT_NUM = 9。
u16HueByYLut[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的色相旋转角度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
u16SatByHueLut[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相的饱和度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_HUE_NUM = 36。
s16SatBySatLut[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的饱和度增减，自动模式下根据色温作切换。值域范围：-511 ~ 511。（0为不调整） HSV_SAT_NUM = 9。
u16SatByYLut[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的饱和度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
s16SatBySYLut[HSV_Y_NUM]	将亮度与饱和度的乘积等分为9份，分别控制每个等分乘积的饱和度增减，自动模式下根据色温作切换。值域范围：-511 ~ 511。（0为不调整） HSV_Y_NUM = 9。
s16YByHueLut[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相的亮度，自动模式下根据色温作切换。值域范围：值域范围：-511 ~ 511。（0为不调整） HSV_HUE_NUM = 36。
u16YBySatLut[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的亮度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_SAT_NUM = 9。
u16YByYLut[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的亮度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
s16HueByHueLut_ByIso[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相旋转角度，自动模式下根据色温作切换。值域范围：-127 ~ 127。（0为不调整） HSV_HUE_NUM = 36。
u16HueBySatLut_ByIso[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的色相旋转角度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_SAT_NUM = 9。
u16HueByYLut_ByIso[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的色相旋转角度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
u16SatByHueLut_ByIso[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相的饱和度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_HUE_NUM = 36。
s16SatBySatLut_ByIso[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的饱和度增减，自动模式下根据色温作切换。值域范围：-511 ~ 511。（0为不调整） HSV_SAT_NUM = 9。
u16SatByYLut_ByIso[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的饱和度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
s16SatBySYLut_ByIso[HSV_Y_NUM]	将亮度与饱和度的乘积等分为9份，分别控制每个等分乘积的饱和度增减，自动模式下根据色温作切换。值域范围：-511 ~ 511。（0为不调整） HSV_Y_NUM = 9。
s16YByHueLut_ByIso[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相的亮度，自动模式下根据色温作切换。值域范围：值域范围：-511 ~ 511。（0为不调整） HSV_HUE_NUM = 36。
u16YBySatLut_ByIso[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的亮度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_SAT_NUM = 9。
u16YByYLut_ByIso[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的亮度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
bVibranceEn	自然饱和度功能开关。开启后此模块内与饱和度相关的控制皆会失效。取而代之的是韧体内部内定的饱和度相关调整曲线，可再增加饱和度的同时保持肤色饱和度少量改变。
u8GrayProtectStrength	灰色物颜色保护强度。值域范围：0 ~ 63。接近灰色物体可利用此参数来确保色相，饱和度，以及亮度不被调整
u16GrayProtectTh	定义灰色物体的阈值。值域范围：0 ~ 1023。数值越大越容易被定义为灰色物，可利用此参数来确保色相，饱和度，以及亮度不被调整
u8DebugMode	除错模式。值域范围：0 ~ 4 可分别显示画面中特定的1.色相，2.饱和度，3.亮度，以及4.亮度与饱和度的乘积（S*Y）。

注意事项

H与Y的调整都是基于Hue的调整量，再针对ByS以及ByY做调整。换句话说，若HbyH的调整量为0，那么HbyS以及HbyY则失效。若YbyH的调整量为0，那么YbyS以及YbyY则失效。

3.38. MI_ISP_IQ_Rgbir结构体¶

3.38.1. 类型结构体（Type Structure）

说明

设定RGB-IR的类型结构体。

定义

typedef struct MI_ISP_IQ_RgbirType_s
{
    MI_ISP_IQ_Bool_e                bEnable;
    MI_ISP_IQ_OpType_e              enOpType;
    MI_ISP_IQ_RgbirAutoAttr_t       stAuto;
    MI_ISP_IQ_RgbirManualAttr_t stManual;
} MI_ISP_IQ_RgbirType_t;

名称

变量名称	描述
bEnable	设定RGB-IR功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定RGB-IR的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定RGB-IR的自动模式属性结构体。
stManual	设定RGB-IR的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetRgbir(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_RgbirType_t *data);

MI_S32 MI_ISP_IQ_GetRgbir(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_RgbirType_t *data);

3.38.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定RGB-IR的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_RgbirAutoAttr_s

{

    MI_ISP_IQ_RgbirParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_RgbirAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.38.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定RGB-IR的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_RgbirManualAttr_s

{

    MI_ISP_IQ_RgbirParam_t stParaAPI;

} MI_ISP_IQ_RgbirManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.38.4. 参数结构体（Parameter Structure）

说明

设定RGB-IR的参数结构体。

定义

typedef struct MI_ISP_IQ_RgbirParam_s

{

    MI_U8      u8IrPosType;

    MI_ISP_IQ_Bool_e  bRemovelEn;

    MI_U16      u16Ratio_R[RGBIR_BY_Y_NUM];

    MI_U16      u16Ratio_G[RGBIR_BY_Y_NUM];

    MI_U16      u16Ratio_B[RGBIR_BY_Y_NUM];

} MI_ISP_IQ_RgbirParam_t;

名称

变量名称	描述
u8IrPosType	RGB-IR分布型态。值域范围：0 ~ 7，默认值：0。
bRemovelEn	设定减IR功能的布尔值，默认值：1。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16Ratio_R[RGBIR_BY_Y_NUM]	红色减IR比例，由暗至亮区@12-bit。 RGBIR_BY_Y_NUM = 6。
u16Ratio_G[RGBIR_BY_Y_NUM]	绿色减IR比例，由暗至亮区@12-bit。 RGBIR_BY_Y_NUM = 6。
u16Ratio_B[RGBIR_BY_Y_NUM]	蓝色减IR比例，由暗至亮区@12-bit。 RGBIR_BY_Y_NUM = 6。

3.39. MI_ISP_IQ_Fpn结构体¶

3.39.1. 类型结构体（Type Structure）

说明

设定FPN的类型结构体。

定义

typedef struct MI_ISP_IQ_FpnType_s
{
    MI_ISP_IQ_Bool_e    bEnable;
} MI_ISP_IQ_FpnType_t;

名称

变量名称 描述

bEnable 设定FPN功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetFpn(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_FpnType_t *data);

MI_S32 MI_ISP_IQ_GetFpn(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_FpnType_t *data);

3.40. MI_ISP_IQ_Demosaic结构体¶

3.40.1. 类型结构体（Type Structure）

说明

设定去马赛克的类型结构体。

定义

typedef struct MI_ISP_IQ_DemosaicType_s
{
    MI_ISP_IQ_Bool_e                bEnable;
    MI_ISP_IQ_OpType_e              enOpType;
    MI_ISP_IQ_DemosaicAutoAttr_t    stAuto;
    MI_ISP_IQ_DemosaicManualAttr_t  stManual;
} MI_ISP_IQ_DemosaicType_t;

名称

变量名称	描述
bEnable	设定去马赛克功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定去马赛克的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定去马赛克的自动模式属性结构体。
stManual	设定去马赛克的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDemosaic(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DemosaicType_t *data);

MI_S32 MI_ISP_IQ_GetDemosaic(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DemosaicType_t *data);

3.40.2 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定去马赛克的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DemosaicAutoAttr_s

{

    MI_ISP_IQ_DemosaicParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_DemosaicAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.40.3 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定去马赛克的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DemosaicManualAttr_s

{

    MI_ISP_IQ_DemosaicParam_t paraAPI;

} MI_ISP_IQ_DemosaicManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.40.4 参数结构体（Parameter Structure）

说明

设定去马赛克的参数结构体。

定义

typedef struct MI_ISP_IQ_DemosaicParam_s
{
    MI_U8               u8DbgMode;
    MI_U8               u8IsoTh;
    MI_U8               u8GradientTh;
    MI_ISP_IQ_Bool_e    bSmoEn;
    MI_U8               u8SmoRange;
    MI_U8               u8SmoStrength;
    MI_ISP_IQ_Bool_e    bDtlEn;
    MI_ISP_IQ_Bool_e    bDtlBypassColorCheck;
    MI_U8               u8DtlColorRatio;
    MI_U8               u8DtlColorOft;
    MI_U8               u8DtlHScale;
    MI_U8               u8DtlMScale;
} MI_ISP_IQ_DemosaicParam_t;

名称

变量名称	描述
u8DbgMode	Debug模式，值域范围：0 ~ 2，1代表方向判断影像，红/蓝/绿/白/黑色区域分别对应到垂直/水平/细节非加强/细节加强/无向性区域，2代表non-smooth影像，只有开启SmoEn才会有效果，影像越亮代表越不会被抹平，影像越黑代表越会被抹平。此debug模式和FalseColor的debug模式会有冲突，以最后呼叫的api为主。
u8IsoTh	无向性区域判断阀值，值域范围：0 ~ 127，值越大则越多区域被判断成无向性区域，可能导致细节模糊和拉链状artifacts。
u8GradientTh	方向性区域判断阀值，值域范围：0 ~ 63，值越大则越少区域被判断成方向性区域，可能导致细节模糊和拉链状artifacts，值太小则会使细节区变少。
bSmoEn	抹平功能开关，值域范围：0 ~ 1。
u8SmoRange	抹平范围，值域范围：0 ~ 7，值越大则越多区域被抹平。
u8SmoStrength	抹平强度，值域范围：0 ~ 255，值越大则抹平的强度越强。
bDtlEn	细节加强开关，值域范围：0 ~ 1，只会作用在细节加强区。
bDtlBypassColorCheck	细节区忽略颜色判断开关，值域范围：0 ~ 1，细节区会再被分为细节非加强区和细节加强区，0代表不忽略颜色判断，只有G通道值大于一定值时，才会被判断成细节加强区，条件为G通道值大于R和B通道值乘以DtlColorRatio再加上DtlColorOft，1代表忽略颜色判断，所有细节区都被判断成细节加强区。
u8DtlColorRatio	细节区颜色判断比例，值域范围：0 ~ 255，值越大则越不容易被判断成细节加强区。
u8DtlColorOft	细节区颜色判断偏移量，值域范围：0 ~ 63，值越大则越不容易被判断成细节加强区。
u8DtlHScale	细节加强区加强高频区域的程度，值域范围：0 ~ 15，值越大则高频区域被加强越多。
u8DtlMScale	细节加强区加强中频区域的程度，值域范围：0 ~ 15，值越大则中频区域被越加强多。

3.41. MI_ISP_IQ_R2Y结构体¶

3.41.1. 类型结构体 (Type Structure)

说明

设定色彩转换的类型结构体。

定义

typedef struct MI_ISP_IQ_R2YType_s
{
    MI_ISP_IQ_Bool_e            bEnable;
    MI_ISP_IQ_R2YManualAttr_t   stManual;
} MI_ISP_IQ_R2YType_t;

名称

变量名称描述

bEnable 设定色彩转换功能的布尔值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

stManual 设定色彩转换的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetR2Y(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_R2YType_t *data);

MI_S32 MI_ISP_IQ_GetR2Y(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_R2YType_t *data);

3.41.2. 手动模式属性结构体 (Manual Mode Attribute Structure)

说明

设定色彩转换的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_R2YManualAttr_s
{
    MI_ISP_IQ_R2YParam_t stParaAPI;
} MI_ISP_IQ_R2YManualAttr_t;

名称

变量名称描述

stParaAPI 手动模式属性结构体。

3.41.3. 参数结构体 (Parameter Structure)

说明

设定色彩转换的参数结构体。

定义

typedef struct MI_ISP_IQ_R2YParam_s
{
    MI_U16 u16Matrix[R2Y_MATRIX_NUM];
    MI_U8 u8AddY16;
} MI_ISP_IQ_R2YParam_t;

名称

变量名称	描述
u16Matrix[R2Y_MATRIX_NUM]	调整RGB to YUV矩阵，值域范围：0 ~ 8191，1倍为1024，负数以2的补码表示，等同于±3.996。R2Y_MATRIX_NUM = 9。
u8AddY16	调整Y Offset，经过矩阵转换后，用来控制是否要对Y加16。

3.42. MI_ISP_IQ_ColorTrans结构体¶

3.42.1. 类型结构体（Type Structure）

说明

设定色彩转换的类型结构体。

定义

typedef struct MI_ISP_IQ_ColorTransType_s
{
    MI_ISP_IQ_Bool_e                    bEnable;
    MI_ISP_IQ_ColorTransManualAttr_t    stManual;
} MI_ISP_IQ_ColorTransType_t;

名称

变量名称	描述
bEnable	设定色彩转换功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stManual	设定色彩转换的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetColorTrans(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ColorTransType_t *data);

MI_S32 MI_ISP_IQ_GetColorTrans(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_ColorTransType_t *data);

3.42.2. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定色彩转换的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_ColorTransManualAttr_s

{

    MI_ISP_IQ_ColorTransParam_t stParaAPI;

} MI_ISP_IQ_ColorTransManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.42.3. 参数结构体（Parameter Structure）

说明

设定色彩转换的参数结构体。

定义

typedef struct MI_ISP_IQ_ColorTransParam_s

{

    MI_U16 u16Y_OFST;

    MI_U16 u16U_OFST;

    MI_U16 u16V_OFST;

    MI_U16 u16Matrix[COLORTRANS_MATRIX_NUM];

} MI_ISP_IQ_ColorTransParam_t;

名称

变量名称	描述
u16Y_OFST	调整Y偏差值。10-bit domain，值域范围：0 ~ 2047，负数以2的补码表示，等同于±1023。
u16U_OFST	调整U偏差值。10-bit domain，值域范围：0 ~ 2047，负数以2的补码表示，等同于±1023。
u16V_OFST	调整V偏差值。10-bit domain，值域范围：0 ~ 2047，负数以2的补码表示，等同于±1023。
u16Matrix[COLORTRANS_MATRIX_NUM]	调整RGB-YUV矩阵，值域范围：0 ~ 1023，1倍为256，负数以2的补码表示，等同于±1.996。 COLORTRANS_MATRIX_NUM = 9。

注意事项

对于YUV_OFST，Matrix[9]，负数以2的补码表示。UV偏差值，在矩阵相乘后，已经预设加上128。

将YUV转为16 ~ 235的值域范围，举例如下：
```
Y=(0.257*R)+(0.504*G)+(0.098*B)+16

Cb=-(0.148*R)-(0.291*G)+(0.439*B)+128

Cr=(0.439*R)-(0.368*G)-(0.071*B)+128
```
Matrix[9] = {66, 129, 25, 986, 950, 112, 112, 930, 1006}

Y_OFST = 64

U_OFST = 0 （预设已加上128*4，所以填0）

V_OFST = 0 （预设已加上128*4，所以填0）

3.43. MI_ISP_IQ_CTEx结构体¶

3.43.1. 类型结构体（Type Structure）

说明

设定色彩转换的类型结构体。

定义

typedef struct MI_ISP_IQ_CTExType_s
{
    MI_ISP_IQ_Bool_e            bEnable;
    MI_ISP_IQ_CTExManualAttr_t  stManual;
} MI_ISP_IQ_CTExType _t;

名称

变量名称 描述

bEnable 设定色彩转换功能的布尔值。
关闭：E_SS_IQ_FALSE = 0。
开启：E_SS_IQ_TRUE = 1。

stManual 设定色彩转换的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetColorTrans_EX(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_CTExType_t *data);
MI_S32 MI_ISP_IQ_GetColorTrans_EX(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_CTExType_t *data);

3.43.2. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定色彩转换的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_CTExManualAttr_s
{
    MI_ISP_IQ_CTEx_t stParaAPI;
} MI_ISP_IQ_CTExManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.43.3. 参数结构体（Parameter Structure）

说明

设定色彩转换的参数结构体。

定义

typedef struct MI_ISP_IQ_CTEx_s
{
    MI_U8       u8Type;
} MI_ISP_IQ_CTEx_t;

名称

变量名称 描述

u8Type 提供6种不同的转换方式。值域范围：0 ~ 5
0: BT601 limit。
1: BT601 full。
2: BT709 limit。
3: BT709 full。
4: BT2020 limit。
5: BT2020 full。
注意事项

相较于ColorTrans可以弹性的设置RGB to YUV的转换矩阵，ColorTrans_EX仅提供0~5种公定的类型可以选择。若有将ColorTrans_EX开启，ColorTrans则失效。

3.44. MI_ISP_IQ_Hdr结构体¶

3.44.1. 类型结构体（Type Structure）

说明

设定高动态范围的类型结构体。

定义

typedef struct MI_ISP_IQ_HdrType_s
{
    MI_ISP_IQ_Bool_e            bEnable;
    MI_ISP_IQ_OpType_e          enOpType;
    MI_ISP_IQ_HdrAutoAttr_t stAuto;
    MI_ISP_IQ_HdrManualAttr_t   stManual;
} MI_ISP_IQ_HdrType_t;

名称

变量名称	描述
bEnable	设定高动态范围功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定高动态范围的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定高动态范围的自动模式属性结构体。
stManual	设定高动态范围的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetHdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HdrType_t *data);

MI_S32 MI_ISP_IQ_GetHdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HdrType_t *data);

3.44.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定高动态范围的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_HdrAutoAttr_s

{

    MI_ISP_IQ_HdrParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_HdrAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.44.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定高动态范围的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_HdrManualAttr_s

{

    MI_ISP_IQ_HdrParam_t stParaAPI;

} MI_ISP_IQ_HdrManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.44.4. 参数结构体（Parameter Structure）

说明

设定高动态范围的参数结构体。

定义

typedef struct MI_ISP_IQ_HdrParam_s
{
    MI_U16          u16YwtTh1;
    MI_U16          u16YwtTh2;
    MI_U16          u16NoiseLevel[HDR_BY_Y_NUM];
    MI_U8               u8YSrcStr[HDR_BLEND_V_NUM];
    MI_U8               u8NrStr;
    MI_U8               u8NrPreStr;
    MI_U16          u16NrYTh1;
    MI_U16          u16NrYTh2;
    MI_U8               u8NrYGain[HDR_LUT_Y_NUM];
    MI_U8               u8NrYSft[HDR_LUT_X_NUM];
    MI_U8               u8NrKernelStr;
    MI_U8               u8NrKernelStrWei[HDR_STR_BY_DIFF];
    MI_U8               u8MotAdjStf1[HDR_MOT_LUT_X_NUM];
    MI_U8               u8MoLuBlendSft[HDR_BLEND_LUT_X_NUM];
    MI_U16          u16MotAdj1[HDR_MOT_LUT_Y_NUM];
    MI_U16          u16MotAdj2[HDR_MOT_LUT_Y_NUM];
    MI_U16          u16MotAdj3[HDR_MOT_LUT_Y_NUM];
    MI_U16          u16MoLuBlendY[HDR_BLEND_LUT_Y_NUM];
} MI_ISP_IQ_HdrParam_t;

名称

变量名称	描述
u16YwtTh1	长曝曝光的最低亮度门阀，Th1以下亮度选用长曝资料。值域范围：0 ~ 1023。
u16YwtTh2	长曝曝光的最高亮度门阀，Th2以上亮度选用短曝数据。Th1至Th2之间为blending方式。值域范围：0 ~ 1023。
u16NoiseLevel[HDR_BY_Y_NUM]	Noise level，用于判断动静，值域范围：0 ~ 16383。横轴为亮度，值越大越容易判断为静。 HDR_BY_Y_NUM = 16。
u8YSrcStr[HDR_BLEND_V_NUM]	fusion by luma的亮度值再与 max(R,G,B) 混合的强度，值域范围：0 ~ 255，值越大 max(R,G,B) 混合越多。u8YSrcStr[0]为长曝强度，u8YSrcStr[1]为短曝强度。HDR_BLEND_V_NUM = 2。
u8NrStr	降噪强度，值域范围：0 ~ 63。值越大NR越强。
u8NrPreStr	前置降噪强度，值域范围：0 ~ 63。值越大NR越强。
u16NrYTh1	降噪的最低亮度门阀，Th1以下亮度使用完整NR。值域范围：0 ~ 1023。
u16NrYTh2	降噪的最高亮度门阀，Th2以上亮度不使用NR。Th1至Th2之间为blending方式。值域范围：0 ~ 1023。
u8NrYGain[HDR_LUT_Y_NUM]	根据亮度差值控制降噪强度，值越小NR越强。值域范围：0 ~ 255，1倍为16。HDR_LUT_Y_NUM = 7。
u8NrYSft[HDR_LUT_X_NUM]	NrYGain的横轴节点，以二的幂次方累加，值域范围：0 ~ 7。HDR_LUT_X_NUM = 6。
u8NrKernelStr	NR Filter强度，值域范围：0 ~ 7。值越大NR越强。
u8NrKernelStrWei[HDR_STR_BY_DIFF]	NR Filter混合权重表，值域范围：0 ~ 31，值越大NR越强，横轴为与中心点的差异，纵轴为权重，正常情况下，差异越小权重设越大。HDR_STR_BY_DIFF = 32。
u8MotAdjStf1[HDR_MOT_LUT_X_NUM]	MotAdj1的横轴节点，以二的幂次方累加，值域范围：0 ~ 7。HDR_MOT_LUT_X_NUM = 6。
u8MoLuBlendSft[HDR_BLEND_LUT_X_NUM]	MoLuBlendY的横轴节点，以二的幂次方累加，值域范围：0 ~ 7。HDR_BLEND_LUT_X_NUM = 6。
u16MotAdj1[HDR_MOT_LUT_Y_NUM]	fusion by motion长曝比例表1，依亮度采用长曝的比例，横轴为亮度，越右边越偏亮。值域范围：0 ~ 256。 HDR_MOT_LUT_Y_NUM = 7。
u16MotAdj2[HDR_MOT_LUT_Y_NUM]	fusion by motion长曝比例表2，运动区采用长曝的比例。值域范围：0 ~ 256。HDR_MOT_LUT_Y_NUM = 7。
u16MotAdj3[HDR_MOT_LUT_Y_NUM]	依据运动程度融合的LUT3，运动区采用长曝的比例，横轴为运动程度，越右边越动。值域范围：0 ~ 256。HDR_MOT_LUT_Y_NUM = 7。
u16MoLuBlendY[HDR_BLEND_LUT_Y_NUM]	fusion by luma与fusion by motion的混合比例表，横轴为静到动，纵轴为混合比例，值越大采用fusion by motion结果的比例越高。值域范围：0 ~ 256。HDR_BLEND_LUT_Y_NUM = 7。

3.45. MI_ISP_IQ_Lsc结构体¶

3.45.1. 类型结构体（Type Structure）

说明

设定LSC的类型结构体。

定义

typedef struct MI_ISP_IQ_LscType_s

{

    MI_ISP_IQ_Bool_e  bEnable;

    MI_U16      u16CenterX;

    MI_U16      u16CenterY;

    MI_U16     u16RateX;

    MI_U16     u16RateY;

    MI_U8      u8Shift;

    MI_U16      u16RGainTable[LSC_TBL_SIZE * LSC_CCT_NUM_MAX];

    MI_U16      u16GGainTable[LSC_TBL_SIZE * LSC_CCT_NUM_MAX];

    MI_U16      u16BGainTable[LSC_TBL_SIZE * LSC_CCT_NUM_MAX];

} MI_ISP_IQ_LscType_t;

名称

变量名称	描述
bEnable	设定LSC功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16CenterX	设定X方向补偿中心点。值域范围：0 ~ 4095。
u16CenterY	设定Y方向补偿中心点。值域范围：0 ~ 4095。
u16RateX	x方向距离差的缩放比例，base为1024，值域：0 ~ 2047。当前点x值和LSC中心点x值的差值，会再乘上此比例，再搭配y方向去计算和LSC中心点的距离。
u16RateY	y方向距离差的缩放比例，base为1024，值域：0 ~ 2047。当前点y值和LSC中心点y值的差值，会再乘上此比例，再搭配x方向去计算和LSC中心点的距离。
u8Shift	根据分辨率设定，不建议修改。值域范围：0 ~ 31。
u16RGainTable [LSC_TBL_SIZE * LSC_CCT_NUM_MAX]	红色通道的LSC补正table。值域范围：0 ~ 1023。 LSC_TBL_SIZE = 32，LSC_CCT_NUM_MAX = 3。
u16GGainTable [LSC_TBL_SIZE * LSC_CCT_NUM_MAX]	绿色通道的LSC补正table。值域范围：0 ~ 1023。 LSC_TBL_SIZE = 32，LSC_CCT_NUM_MAX = 3。
u16BGainTable [LSC_TBL_SIZE * LSC_CCT_NUM_MAX]	蓝色通道的LSC补正table。值域范围：0 ~ 1023。 LSC_TBL_SIZE = 32，LSC_CCT_NUM_MAX = 3。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetLsc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_LscType_t *data);

MI_S32 MI_ISP_IQ_GetLsc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_LscType_t *data);

3.46. MI_ISP_IQ_LscCtrl结构体¶

3.46.1. 类型结构体（Type Structure）

说明

设定LSC CTRL的类型结构体。

定义

typedef struct MI_ISP_IQ_LscCtrlType_s
{
    MI_ISP_IQ_Bool_e        bEnable;
    MI_U8                   u8RRatioByCct[LSC_CCT_NUM_MAX];
    MI_U8                   u8GRatioByCct[LSC_CCT_NUM_MAX];
    MI_U8                   u8BRatioByCct[LSC_CCT_NUM_MAX];
    MI_ISP_IQ_IntpLut_t RatioByBv;
} MI_ISP_IQ_LscCtrlType_t;

名称

变量名称	描述
bEnable	设定LSC CTRL功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u8RRatioByCct [LSC_CCT_NUM_MAX]	红色通道的LSC额外ratio。值域范围：0 ~ 128（128 = 1x）。 LSC_CCT_NUM_MAX = 3。
u8GRatioByCct [LSC_CCT_NUM_MAX]	绿色通道的LSC额外ratio。值域范围：0 ~ 128（128 = 1x）。 LSC_CCT_NUM_MAX = 3。
u8BRatioByCct [LSC_CCT_NUM_MAX]	蓝色通道的LSC额外ratio。值域范围：0 ~ 128（128 = 1x）。 LSC_CCT_NUM_MAX = 3。
RatioByBv.u16NumOfPoints	RatioByBv节点个数。值域范围：0 ~ 16。
RatioByBv.s32Y[INTP_LUT_NUM]	各节点Ratio。值域范围：0 ~ 128（128 = 1x）。 INTP_LUT_NUM = 16。
RatioByBv.s32X[INTP_LUT_NUM]	各节点BV。INTP_LUT_NUM = 16。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetLscCtrl(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_LscCtrlType_t *data);

MI_S32 MI_ISP_IQ_GetLscCtrl(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_LscCtrlType_t *data);

3.47. MI_ISP_IQ_Alsc结构体¶

3.47.1. 类型结构体（Type Structure）

说明

设定ALSC的类型结构体。

定义

typedef struct MI_ISP_IQ_AlscType_s
{
    MI_ISP_IQ_Bool_e    bEnable;
    MI_U8               u8GridX;
    MI_U8               u8GridY;
    MI_U16          u16CCTthr[ALSC_CCT_NUM_MAX];
    MI_U8               u8DeltaMode;
    MI_ISP_IQ_Bool_e    bDeltaModeAdvEn;
    MI_U8               u8DeltaLutX[ALSC_DELTA_LUT_NUM];
    MI_U8               u8DeltaLutY[ALSC_DELTA_LUT_NUM];
    MI_U16          u16TableR[ALSC_CCT_NUM_MAX][ALSC_TBL_MAX];
    MI_U16          u16TableG[ALSC_CCT_NUM_MAX][ALSC_TBL_MAX];
    MI_U16          u16TableB[ALSC_CCT_NUM_MAX][ALSC_TBL_MAX];
} MI_ISP_IQ_AlscType_t;

名称

变量名称	描述
bEnable	设定ALSC功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u8GridX	X方向shading table方格总点数。值域范围：0 ~ 27。
u8GridY	Y方向shading table方格总点数。值域范围：0 ~ 17。
u16CCTthr[ALSC_CCT_NUM_MAX]	色温节点。值域范围：0 ~ 20000。 ALSC_CCT_NUM_MAX = 3。
u8DeltaMode	16组预设的shading table间距形式，0代表等距，值愈大，中心间距越大，周围越小。值域范围：0 ~ 15。
bDeltaModeAdvEn	手动控制每格间距开关，开了则u8DeltaMode失效。值域范围：0 ~ 1。
u8DeltaLutX[ALSC_DELTA_LUT_NUM]	X方向每格间距，只限填1、2、4、8、16。值域范围：0 ~ 16。ALSC_DELTA_LUT_NUM = 26。
u8DeltaLutY[ALSC_DELTA_LUT_NUM]	Y方向每格间距，只限填1、2、4、8、16。值域范围：0 ~ 16。ALSC_DELTA_LUT_NUM = 26。
u16TableR[ALSC_CCT_NUM_MAX][ALSC_TBL_MAX]	红色通道的ALSC补正table。值域范围：0 ~ 8191（1024 = 1x）。 ALSC_CCT_NUM_MAX = 3，ALSC_TBL_MAX = 459。
u16TableG[ALSC_CCT_NUM_MAX][ALSC_TBL_MAX]	绿色通道的ALSC补正table。值域范围：0 ~ 8191（1024 = 1x）。 ALSC_CCT_NUM_MAX = 3，ALSC_TBL_MAX = 459。
u16TableB[ALSC_CCT_NUM_MAX][ALSC_TBL_MAX]	蓝色通道的ALSC补正table。值域范围：0 ~ 8191（1024 = 1x）。 ALSC_CCT_NUM_MAX = 3，ALSC_TBL_MAX = 459。

注意事项

R、G、B Table数值不建议设低于1024，否则高亮部分会因为无法饱和而造成色偏问题。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetAlsc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_AlscType_t *data);

MI_S32 MI_ISP_IQ_GetAlsc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_AlscType_t *data);

3.48. MI_ISP_IQ_AlscCtrl结构体¶

3.48.1. 类型结构体（Type Structure）

说明

设定ALSC CTRL的类型结构体。

定义

typedef struct MI_ISP_IQ_AlscCtrlType_s
{
    MI_ISP_IQ_Bool_e        bEnable;
    MI_U8                   u8RRatioByCct[ALSC_CCT_NUM_MAX];
    MI_U8                   u8GRatioByCct[ALSC_CCT_NUM_MAX];
    MI_U8                   u8BRatioByCct[ALSC_CCT_NUM_MAX];
    MI_ISP_IQ_IntpLut_t RatioByBv;
} MI_ISP_IQ_AlscCtrlType_t;

名称

变量名称	描述
bEnable	设定LSC CTRL功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u8RRatioByCct[ALSC_CCT_NUM_MAX]	红色通道的ALSC额外ratio。值域范围：0 ~ 128（128 = 1x）。 ALSC_CCT_NUM_MAX = 3。
u8GRatioByCct[ALSC_CCT_NUM_MAX]	绿色通道的ALSC额外ratio。值域范围：0 ~ 128（128 = 1x）。 ALSC_CCT_NUM_MAX = 3。
u8BRatioByCct[ALSC_CCT_NUM_MAX]	蓝色通道的ALSC额外ratio。值域范围：0 ~ 128（128 = 1x）。 ALSC_CCT_NUM_MAX = 3。
RatioByBv.u16NumOfPoints	RatioByBv节点个数。值域范围：0 ~ 16。
RatioByBv.s32Y[INTP_LUT_NUM]	各节点Ratio。值域范围：0 ~ 128（128 = 1x）。 INTP_LUT_NUM = 16。
RatioByBv.s32X[INTP_LUT_NUM]	各节点BV。INTP_LUT_NUM = 16。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetAlscCtrl(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_AlscCtrlType_t *data);

MI_S32 MI_ISP_IQ_GetAlscCtrl(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_AlscCtrlType_t *data);

3.49. MI_ISP_IQ_DarkShading结构体¶

3.49.1. 类型结构体（Type Structure）

说明

设定Dark Shading的类型结构体。

定义

typedef struct MI_ISP_IQ_DarkShadingType_s
{
    MI_ISP_IQ_Bool_e                    bEnable;
    MI_ISP_IQ_DarkShadingManualAttr_t   stManual;
} MI_ISP_IQ_DarkShadingType_t;

名称

变量名称	描述
bEnable	设定Dark Shading功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stManual	设定Dark Shading的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDarkShading(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DarkShadingType_t *data);

MI_S32 MI_ISP_IQ_GetDarkShading(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DarkShadingType_t *data);

3.49.2. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定Dark Shading的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DarkShadingManualAttr_s
{
    MI_ISP_IQ_DarkShadingParam_t stParaAPI;
} MI_ISP_IQ_DarkShadingManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.49.3. 参数结构体（Parameter Structure）

说明

设定Dark Shading的参数结构体。

定义

typedef struct MI_ISP_IQ_DarkShadingParam_s
{
    MI_U16 u16Radius;
    MI_U8  u8SmoothBoundary;
} MI_ISP_IQ_DarkShadingParam_t;

名称

变量名称	描述
u16Radius	依据影像中心点调整半径范围，值域范围：0 ~ 65535。值越大则shading可视范围大。
u8SmoothBoundary	依据影像画面调整边缘平滑范围，值域范围：0 ~ 16。值越大则影像边缘过度区间越大。

3.50. MI_ISP_IQ_DaynightDetection结构体¶

3.50.1. 类型结构体（Type Structure）

说明

设定Day/Night侦测的类型结构体。

定义

typedef struct MI_ISP_IQ_DaynightDetectionType_s
{
    MI_ISP_IQ_Bool_e    bEnable;
    MI_S32          s32D2N_BvThd;
    MI_U32          u32N2D_VsbLtScoreThd;
} MI_ISP_IQ_DaynightDetectionType_t;

名称

变量名称	描述
bEnable	设定Day/Night侦测功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
s32D2N_BvThd	用来判断是否要切为Night mode的BV阀值，当Current BV（BV in AEInfo）小于此阀值，则DayNightInfo中的D2N会显示TRUE。值域范围：-1048576 ~ 1048576。
u32N2D_VsbLtScoreThd	用来判断是否要切为Day mode的Score阀值，Score是由可见光与IR光比例所算出的一个分数，分数越高表示可见光成分越多。当目前Score (N2D_VsbLtScore in DayNightInfo)大于此阀值时，DayNightInfo中的N2D会显示TRUE。值域：0 ~ 2000。

注意事项

无。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDayNightDetection(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DaynightDetectionType_t *data);

MI_S32 MI_ISP_IQ_GetDayNightDetection(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DaynightDetectionType_t *data);

3.51. MI_ISP_IQ_DaynightInfo结构体¶

3.51.1. 类型结构体（Type Structure）

说明

取得Day/Night侦测结果的类型结构体。

定义

typedef struct MI_ISP_IQ_DaynightInfoType_s

{

    MI_ISP_IQ_Bool_e  bD2N;

    MI_ISP_IQ_Bool_e  bN2D;

    MI_U32     u32N2D_VsbLtScore;

} MI_ISP_IQ_DaynightInfoType_t;

名称

变量名称	描述
bD2N	目前是否需要转为Night mode的flag，值为1时表示目前环境亮度已达要切Night mode标准。注意此flag只有当目前在Day mode的状态下才具有参考意义。
bN2D	目前是否需要转为Day mode的flag，值为1时表示目前环境亮度已达要切Day mode标准。注意此flag只有当目前在Night mode的状态下才具有参考意义。
u32N2D_VsbLtScore	显示目前可见光与IR光比例所算出的分数，分数越高代表环境中可见光的比例越高。使用者可以在认为该切回Day mode的环境下读取此值来决定N2D_VsbLtScoreThd该设多少。

相关结构类型与函式

MI_S32 MI_ISP_IQ_QueryDayNightInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DaynightInfoType_t *data);

3.52. MI_ISP_IQ_NrLumaAdv结构体¶

3.52.1. 类型结构体（Type Structure）

说明

设定Luma_Adv降噪的类型结构体。

定义

typedef struct MI_ISP_IQ_NrLumaAdvType_s
{
    MI_ISP_IQ_Bool_e                bEnable;
    MI_ISP_IQ_OpType_e              enOpType;
    MI_ISP_IQ_NrLumaAdvAutoAttr_t   stAuto;
    MI_ISP_IQ_NrLumaAdvManualAttr_t stManual;
} MI_ISP_IQ_NrLumaAdvType_t;

名称

变量名称	描述
bEnable	设定Luma_Adv降噪功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定Luma_Adv降噪的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定Luma_Adv降噪的自动模式属性结构体。
stManual	设定Luma_Adv降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNrLumaAdv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrLumaAdvType_t *data);

MI_S32 MI_ISP_IQ_GetNrLumaAdv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrLumaAdvType_t *data);

3.52.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定Luma_Adv降噪的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_NrLumaAdvAutoAttr_s

{

    MI_ISP_IQ_NrLumaAdvParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_NrLumaAdvAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.52.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定Luma_Adv降噪的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_NrLumaAdvManualAttr_s

{

    MI_ISP_IQ_NrLumaAdvParam_t stParaAPI;

} MI_ISP_IQ_NrLumaAdvManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.52.4. 参数结构体（Parameter Structure）

说明

设定Luma_Adv降噪的参数结构体。

定义

typedef struct MI_ISP_IQ_NrLumaAdvParam_s
{
    MI_U8  u8HotPixCnt;
    MI_U8  u8DarkPixCnt;
    MI_U8  u8HotPix[NRLUMA_ADV_PIX_NUM];
    MI_U8  u8DarkPix[NRLUMA_ADV_PIX_NUM];
    MI_U8  u8DbgMode;
    MI_U16 u16EdgeThByLuma[NRLUMA_ADV_BY_LUMA_NUM];
    MI_U8  u8LumaSft[NRLUMA_ADV_LUMASFT_NUM];
    MI_U8  u8EdgeThByMot[NRLUMA_ADV_BY_MOT_NUM];
    MI_U8  u8EdgeThByMot1[NRLUMA_ADV_BY_MOT_NUM];
    MI_U8  u8SF1_str;
    MI_U8  u8SF2_str;
    MI_U8  u8SF3_KerStr;
    MI_U8  u8SF3_KerWei[NRLUMA_ADV_KERWEI_NUM];
    MI_U8  u8SF3_StrByLuma[NRLUMA_ADV_BY_LUMA_NUM];
    MI_U8  u8SF3_StrByMot[NRLUMA_ADV_BY_MOT_NUM];
    MI_U8  u8SF3_StrByHue[NRLUMA_ADV_BY_HUE_NUM];
    MI_U8  u8SF3_StrByHue_SatTh[NRLUMA_ADV_LEVEL_NUM];
    MI_U8  u8SF3_StrByRadius_Sft[NRLUMA_ADV_RADIUSSFT_NUM];
    MI_U8  u8SF3_StrByRadius[NRLUMA_ADV_RADIUS_NUM];
    MI_U8  u8SF4_KerStr;
    MI_U8  u8SF4_KerWei[NRLUMA_ADV_KERWEI_NUM];
    MI_U8  u8SF4_StrByMot[NRLUMA_ADV_BY_MOT_NUM];
    MI_U16 u16Strength[NRLUMA_ADV_LEVEL_NUM];
    MI_U8  u8StrengthByMot[NRLUMA_ADV_BY_MOT_NUM];
    MI_U8  u8StrengthByLuma[NRLUMA_ADV_BY_LUMA_NUM];
} MI_ISP_IQ_NrLumaAdvParam_t;

名称

变量名称	描述
u8HotPixCnt	亮点补偿个数，值域范围：0 ~ 7，决定需要补偿的坏点（亮点）数，建议值为1。
u8DarkPixCnt	暗点补偿个数，值域范围：0 ~ 7，决定需要补偿的坏点（暗点）数，建议值为1。
u8HotPix[NRLUMA_ADV_PIX_NUM]	亮点补偿阀值，值域范围：0 ~ 255，四个值决定阀值曲线，当中心点与周围点差值大于曲线阀值时就会判定为坏（亮）点。NRLUMA_ADV_PIX_NUM = 4
u8DarkPix[NRLUMA_ADV_PIX_NUM]	暗点补偿阀值，值域范围：0 ~ 255，四个值决定阀值曲线，当中心点与周围点差值大于曲线阀值时就会判定为坏（暗）点。NRLUMA_ADV_PIX_NUM = 4
u8DbgMode	Debug模式，值域范围：0 ~ 2，1为edge判断的模式，影像越亮代表越被判断成edge区，影像越暗则代表越被判断成non-edge区，这边只做Luma处理，影像颜色没有意义。2为defect detection的模式，可以观察白点defect出现的地方。
u16EdgeThByLuma[NRLUMA_ADV_BY_LUMA_NUM]	Edge阀值根据亮度调节，值域范围：0 ~ 8191，横轴为亮度，越右边越偏亮。可以搭配DbgMode调整，观察edge分布是否合理。NRLUMA_ADV_BY_LUMA_NUM = 8
u8LumaSft[NRLUMA_ADV_LUMASFT_NUM]	亮度尺度调节，值域范围：0 ~ 8，可以根据不同亮度区间改变可调整的尺度大小。 NRLUMA_ADV_LUMASFT_NUM = 7
u8EdgeThByMot[NRLUMA_ADV_BY_MOT_NUM]	L1 Edge阀值根据motion调节，值域范围：0 ~ 255，横轴为motion程度，越右边越静。可以搭配DbgMode调整，观察edge分布是否合理。 NRLUMA_ADV_BY_MOT_NUM = 16
u8EdgeThByMot1[NRLUMA_ADV_BY_MOT_NUM]	L2 Edge阀值根据motion调节，值域范围：0 ~ 255，横轴为motion程度，越右边越静。可以搭配DbgMode调整，观察edge分布是否合理。 NRLUMA_ADV_BY_MOT_NUM = 16
u8SF1_str	edge区的NR强度，值域范围：0 ~ 127，可以按照Debug模式来观察何处edge区来调整NR大小。
u8SF2_str	平坦或是移动区域的NR强度，值域范围：0 ~ 127，可以按照Debug模式来观察何处是平坦或是动区来调整NR大小。
u8SF3_KerStr	有方向性的去躁参数，与中心点差异的横移量，值域范围：0 ~ 9，值越大则去躁效果越强。
u8SF3_KerWei[NRLUMA_ADV_KERWEI_NUM]	有方向性的去躁参数，混合权重表，值域范围：0 ~ 63，横轴为与中心点的差异，纵轴为权重，正常情况下，差异越小则权重设越大。NRLUMA_ADV_KERWEI_NUM = 16
u8SF3_StrByLuma[NRLUMA_ADV_BY_LUMA_NUM]	依据亮度调整强度，值域范围：0 ~ 127，横轴为亮度，越右边越偏亮。 NRLUMA_ADV_BY_LUMA_NUM = 8
u8SF3_StrByMot[NRLUMA_ADV_BY_MOT_NUM]	有方向性的去躁参数，依据motion去混合mean filter的结果，值域范围：0 ~ 127，横轴为motion，越右边越偏静，纵轴为混合mean filter结果的比例，由于mean filter过强，因此不建议设太大。 NRLUMA_ADV_BY_MOT_NUM = 16
u8SF3_StrByHue[NRLUMA_ADV_BY_HUE_NUM]	依据hue调整强度，值域范围：0 ~ 127，横轴为hue（同HSV）。 NRLUMA_ADV_BY_HUE_NUM = 24
u8SF3_StrByHue_SatTh[NRLUMA_ADV_LEVEL_NUM]	依据saturation调整强度，值域范围：0 ~ 127，当saturation小于SF3_StrByHue_SatTh1，则SF3_StrByHue失效，也就是强度的调整不受到饱和度太低的hue影响，当saturation大于SF3_StrByHue_SatTh2，则完全依照SF3_StrByHue调整强度，过度区则线性变化。 NRLUMA_ADV_LEVEL_NUM = 2
u8SF3_StrByRadius_Sft[NRLUMA_ADV_RADIUSSFT_NUM]	调整SF3_StrByRadius与中心点距离的尺度大小，值域范围：0 ~ 7，可以根据不同距离区间调整尺度大小。NRLUMA_ADV_RADIUSSFT_NUM = 5
u8SF3_StrByRadius[NRLUMA_ADV_RADIUS_NUM]	依据与中心点距离调整强度，值域范围：0 ~ 127，横轴为与中心点的距离大小，越右边离中心点越远。NRLUMA_ADV_RADIUS_NUM = 6
u8SF4_KerStr	无方向性的去躁参数，与中心点差异的横移量，值域范围：0 ~ 9，值越大则去躁效果越强。
u8SF4_KerWei[NRLUMA_ADV_KERWEI_NUM]	无方向性的去躁参数，混合权重表，值域范围：0 ~ 63，横轴为与中心点的差异，纵轴为权重，正常情况下，差异越小则权重设越大。NRLUMA_ADV_KERWEI_NUM = 16
u8SF4_StrByMot[NRLUMA_ADV_BY_MOT_NUM]	无方向性的去躁参数，依据motion去混合mean filter的结果，值域范围：0 ~ 6，横轴为motion，越右边越偏静，纵轴为混合mean filter结果的比例，由于mean filter过强，因此不建议设太大。 NRLUMA_ADV_BY_MOT_NUM = 16
u16Strength[NRLUMA_ADV_LEVEL_NUM]	整体强度，值域范围：0 ~ 256，Strength1为edge区的强度，Strength2为平坦与移动区的强度，值越大则NR越强。最终强度是以Strength为基础，再加上StrengthByMot和StrengthByLuma的控制，因此建议不要将Strength设到最强，否则StrengthByMot和StrengthByLuma就失效了。 NRLUMA_ADV_LEVEL_NUM = 2
u8StrengthByMot[NRLUMA_ADV_BY_MOT_NUM]	依据motion调整强度，值域范围：0 ~ 64，横轴为motion，越右边越偏静。 NRLUMA_ADV_BY_MOT_NUM = 16
u8StrengthByLuma[NRLUMA_ADV_BY_LUMA_NUM]	依据亮度调整强度，值域范围：0 ~ 64，横轴为亮度，越右边越亮。 NRLUMA_ADV_BY_LUMA_NUM = 8

3.53. MI_ISP_IQ_NrChromaAdv结构体¶

3.53.1. 类型结构体（Type Structure）

说明

设定Chroma_Adv降噪的类型结构体。

定义

typedef struct MI_ISP_IQ_NrChromaAdvType_s
{
    MI_ISP_IQ_Bool_e                        bEnable;
    MI_ISP_IQ_OpType_e                      enOpType;
    MI_ISP_IQ_NrChromaAdvAutoAttr_t         stAuto;
    MI_ISP_IQ_NrChromaAdvManualAttr_t       stManual;
} MI_ISP_IQ_NrChromaAdvType_t;

名称

变量名称	描述
bEnable	设定Chroma_Adv降噪功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定Chroma_Adv降噪的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定Chroma_Adv降噪的自动模式属性结构体。
stManual	设定Chroma_Adv降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNrChromaAdv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrChromaAdvType_t *data);

MI_S32 MI_ISP_IQ_GetNrChromaAdv(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrChromaAdvType_t *data);

3.53.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定Chroma_Adv降噪的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_NrChromaAdvAutoAttr_s

{

    MI_ISP_IQ_NrChromaAdvParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_NrChromaAdvAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.53.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定Chroma_Adv降噪的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_NrChromaAdvManualAttr_s

{

    MI_ISP_IQ_NrChromaAdvParam_t stParaAPI;

} MI_ISP_IQ_NrChromaAdvManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.53.4. 参数结构体（Parameter Structure）

说明

设定Chroma_Adv降噪的参数结构体。

定义

typedef struct MI_ISP_IQ_NrChromaAdvParam_s
{
    MI_U8  u8StrengthByY[NRCHROMA_ADV_BY_Y_NUM];
    MI_U8  u8StrengthByYEdge[NRCHROMA_ADV_BY_YEDGE_NUM];
    MI_U8  u8StrengthByCEdge[NRCHROMA_ADV_BY_CEDGE_NUM];
    MI_U8  u8MaxStrength;
    MI_U8  u8StrengthByMot[NRCHROMA_ADV_BY_MOT_NUM];
    MI_U8  u8MotionClip;
    MI_U8  u8MotionColorReduce;
    MI_U8  u8MotionColorRecover;
    MI_U8  u8PreStrength;
} MI_ISP_IQ_NrChromaAdvParam_t;

名称

变量名称	描述
u8StrengthByY[NRCHROMA_ADV_BY_Y_NUM]	针对不同亮度，给予不同NR强度的控制，横轴越右边代表亮度越大。值越大越强，值域范围：0 ~ 255。 NRCHROMA_ADV_BY_Y_NUM = 8。
u8StrengthByYEdge [NRCHROMA_ADV_BY_YEDGE_NUM]	使用Luma来侦测Edge程度，针对不同Edge，给予不同NR强度的控制，横轴越右边代表Edge越大。值越大越强，值域范围：0 ~ 63。 NRCHROMA_ADV_BY_YEDGE_NUM = 8。
u8StrengthByCEdge [NRCHROMA_ADV_BY_CEDGE_NUM]	使用Chroma来侦测Edge程度，针对不同Edge，给予不同NR强度的控制，横轴越右边代表Edge越大。值越大越强，值域范围：0 ~ 255。 NRCHROMA_ADV_BY_CEDGE_NUM = 8。
u8MaxStrength	控制Y/C差异小的区域，NR的强度。值越大越强，值域范围：0 ~ 255。
u8StrengthByMot [NRCHROMA_ADV_BY_MOT_NUM]	依据motion调整NR的强度，横轴为motion，越右边越偏静。值域：0 ~ 63，值越大越强。 NRCHROMA_ADV_BY_MOT_NUM = 16。
u8MotionClip	针对移动区域，给予更多NR强度。值越大越强，值域范围：0 ~ 255。
u8MotionColorReduce	针对移动区域，可降低饱和度。值越大饱和度降越多，值域范围：0 ~ 255。
u8MotionColorRecover	针对移动区域，可根据MotionColorReduce所降低的饱和度，再把gain乘回来。值越大饱和度恢复越多，值域范围：0 ~ 255。
u8PreStrength	针对Chroma先做简单的去躁处理。值越大越强，值域范围：0 ~ 128。

3.54. MI_ISP_IQ_Pfc结构体¶

3.54.1. 类型结构体（Type Structure）

说明

设定PFC的类型结构体。

定义

typedef struct MI_ISP_IQ_PfcType_s
{
    MI_ISP_IQ_Bool_e                bEnable;
    MI_ISP_IQ_OpType_e              enOpType;
    MI_ISP_IQ_PfcAutoAttr_t     stAuto;
    MI_ISP_IQ_PfcManualAttr_t       stManual;
} MI_ISP_IQ_PfcType_t;

名称

变量名称	描述
bEnable	设定PFC功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定PFC的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定PFC的自动模式属性结构体。
stManual	设定PFC的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetPfc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_PfcType_t *data);

MI_S32 MI_ISP_IQ_GetPfc(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_PfcType_t *data);

3.54.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定PFC的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_PfcAutoAttr_s

{

    MI_ISP_IQ_PfcParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_PfcAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.54.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定PFC的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_PfcManualAttr_s

{

    MI_ISP_IQ_PfcParam_t stParaAPI;

} MI_ISP_IQ_PfcManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.54.4. 参数结构体（Parameter Structure）

说明

设定PFC的参数结构体。

定义

typedef struct MI_ISP_IQ_PfcParam_s
{
    MI_U8       u8Strength;
    MI_U8       u8UStrength;
    MI_U8       u8VStrength;
    MI_U8       u8StrengthByY[PFC_BY_Y_NUM];
    MI_U8       u8FlatProtect;
    MI_U8       u8SatByY[PFC_LUT_NUM];
    MI_U8       u8StrengthByContrast[PFC_BY_CONTRAST_NUM];
} MI_ISP_IQ_PfcParam_t;

名称

变量名称	描述
u8Strength	去紫边的强度控制。值越大越强，值域范围：0 ~ 255。
u8UStrength	去紫边作用在U channel的强度。值越大越强，值域：0 ~ 63。
u8VStrength	去紫边作用在V channel的强度。值越大越强，值域：0 ~ 63。
u8StrengthByY[PFC_BY_Y_NUM]	紫边通常出现在较暗的地方，且周围是高亮区域，所以可针对不同亮度，给予不同去紫边的强度，横轴越右边代表亮度越大。值越大越强，值域范围：0 ~ 255。PFC_BY_Y_NUM = 8。
u8FlatProtect	平坦区的判断，避免大面积的紫色被判断为紫边，而做的保护。值越大越多地方不做PFC，值域范围：0 ~ 127。
u8SatByY[PFC_LUT_NUM]	高对比度区的判断，紫边通常出现在对比较高的区域，所以使用SatByY[0]来判断对比的程度。值越大，代表侦测到的对比度需超过SatByY[0]才为高对比度。SatByY[1]用来判断亮度饱和区的程度。值越大，代表越亮的地方越不做PFC，值域范围：0 ~ 25。 PFC_LUT_NUM = 2。
u8StrengthByContrast[PFC_BY_CONTRAST_NUM]	针对对比的程度，给予不同强度的PFC，横轴越右边代表对比越强。值越大PFC越强，值域范围：0 ~ 63。 PFC_BY_CONTRAST_NUM = 8。

3.55. MI_ISP_IQ_PfcEx结构体¶

3.55.1. 类型结构体（Type Structure）

说明

设定PFC_EX的类型结构体。

定义

typedef struct MI_ISP_IQ_PfcExType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_PfcExManualAttr_t  stManual;

} MI_ISP_IQ_PfcExType_t;

名称

变量名称 描述

bEnable 设定PFC_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。

stManual 设定PFC_EX的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetPfcEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_PfcExType_t *data);

MI_S32 MI_ISP_IQ_GetPfcEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_PfcExType_t *data);

3.55.2. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定PFC_EX的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_PfcExManualAttr_s

{

    MI_ISP_IQ_PfcExParam_t stParaAPI;

} MI_ISP_IQ_PfcExManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.55.3. 参数结构体（Parameter Structure）

说明

设定PFC_EX的参数结构体。

定义

typedef struct MI_ISP_IQ_PfcExParam_s
{
    MI_ISP_IQ_Bool_e    bDbgEn;
    MI_U8               u8SatMaskSel; 
    MI_ISP_IQ_Bool_e    bSatAmpEn;
    MI_U8               u8StrengthByHue[PFC_EX_BY_HUE_NUM];
} MI_ISP_IQ_PfcExParam_t;

名称

变量名称	描述
bDbgEn	显示PFC的作用范围。值域0 ~ 1，1代表开启。
u8SatMaskSel	对比区判断的Mask大小选择。值域0 ~ 1，Mask 0范围较小，Mask 1范围较大。
bSatAmpEn	对比区判断时，勾选此功能，可将增加判断对比度时的精确度。
u8StrengthByHue[PFC_EX_BY_HUE_NUM]	根据不同的Hue，给予不同强度的PFC处理，值域范围：0 ~ 255。PFC_EX_BY_HUE_NUM = 12。

3.56. MI_ISP_IQ_HdrEx结构体¶

3.56.1. 类型结构体（Type Structure）

说明

设定HDR_EX的类型结构体。

定义

typedef struct MI_ISP_IQ_HdrExType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_HdrExManualAttr_t  stManual;

} MI_ISP_IQ_HdrExType_t;

名称

变量名称 描述

bEnable 设定HDR_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。

stManual 设定HDR_EX的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetHdrEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HdrExType_t *data);

MI_S32 MI_ISP_IQ_GetHdrEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_HdrExType_t *data);

3.56.2. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定HDR_EX的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_HdrExManualAttr_s

{

    MI_ISP_IQ_HdrExParam_t stParaAPI;

} MI_ISP_IQ_HdrExManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.56.3. 参数结构体（Parameter Structure）

说明

设定HDR_EX的参数结构体。

定义

typedef struct MI_ISP_IQ_HdrExParam_s
{
    MI_ISP_IQ_Bool_e    bDbgEn;
    MI_ISP_IQ_Bool_e    bDynRatioEn;
    MI_ISP_IQ_Bool_e    bNrEn;
    MI_U16          u16SensorExpRatio;
    MI_U8               u8DynRatioSrcSel;
    MI_U8               u8YSrcSel;
    MI_U8               u8NoiseLevelSrcSel;
    MI_U8               u8MotionMaxVal;
    MI_U8               u8MotAdjSft2[HDR_EX_MOT_LUT_X_NUM];
} MI_ISP_IQ_HdrExParam_t;

名称

变量名称	描述
bDbgEn	Debug mode。值域范围：0 ~ 1。
bDynRatioEn	动态曝光补偿开关。值域范围：0 ~ 1。
bNrEn	控制短曝NR开关。值域范围：0 ~ 1。
u16SensorExpRatio	长短曝亮度比，建议和AE设定一致。值域范围：1024 ~ 65535。
u8DynRatioSrcSel	动态曝光补偿亮度来源，0代表长曝，1代表短曝。值域范围：0 ~ 1。
u8YSrcSel	fusion by luma亮度来源，0代表长曝，1代表短曝。值域范围：0 ~ 1。
u8NoiseLevelSrcSel	NoiseLevel亮度来源。0代表长曝，1代表短曝，2代表两者最小值，3代表两者最大值。值域范围：0 ~ 3。
u8MotionMaxVal	运动程度上限值，值越大越不容易把噪声误判成运动，不建议调整。值域范围：0 ~ 7。
u8MotAdjSft2[HDR_EX_MOT_LUT_X_NUM]	MotAdj2，MotAdj3的横轴节点，以二的幂次方累加，不建议调整。值域范围：0 ~ 7。HDR_EX_MOT_LUT_X_NUM = 6。

3.57. MI_ISP_IQ_Nr3dEx结构体¶

3.57.1. 类型结构体（Type Structure）

说明

设定NR3D_EX的类型结构体。

定义

typedef struct MI_ISP_IQ_Nr3dExType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_Nr3dExManualAttr_t  stManual;

} MI_ISP_IQ_Nr3dExType_t;

名称

变量名称 描述

bEnable 设定NR3D_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。

stManual 设定NR3D_EX的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNr3dEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_Nr3dExType_t *data);

MI_S32 MI_ISP_IQ_GetNr3dEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_Nr3dExType_t *data);

3.57.2. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定NR3D_EX的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_Nr3dExManualAttr_s

{

    MI_ISP_IQ_Nr3dExParam_t stParaAPI;

} MI_ISP_IQ_Nr3dExManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.57.3. 参数结构体（Parameter Structure）

说明

设定NR3D_EX的参数结构体。

定义

typedef struct MI_ISP_IQ_Nr3dExParam_s
{
    MI_ISP_IQ_Bool_e    bDbgEn;
    MI_ISP_IQ_Bool_e    bAREn;
    MI_U8               u8ARLumaTh[NR3D_EX_AR_LUMA_NUM];
    MI_U8               u8ARMotTh[NR3D_EX_AR_MOT_NUM];
} MI_ISP_IQ_Nr3dExParam_t;

名称

变量名称	描述
bDbgEn	Debug模式，值域范围：0 ~ 1。影像颜色越黑则代表越被判断成动区。使用前务必将AE停掉。
bAREn	根据亮度与motion信息，限制NR3D强度的开关，值域0 ~ 1。
u8ARLumaTh[NR3D_EX_AR_LUMA_NUM]	当Luma < LumaTh[0]，则NR3D强度不变，当Luma > LumaTh[1]时，NR3D强度为0，值域0 ~ 255。 NR3D_EX_AR_LUMA_NUM = 2。
u8ARMotTh[NR3D_EX_AR_MOT_NUM]	当motion < MotTh[0]，则NR3D强度不变，当motion > MotTh[1]时，NR3D强度为0，值域0 ~ 255。 NR3D_EX_AR_MOT_NUM = 2。

3.58. MI_ISP_IQ_Dummy结构体¶

3.58.1. 类型结构体（Type Structure）

说明

设定DUMMY的类型结构体。

定义

typedef struct MI_ISP_IQ_DUMMY_TYPE_s
{
    MI_ISP_IQ_Bool_e                bEnable;
    MI_ISP_IQ_OpType_e              enOpType;
    MI_ISP_IQ_Bool_e                bLogEn;
    MI_ISP_IQ_DummyAutoAttr_t       stAuto;
    MI_ISP_IQ_DummyManualAttr_t stManual;
} MI_ISP_IQ_DummyType_t;

名称

变量名称	描述
bEnable	设定DUMMY功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定DUMMY的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
bLogEn	设定DUMMY的打印讯息开关，开启后会打印出DUMMY的参数结构体所对应的内容。
stAuto	设定DUMMY的自动模式属性结构体。
stManual	设定DUMMY的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDummy(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DummyType_t *data);

MI_S32 MI_ISP_IQ_GetDummy(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DummyType_t *data);

3.58.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定DUMMY的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DummyAutoAttr_s

{

    MI_ISP_IQ_DummyParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_DummyAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.58.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定DUMMY的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DummyManualAttr_s

{

    MI_ISP_IQ_DummyParam_t stParaAPI;

} MI_ISP_IQ_DummyManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.58.4. 参数结构体（Parameter Structure）

说明

设定DUMMY的参数结构体。

定义

typedef struct MI_ISP_IQ_DummyParam_s

{

    MI_S16 s16Dummy0[DUMMY_NUM];

    MI_S16 s16Dummy1[DUMMY_NUM];

    MI_S16 s16Dummy2[DUMMY_NUM];

    MI_S16 s16Dummy3;

    MI_S16 s16Dummy4;

} MI_ISP_IQ_DummyParam_t;

名称

变量名称	描述
s16Dummy0[DUMMY_NUM]	预设为-1，值域范围：-1 ~ 1023。 Dummy0[0]设为-1为关闭Dummy0，使用SharpnessEX内预设的EdgeKillLut节点以及EdgeKillLutUp EdgeKillLutDown；Dummy0[0]设为非-1的值，则开启SharpnessEX EdgeKillLut调控的功能，Dummy0[1_{6]为EdgeKillLut的六个节点，Dummy0[7}13]为EdgeKillLutUp，Dummy0[14_{20]为EdgeKillLutDown，其中EdgeKillLutUp/Down值域范围为0}1023。 DUMMY_NUM = 256。
s16Dummy1[DUMMY_NUM]	目前没作用，预设为-1，值域范围：-1 ~ 255。 DUMMY_NUM = 256。
s16Dummy2[DUMMY_NUM]	目前没作用，预设为-1，值域范围：-1 ~ 255。 DUMMY_NUM = 256。
s16Dummy3	目前没作用，预设为-1，值域范围：-1 ~ 255。
s16Dummy4	目前没作用，预设为-1，值域范围：-1 ~ 255。

3.59. MI_ISP_IQ_DummyEx结构体¶

3.59.1. 类型结构体（Type Structure）

说明

设定DUMMY_EX的类型结构体。

定义

typedef struct MI_ISP_IQ_DummyExType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_Bool_e        bLogEn;

    MI_ISP_IQ_DummyExManualAttr_t stManual;

} MI_ISP_IQ_DummyExType_t;

名称

变量名称	描述
bEnable	设定DUMMY_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
bLogEn	设定DUMMY的打印讯息开关，开启后会打印出DUMMY的参数结构体所对应的内容。
stManual	设定DUMMY_EX的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDummyEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DummyExType_t *data);

MI_S32 MI_ISP_IQ_GetDummyEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DummyExType_t *data);

3.59.2. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定DUMMY_EX的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DummyExManualAttr_s

{

    MI_ISP_IQ_DummyExParam_t stParaAPI;

} MI_ISP_IQ_DummyExManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.59.3. 参数结构体（Parameter Structure）

说明

设定DUMMY_EX的参数结构体。

定义

typedef struct MI_ISP_IQ_DummyExParam_s

{

    MI_S16 s16DummyEx0[DUMMY_EX_NUM];

    MI_S16 s16DummyEx1[DUMMY_EX_NUM];

    MI_S16 s16DummyEx2[DUMMY_EX_NUM];

    MI_S16 s16DummyEx3;

    MI_S16 s16DummyEx4;

} MI_ISP_IQ_DummyExParam_t;

名称

变量名称	描述
s16DummyEx0[DUMMY_EX_NUM]	目前没作用，预设为-1，值域范围：-1 ~ 255。 DUMMY_EX_NUM = 256。
s16DummyEx1[DUMMY_EX_NUM]	目前没作用，预设为-1，值域范围：-1 ~ 255。 DUMMY_EX_NUM = 256。
s16DummyEx2[DUMMY_EX_NUM]	目前没作用，预设为-1，值域范围：-1 ~ 255。 DUMMY_EX_NUM = 256。
s16DummyEx3	目前没作用，预设为-1，值域范围：-1 ~ 255。
s16DummyEx4	目前没作用，预设为-1，值域范围：-1 ~ 255。

3.60. MI_ISP_IQ_WDRCurveFull结构体¶

3.60.1. 类型结构体（Type Structure）

说明

设定WDRCurveFull的类型结构体。

定义

typedef struct MI_ISP_IQ_WdrCurveFullType_s
{
    MI_ISP_IQ_Bool_e                    bEnable[E_WDR_CURVE_FULL_MAX];
    MI_ISP_IQ_OpType_e                  enOpType[E_WDR_CURVE_FULL_MAX];
    MI_ISP_IQ_WdrCurveFullAutoAttr_t    stAuto;
    MI_ISP_IQ_WdrCurveFullManualAttr_t  stManual;
} MI_ISP_IQ_WdrCurveFullType_t;

名称

变量名称	描述
bEnable	设定WDRCurveFull功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定WDRCurveFull的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定WDRCurveFull的自动模式属性结构体。
stManual	设定WDRCurveFull的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetWdrCurveFull(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrCurveFullType_t *data);

MI_S32 MI_ISP_IQ_GetWdrCurveFull(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_WdrCurveFullType_t *data);

3.60.2. 曲线列举结构体（Curve Enum Structure）

说明

WDRCurveFull的曲线列举结构体。

定义

typedef enum __attribute__ ((aligned (4)))

{

    E_WDR_CURVE_FULL_GLOBAL_TONE,

    E_WDR_CURVE_FULL_CURVE1,

    E_WDR_CURVE_FULL_CURVE2,

    E_WDR_CURVE_FULL_MAX

} MI_ISP_IQ_WDRCurveFull_e;

名称

变量名称	描述
E_WDR_CURVE_FULL_GLOBAL_TONE	Global tone的相关设定。
E_WDR_CURVE_FULL_CURVE1	Curve1的相关设定。
E_WDR_CURVE_FULL_CURVE2	Curve2的相关设定。
E_WDR_CURVE_FULL_MAX	曲线列举列表的最大值。

3.60.3. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定WDRCurveFull的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_WdrCurveFullAutoAttr_s

{

    MI_ISP_IQ_WdrCurveFullParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_WdrCurveFullAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.60.4. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定WDRCurveFull的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_WdrCurveFullManualAttr_s

{

    MI_ISP_IQ_WdrCurveFullParam_t stParaAPI;

} MI_ISP_IQ_WdrCurveFullManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.60.5. 参数结构体（Parameter Structure）

说明

设定WDRCurveFull的参数结构体。

定义

typedef struct MI_ISP_IQ_WdrCurveFullParam_s

{

    MI_U8    u8GlobalToneSft[WDR_CURVE_FULL_LUT_X_NUM];

    MI_U16 u16GlobalToneLut[WDR_CURVE_FULL_LUT_Y_NUM];

    MI_U16 u16Curve1[WDR_CURVE_FULL_CURVE_NUM];

    MI_U16 u16Curve2[WDR_CURVE_FULL_CURVE_NUM];

} MI_ISP_IQ_WdrCurveFullParam_t;

名称

变量名称	描述
u8GlobalToneSft [WDR_CURVE_FULL_LUT_X_NUM]	Global tone的横轴节点，值域范围：3 ~ 15，有32个节点，X轴依序为0、2^{GlobalToneSft[0]、2}GlobalToneSft[0]+2^{GlobalToneSft[1]、2}GlobalToneSft[0]+2^{GlobalToneSft[1]+2}GlobalToneSft[2] ...，Y轴依序为GlobalToneLut[0]、GlobalToneLut[1]、GlobalToneLut[2] ...，此外，Y轴的最后一个节点有特殊设计，若X轴的最后一个节点小于65535，则Y轴的最后一个节点为GlobalToneLut[32]，若X轴的最后一个节点大于65535，则Y轴的最后一个节点为GlobalToneLut[31]+GlobalToneLut[32]，主要是为了让global tone能完全使用所有动态区间，也就是解决最后一个节点不一定刚好落在(x, y) = (65535, 4095)的问题，假设X轴的最后一个节点超过65535，那Y轴也要超过4095，才能让此节点和前一个节点的线段刚好通过(x, y) = (65535, 4095)。如需调整，建议用Excel画出原本的曲线，调整GlobalToneSft将想要细调的区间切细后，找到对应的GlobalToneLut，确认效果和先前一致后，再调整GlobalToneLut。WDR_CURVE_FULL_LUT_X_NUM = 31。
u16GlobalToneLut [WDR_CURVE_FULL_LUT_Y_NUM]	Global tone的纵轴节点，值域范围：0 ~ 4095。功能和DarkToneEnhance相同。WDR_CURVE_FULL_LUT_Y_NUM = 32。
u16Curve1 [WDR_CURVE_FULL_CURVE_NUM]	前级亮度调整曲线，值域范围：0 ~ 4096。横轴为输入亮度，纵轴为输出亮度，值越大则「没有经过直方图均衡化处理的影像」越亮。输出结果会依据Strength和WDRStrByY的比例来混合经过直方图均衡化处理的结果，剩下的比例会混合经过Curve1处理的结果。 WDR_CURVE_FULL_CURVE_NUM = 33。
u16Curve2 [WDR_CURVE_FULL_CURVE_NUM]	后级亮度调整曲线，值域范围：0 ~ 4096。横轴为输入亮度，纵轴为输出亮度，值越大则最终影像越亮。 WDR_CURVE_FULL_CURVE_NUM = 33。

3.61. MI_ISP_IQ_Defog结构体¶

3.61.1. 类型结构体（Type Structure）

说明

设定Defog的类型结构体。

定义

typedef struct MI_ISP_IQ_DefogType_s

{

    MI_ISP_IQ_Bool_e        bEnable;

    MI_ISP_IQ_OpType_e       enOpType;

    MI_ISP_IQ_DefogAutoAttr_t   stAuto;

    MI_ISP_IQ_DefogManualAttr_t  stManual;

} MI_ISP_IQ_DefogType_t;

名称

变量名称	描述
bEnable	设定Defog功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定Defog的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定Defog的自动模式属性结构体。
stManual	设定Defog的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDefog(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DefogType_t *data);

MI_S32 MI_ISP_IQ_GetDefog(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_DefogType_t *data);

3.61.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定Defog的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DefogAutoAttr_s

{

    MI_ISP_IQ_DefogParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_DefogAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.61.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定Defog的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_DefogManualAttr_s

{

    MI_ISP_IQ_DefogParam_t   stParaAPI;

} MI_ISP_IQ_DefogManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.61.4. 参数结构体（Parameter Structure）

说明

设定Defog的参数结构体。

定义

typedef struct MI_ISP_IQ_DefogParam_s

{

    MI_U8  u8Strength;

} MI_ISP_IQ_DefogParam_t;

名称

变量名称 描述

u8Strength 设定对比度、亮度、灰度的可变强度数值。值域范围：0 ~ 100。

3.62. MI_ISP_IQ_Temp结构体¶

3.62.1. 类型结构体（Type Structure）

说明

设定Temperature的类型结构体。

定义

typedef struct MI_ISP_IQ_TempType_s
{
    MI_ISP_IQ_Bool_e                bEnable;
    MI_U8                       u8TemperatureLut[TEMP_LUT_NUM];
    MI_ISP_IQ_OpType_e              enOpType;
    MI_ISP_IQ_TempAutoAttr_t        stAuto;
    MI_ISP_IQ_TempManualAttr_t      stManual;
} MI_ISP_IQ_TempType_t;

名称

变量名称	描述
bEnable	设定Temperature功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u8TemperatureLut[TEMP_LUT_NUM]	设定Temperature节点，支持16个节点，值域范围：0 ~ 100。 TEMP_LUT_NUM = 16。
enOpType	设定Temperature的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定Temperature的自动模式属性结构体。
stManual	设定Temperature的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetTemp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_TempType_t *data);

MI_S32 MI_ISP_IQ_GetTemp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_TempType_t *data);

3.62.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定Temperature的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_TempAutoAttr_s

{

    MI_ISP_IQ_TempParam_t  stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_TempAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.62.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定Temperature的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_TempManualAttr_s

{

    MI_ISP_IQ_TempParam_t  stParaAPI;

} MI_ISP_IQ_TempManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.62.4. 参数结构体（Parameter Structure）

说明

设定Temperature的参数结构体。

定义

typedef struct MI_ISP_IQ_TempParam_s

{

    MI_S16 s16ObcOffset;

    MI_U8    u8DynamicDPRatio;

    MI_U8    u8CrosstalkRatio;

    MI_U8    u8NRDeSpikeRatio;

    MI_U8    u8NR3DRatio[TEMP_NR3D_NUM];

    MI_U8    u8NRLumaRatio;

    MI_U8    u8SharpnessRatio[TEMP_SHARPNESS_NUM];

    MI_U8    u8SaturationRatio;

    MI_U8    u8ColorToneRatio[TEMP_COLOR_TONE_NUM];

} MI_ISP_IQ_TempParam_t;

名称

变量名称	描述
s16ObcOffset	OBC偏移量，预设为0，值越大扣越多。值域范围：-32768 ~ 32767。
u8DynamicDPRatio	DynamicDP强度变化比例，值越大越强，预设为50。值域范围：0 ~ 100。
u8CrosstalkRatio	Crosstalk强度变化比例，值越大越强，预设为50。值域范围：0 ~ 100。
u8NRDeSpikeRatio	NRDeSpike强度变化比例，值越大越强，预设为50。值域范围：0 ~ 100。
u8NR3DRatio[TEMP_NR3D_NUM]	NR3D强度变化比例，值越大越强，u8NR3DRatio[0]代表MD.Thd，u8NR3DRatio[1]代表MD.Gain，预设为50。值域范围：0 ~ 100。TEMP_NR3D_NUM = 2。
u8NRLumaRatio	NRLuma强度变化比例，值越大越强，预设为50。值域范围：0 ~ 100。
u8SharpnessRatio[TEMP_SHARPNESS_NUM]	Sharpness强度变化比例，值越大越锐利，u8SharpnessRatio[0]代表OverShootGain，u8SharpnessRatio[1]代表UnderShootGain，预设为50。值域范围：0 ~ 100。TEMP_SHARPNESS_NUM = 2。
u8SaturationRatio	Saturation强度变化比例，值越大越饱和，预设为50。值域范围：0 ~ 100。
u8ColorToneRatio[TEMP_COLOR_TONE_NUM]	ColorTone强度变化比例，值越大越饱和，u8ColorToneRatio[0~2]依序对应到R/G/B，预设为50。值域范围：0 ~ 100。TEMP_COLOR_TONE_NUM = 3。

3.63. MI_ISP_IQ_TempInfo结构体¶

3.63.1. 类型结构体（Type Structure）

说明

设定temperature info的类型结构体。

定义

typedef struct MI_ISP_IQ_TempInfoType_s

{

    MI_U8  u8Temperature;

} MI_ISP_IQ_TempInfoType_t;

名称

变量名称 描述

u8Temperature 获取当前chip温度，只读，值域范围：0 ~ 255。

相关结构类型与函式

MI_S32 MI_ISP_IQ_GetTempInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_TempInfoType_t *data);

3.64. MI_ISP_IQ_NrChromaPre结构体¶

3.64.1. 类型结构体（Type Structure）

说明

设定Chroma_Pre降噪的类型结构体。

定义

typedef struct MI_ISP_IQ_NrChromaPreType_s
{
    MI_ISP_IQ_Bool_e                    bEnable;
    MI_ISP_IQ_OpType_e                  enOpType;
    MI_ISP_IQ_NrChromaPreAutoAttr_t     stAuto;
    MI_ISP_IQ_NrChromaPreManualAttr_t   stManual;
} MI_ISP_IQ_NrChromaPreType_t;

名称

变量名称	描述
bEnable	设定Chroma_Pre降噪功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定Chroma_Pre降噪的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定Chroma_Pre降噪的自动模式属性结构体。
stManual	设定Chroma_Pre降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNrChromaPre(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrChromaPreType_t *data);

MI_S32 MI_ISP_IQ_GetNrChromaPre(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_IQ_NrChromaPreType_t *data);

3.64.2. 自动模式属性结构体（Automatic Mode Attribute Structure）

说明

设定Chroma_Pre降噪的自动模式属性结构体。

定义

typedef struct MI_ISP_IQ_NrChromaPreAutoAttr_s

{

    MI_ISP_IQ_NrChromaPreParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_NrChromaPreAutoAttr_t;

名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

3.64.3. 手动模式属性结构体（Manual Mode Attribute Structure）

说明

设定Chroma_Pre降噪的手动模式属性结构体。

定义

typedef struct MI_ISP_IQ_NrChromaPreManualAttr_s

{

    MI_ISP_IQ_NrChromaPreParam_t stParaAPI;

} MI_ISP_IQ_NrChromaPreManualAttr_t;

名称

变量名称 描述

stParaAPI 手动模式属性结构体。

3.64.4. 参数结构体（Parameter Structure）

说明

设定Chroma_Pre降噪的参数结构体。

定义

typedef struct MI_ISP_IQ_NrChromaPreParam_s

{

    MI_ISP_IQ_Bool_e  bDbgEn;

    MI_U16     u16Strength;

    MI_U8       u8MotionEnhance[NRCHROMA_PRE_YC_NUM];

    MI_U16     u16MaskGenTh;

    MI_U16     u16MeanFilterTh[NRCHROMA_PRE_YC_NUM];

    MI_U16     u16MedianFilterTh[NRCHROMA_PRE_YC_NUM];

    MI_U16     u16BlendTh;

    MI_U8        u8BlendGap;

} MI_ISP_IQ_NrChromaPreParam_t;

名称

变量名称	描述
bDbgEn	Debug模式，值域范围：0 ~ 1，使用前务必将Strength设为最大值256，影像的U/V通道值越小则代表越使用mean filter的结果，U/V通道值越大则代表越使用median filter的结果。
u16Strength	整体强度，值域范围：0 ~ 256，值越大则NR效果越强。
u8MotionEnhance[NRCHROMA_PRE_YC_NUM]	动态区域加强程度，值域范围：0 ~ 127，第一格为Y信道加强幅度，第二格为U/V信道加强幅度，值越大则动态区域NR效果越强。NRCHROMA_PRE_YC_NUM = 2。
u16MaskGenTh	U/V通道阀值，用于产生mask，并在此mask内做NR，值域范围：0 ~ 1023，值越大则mask越大，NR效果越强。
u16MeanFilterTh[NRCHROMA_PRE_YC_NUM]	Y/U/V通道阀值，用于控制mean filter强度，值域范围：0 ~ 1023，第一格为Y通道阀值，第二格为U/V通道阀值，只有当mask内的差值小于此阀值才会被纳入做mean filter，值越大则NR效果越强。 NRCHROMA_PRE_YC_NUM = 2。
u16MedianFilterTh[NRCHROMA_PRE_YC_NUM]	Y/U/V通道阀值，用于控制median filter强度，值域范围：0 ~ 1023，第一格为Y通道阀值，第二格为U/V通道阀值，只有当mask内的差值小于此阀值才会被纳入做median filter，值越大则NR效果越强。 NRCHROMA_PRE_YC_NUM = 2。
u16BlendTh	混合阀值，值域范围：0 ~ 1023，当mask内的U/V通道最大差值小于BlendTh，则使用mean filter的结果，值越大则越偏向使用mean filter的结果。
u8BlendGap	混合区间，值域范围：0 ~ 15，当mask内的U/V通道最大差值大于BlendTh+2^BlendGap，则使用median filter的结果，值越大则越偏向使用mean filter的结果。

3.65. MI_ISP_IQ_ApiBypass结构体¶

3.65.1. 类型结构体（Type Structure）

说明

设定ISP对应IP模块的略过模式的类型结构体。

定义

typedef struct MI_ISP_IQ_ApiBypassType_s

{

    MI_ISP_IQ_BypassMode_e bEnable;

    MI_ISP_IQ_ApiId_e   eAPIIndex;

} MI_ISP_IQ_ApiBypassType_t;

名称

变量名称	描述
bEnable	设定ISP对应IP模块的略过模式功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
eAPIIndex	设定ISP API ID列举数值。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetApiBypassMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ApiBypassType_t *data);

MI_S32 MI_ISP_IQ_GetApiBypassMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ApiBypassType_t *data);

3.66. MI_ISP_AE_bool结构体¶

3.66.1. 列举结构体（Enum Structure）

说明

布尔值的列举结构体。

定义

typedef enum

{

    E_SS_AE_FALSE = 0,

    E_SS_AE_TRUE = !E_SS_AE_FALSE,

    E_SS_AE_BOOL_MAX

} MI_ISP_AE_bool_e;

名称

变量名称 描述

E_SS_AE_FALSE 布尔值等于0。

E_SS_AE_TRUE 布尔值等于1。

E_SS_AE_BOOL_MAX 判断布尔值列举列表的最大值。

相关结构类型与函式

MI_ISP_AE_ExpoInfoType_t

MI_ISP_AE_FlickerExType_t

MI_ISP_AE_QueryFlickerExInfo

MI_ISP_AE_StrategyExType_t

MI_ISP_AE_RgbirAeType_t

MI_ISP_AE_StabilizerType_t

MI_ISP_AE_PowerLineType_t

3.67. MI_ISP_AE_OpType结构体¶

3.67.1. 列举结构体（Enum Structure）

说明

工作模式的列举结构体。

定义

typedef enum

{

    E_SS_AE_OP_TYP_AUTO = 0,

    E_SS_AE_OP_TYP_MANUAL = ! E_SS_AE_OP_TYP_AUTO,

    E_SS_AE_OP_TYP_MODE_MAX

} MI_ISP_AE_OpType_e;

名称

变量名称 描述

E_SS_AE_OP_TYP_AUTO 自动工作模式。

E_SS_AE_OP_TYP_MANUAL 手动工作模式。

E_SS_AE_OP_TYP_MODE_MAX 判断工作模式列举列表的最大值。
相关结构类型与函式
```
MI_ISP_AE_FlickerExType_t
```

3.68. MI_ISP_AE_SmStateType结构体¶

3.68.1. 列举结构体（Enum Structure）

说明

状态机（State Machine）的列举结构体。

定义

typedef enum

{

    E_SS_AE_STATE_NORMAL = 0,

    E_SS_AE_STATE_PAUSE = 1,

    E_SS_AE_STATE_MAX

} MI_ISP_AE_SmStateType_e;

名称

变量名称 描述

E_SS_AE_STATE_NORMAL 正常模式。

E_SS_AE_STATE_PAUSE 暂停模式。

E_SS_AE_STATE_MAX 判断状态机列举清单的最大值。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetState(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_SmStateType_e *data);

MI_S32 MI_ISP_AE_GetState(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_SmStateType_e *data);

3.69. MI_ISP_AE_ExpoValue结构体¶

3.69.1. 类型结构体（Type Structure）

说明

记录曝光参数的类型结构体。

定义

typedef struct MI_ISP_AE_ExpoValueType_s

{

    MI_U32 u32FNx10;

    MI_U32 u32SensorGain;

    MI_U32 u32ISPGain;

    MI_U32 u32US;

} MI_ISP_AE_ExpoValueType_t;

名称

变量名称	描述
u32FNx10	光圈值×10（ex：光圈F1.8则此项等于18）。
u32SensorGain	Sensor增益值（含sensor模拟增益与sensor数字增益，1024等于1倍）。
u32ISPGain	ISP数字增益（1024等于1倍）。
u32US	曝光时间（μsec）。

相关结构类型与函式

MI_ISP_AE_ExpoInfoType_t

MI_S32 MI_ISP_AE_SetManualExpo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoValueType_t *data);

MI_S32 MI_ISP_AE_GetManualExpo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoValueType_t *data);

MI_S32 MI_ISP_AE_SetManualShortExpo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoValueType_t *data);

MI_S32 MI_ISP_AE_GetManualShortExpo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoValueType_t *data);

3.70. MI_ISP_AE_HistWeightY结构体¶

3.70.1. 类型结构体（Type Structure）

说明

纪录当前画面亮度及直方统计数据的结构体。

定义

typedef struct MI_ISP_AE_HistWeightYType_s

{

    MI_U32 u32LumY;

    MI_U32 u32AvgY;

    MI_U32 u32Hits[MI_ISP_AE_HIST_BIN];

} MI_ISP_AE_HistWeightYType_t;

名称

变量名称	描述
u32LumY	经区块权重表加权过后的当前画面亮度。
u32AvgY	当前画面的平均亮度（无加权）。
u32Hits[MI_ISP_AE_HIST_BIN]	画面值方图统计资料（共128柱对应到0 ~ 255）。 MI_ISP_AE_HIST_BIN = 128。

相关结构类型与函式

MI_ISP_AE_ExpoInfoType_t

MI_S32 MI_ISP_AE_GetHistoWghtY(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_HistWeightYType_t *data);

3.71. MI_ISP_AE_ExpoInfo结构体¶

3.71.1. 类型结构体（Type Structure）

说明

获取当前整体曝光信息的结构体。

定义

typedef struct MI_ISP_AE_ExpoInfoType_s
{
    MI_ISP_AE_bool_e                bIsStable;
    MI_ISP_AE_bool_e                bIsReachBoundary;
    MI_ISP_AE_ExpoValueType_t       stExpoValueLong;
    MI_ISP_AE_ExpoValueType_t       stExpoValueShort;
    MI_ISP_AE_HistWeightYType_t stHistWeightY;
    MI_U32                      u32LVx10;
    MI_S32                      s32BV;
    MI_U32                      u32SceneTarget;
} MI_ISP_AE_ExpoInfoType_t;

名称

变量名称	描述
bIsStable	AE是否收敛（1：收敛，0：尚未收敛）。
bIsReachBoundary	当前曝光参数是否已顶到变动范围上下界（1：顶到，0：未顶到）。
stExpoValueLong	当前曝光参数（如为HDR mode则为长曝曝光参数）。
stExpoValueShort	HDR mode下的短曝曝光参数。
stHistWeightY	当前画面亮度及直方图统计资料。
u32LVx10	当前LV数值×10。
s32BV	当前BV数值×16384。
u32SceneTarget	当前AE目标亮度。

相关结构类型与函式

MI_S32 MI_ISP_AE_QueryExposureInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoInfoType_t *data);

3.72. MI_ISP_AE_EvComp结构体¶

3.72.1. 类型结构体（Type Structure）

说明

设定额外增减曝光补偿强度的结构体。

定义

typedef struct MI_ISP_AE_EvCompType_s

{

    MI_S32 s32EV;

    MI_U32 u32Grad;

} MI_ISP_AE_EvCompType_t;

名称

变量名称 描述

s32EV 额外的增减曝光能量的分子。值域范围：-10 ~ 10。

u32Grad 额外的增减曝光能量的分母。值域范围：1 ~ 10。
注意事项

Ex：s32EV = 1、u32Grad = 2，则曝光能量会较原订自动模式再额外增加½ EV。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetEvComp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_EvCompType_t *data);

MI_S32 MI_ISP_AE_GetEvComp(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_EvCompType_t *data);

3.73. MI_ISP_AE_Mode结构体¶

3.73.1. 类型结构体（Type Structure）

说明

设定全自动、半自动或手动曝光模式。

定义

typedef enum

{

    E_SS_AE_MODE_A,

    E_SS_AE_MODE_AV,

    E_SS_AE_MODE_SV,

    E_SS_AE_MODE_TV,

    E_SS_AE_MODE_M,

    E_SS_AE_MODE_MAX

} MI_ISP_AE_ModeType_e;

名称

变量名称	描述
E_SS_AE_MODE_A	全自动曝光模式。
E_SS_AE_MODE_AV	光圈先决模式。
E_SS_AE_MODE_SV	增益先决模式。
E_SS_AE_MODE_TV	快门先决模式。
E_SS_AE_MODE_M	手动模式。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetExpoMode(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ModeType_e *data);

MI_S32 MI_ISP_AE_GetExpoMode(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ModeType_e *data);

3.74. MI_ISP_AE_IntpLut结构体¶

3.74.1. 类型结构体（Type Structure）

说明

具结点内插功能的参数数据设定表。

可用于设定随环境亮度变化的画面目标亮度（ex：X轴：BV、Y轴：画面目标亮度）。

或随环境亮度变化的画面目标亮度浮动范围（ex：X轴：BV、Y轴：画面目标亮度的浮动范围）。

定义

typedef struct MI_ISP_AE_IntpLutType_s

{

    MI_U16 u16NumOfPoints;

    MI_S32 s32Y[MI_ISP_AE_LUT_16];

    MI_S32 s32X[MI_ISP_AE_LUT_16];

} MI_ISP_AE_IntpLutType_t;

名称

变量名称	描述
u16NumOfPoints	实际表中数据的有效节点数，最大支持16个节点，也就是可填入16笔X、Y数据。
s32Y[MI_ISP_AE_LUT_16]	对应每一节点的Y 轴参数，如不使用的节点可将参数设0。 MI_ISP_AE_LUT_16 = 16。
s32X[MI_ISP_AE_LUT_16];	对应每一节点的X 轴参数，如不使用的节点可将参数设0。 MI_ISP_AE_LUT_16 = 16。

相关结构类型与函式

MI_ISP_AE_HdrType_t

MI_ISP_AE_StrategyType_t

MI_ISP_AE_LumaWgtType_t

MI_S32 MI_ISP_AE_SetTarget(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_IntpLutType_t *data);

MI_S32 MI_ISP_AE_GetTarget(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_IntpLutType_t *data);

3.75. MI_ISP_AE_ConvConditon结构体¶

3.75.1. 类型结构体（Type Structure）

说明

设定自动曝光的收敛条件。

定义

typedef struct MI_ISP_AE_ConvConditonType_s
{
    MI_ISP_AE_ConvThdParam_t    stConvThrd;
    MI_ISP_AE_ConvSpeedParam_t  stConvSpeed;
} MI_ISP_AE_ConvConditonType_t;

名称

变量名称 描述

stConvThrd 设定自动曝光启动收敛或判断收敛完成的区间。

stConvSpeed 设定自动曝光的收敛速度。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetConverge(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ConvConditonType_t *data);

MI_S32 MI_ISP_AE_GetConverge(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ConvConditonType_t *data);

3.75.2. 收敛区间结构体（MI_ISP_AE_ConvThdParam_t）

说明

设定自动曝光启动收敛或判断收敛完成的区间。

定义

typedef struct MI_ISP_AE_ConvThdParam_s

{

    MI_U32 u32InThd;

    MI_U32 u32OutThd;

} MI_ISP_AE_ConvThdParam_t;

名称

变量名称	描述
u32InThd	若画面加权亮度与画面目标亮度的差小于此数值，则判断为自动曝光已收敛。值域范围：1 ~ 100。
u32OutThd	若画面加权亮度与画面目标亮度的差大于此数值，则判断为自动曝光未收敛，自动曝光将启动收敛程序。值域范围：2 ~ 100。

相关结构类型与函式
```
MI_ISP_AE_ConvConditonType_t
```

3.75.3. 收敛速度结构体（MI_ISP_AE_ConvSpeedParam_t）

说明

设定自动曝光的收敛速度。

共提供四组节点，X轴为对应的画面亮度，Y轴为对应画面亮度的收敛速度。

定义

typedef struct MI_ISP_AE_ConvSpeedParam_s

{

    MI_U32 u32SpeedX[MI_ISP_AE_LUT_4];

    MI_U32 u32SpeedY[MI_ISP_AE_LUT_4];

} MI_ISP_AE_ConvSpeedParam_t;

名称

变量名称	描述
u32SpeedX[MI_ISP_AE_LUT_4]	选择要对到的当前画面加权亮度。值域范围：1 ~ 2550。 MI_ISP_AE_LUT_4 = 4。
u32SpeedY[MI_ISP_AE_LUT_4]	收敛速度，基础为1024。（ex：若Y设为500，则当画面亮度刚好落到对应Y的X节点时，自动曝光往曝光目标逼近一次的幅度为500/1024）。值域范围：1 ~ 1024。 MI_ISP_AE_LUT_4 = 4。

注意事项

u32SpeedX[1] & u32SpeedX[2]中间两节点固定内定为当前的画面目标亮度，以便在目标亮度不固定的状况下能自动对应到相应的数值，故手动修改这两项将无效果。
相关结构类型与函式
```
MI_ISP_AE_ConvConditonType_t
```

3.76. MI_ISP_AE_ExpoLimit结构体¶

3.76.1. 类型结构体（Type Structure）

说明

设定自动曝光运作的极值。

定义

typedef struct MI_ISP_AE_ExpoLimitType_s

{

    MI_U32 u32MinShutterUS;

    MI_U32 u32MaxShutterUS;

    MI_U32 u32MinFNx10;

    MI_U32 u32MaxFNx10;

    MI_U32 u32MinSensorGain;

    MI_U32 u32MinISPGain;

    MI_U32 u32MaxSensorGain;

    MI_U32 u32MaxISPGain;

} MI_ISP_AE_ExpoLimitType_t;

名称

变量名称	描述
u32MinShutterUS	最短Shutter限制（μsec）。值域范围：1 ~ 1000000。
u32MaxShutterUS	最长Shutter限制（μsec）。值域范围：1 ~ 1000000。
u32MinFNx10	最小光圈值（ex：F1.8等于18）。值域范围：10 ~ 220。
u32MaxFNx10	最大光圈值（ex：F1.8等于18）。值域范围：10 ~ 220。
u32MinSensorGain	最小Sensor gain（1024等于1倍）。值域范围：1024 ~ 5242880。
u32MinISPGain	最小ISP gain（1024等于1倍）。值域范围：1024 ~ 262144。
u32MaxSensorGain	最大Sensor gain（1024等于1倍）。值域范围：1024 ~ 5242880。
u32MaxISPGain	最大ISP gain（1024等于1倍）。值域范围：1024 ~ 262144。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetExposureLimit(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoLimitType_t *data);

MI_S32 MI_ISP_AE_GetExposureLimit(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_ExpoLimitType_t *data);

3.77. MI_ISP_AE_ExpoTable结构体¶

3.77.1. 类型结构体（Type Structure）

说明

曝光行程表。

定义

typedef struct MI_ISP_AE_ExpoTableType_s

{

    MI_U32         u32NumPoints;

    MI_ISP_AE_ExpoPointParam_t stExpoTbl[MI_ISP_AE_LUT_16];

} MI_ISP_AE_ExpoTableType_t;

名称

变量名称 描述

u32NumPoints 曝光行程表的节点数。值域范围：1 ~ 16。

stExpoTbl[MI_ISP_AE_LUT_16] 曝光行程表的节点参数数据。 MI_ISP_AE_LUT_16 = 16。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetPlainLongExpoTable(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableType_t *data);

MI_S32 MI_ISP_AE_GetPlainLongExpoTable(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableType_t *data);

MI_S32 MI_ISP_AE_SetPlainShortExpoTable(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableType_t *data);

MI_S32 MI_ISP_AE_GetPlainShortExpoTable(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableType_t *data);

3.77.2. 曝光行程节点参数结构体（MI_ISP_AE_ExpoPointParam_t）

说明

设定曝光行程中各节点的曝光时间、光圈及增益值。

定义

typedef struct MI_ISP_AE_ExpoPointParam_s

{

    MI_U32 u32FNumx10;

    MI_U32 u32Shutter;

    MI_U32 u32TotalGain;

    MI_U32 u32SensorGain;

} MI_ISP_AE_ExpoPointParam_t;

名称

变量名称	描述
u32FNumx10	光圈值（ex：F1.8等于18）。值域范围：10 ~ 220。
u32Shutter	快门时间（μsec）。值域范围：1 ~ 1000000。
u32TotalGain	总增益 = sensor增益×ISP数字增益（1024等于1倍）。值域范围：1024 ~ 5242880。
u32SensorGain	Sensor增益（1024等于1倍）。值域范围：1024 ~ 5242880。

相关结构类型与函式
```
MI_ISP_AE_ExpoTableType_t
```

3.78. MI_ISP_AE_WinWeightMode结构体¶

3.78.1. 类型结构体（Type Structure）

说明

单独设定或切换画面亮度计算的权重表种类。

定义

typedef enum

{

    E_SS_AE_WEIGHT_AVERAGE = 0,

    E_SS_AE_WEIGHT_CENTER,

    E_SS_AE_WEIGHT_SPOT,

    E_SS_AE_WEIGHT_MAX

} MI_ISP_AE_WinWeightModeType_e;

名称

变量名称 描述

E_SS_AE_WEIGHT_AVERAGE 切换至平均测光的权重表

E_SS_AE_WEIGHT_CENTER 切换至中央测光的权重表

E_SS_AE_WEIGHT_SPOT 切换至点状测光的权重表

相关结构类型与函式

MI_ISP_AE_WinWeightType_t

MI_S32 MI_ISP_AE_SetWinWgtType(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_WinWeightModeType_e *data);

MI_S32 MI_ISP_AE_GetWinWgtType(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_WinWeightModeType_e *data);

3.79. MI_ISP_AE_WinWeight结构体¶

3.79.1. 类型结构体（Type Structure）

说明

设定或切换画面亮度计算的权重表种类并设定权重表。

定义

typedef struct MI_ISP_AE_WinWeightType_s
{
    MI_ISP_AE_WinWeightModeType_e   eTypeID;
    MI_ISP_AE_WinWeightParam_t      stParaAPI;
} MI_ISP_AE_WinWeightType_t;

名称

变量名称	描述
eTypeID	选择要切换过去的测光权重表种类。平均测光：E_SS_AE_WEIGHT_AVERAGE 中央测光：E_SS_AE_WEIGHT_CENTER 点状测光：E_SS_AE_WEIGHT_SPOT
PARAM_t	设定曝光权重表。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetWinWgt(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_WinWeightType_t *data);

MI_S32 MI_ISP_AE_GetWinWgt(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_WinWeightType_t *data);

3.79.2. 测光权重表参数结构体（MI_ISP_AE_WinWeightParam_t）

说明

设定32×32的测光权重表。

定义

typedef struct MI_ISP_AE_WinWeightParam_s

{

    MI_U8  u8AverageTbl[MI_ISP_AE_LUT_32 * MI_ISP_AE_LUT_32];

    MI_U8  u8CenterTbl[MI_ISP_AE_LUT_32 * MI_ISP_AE_LUT_32];

    MI_U8  u8SpotTbl[MI_ISP_AE_LUT_32 * MI_ISP_AE_LUT_32];

} MI_ISP_AE_WinWeightParam_t;

名称

变量名称	描述
u8AverageTbl [MI_ISP_AE_LUT_32 * MI_ISP_AE_LUT_32]	平均测光分块权重表。值域范围：0 ~ 255。 MI_ISP_AE_LUT_32 = 32。
u8CenterTbl [MI_ISP_AE_LUT_32 * MI_ISP_AE_LUT_32]	中央测光分块权重表。值域范围：0 ~ 255。 MI_ISP_AE_LUT_32 = 32。
u8SpotTbl [MI_ISP_AE_LUT_32 * MI_ISP_AE_LUT_32]	点状测光分块权重表。值域范围：0 ~ 255。 MI_ISP_AE_LUT_32 = 32。

注意事项

最大支持尺寸为32×32，目前默认尺寸为16×16。
相关结构类型与函式
```
MI_ISP_AE_WinWeightType_t
```

3.80. MI_ISP_AE_Flicker结构体¶

3.80.1. 类型结构体（Type Structure）

说明

设定抗频闪频率。

定义

typedef enum

{

    E_SS_AE_FLICKER_TYPE_DISABLE = 0,

    E_SS_AE_FLICKER_TYPE_60HZ = 1,

    E_SS_AE_FLICKER_TYPE_50HZ = 2,

    E_SS_AE_FLICKER_TYPE_AUTO = 3,

    E_SS_AE_FLICKER_TYPE_MAX

} MI_ISP_AE_FlickerType_e;

名称

变量名称	描述
E_SS_AE_FLICKER_TYPE_DISABLE	关闭抗频闪功能。
E_SS_AE_FLICKER_TYPE_60HZ	设定频闪环境为60Hz。
E_SS_AE_FLICKER_TYPE_50HZ	设定频闪环境为50Hz。
E_SS_AE_FLICKER_TYPE_AUTO	自动设定频闪环境。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetFlicker(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_FlickerType_e *data);

MI_S32 MI_ISP_AE_GetFlicker(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_FlickerType_e *data);

3.81. MI_ISP_AE_FlickerEx结构体¶

3.81.1. 类型结构体（Type Structure）

说明

设定侦测抗闪烁速率。

定义

typedef struct MI_ISP_AE_FlickerExType_s
{
    MI_ISP_AE_bool_e                bEnable;
    MI_ISP_AE_OpType_e              enOpType;
    MI_U8                           u8AmpSensitivity;
    MI_U8                           u8ScoreThd;
    MI_U8                           u8RefreshCycles;
    MI_U8                           u8ValidTimesThd;
    MI_ISP_AE_FlickerDetectType_e   eFlickerType;
} MI_ISP_AE_FlickerExType_t;

名称

变量名称	描述
bEnable	设定侦测抗闪烁功能的布尔值。当bEnable为1时，旧版Flicker API则失效。关闭：E_SS_AE_FALSE = 0。开启：E_SS_AE_TRUE = 1。
enOpType	设定侦测抗闪烁的工作模式。若设为auto，当侦测到flicker时会自动切换eFlickerType. 自动模式：E_SS_AE_OP_TYP_AUTO = 0。手动模式：E_SS_AE_OP_TYP_MANUAL = 1。
u8AmpSensitivity	调整侦测抗闪烁的灵敏程度（数值愈大愈灵敏）。值域范围1 ~ 100，此参数建议默认值为70。
u8ScoreThd	Auto模式下是否触发自动切换FlickerType的阀值，若Score小于此阀值，ValidTimes会加1，若大于此阀值，ValidTimes会被重置为0。值域范围1 ~ 100，建议默认值为50。
u8RefreshCycles	调整侦测抗闪烁计算分数的更新速率，此参数代表几个cycle更新一次Score，一个cycle通常约在4 ~ 7个frame。值域范围1 ~ 10，值越大Score越可靠，但花的时间越久，建议默认值为3。
u8ValidTimesThd	Auto模式下，当ValidTimes到达ValidTimesThd，则算法会自动切换到另一个Flicker模式。值域范围1 ~ 10，值越大越不容易误判，但花的时间越久，建议默认值为2。
eFlickerType	设定侦测抗闪烁模式，模式分别为0 = 60Hz、1 = 50Hz。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetFlickerEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_FlickerExType_t *data);

MI_S32 MI_ISP_AE_GetFlickerEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_FlickerExType_t *data);

3.81.2. 侦测抗闪烁模式结构体（MI_ISP_AE_FlickerDetectType_e）

说明

选择侦测抗闪烁的模式。

定义

typedef enum

{

    E_SS_AE_FLICKER_TYPE_DETECT_60HZ = 0,

    E_SS_AE_FLICKER_TYPE_DETECT_50HZ = 1,

    E_SS_AE_FLICKER_TYPE_DETECT_MAX

} MI_ISP_AE_FlickerDetectType_e;

名称

变量名称 描述

E_SS_AE_FLICKER_TYPE_DETECT_60HZ 设定侦测抗闪烁环境为60Hz。

E_SS_AE_FLICKER_TYPE_DETECT_50HZ 设定侦测抗闪烁环境为50Hz。

相关结构类型与函式

MI_ISP_AE_FlickerExType_t

MI_ISP_AE_FlickerExInfoType_tkerExType_t

3.82. MI_ISP_AE_QueryFlickerExInfo结构体¶

3.82.1. 类型结构体（Type Structure）

说明

获取当前侦测抗闪烁信息的结构体。

定义

typedef struct MI_ISP_AE_FlickerExInfoType_s
{
    MI_ISP_AE_bool_e                bIsEffective;
    MI_ISP_AE_FlickerDetectType_e   eFlickerType;
    MI_U16                      u16Score;
} MI_ISP_AE_FlickerExInfoType_t;

名称

变量名称	描述
bIsEffective	取得当前侦测抗闪烁是否有效（1：有效值，0：无效值）。
eFlickerType	取得当前侦测抗闪烁模式，模式分别为0 = 60Hz、1 = 50Hz。
u16Score	取得当前侦测抗闪烁有效模式的程度分数。如果分数较高，则判断为当前的抗闪烁速率模式。如果分数较低，则判断为另一种抗闪烁速率模式。

相关结构类型与函式

MI_S32 MI_ISP_AE_QueryFlickerInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FlickerExInfoType_t *data);

3.83. MI_ISP_AE_Strategy结构体¶

3.83.1. 类型结构体（Type Structure）

说明

设定自动曝光的曝光策略。

定义

typedef struct MI_ISP_AE_StrategyType_s
{
    MI_ISP_AE_StrategyType_e    eAEStrategyMode;
    MI_U32                  u32Weighting;
    MI_ISP_AE_IntpLutType_t stUpperOffset;
    MI_ISP_AE_IntpLutType_t stLowerOffset;
    MI_U32                  u32BrightToneStrength;
    MI_U32                  u32BrightToneSensitivity;
    MI_U32                  u32DarkToneStrength;
    MI_U32                  u32DarkToneSensitivity;
    MI_U32                  u32AutoStrength;
    MI_U32                  u32AutoSensitivity;
} MI_ISP_AE_StrategyType_t;

名称

变量名称	描述
eAEStrategyMode	自动曝光策略的模式选择。
u32Weighting	自动曝光策略下计算出的画面目标亮度与MI_ISP_AE_SetTarget 中所设定的画面目标亮度间的权重。 FinalAETarget = defaultAETarget × (1 - weighting) + StragetyTarget × weighting。
stUpperOffset	自动曝光策略向上浮动调整画面亮度目标的空间。 X轴为环境亮度BV、Y轴为向上浮动空间（0 ~ 470）。
stLowerOffset	自动曝光策略向下浮动调整画面亮度目标的空间。 X轴为环境亮度BV、Y轴为向下浮动空间（0 ~ 470）。
u32BrightToneStrength	eAEStrategyMode设定为E_SS_AE_STRATEGY_BRIGHTTONE时，可用来调整亮阶区域的目标亮度（数值愈大画面将愈暗）。值域范围：0 ~ 1024。
BrightToneSensitivity	eAEStrategyMode设定为E_SS_AE_STRATEGY_BRIGHTTONE时，可用来调整对亮阶区域的敏感度（数值愈大愈敏感，即使影像中仅少部分区域过曝也会选择将画面压暗）。值域范围：0 ~ 1024。
DarkToneStrength	eAEStrategyMode 设定为E_SS_AE_STRATEGY_DARKTONE时，可用来调整暗阶区域的目标亮度（数值愈大画面将愈亮）。值域范围：0 ~ 1024。
DarkToneSensitivity	eAEStrategyMode设定为E_SS_AE_STRATEGY_DARKTONE时，可用来调整对暗阶区域的敏感（数值愈大愈敏感，即使影像中仅少部分区域很暗也会选择将画面拉亮）。值域范围：0 ~ 1024。
AutoStrength	eAEStrategyMode设定为E_SS_AE_STRATEGY_AUTO时，可用来调整亮阶区域的目标亮度（数值愈大画面将愈暗）。值域范围：0 ~ 1024。
AutoSensitivity	eAEStrategyMode设定为E_SS_AE_STRATEGY_AUTO时，可用来调整对亮阶区域的敏感度（数值愈大愈敏感，即使影像中仅少部分区域过曝也会选择将画面压暗）。值域范围：0 ~ 1024。

注意事项

如stUpperOffset / stLowerOffset的浮动区间设定为0，则因无上下浮动的区间，AE曝光策略的效果会失效，而画面目标亮度会等于MI_ISP_AE_SetTarget所设定的数值（default target）。

曝光策略浮动target的变化范围等于default target - lower limit ~ default target + upperlimit。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetStrategy(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyType_t *data);

MI_S32 MI_ISP_AE_GetStrategy(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyType_t *data);

3.83.2. 曝光策略模式结构体（MI_ISP_AE_StrategyType_e）

说明

选择曝光策略的模式。

定义

typedef enum

{

    E_SS_AE_STRATEGY_BRIGHTTONE,

    E_SS_AE_STRATEGY_DARKTONE,

    E_SS_AE_STRATEGY_AUTO,

    E_SS_AE_STRATEGY_MAX

} MI_ISP_AE_StrategyType_e;

名称

变量名称	描述
E_SS_AE_STRATEGY_BRIGHTTONE	强光抑制模式（亮阶优先）。
E_SS_AE_STRATEGY_DARKTONE	背光补偿模式（暗阶优先）。
E_SS_AE_STRATEGY_AUTO	自动补偿模式。

相关结构类型与函式
```
MI_ISP_AE_StrategyType_t
```

3.84. MI_ISP_AE_StrategyEx结构体¶

3.84.1. 类型结构体（Type Structure）

说明

设定自动曝光的曝光策略。

定义

typedef struct MI_ISP_AE_StrategyExType_s
{
    MI_ISP_AE_bool_e                bEnable;
    MI_ISP_AE_StrategyExMode_e      eMode;
    MI_ISP_AE_StrategyExPriority_e  ePriority;
    MI_U16                      u16BT_NodeNum;
    MI_S32                      u32BT_NodeBV[MI_ISP_AE_LUT_16];
    MI_U32                      u32BT_ThdY[MI_ISP_AE_LUT_16];
    MI_U32                      u32BT_Percentx10[MI_ISP_AE_LUT_16];
    MI_U32                      u32BT_TargetYx10[MI_ISP_AE_LUT_16];
    MI_U32                      u32BT_MaxOffsetDown[MI_ISP_AE_LUT_16];
    MI_U16                      u16DT_NodeNum;
    MI_S32                      u32DT_NodeBV[MI_ISP_AE_LUT_16];
    MI_U32                      u32DT_ThdY[MI_ISP_AE_LUT_16];
    MI_U32                      u32DT_Percentx10[MI_ISP_AE_LUT_16];
    MI_U32                      u32DT_TargetYx10[MI_ISP_AE_LUT_16];
    MI_U32                      u32DT_MaxOffsetUp[MI_ISP_AE_LUT_16];
} MI_ISP_AE_StrategyExType_t;

名称

变量名称	描述
bEnable	自动曝光策略开关。
eMode	曝光策略模式，有Count Mode与Target Mode可做选择。选择Count Mode时，主要使用BT(DT)_ThdY及BT(DT)_Percentx10。使用者可以指定在多少亮度以上（以下）的统计值占统计值总数量大约多少千分比。选择Target Mode时，主要使用BT(DT)_Percentx10及BT(DT)_Targetx10。使用者可以指定最亮（最暗）多少千分比的统计值平均亮度要接近多少亮度。
ePriority	曝光策略优先权设定，可选择暗阶优先（过暗抑制）／亮阶优先（过曝抑制）。
u16BT_NodeNum	Bright Tone相关参数的节点个数。
u32BT_NodeBV[MI_ISP_AE_LUT_16]	Bright Tone节点对应BV设定。MI_ISP_AE_LUT_16 = 16。
u32BT_ThdY[MI_ISP_AE_LUT_16]	Bright Tone亮度阀值设定，值域0 ~ 255。仅在Count Mode有用。MI_ISP_AE_LUT_16 = 16。
u32BT_Percentx10[MI_ISP_AE_LUT_16]	Bright Tone千分比设定，值域0 ~ 1000。在Count Mode及Target Mode都有用。MI_ISP_AE_LUT_16 = 16。
u32BT_TargetYx10[MI_ISP_AE_LUT_16]	Bright Tone目标平均亮度设定，值域0 ~ 2550。仅在Target Mode有用。MI_ISP_AE_LUT_16 = 16。
u32BT_MaxOffsetDown[MI_ISP_AE_LUT_16]	AE target向下浮动的范围，值域0 ~ 2550。如设0则等于关闭浮动target，将完全参考上面设的Target Offset设定。 MI_ISP_AE_LUT_16 = 16。
u16DT_NodeNum	Dark Tone相关参数的节点个数。
u32DT_NodeBV[MI_ISP_AE_LUT_16]	Dark Tone节点对应BV设定。MI_ISP_AE_LUT_16 = 16。
u32DT_ThdY[MI_ISP_AE_LUT_16]	Dark Tone亮度阀值设定，值域0 ~ 255。仅在Count Mode有用。 MI_ISP_AE_LUT_16 = 16。
u32DT_Percentx10[MI_ISP_AE_LUT_16]	Dark Tone千分比设定，值域0 ~ 1000。在Count Mode及Target Mode都有用。MI_ISP_AE_LUT_16 = 16。
u32DT_TargetYx10[MI_ISP_AE_LUT_16]	Dark Tone目标平均亮度设定，值域0 ~ 2550。仅在Target Mode有用。MI_ISP_AE_LUT_16 = 16。
u32DT_MaxOffsetUp[MI_ISP_AE_LUT_16]	AE target向上浮动的范围，值域0 ~ 2550。如设0则等于关闭浮动target，将完全参考上面设的Target Offset 设定。 MI_ISP_AE_LUT_16 = 16。

注意事项

Figure 4：AE StrategyEx Count Mode & Bright Priority

Figure 5：AE StrategyEx Target Mode & Bright Priority

Figure 6：All LUTs share the same NodeNum & NodeBV

相关结构类型与函式

MI_S32 MI_ISP_AE_SetStrategyEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyExType_t *data);

MI_S32 MI_ISP_AE_GetStrategyEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyExType_t *data);

3.84.2. 曝光策略模式结构体（MI_ISP_AE_StrategyExMode_e）

说明

选择曝光策略的模式。

定义

typedef enum

{

    E_SS_AE_STRATEGY_EX_COUNT,

    E_SS_AE_STRATEGY_EX_TARGET,

} MI_ISP_AE_STRATEGY_EX_TYPE_e;

名称

变量名称	描述
E_SS_AE_STRATEGY_EX_COUNT	选择Count Mode时，主要使用BT(DT)_ThdY以及BT(DT)_Percentx10。使用者可以指定在多少亮度以上（以下）的统计值占统计值总数量大约多少千分比。
E_SS_AE_STRATEGY_EX_TARGET	选择Target Mode时，主要使用BT(DT)_Percentx10及BT(DT)_Targetx10。使用者可以指定最亮（最暗）多少千分比的统计值平均亮度要接近多少亮度。

相关结构类型与函式
```
MI_ISP_AE_StrategyExType_t
```

3.84.3. 曝光策略优先权模式结构体（MI_ISP_AE_StrategyExPriority_e）

说明

选择曝光策略优先权模式。

定义

typedef enum

{

    E_SS_AE_STRATEGY_EX_BRIGHTTONE,

    E_SS_AE_STRATEGY_EX_DARKTONE,

} MI_ISP_AE_StrategyExPriority_e;

名称

变量名称 描述

E_SS_AE_STRATEGY_EX_BRIGHTTONE 亮阶优先（过曝抑制）。

E_SS_AE_STRATEGY_EX_DARKTONE 暗阶优先（过暗抑制）。
相关结构类型与函式
```
MI_ISP_AE_StrategyExType_t
```

3.85. MI_ISP_AE_StrategyExAdvType结构体¶

3.85.1. 类型结构体 (Type Structure)

说明

设定HDR自动曝光之曝光策略。

定义

typedef struct MI_ISP_AE_StrategyExAdvType_s

{

    MI_S16 u16WeightRatio1;

    MI_S16  u16WeightRatio2;

} MI_ISP_AE_StrategyExAdvType_t;

名称

变量名称	描述
u16WeightRatio1	调整暗阶优先或亮阶优先的权重数值，值域0~1024。当小于512时，即越小越偏重于亮阶优先（Bright Tone Priority）当大于512时，则越大越偏重于暗阶优先（Dark Tone Priority）
u16WeightRatio2	调整AE Target的权重数值，值域0~1024。当值等于0时，即AE Target权重无效，则画面亮度依照Weight1结果为主。当值大于0时，即AE Target权重越大，则画面亮度接近AE Target。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetStrategyExAdv(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyExAdvType_t *data);

MI_S32 MI_ISP_AE_GetStrategyExAdv(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyExAdvType_t *data);

3.86. MI_ISP_AE_StrategyExInfo结构体¶

3.86.1. 类型结构体（Type Structure）

说明

获取当前曝光策略信息的结构体。

定义

typedef struct MI_ISP_AE_StrategyExInfoType_s

{

    MI_U16 u16GMBlendRatio;

    MI_U16 u16UpperLimitTargetx10;

    MI_U16 u16LowerLimitTargetx10;

    MI_U16 u16BTCntPcntx10;

    MI_U16 u16DTCntPcntx10;

    MI_U16 u16BTYx10;

    MI_U16 u16DTYx10;

} MI_ISP_AE_StrategyExInfoType_t;

名称

变量名称	描述
u16GMBlendRatio	Adaptive Gamma与一般Gamma的混和比例，值域0 ~ 1024。根据最终SceneTarget、TargetOffset及最大BT_MaxOffsetDown、DT_MaxOffsetUp计算得来。当ratio小于512，则拿BTGamma与一般Gamma做混和，当ratio大于512，则拿DTGamma与一般Gamma做混和，当ratio等于512，则直接使用一般Gamma。
u16UpperLimitTargetx10	目前AE target浮动上限。
u16LowerLimitTargetx10	目前AE target浮动下限。
u16BTCntPcntx10	目前大于BT_ThdY的统计值数量占总统计值数量的千分比。
u16DTCntPcntx10	目前小于DT_ThdY的统计值数量占总统计值数量的千分比。
u16BTYx10	目前最亮前BT_Percentx10千分比统计值的平均亮度。
u16DTYx10	目前最暗前DT_Percentx10千分比统计值的平均亮度。

注意事项

Figure 7：How GNBlendRatio and AdaptiveGamma work

相关结构类型与函式

MI_S32 MI_ISP_AE_QueryStrategyExInfo (MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_StrategyExInfoType_t *data);

3.87. MI_ISP_AE_RgbirAe结构体¶

3.87.1. 类型结构体（Type Structure）

说明

RGBIR mode 的相关AE控制参数

定义

typedef struct MI_ISP_AE_RgbirAeType_s

{

    MI_ISP_AE_bool_e  bEnable;

    MI_U16     u16MaxYWithIR;

    MI_U16     u16MinISPGainCompRatio;

} MI_ISP_AE_RgbirAeType_t;

名称

变量名称	描述
bEnable	Enable / disable RGB-IR AE
u16MaxYWithIR	减IR前R、G、B分块容许的最大亮度（Y）值。值域范围：0 ~ 2550
u16MinISPGainCompRatio	使用ISP gain作为画面亮度补偿时的最小转换率，使用的最大ISP gain = 10000/ u16MinISPGainCompRatio （ex：10000 = 1x、1000 = 10x）。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetRgbirAe(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_RgbirAeType_t *data);

MI_S32 MI_ISP_AE_GetRgbirAe(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_RgbirAeType_t *data);

3.88. MI_ISP_AE_Hdr结构体¶

3.88.1. 类型结构体（Type Structure）

说明

具结点内插功能的参数数据设定表。

可用于设定随总增益变化的HDR的长短曝光比例（ex：X轴－total gain；Y轴－HDR长短曝光比例）。

定义

typedef struct MI_ISP_AE_HdrType_s

{

    MI_ISP_AE_IntpLutType_t stAeHdrRatio;

} MI_ISP_AE_HdrType_t;

名称

变量名称 描述

stAeHdrRatio 可设定不同总增益下的HDR长短曝曝光倍率，使用方法同MI_ISP_AE_IntpLutType_t

相关结构类型与函式

MI_S32 MI_ISP_AE_SetHdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_HdrType_t *data);

MI_S32 MI_ISP_AE_GetHdr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AE_HdrType_t *data);

3.89. MI_ISP_AE_Stabilizer结构体¶

3.89.1. 类型结构体（Type Structure）

说明

Stabilizer结构体。

定义

typedef struct MI_ISP_AE_StabilizerType_s
{
    MI_ISP_AE_bool_e    bEnable;
    MI_U16          u16DiffThd;
    MI_U16          u16Percent;
} MI_ISP_AE_StabilizerType_t;

名称

变量名称	描述
bEnable	Stabilizer功能开关。
u16DiffThd	判断目前画面与参考画面是否有变化的阀值，Y差异超过此阀值则判为有变化，小于此阀值则当作无变化。值域0 ~ 20（精度8bits），建议值为2。不建议设定太大，容易导致光线渐亮渐暗的情况下不够连续。
u16Percent	画面比例阀值，当AE在收敛的状况下，画面中被判断为有变化区域占全画面的比例小于此值，则AE维持不变。值域0 ~ 100，默认值为50。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetStabilizer(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StabilizerType_t *data);

MI_S32 MI_ISP_AE_GetStabilizer(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StabilizerType_t *data);

3.90. MI_ISP_AE_PowerLine结构体¶

3.90.1. 类型结构体（Type Structure）

说明

PowerLine结构体。

定义

typedef struct MI_ISP_AE_PowerLineType_s
{
    MI_ISP_AE_bool_e            bEnable;
    MI_U16                  u16Ratio;
} MI_ISP_AE_PowerLineType_t;

名称

变量名称描述

bEnable PowerLine Flicker功能开关。

u16Ratio 调整PowerLine的补偿倍率，值域范围 : 0 ~ 1024 (128 = 1x)。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetPowerLine(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_PowerLineType_t *data);

MI_S32 MI_ISP_AE_GetPowerLine(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_PowerLineType_t *data);

3.91. MI_ISP_AE_PowerLineInfo结构体¶

3.91.1. 类型结构体（Type Structure）

说明

PowerLineInfo结构体。

定义

typedef struct MI_ISP_AE_PowerLineInfoType_s
{
    MI_S16  s2Direction;
    MI_U16  u2IsEffective;
    MI_U32  u4PreShutter;
} MI_ISP_AE_PowerLineInfoType_t;

名称

变量名称	描述
s2Direction	判断当前shutter由暗变亮或者亮变暗的作用状态，值域范围：-1 ~ 1。当Direction = 1表示此功能生效；当Direction = -1或0表示此功能无生效。
u2IsEffective	显示此功能是否进入工作区间，值域范围 : 0 ~ 1。0表示PowerLine function无做动；1表示PowerLine function有做动。
u4PreShutter	记录前一次的曝光时间数值。

相关结构类型与函式

MI_S32 MI_ISP_AE_QueryPowerLineInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_PowerLineInfoType_t *data);

3.92. MI_ISP_AE_LumaWgt结构体¶

3.92.1. 类型结构体（Type Structure）

说明

Weight by luminance结构体。

定义

typedef struct MI_ISP_AE_LumaWgtType_s
{
    MI_ISP_AE_bool_e            bEnable;
    MI_ISP_AE_IntpLutType_t     WeightLuma;
    MI_ISP_AE_IntpLutType_t     WeightSatCnt;
    MI_U16                  u2SatCntThd;
} MI_ISP_AE_LumaWgtType_t;

名称

变量名称	描述
bEnable	Weight by luminance功能开关。
WeightLuma	根据AE统计值-MxN的亮度设定相对应权重，M x N = 16 x 16。 X轴为亮度(x10)，Range : 0 ~ 2550。 Y轴为权重，Range : 0 ~ 256，1x = 256。
WeightSatCnt	根据AE统计值-MxN的亮度大于SatCntThd数量设定相对应权重，M x N = 16 x 16。 X轴为Saturate Count数量，Range : 0 ~ 256。 Y轴为权重，Range : 0 ~ 256，1x = 256。
u2SatCntThd	设定Saturate count的阀值，当此数值调整越大表示亮区权重下降。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetLumaWgt(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_LumaWgtType_t *data);

MI_S32 MI_ISP_AE_GetLumaWgt(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_LumaWgtType_t *data);

3.93. MI_ISP_AE_VerInfo结构体¶

3.93.1. 类型结构体（Type Structure）

说明

AE Version Information结构体。

定义

typedef struct MI_ISP_AE_VerInfoType_s
{
    MI_U32  u32ReleaseDate;
    MI_U32  u32ReportID;
    MI_U8   u8Major;
    MI_U8   u8Minor;
    MI_U8   u8TestVer;
} MI_ISP_AE_VerInfoType_t;

名称

变量名称	描述
u32ReleaseDate	打印AE FW更新日期。
u32ReportID	打印AE FW反馈问题的数值编号，default：0。
u8Major	打印AE FW主要版本编号。
u8Minor	打印AE FW次要版本编号。
u8TestVer	打印AE FW测试版本编号，default：0。

相关结构类型与函式

MI_S32 MI_ISP_AE_GetVersionInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_VerInfoType_t *data);

3.94. MI_ISP_AWB_bool结构体¶

3.94.1. 列举结构体（Enum Structure）

说明

布尔值的列举结构体。

定义

typedef enum

{

    E_SS_AWB_FALSE = 0,

    E_SS_AWB_TRUE = !E_SS_AWB_FALSE,

    E_SS_AWB_BOOL_MAX

} MI_ISP_AWB_bool_e;

名称

变量名称 描述

E_SS_AWB_FALSE 布尔值等于0。

E_SS_AWB_TRUE 布尔值等于1。

E_SS_AWB_BOOL_MAX 判断布尔值列举列表的最大值。

相关结构类型与函式

MI_ISP_AWB_QueryInfoType_t
MI_ISP_AWB_AttrExType_t
MI_ISP_AWB_MultiLsType_t
MI_ISP_AWB_StabilizerType_t

3.95. MI_ISP_AWB_OpType结构体¶

3.95.1. 列举结构体（Enum Structure）

说明

工作模式的列举结构体。

定义

typedef enum

{

    E_SS_AWB_OP_TYP_AUTO = 0,

    E_SS_AWB_OP_TYP_MANUAL = ! E_SS_AWB_OP_TYP_AUTO,

    E_SS_AWB_OP_TYP_MODE_MAX

} MI_ISP_AWB_OpType_e;

名称

变量名称 描述

E_SS_AWB_OP_TYP_AUTO 自动工作模式。

E_SS_AWB_OP_TYP_MANUAL 手动工作模式。

E_SS_AWB_OP_TYP_MODE_MAX 判断工作模式列举列表的最大值。

3.96. MI_ISP_AWB_SmStateType结构体¶

3.96.1. 列举结构体（Enum Structure）

说明

状态机（State Machine）的列举结构体。

定义

typedef enum

{

    E_SS_AWB_STATE_NORMAL = 0,

    E_SS_AWB_STATE_PAUSE = 1,

    E_SS_AWB_STATE_MAX

} MI_ISP_AWB_SmStateType_e;

名称

变量名称 描述

E_SS_AWB_STATE_NORMAL 正常模式。

E_SS_AWB_STATE_PAUSE 暂停模式。

E_SS_AWB_STATE_MAX 判断状态机列举清单的最大值。
相关结构类型与函式
```
MI_ISP_AWB_AttrType_t
```

3.97. MI_ISP_AWB_QueryInfo结构体¶

3.97.1. 类型结构体（Type Structure）

说明

设定当前整体白平衡信息的类型结构体。

定义

typedef struct MI_ISP_AWB_QueryInfoType_s

{

    MI_ISP_AWB_bool_e bIsStable;

    MI_U16     u16Rgain;

    MI_U16     u16Grgain;

    MI_U16     u16Gbgain;

    MI_U16     u16Bgain;

    MI_U16     u16ColorTemp;

    MI_U8       u8WPInd;

    MI_ISP_AWB_bool_e bMultiLSDetected;

    MI_U8       u8FirstLSInd;

    MI_U8       u8SecondLSInd;

} MI_ISP_AWB_QueryInfoType_t;

名称

变量名称	描述
bIsStable	获取目前AWB是否在收敛状态（1：收敛，0：尚未收敛）。
u16Rgain	获取目前设定的白平衡R通道增益。
u16Grgain	获取目前设定的白平衡Gr通道增益。
u16Gbgain	获取目前设定的白平衡Gb通道增益。
u16Bgain	获取目前设定的白平衡B通道增益。
u16ColorTemp	获取目前计算的色温值。
u8WPInd	当开启WpWeight功能，获取目前参考白点色温框index。
bMultiLSDetected	当开启混光色偏校正功能，获取目前是否侦测出混光。关闭：E_SS_AWB_FALSE = 0。开启：E_SS_AWB_TRUE = 1。
u8FirstLSInd	当开启混光色偏校正功能，获取混光中数量第一大光源index×2。
u8SecondLSInd	当开启混光色偏校正功能，获取混光中数量第二大光源index×2。

注意事项

u8FirstLSInd与u8SecondLSInd显示的index值是实际色温框Index值乘以2。也就是说，当u8FirstLSInd为8时，实际代表的色温框index是8/2 = 4 (5000K)；当u8FirstLSInd为9时，实际代表的色温框index是9/2 = 4.5，其中，「.5」的意思代表此光源色温落在index 4 (5000K)与5 (4000K)之间。

相关结构类型与函式

MI_S32 MI_ISP_AWB_QueryInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_QueryInfoType_t *data);

3.98. MI_ISP_AWB_CtStatistics结构体¶

3.98.1. 类型结构体（Type Structure）

说明

设定自动白平衡校正统计值的类型结构体。

定义

typedef struct MI_ISP_AWB_CtStatisticsType_s

{

    MI_U16 u16Width;

    MI_U16 u16Height;

    MI_U16 u16StatisX[MI_ISP_AWB_STAT_BLOCK / 2];

    MI_U16 u16StatisY[MI_ISP_AWB_STAT_BLOCK / 2];

} MI_ISP_AWB_CtStatisticsType_t;

名称

变量名称	描述
u16Width	有效区宽度。
u16Height	有效区高度。
u16StatisX[MI_ISP_AWB_STAT_BLOCK / 2]	色温域的统计X。 MI_ISP_AWB_STAT_BLOCK / 2 = 128 * 90 / 2 = 5760。
u16StatisY[MI_ISP_AWB_STAT_BLOCK / 2]	色温域的统计Y。 MI_ISP_AWB_STAT_BLOCK / 2 = 128 * 90 / 2 = 5760。

相关结构类型与函式

MI_S32 MI_ISP_AWB_GetCtStats(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_CtStatisticsType_t *data);

3.98.2. 个别AWB硬件统计值结构体（MI_ISP_AWB_AVGS）

说明

个别AWB硬件统计值的结构体。

定义

typedef enum

{

    MI_U8 uAvgR;

    MI_U8 uAvgG;

    MI_U8 uAvgB;

} MI_ISP_AWB_AVGS;

名称

变量名称 描述

uAvgR 个别统计值的R平均值。值域0~255。

uAvgG 个别统计值的G平均值。值域0~255。

uAvgB 个别统计值的B平均值。值域0~255。

3.99. MI_ISP_AWB_Attr结构体¶

3.99.1. 类型结构体（Type Structure）

说明

设定AWB属性的类型结构体。

定义

typedef struct MI_ISP_AWB_AttrType_s
{
    MI_ISP_AWB_SmStateType_e    eState;
    MI_ISP_AWB_ModeType_e       eOpType;
    MI_ISP_AWB_MwbAttrParam_t   stManualParaAPI;
    MI_ISP_AWB_AttrParam_t      stAutoParaAPI;
} MI_ISP_AWB_AttrType_t;

名称

变量名称	描述
eState	设定AWB属性的状态模式。正常：E_SS_AWB_STATE_NORMAL = 0。暂停：E_SS_AWB_STATE_PAUSE = 1。
enOpType	设定AWB属性的工作模式。自动模式：E_SS_AWB_MODE_AUTO = 0。手动模式：E_SS_AWB_MODE_MANUAL = 1。色温手动模式：E_SS_AWB_MODE_CTMANUAL = 2。
stAutoParaAPI	设定AWB属性的自动模式属性结构体。
stManualParaAPI	设定AWB属性的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_AttrType_t *data);

MI_S32 MI_ISP_AWB_GetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_AttrType_t *data);

3.99.2. AWB工作模式列举结构体（MI_ISP_AWB_ModeType_e）

说明

设定AWB工作模式的列举结构体。

定义

typedef enum

{

    E_SS_AWB_MODE_AUTO,

    E_SS_AWB_MODE_MANUAL,

    E_SS_AWB_MODE_CTMANUAL,

    E_SS_AWB_MODE_MAX

} MI_ISP_AWB_ModeType_e;

名称

变量名称	描述
E_SS_AWB_MODE_AUTO	自动模式。
E_SS_AWB_MODE_MANUAL	手动模式。
E_SS_AWB_MODE_CTMANUAL	色温自动模式。选择此模式会根据CTMWB的色温设定来套用WB gain。

相关结构类型与函式
```
MI_ISP_AWB_AttrType_t
```

3.99.3. 手动模式参数结构体（Manual Parameter Structure）

说明

设定的手动模式参数结构体。

定义

typedef struct MI_ISP_AWB_MwbAttrParam_s

{

    MI_U16 u16Rgain;

    MI_U16 u16Grgain;

    MI_U16 u16Gbgain;

    MI_U16 u16Bgain;

} MI_ISP_AWB_MwbAttrParam_t;

名称

变量名称	描述
u16Rgain	白平衡R通道增益。值域范围：0 ~ 8191。
u16Grgain	白平衡Gr通道增益。值域范围：0 ~ 8191。
u16Gbgain	白平衡Gb通道增益。值域范围：0 ~ 8191。
u16Bgain	白平衡B通道增益。值域范围：0 ~ 8191。

相关结构类型与函式
```
MI_ISP_AWB_AttrType_t
```

3.99.4. 自动模式参数结构体（Automatic Parameter Structure）

说明

设定的自动模式参数结构体。

定义

typedef struct MI_ISP_AWB_AttrParam_s
{
    MI_U8                       u8Speed;
    MI_U8                       u8ConvInThd;
    MI_U8                       u8ConvOutThd;
    MI_ISP_AWB_AlgoType_e       eAlgType;
    MI_ISP_AWB_AdvType_e        eAdvType;
    MI_U8                       u8RGStrength;
    MI_U8                       u8BGStrength;
    MI_ISP_AWB_CtLimitParam_t   stCTLimit;
    MI_ISP_AWB_CtWeightParam_t  stLvWeight[MI_ISP_AWB_LV_CT_TBL_NUM];
    MI_ISP_AWB_CtRatioParam_t   stPreferRRatio[MI_ISP_AWB_LV_CT_TBL_NUM];
    MI_ISP_AWB_CtRatioParam_t   stPreferBRatio[MI_ISP_AWB_LV_CT_TBL_NUM];
    MI_U16                  u16WpWeight[MI_ISP_AWB_CT_TBL_NUM];
    MS_U32                  u32WeightWin[MI_ISP_AWB_WEIGHT_WIN_NUM];
} MI_ISP_AWB_AttrParam_t;

名称

变量名称	描述
u8Speed	自动白平衡算法收敛速度，值越大收敛速度越快。值域范围：0 ~ 100。
u8ConvInThd	设定白平衡的收敛区间，值越小则AWB收敛的与目标值越接近。值域范围：0 ~ 255，不建议将值设太小，容易导致AWB一直处在不稳定状态，建议值32。
u8ConvOutThd	设定要让白平衡离开收敛状态重新计算白平衡的阀值，值越大则AWB收敛稳定后，越不容易重新计算。值域范围：0 ~ 255，不建议将值设太大，建议值64。
eAlgType	自动白平衡算法类型设定，共有以下四种选择： 1. GrayWorld 2. Normal 3. Balance 4. Focus。详细说明请参考MI_ISP_AWB_AlgoType_e
eAdvType	自动白平衡进阶算法的类型，设定为SS_AWB_ADV_ADVANCE时，可以开启MI_ISP_AWB_SetAttrEx API设定功能。
u8RGStrength	自动白平衡R Gain的强度。等于0x80表示R Gain不变大于0x80表示R Gain变大偏红小于0x80表示R Gain变小
u8BGStrength	自动白平衡B Gain的强度。等于0x80表示B Gain不变大于0x80表示B Gain变大偏蓝小于0x80表示B Gain变小
stCTLimit	白平衡算法环境色温，不在色温曲线范围内时，设定增益限制的计算模式及手动增益值，此参数不建议调整。此参数是限制整个色温曲线坐标的范围，超出范围的统计值则不纳入白平衡算法计算。
stLvWeight[MI_ISP_AWB_LV_CT_TBL_NUM]	给定指定环境亮度下各色温的权重，权重越高，最后的目标R、B gain会越倾向该色温的R、B gain，共18组。值域范围：1 ~ 255。
stPreferRRatio[MI_ISP_AWB_LV_CT_TBL_NUM]	给定指定环境亮度下各色温的R ratio，用来微调目标R gain，共18组。值域范围：1 ~ 255。
stPreferBRatio[MI_ISP_AWB_LV_CT_TBL_NUM]	给定指定环境亮度下各色温的B ratio，用来微调目标B gain，共18组。值域范围：1 ~ 255。
u16WpWeight[MI_ISP_AWB_CT_TBL_NUM]	参考白点权重，权重越高的色温越容易被选为参考白点，共10组。值域范围：1 ~ 400，默认值100。
u32WeightWin[MI_ISP_AWB_WEIGHT_WIN_NUM]	将画面区分成9x9个区域，可以分别给定各区域的权重，让白平衡计算更偏向将该区域做灰。值域范围：0 ~ 16。

注意事项

u8RGStrength，u8BGStrength调整建议：依客户喜好调整，例如：某些场景下，客户希望偏绿，可以同时微调u8RGStrength和u8BGStrength，让这两个值同时小于128。
相关结构类型与函式
```
MI_ISP_AWB_AttrType_t
```

3.99.5. 参数结构体（Parameter Structure）

说明

设定定义白平衡的增益范围限制的参数结构体。

定义

typedef struct MI_ISP_AWB_CtLimitParam_s

{

    MI_U16 u16MaxRgain;

    MI_U16 u16MinRgain;

    MI_U16 u16MaxBgain;

    MI_U16 u16MinBgain;

} MI_ISP_AWB_CtLimitParam_t;

名称

变量名称	描述
u16MaxRgain	设定高色温时的最大R Gain。值域范围：256 ~ 4095。
u16MinRgain	设定低色温时的最小R Gain。值域范围：256 ~ 4095。
u16MaxBgain	设定高色温时的最大B Gain。值域范围：256 ~ 4095。
u16MinBgain	设定低色温时的最小B Gain。值域范围：256 ~ 4095。

相关结构类型与函式
```
MI_ISP_AWB_AttrParam_t
```

3.99.6. 参数结构体（Parameter Structure）

说明

设定计算目标R、B gain时各色温的权重的参数结构体。

定义

typedef struct MI_ISP_AWB_CtWeightParam_s

{

    MI_U16 u16Weight[MI_ISP_AWB_CT_TBL_NUM];

} MI_ISP_AWB_CtWeightParam_t;

名称

变量名称	描述
u16Weight[MI_ISP_AWB_CT_TBL_NUM]	计算目标R、B gain时各色温的权重，权重越大，目标R、B gain会越倾向该色温R、B gain，MI_ISP_AWB_CT_TBL_NUM = 10。值域范围：1 ~ 255，默认值100。

相关结构类型与函式
```
MI_ISP_AWB_AttrParam_t
```

3.99.7. 参数结构体（Parameter Structure）

说明

设定微调目标R、B gain所乘上的一个ratio的参数结构体。

定义

typedef struct MI_ISP_AWB_CtRatioParam_s

{

    MI_U16 u16Ratio[MI_ISP_AWB_CT_TBL_NUM];

} MI_ISP_AWB_CtRatioParam_t;

名称

变量名称	描述
u16Ratio [MI_ISP_AWB_CT_TBL_NUM]	用来微调各环境色温目标R、B gain所乘上的一个ratio，MI_ISP_AWB_CT_TBL_NUM = 10。值域范围：1 ~ 255，默认值100。

相关结构类型与函式
```
MI_ISP_AWB_AttrParam_t
```

3.100. MI_ISP_AWB_AttrEx结构体¶

3.100.1. 类型结构体（Type Structure）

说明

设定AWB增强属性的类型结构体。

定义

typedef struct MI_ISP_AWB_AttrExType_s

{

    MI_ISP_AWB_bool_e                       bExtraLightEn;

    MI_ISP_AWB_AttrExtraLightsourceParam_t  stLightInfo[MI_ISP_AWB_EX_LIGHT_CNT];

} MI_ISP_AWB_AttrExType_t;

名称

变量名称	描述
bExtraLightEn	设定自动白平衡计算时是否考虑使用者设的独立色温范围功能的布尔值。关闭：E_SS_AWB_FALSE = 0。开启：E_SS_AWB_TRUE = 1。
stLightInfo[MI_ISP_AWB_EX_LIGHT_CNT]	用户设定的独立光源点信息。 MI_ISP_AWB_EX_LIGHT_CNT = 4。

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetAttrEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_AttrExType_t *data);

MI_S32 MI_ISP_AWB_GetAttrEx(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_AttrExType_t *data);

3.100.2. 白平衡独立光源点参数结构体（AWB Extra LightSource Parameter Structure）

说明

设定白平衡独立光源点的参数结构体。

定义

typedef struct MI_ISP_AWB_AttrExtraLightsourceParam_s

{

    MI_U16     u16WhiteRgain;

    MI_U16     u16WhiteBgain;

    MI_U8       u8AreaSize;

    MI_ISP_AWB_bool_e bExclude;

} MI_ISP_AWB_AttrExtraLightsourceParam_t;

名称

变量名称	描述
u16WhiteRgain	此设定值会映像到色温坐标的某一个独立点，不需要参考色温，使用者设定的独立光源点的R Gain值（G × 1024 / R）。值域范围：256 ~ 4095。
u16WhiteBgain	此设定值会映像到色温坐标的某一个独立点，不需要参考色温，使用者设定的独立光源点的B Gain值（G × 1024 / B）。值域范围：256 ~ 4095。
u8AreaSize	使用者设定的独立光源点，在色温坐标的范围，值越大表示范围越广。值域范围：1 ~ 32。
bExclude	设定白平衡演算时排除或包含使用者设定的独立光源点功能的布尔值。在白平衡算法计算时，判定白点是否纳入或排除使用者设定的光源点范围。包含：E_SS_AWB_FALSE = 0。排除：E_SS_AWB_TRUE = 1。

相关结构类型与函式
```
MI_ISP_AWB_AttrExType_t
```

3.101. MI_ISP_AWB_MultiLs结构体¶

3.101.1. 类型结构体（Type Structure）

说明

设定自动白平衡混光偏校正的类型结构体。

定义

typedef struct MI_ISP_AWB_MultiLsType_s

{

    MI_ISP_AWB_bool_e bEnable;

    MI_U8       u8Sensitive;

    MI_U8       u8CaliStrength;

    MI_U16     u16CcmForLow[MI_ISP_AWB_MULTILS_CNT];

    MI_U16     u16CcmForHigh[MI_ISP_AWB_MULTILS_CNT];

} MI_ISP_AWB_MultiLsType_t;

名称

变量名称	描述
bEnable	设定混光色偏校正功能的布尔值。关闭：E_SS_AWB_FALSE = 0。开启：E_SS_AWB_TRUE = 1。
u8Sensitive	判断混光的敏感度，值越大越容易判断为混光场景。值域范围：1 ~ 10，默认值为5。
u8CaliStrength	最大混光色温差距的色偏校正强度，最大混光差距表示两个光源的落点刚好分别落在StartIdx与EndIdx。实际作用的强度会根据两光源色温差距与最大色温差距的比例做调整。值域范围：0 ~ 100，默认值为100。
u16CcmForLow[MI_ISP_AWB_MULTILS_CNT]	当判断出混光，且将高色温光源做灰时，用来补正低色温光源处色偏的CCM。注意u16CcmForLow[3] ~ [5]（G列）是无作用的，修改请以u16CcmForLow[0] ~ [2]（R列）及u16CcmForLow[6] ~ [8]（B列）为主。值域范围：0 ~ 8191。MI_ISP_AWB_MULTILS_CNT = 9。
u16CcmForHigh[MI_ISP_AWB_MULTILS_CNT]	当判断出混光，且将低色温光源做灰时，用来补正高色温光源处色偏的CCM。注意u16CcmForLow[3] ~ [5]（G列）是无作用的，修改请以u16CcmForLow[0] ~ [2]（R列）及u16CcmForLow[6] ~ [8]（B列）为主。值域范围：0 ~ 8191。MI_ISP_AWB_MULTILS_CNT = 9。

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetMultiLsAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_MultiLsType_t *data);

MI_S32 MI_ISP_AWB_GetMultiLsAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_MultiLsType_t *data);

3.102. MI_ISP_AWB_CtCali结构体¶

3.102.1. 类型结构体（Type Structure）

说明

设定自动白平衡校正的类型结构体。

定义

typedef struct MI_ISP_AWB_CtCaliType_s

{

    MI_U16 u16StartIdx;

    MI_U16 u16EndIdx;

    MI_U16 u16CtParams[MI_ISP_AWB_CT_CALI_CNT];

} MI_ISP_AWB_CtCaliType_t;

名称

变量名称 描述

u16StartIdx 亮区开始索引。

u16EndIdx 亮区结束索引。

u16CtParams[MI_ISP_AWB_CT_CALI_CNT] 色温cali参数。MI_ISP_AWB_CT_CALI_CNT = 40。

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetCtCaliAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_CtCaliType_t *data);

MI_S32 MI_ISP_AWB_GetCtCaliAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_CtCaliType_t *data);

3.103. MI_ISP_AWB_CurCtCali结构体¶

3.103.1. 类型结构体（Type Structure）

说明

自动白平衡色温框数据的类型结构体。

定义

typedef struct MI_ISP_AWB_CurCtCaliType_s

{

    MI_U16 u16CtParams[MI_ISP_AWB_CT_CALI_CNT];

} MI_ISP_AWB_CurCtCaliType_t;

名称

变量名称 描述

u16CtParams[MI_ISP_AWB_CT_CALI_CNT] 色温框资料。MI_ISP_AWB_CT_CALI_CNT = 40。

相关结构类型与函式

MI_S32 MI_ISP_AWB_GetCurCtCaliAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_CurCtCaliType_t *data);

3.104. MI_ISP_AWB_Ctmwb结构体¶

3.104.1. 类型结构体（Type Structure）

说明

手动色温白平衡色温的类型结构体。

定义

typedef struct MI_ISP_AWB_CtmwbParam_s

{

    MI_U32 u32CT;

} MI_ISP_AWB_CtmwbParam_t;

名称

变量名称 描述

u32CT 色温设定。值域范围：1000 ~ 20000。

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetCtMwbAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_CtmwbParam_t *data);

MI_S32 MI_ISP_AWB_GetCtMwbAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_CtmwbParam_t *data);

3.105. MI_ISP_AWB_Stabilizer结构体¶

3.105.1. 类型结构体（Type Structure）

说明

AWB stabilizer的类型结构体。

定义

typedef struct MI_ISP_AWB_StabilizerType_s

{

    MI_ISP_AWB_bool_e bEnable;

    MI_U16      u16GlbGainThd;

    MI_U16      u16CountThd;

    MI_U16      u16ForceTriGainThd;

} MI_ISP_AWB_StabilizerType_t;

名称

变量名称	描述
bEnable	此功能开关。
u16GlbGainThd	整体WB gain变化的阀值控制。当AWB在收敛状态要重新被trigger，除了满足原有的条件之外（ConvOutThd），还需要整体WB gain变化超出此阀值才会被重新trigger。值域0 ~ 512，建议此值设的与ConvOutThd相同或更小一些即可，默认值是64。
u16CountThd	连续判定要重新trigger AWB的次数阀值。当此值为2则须连续三次满足重新trigger的条件才会重新触发AWB，否则AWB仍会维持在稳定状态。值域0 ~ 100。建议此值不需要设太高，因为会延迟AWB被触发的反应时间。默认值为2。
u16ForceTriGainThd	为了避免环境光源色温瞬间大幅度变化时AWB反应时间因CountThd变慢，我们又定义了一个强制Trigger的gain阀值，只要当Gain变化满足重新trigger AWB的条件，且变化量大于此阀值，则会忽略CountThd直接trigger AWB。值域0 ~ 8191。默认值150。

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetStabilizer(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_StabilizerType_t *data);

MI_S32 MI_ISP_AWB_GetStabilizer(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_StabilizerType_t *data);

3.106. MI_ISP_AWB_SpecialCase结构体¶

3.106.1. 类型结构体 (Type Structure)

说明

AWB SpecialCase的类型结构体。

定义

typedef struct MI_ISP_AWB_SpecialCaseType_s

{

    MI_U32 u32CaseNum;

    MI_ISP_AWB_SpecialCaseParam_t  stCase[MI_ISP_AWB_SPECIAL_CASE_NUM];

} MI_ISP_AWB_SpecialCaseType_t;

名称

变量名称	描述
u32CaseNum	欲使用Case数量。值域0 ~ 4，0等于此功能关闭。
stCase[MI_ISP_AWB_SPECIAL_CASE_NUM]	用来设定每个case的SpecialCase参数。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetSpecialCase(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_SpecialCaseType_t *data);

MI_S32 MI_ISP_AWB_GetSpecialCase(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_SpecialCaseType t *data);

3.106.2. MI_ISP_AWB_SpecialCaseParam_t参数结构体 (Parameter Structure)

说明

个别case的参数结构体，用来设定每个case的SpecialCase参数。

定义

typedef struct MI_ISP_AWB_SpecialCaseParam_s
{
    MI_U8       u8Group1_ZoneNum;
    MI_U16  u16Group1_CenterX[MI_ISP_AWB_SPECIAL_ZONE_NUM];
    MI_U16  u16Group1_CenterY[MI_ISP_AWB_SPECIAL_ZONE_NUM];
    MI_U8       u8Group1_Radius[MI_ISP_AWB_SPECIAL_ZONE_NUM];
    MI_U8       u8Group1_CntLutNodeNum;
    MI_S32  s32Group1_CntLutX[MI_ISP_AWB_SPECIAL_NODE_NUM];
    MI_S32  s32Group1_CntLutY[MI_ISP_AWB_SPECIAL_NODE_NUM];
    MI_U8       u8Group2_ZoneNum;
    MI_U16  u16Group2_CenterX[MI_ISP_AWB_SPECIAL_ZONE_NUM];
    MI_U16  u16Group2_CenterY[MI_ISP_AWB_SPECIAL_ZONE_NUM];
    MI_U8       u8Group2_Radius[MI_ISP_AWB_SPECIAL_ZONE_NUM];
    MI_U8       u8Group2_CntLutNodeNum;
    MI_S32  s32Group2_CntLutX[MI_ISP_AWB_SPECIAL_NODE_NUM];
    MI_S32  s32Group2_CntLutY[MI_ISP_AWB_SPECIAL_NODE_NUM];
    MI_U8       u8BvLutNodeNum;
    MI_S32  s32BvLutX[MI_ISP_AWB_SPECIAL_NODE_NUM];
    MI_S32  s32BvLutY[MI_ISP_AWB_SPECIAL_NODE_NUM];
    MI_ISP_AWB_SpecialMode_e    eMode;
    MI_U16  u16Weight[MI_ISP_AWB_CT_TBL_NUM];
    MI_U32  u32PreferCT;
    MI_U16  u16PreferRgain;
    MI_U16  u16PreferBgain;
} MI_ISP_AWB_SpecialCaseParam_t;

名称

变量名称	描述
u8Group1_ZoneNum	欲定义的zone数量，算法会分析落入所有zone的AWB统计值数量占全统计值数量的百分比。值域0 ~ 8，设0代表此条件无条件达成。
u16Group1_CenterX[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的中心点在R/G-B/G plane上的x坐标。值域0 ~ 1023。MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u16Group1_CenterY[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的中心点在R/G-B/G plane上的y坐标。值域0 ~ 1023。 MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u8Group1_Radius[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的半径大小。值域0 ~ 20。 MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u8Group1_CntLutNodeNum	决定CntLut欲使用的节点数量。值域0 ~ 4。
s32Group1_CntLutX[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定CntLut节点x值，代表落入所有zone的统计值总数占统计值总数的百分比。算法会分析出Group1的统计值百分比来查此表，得到Group1条件达标率Group1.CntRatio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
s32Group1_CntLutY[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定CntLut节点y值，代表ratio值。算法会分析出Group1的统计值百分比来查此表，得到Group1条件达标率Group1.CntRatio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
u8Group2_ZoneNum	欲定义的zone数量，算法会分析落入所有zone的AWB统计值数量占全统计值数量的百分比。值域0 ~ 8，设0代表此条件无条件达成。
u16Group2_CenterX[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的中心点在R/G-B/G plane上的x坐标。值域0 ~ 1023。MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u16Group2_CenterY[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的中心点在R/G-B/G plane上的y坐标。值域0 ~ 1023。 MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u8Group2_Radius[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的半径大小。值域0 ~ 20。 MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u8Group2_CntLutNodeNum	决定CntLut欲使用的节点数量。值域0 ~ 4。
s32Group2_CntLutX[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定CntLut节点x值，代表落入所有zone的统计值总数占统计值总数的百分比。算法会分析出Group2的统计值百分比来查此表，得到Group2条件达标率Group2.CntRatio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
s32Group2_CntLutY[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定CntLut节点y值，代表ratio值。算法会分析出Group2的统计值百分比来查此表，得到Group2条件达标率Group2.CntRatio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
u8BvLutNodeNum	BvLut节点数量。值域0 ~ 4，设0代表此条件无条件达成。
s32BvLutX[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定BvLut节点x值，代表Bv。值域-81920 ~ 245760。 MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
s32BvLutY[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定BvLut节点y值，代表达标率。值域0 ~ 1024。 MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
eMode	case达成时的行为模式选择，值域0 ~ 2。 0：WeightCtrl mode 1：PreferCT mode 2：PreferGain mode
u16Weight[MI_ISP_AWB_CT_TBL_NUM]	当Mode为0时有效，色温框会根据CaseRatio套用此weight设定。值域0 ~ 1024。 MI_ISP_AWB_CT_TBL_NUM = 10。
u32PreferCT	当Mode为1时有效，原来的Target WB gain会根据CaseRatio与PreferCT对应的WB gain做混和成为新的Target WB gain。值域0 ~ 20000。
u16PreferRgain	当Mode为2时有效，原来的Target WB gain会根据CaseRatio与PreferRgain做混和成为新的Target WB gain。值域0 ~ 8191。
u16PreferBgain	当Mode为2时有效，原来的Target WB gain会根据CaseRatio与PreferBgain做混和成为新的Target WB gain。值域0 ~ 8191。

相关结构类型与函式
```
MI_ISP_AWB_SpecialCaseType_t
```

3.106.3. MI_ISP_AWB_SpecialMode_e列举结构体 (Enum Structure)

说明

SpecicalCase行为模式列举结构体。

定义

typedef enum

{

    E_SS_AWB_SPECIAL_WEIGHTCTRL  = 0,

    E_SS_AWB_SPECIAL_PREFER_CT   = 1,

    E_SS_AWB_SPECIAL_PREFER_GAIN  = 2

} MI_ISP_AWB_SpecialMode_e;

名称

变量名称	描述
E_SS_AWB_SPECIAL_WEIGHTCTRL	Weight控制模式。可调整当case达成时各色温框的weight。
E_SS_AWB_SPECIAL_PREFER_CT	PreferCT模式。可调整当case达成时欲与target WB gain混和的指定色温WB gain。
E_SS_AWB_SPECIAL_PREFER_GAIN	PreferGain模式。可调整当case达成时欲与target WB gain混和的指定WB gain。

相关结构类型与函式
```
MI_ISP_AWB_SpecialCaseParam_t
```

3.107. MI_ISP_AWB_SpecialCaseInfo结构体¶

3.107.1. SpecialCase Info类型结构体 (Type Structure)

说明

AWB SpecialCase Info的类型结构体。

定义

typedef struct MI_ISP_AWB_SpecialCaseInfoType_s
{
    MI_U32  u32Group1Cnt[MI_ISP_AWB_SPECIAL_CASE_NUM];
    MI_U32  u32Group1CntRatio[MI_ISP_AWB_SPECIAL_CASE_NUM];
    MI_U32  u32Group2Cnt[MI_ISP_AWB_SPECIAL_CASE_NUM];
    MI_U32  u32Group2CntRatio[MI_ISP_AWB_SPECIAL_CASE_NUM];
    MI_U32  u32BvRatio[MI_ISP_AWB_SPECIAL_CASE_NUM];
    MI_U32  u32CaseRatio[MI_ISP_AWB_SPECIAL_CASE_NUM];
    MI_U16  u16CaseWeight[MI_ISP_AWB_SPECIAL_CASE_NUM][MI_ISP_AWB_CT_TBL_NUM];
    MI_U16  u16SpecialWeight[MI_ISP_AWB_CT_TBL_NUM];
    MI_U16  u16SpecialRgain[MI_ISP_AWB_SPECIAL_CASE_NUM];
    MI_U16  u16SpecialBgain[MI_ISP_AWB_SPECIAL_CASE_NUM];
} MI_ISP_AWB_SpecialCaseInfoType_t;

名称

变量名称	描述
u32Group1Cnt[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case的Group1统计值落点总数。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u32Group1CntRatio[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case的Group1统计值落点总数查Group1.CntLut后得到的Ratio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u32Group2Cnt[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case的Group2统计值落点总数。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u32Group2CntRatio[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case的Group2统计值落点总数查Group2.CntLut后得到的Ratio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u32BvRatio[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case根据Bv查BvLut后得到的Ratio。值域0 ~ 1024。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u32CaseRatio[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case将Group1.CntRatio、Group1.CntRatio及BvRatio整合后的Ratio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u16CaseWeight[MI_ISP_AWB_SPECIAL_CASE_NUM] [MI_ISP_AWB_CT_TBL_NUM]	显示各个case透过CaseRatio得到的CaseWeight。若Mode选择不为0的case其CaseWeight会全是100，代表没有作用。MI_ISP_AWB_SPECIAL_CASE_NUM = 4；MI_ISP_AWB_CT_TBL_NUM = 10。
u16SpecialWeight[MI_ISP_AWB_CT_TBL_NUM]	将四组CaseWeight整合起来最终成为一组SpecialWeight。MI_ISP_AWB_CT_TBL_NUM = 10。
u16SpecialRgain[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case要与Target WB gain做混和的R gain。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u16SpecialBgain[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case要与Target WB gain做混和的B gain。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。

相关结构类型与函式

MI_S32 MI_ISP_AWB_QuerySpecialCaseInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SpecialCaseInfoType_t *data);

3.108. MI_ISP_AWB_StatisFilter结构体¶

3.108.1. 类型结构体 (Type Structure)

说明

AWB StatisFilter的类型结构体。

定义

typedef struct MI_ISP_AWB_StatisFilterType_s

{

    MI_U32 u32NodeNum;

    MI_S32 s32LutX_BV[MI_ISP_AWB_STATISFILTER_NODE_NUM];

    MI_S32 s32LutY_HighThd[MI_ISP_AWB_STATISFILTER_NODE_NUM];

    MI_S32 s32LutY_LowThd[MI_ISP_AWB_STATISFILTER_NODE_NUM];

} MI_ISP_AWB_StatisFilterType_t;

名称

变量名称	描述
u32NodeNum	设定lookup table节点数量。值域0 ~ 4，设0会使用预设有效亮度区间4 ~ 224。
s32LutX_BV[MI_ISP_AWB_STATISFILTER_NODE_NUM]	设定lookup table的节点x坐标，也就是BV。值域-81920 ~ 245760。 MI_ISP_AWB_STATISFILTER_NODE_NUM = 4。
s32LutY_HighThd[MI_ISP_AWB_STATISFILTER_NODE_NUM]	设定lookup table的节点Y坐标，也就是最高亮度限制。统计值的RGB中只要任一值超过此限制，则该统计值即被忽略。值域0 ~ 255。 MI_ISP_AWB_STATISFILTER_NODE_NUM = 4。
s32LutY_LowThd[MI_ISP_AWB_STATISFILTER_NODE_NUM]	设定另一个lookup table的节点Y坐标，也就是最低亮度限制。统计值的RGB中只要任一值低于此限制，则该统计值即被忽略。值域0 ~ 255。注意LowThd要小于HighThd。MI_ISP_AWB_STATISFILTER_NODE_NUM = 4。

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetStatisFilter(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StatisFilterType_t *data);

MI_S32 MI_ISP_AWB_GetStatisFilter(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StatisFilterType t *data);

3.109. MI_ISP_AWB_VerInfo结构体¶

3.109.1. 类型结构体（Type Structure）

说明

AWB Version Information结构体。

定义

typedef struct MI_ISP_AWB_VerInfoType_s
{
    MI_U32  u32ReleaseDate;
    MI_U32  u32ReportID;
    MI_U8   u8Major;
    MI_U8   u8Minor;
    MI_U8   u8TestVer;
} MI_ISP_AWB_VerInfoType_t;

名称

变量名称	描述
u32ReleaseDate	打印AWB FW更新日期。
u32ReportID	打印AWB FW反馈问题的数值编号，default：0。
u8Major	打印AWB FW主要版本编号。
u8Minor	打印AWB FW次要版本编号。
u8TestVer	打印AWB FW测试版本编号，default：0。

相关结构类型与函式

MI_S32 MI_ISP_AWB_GetVersionInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AWB_VerInfoType_t *data);

3.110. MI_ISP_AF_bool结构体¶

3.110.1. 列举结构体（Enum Structure）

说明

布尔值的列举结构体。

定义

typedef enum

{

    E_SS_AF_FALSE = 0,

    E_SS_AF_TRUE = !E_SS_AF_FALSE,

    E_SS_AF_BOOL_MAX

} MI_ISP_AF_bool_e;

名称

变量名称 描述

E_SS_AF_FALSE 布尔值等于0。

E_SS_AF_TRUE 布尔值等于1。

E_SS_AF_BOOL_MAX 判断布尔值列举列表的最大值。

相关结构类型与函式

MI_ISP_AF_QueryInfoType_t

MI_ISP_AF_AccWeightType_t

3.111. MI_ISP_AF_OpType结构体¶

3.111.1. 列举结构体（Enum Structure）

说明

工作模式的列举结构体。

定义

typedef enum

{

    E_SS_AF_OP_TYP_AUTO = 0,

    E_SS_AF_OP_TYP_MANUAL = ! E_SS_AF_OP_TYP_AUTO,

    E_SS_AF_OP_TYP_MODE_MAX

} MI_ISP_AF_OpType_e;

名称

变量名称 描述

E_SS_AF_OP_TYP_AUTO 自动工作模式。

E_SS_AF_OP_TYP_MANUAL 手动工作模式。

E_SS_AF_OP_TYP_MODE_MAX 判断工作模式列举列表的最大值。
相关结构类型与函式
```
MI_ISP_AF_AttrType_t
```

3.112. MI_ISP_AF_SmStateType结构体¶

3.112.1. 列举结构体（Enum Structure）

说明

状态机（State Machine）的列举结构体。

定义

typedef enum

{

    E_SS_AF_STATE_NORMAL = 0,

    E_SS_AF_STATE_PAUSE = 1,

    E_SS_AF_STATE_MAX

} MI_ISP_AF_SmStateType_e;

名称

变量名称 描述

E_SS_AF_STATE_NORMAL 正常模式。

E_SS_AF_STATE_PAUSE 暂停模式。

E_SS_AF_STATE_MAX 判断状态机列举清单的最大值。
相关结构类型与函式
```
MI_ISP_AF_AttrType_t
```

3.113. MI_ISP_AF_QueryInfo结构体¶

3.113.1. 类型结构体（Type Structure）

说明

设定当前AF信息。

定义

typedef struct MI_ISP_AF_QueryInfoType_s

{

    MI_ISP_AF_bool_e  bIsStable;

    MI_U16     u16CurMotorPos;

} MI_ISP_AF_QueryInfoType_t;

名称

变量名称 描述

bIsStable 获取目前AF是否在收敛状态。

u16CurMotorPos 获取目前Motor位置。

相关结构类型与函式

MI_S32 MI_ISP_AF_QueryInfo(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_QueryInfoType_t *data);

3.114. MI_ISP_AF_HwWin结构体¶

3.114.1. 类型结构体（Type Structure）

说明

设定AF Win。

定义

typedef struct MI_ISP_AF_HwWinType_s
{
    MI_ISP_AF_HwRoiModeType_e   eMode;
    MI_U32                  u32VerticalBlockNumber;
    MI_ISP_AF_WinType_t     stParaAPI[AF_HW_WIN_NUM];
} MI_ISP_AF_HwWinType_t;

名称

变量名称	描述
eMode	ROI模式控制选项，选择0可切为16组ROI，window size与位置可随意分割，选择1可切为16*N组ROI，window size与位置稍有限制，值域0 ~ 1。
u32VerticalBlockNumber	当Mode为Matrix时才有效果，可切为16*N组ROI （N = VerticalBlockNumber），值域1 ~ 16。
stParaAPI[AF_HW_WIN_NUM]	16组ROI坐标，依序为x_start, y_start, x_end, y_end，值域0 ~ 1023。AF_HW_WIN_NUM = 16。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetHwWin(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwWinType_t *data);

MI_S32 MI_ISP_AF_GetHwWin(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwWinType_t *data);

3.114.2. 模式列举结构体（Mode Enum Structure）

说明

AF统计值的ROI模式。

定义

typedef enum __attribute__ ((aligned (1)))

{

    E_IQ_AF_ROI_MODE_NORMAL,

    E_IQ_AF_ROI_MODE_MATRIX

} MI_ISP_AF_HwRoiModeType_e;

名称

变量名称	描述
E_IQ_AF_ROI_MODE_NORMAL	Normal模式。可切为16组ROI，window size与位置可随意分割。
E_IQ_AF_ROI_MODE_MATRIX	Matrix模式。可切为16*N组ROI，window size与位置稍有限制。

相关结构类型与函式
```
MI_ISP_AF_HwWinType_t
```

3.114.3. 窗类型结构体（Window Type Structure）

说明

设定AF Win的位置。

定义

typedef struct MI_ISP_AF_WinType_s

{

    MI_U32 u16StartX;

    MI_U32 u16StartY;

    MI_U32 u16EndX;

    MI_U32 u16EndY;

} MI_ISP_AF_WinType_t;

名称

变量名称	描述
u16StartX	起始位置的X坐标值，值域0 ~ 1023。
u16StartY	起始位置的Y坐标值，值域0 ~ 1023。
u16EndX	终点位置的X坐标值，值域0 ~ 1023。
u16EndY	终点位置的Y坐标值，值域0 ~ 1023。

相关结构类型与函式
```
MI_ISP_AF_HwWinType_t
```

3.115. MI_ISP_AF_HwFilterAttr结构体¶

3.115.1. 类型结构体（Type Structure）

说明

设定AF filter系数。

定义

typedef struct MI_ISP_AF_HwFilterAttrType_s
{
    MI_U16 u16IIR1_a0;
    MI_U16 u16IIR1_a1;
    MI_U16 u16IIR1_a2;
    MI_U16 u16IIR1_b1;
    MI_U16 u16IIR1_b2;
    MI_U16 u16IIR1_1st_low_clip;
    MI_U16 u16IIR1_1st_high_clip;
    MI_U16 u16IIR1_2nd_low_clip;
    MI_U16 u16IIR1_2nd_high_clip;
    MI_U16 u16IIR2_a0;
    MI_U16 u16IIR2_a1;
    MI_U16 u16IIR2_a2;
    MI_U16 u16IIR2_b1;
    MI_U16 u16IIR2_b2;
    MI_U16 u16IIR2_1st_low_clip;
    MI_U16 u16IIR2_1st_high_clip;
    MI_U16 u16IIR2_2nd_low_clip;
    MI_U16 u16IIR2_2nd_high_clip;

    MI_U16 u16IIR1_e1_en;
    MI_U16 u16IIR1_e1_a0;
    MI_U16 u16IIR1_e1_a1;
    MI_U16 u16IIR1_e1_a2;
    MI_U16 u16IIR1_e1_b1;
    MI_U16 u16IIR1_e1_b2;
    MI_U16 u16IIR1_e2_en;
    MI_U16 u16IIR1_e2_a0;
    MI_U16 u16IIR1_e2_a1;
    MI_U16 u16IIR1_e2_a2;
    MI_U16 u16IIR1_e2_b1;
    MI_U16 u16IIR1_e2_b2;

    MI_U16 u16IIR2_e1_en;
    MI_U16 u16IIR2_e1_a0;
    MI_U16 u16IIR2_e1_a1;
    MI_U16 u16IIR2_e1_a2;
    MI_U16 u16IIR2_e1_b1;
    MI_U16 u16IIR2_e1_b2;
    MI_U16 u16IIR2_e2_en;
    MI_U16 u16IIR2_e2_a0;
    MI_U16 u16IIR2_e2_a1;
    MI_U16 u16IIR2_e2_a2;
    MI_U16 u16IIR2_e2_b1;
    MI_U16 u16IIR2_e2_b2;
} MI_ISP_AF_HwFilterAttrType_t;

名称

名称	bit表示	描述	IIR1 default	IIR2 default
a0	S+9	a0乘法器	37	19
a1	S+10	a1乘法器	0	0
a2	S+9	a2乘法器	-37	-19
b1	S+13	b1乘法器	-6848	-7808
b2	S+13	b2乘法器	3136	3776
1st_low_clip	10	X(n) input low clip	0	0
1st_high_clip	10	X(n) input high clip	1023	1023
2nd_low_clip	10	Y(n) output low clip	0	0
2nd_high_clip	10	Y(n) output high clip	1023	1023
e1_en	1	Extra1 enable	1	1
e1_a0	S+9	a0乘法器	37	19
e1_a1	S+10	a1乘法器	0	0
e1_a2	S+9	a2乘法器	-37	-19
e1_b1	S+13	b1乘法器	1600	-4672
e1_b2	S+13	b2乘法器	1792	2304
e2_en	1	Extra2 enable	1	1
e2_a0	S+9	a0乘法器	32	17
e2_a1	S+10	a1乘法器	0	0
e2_a2	S+9	a2乘法器	-32	-17
e2_b1	S+13	b1乘法器	-2624	-5824
e2_b2	S+13	b2乘法器	0	1920

IIR1 default为IIR High，IIR2 default为IIR Low。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetHwFilterAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwFilterAttrType_t *data);

MI_S32 MI_ISP_AF_GetHwFilterAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwFilterAttrType_t *data);

3.116. MI_ISP_AF_HwFilterSq结构体¶

3.116.1. 类型结构体（Type Structure）

说明

设定AF filter square系数。

定义

typedef struct MI_ISP_AF_HwFilterSqType_s
{
    MI_U8   bSobelYSatEn;
    MI_U16  u16SobelYThd;
    MI_U8   bIIRSquareAccEn;
    MI_U8   bSobelSquareAccEn;
    MI_U16  u16IIR1Thd;
    MI_U16  u16IIR2Thd;
    MI_U16  u16SobelHThd;
    MI_U16  u16SobelVThd;
    MI_U8   u8AFTbl1X[AF_FILTER_SQ_TBL_X_NUM];
    MI_U16  u16AFTbl1Y[AF_FILTER_SQ_TBL_Y_NUM];
    MI_U8   u8AFTbl2X[AF_FILTER_SQ_TBL_X_NUM];
    MI_U16  u16AFTbl2Y[AF_FILTER_SQ_TBL_Y_NUM];
} MI_ISP_AF_HwFilterSqType_t;

名称

变量名称	描述
bSobelYSatEn	此开关包含两种动作：Sobel Filter Y阀值控制；y_sat统计值的设定控制。
u16SobelYThd	当bSobelYSatEn = 1 Sobel Filter Y阀值控制：pixel亮度小于u16SobelYThd时，就会列入sobel filter计算中。 y_sat统计值的设定控制：回传大于u16SobelYThd的pixel个数，反应于y_sat统计值中。数值范围：0 ~ 1023。
bIIRSquareAccEn	IIR Filter Square增强控制开关。
bSobelSquareAccEn	Sobel Filter Square增强控制开关。
u16IIR1Thd	IIR1 Filter Output = IIR1 Filter Output – IIR1Thd。数值范围：0 ~ 1023。
u16IIR2Thd	IIR2 Filter Output = IIR2 Filter Output – IIR2Thd。数值范围：0 ~ 1023。
u16SobelHThd	SobelH Filter Output = SobelH Filter Output – SobelH Thd。数值范围：0 ~ 1023。
u16SobelVThd	SobelV Filter Output = SobelV Filter Output – SobelV Thd。数值范围：0 ~ 1023。
u8AFTbl1X [AF_FILTER_SQ_TBL_X_NUM]	针对IIR1与SobelH Filter，做一个non-linear的mapping。 u8AFTbl1X为Tbl1横轴，节点为二的幂次方累加，累加起来需大于1024。数值范围：0 ~ 15。 AF_FILTER_SQ_TBL_X_NUM = 12。
u16AFTbl1Y [AF_FILTER_SQ_TBL_Y_NUM]	针对IIR1与SobelH Filter，做一个non-linear的mapping。 u16AFTbl1Y为Tbl1纵轴，数值范围：0 ~ 8191。 AF_FILTER_SQ_TBL_Y_NUM = 13。
u8AFTbl2X [AF_FILTER_SQ_TBL_X_NUM]	针对IIR2与SobelV Filter，做一个non-linear的mapping。 u8AFTbl2X为Tbl2横轴，节点为二的幂次方累加，累加起来需大于1024。数值范围：0 ~ 15。 AF_FILTER_SQ_TBL_X_NUM = 12。
u16AFTbl2Y [AF_FILTER_SQ_TBL_Y_NUM]	针对IIR2与SobelV Filter，做一个non-linear的mapping。 u16AFTbl2Y为Tbl2纵轴，数值范围：0 ~ 8191。 AF_FILTER_SQ_TBL_Y_NUM = 13。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetHwFilterSq(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwFilterSqType_t *data);

MI_S32 MI_ISP_AF_GetHwFilterSq(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwFilterSqType_t *data);

3.117. MI_ISP_AF_HwBnr结构体¶

3.117.1. 类型结构体（Type Structure）

说明

设定AF bayer降噪系数。

定义

typedef struct MI_ISP_AF_HwBnrType_s
{
    MI_U8 u8BnrEn;
    MI_U8 u8FilterStr;
} MI_ISP_AF_HwBnrType_t;

名称

变量名称描述

u8BnrEn Bayer降噪开关，值域0 ~ 1。

u8FilterStr Bayer降噪强度，值域范围：0 ~ 63，值越大则NR越强。
注意事项

AF Bayer降噪必须在AF source 设置在E_IQ_AF_SOURCE_BF_3DNR_AF_HDR时才有作用。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetHwBnr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwBnrType_t *data);

MI_S32 MI_ISP_AF_GetHwBnr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwBnrType_t *data);

3.118. MI_ISP_AF_HwYParam结构体¶

3.118.1. 类型结构体（Type Structure）

说明

设定AF filter bayer to Y的RGB比例系数。

定义

typedef struct MI_ISP_AF_HwYParamType_s

{

    MI_U8 u8R;

    MI_U8 u8G;

    MI_U8 u8B;

} MI_ISP_AF_HwYParamType_t;

名称

变量名称 描述

u8R Bayer to Y的R channel比例（0~255）。

u8G Bayer to Y的G channel比例（0~255）。

u8B Bayer to Y的B channel比例（0~255）。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetHwYParam(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwYParamType_t *data);

MI_S32 MI_ISP_AF_GetHwYParam(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwYParamType_t *data);

3.119. MI_ISP_AF_HwSource结构体¶

3.119.1. 类型结构体（Type Structure）

说明

设定AF filter抽取统计值的位置。

定义

typedef enum
{
    E_IQ_AF_SOURCE_BF_3DNR_AF_HDR       = 0,
    E_IQ_AF_SOURCE_FROM_SE_OBC_BF_HDR   = 2,
    E_IQ_AF_SOURCE_FROM_SE_WBG_BF_HDR   = 3,
    E_IQ_AF_SOURCE_FROM_ALSC_AF_HDR     = 4,
    E_IQ_AF_SOURCE_FROM_WBG_AF_HDR      = 5,
    E_IQ_AF_SOURCE_FROM_LE_OBC_BF_HDR   = 6,
    E_IQ_AF_SOURCE_FROM_LE_WBG_BF_HDR   = 7,
} MI_ISP_AF_HwSourceType_e;

名称

变量名称	描述
E_IQ_AF_SOURCE_BF_3DNR_AF_HDR	Linear模式：选择3DNR前的结果 HDR模式：选择HDR后的结果（3DNR前）
E_IQ_AF_SOURCE_FROM_SE_OBC_BF_HDR	Linear模式：选择OB后的结果 HDR模式：选择HDR前的短曝结果（OB后）
E_IQ_AF_SOURCE_FROM_SE_WBG_BF_HDR	Linear模式：选择WBGain后的结果 HDR模式：选择HDR前的短曝结果（WBGain后）
E_IQ_AF_SOURCE_FROM_ALSC_AF_HDR	Linear模式：CI前的结果（Shading后） HDR模式：选择HDR后的结果（Shading后）
E_IQ_AF_SOURCE_FROM_WBG_AF_HDR	Linear模式：选择CI前的结果（WBGain后） HDR模式：选择HDR后的结果（WBGain后）
E_IQ_AF_SOURCE_FROM_LE_OBC_BF_HDR	Linear模式：不支援 HDR模式：选择HDR前的长曝结果（OB后）
E_IQ_AF_SOURCE_FROM_LE_WBG_BF_HDR	Linear模式：不支援 HDR模式：选择HDR前的长曝结果（WBGain后）

相关结构类型与函式

MI_S32 MI_ISP_AF_SetHwSource(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwSourceType_e *data);

MI_S32 MI_ISP_AF_GetHwSource(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwSourceType_e *data);

3.120. MI_ISP_AF_HwPrefilter结构体¶

3.120.1. 类型结构体（Type Structure）

说明

设定AF filter pre-filter系数。

定义

typedef struct MI_ISP_AF_HwPrefilterType_s
{
    MI_U8 u8IIR1En;
    MI_U8 u8IIR1Cor;
    MI_U8 u8IIR1Hor;
    MI_U8 u8IIR1Vert;
    MI_U8 u8IIR1Cent;
    MI_U8 u8IIR1Div;
    MI_U8 u8IIR2En;
    MI_U8 u8IIR2Cor;
    MI_U8 u8IIR2Hor;
    MI_U8 u8IIR2Vert;
    MI_U8 u8IIR2Cent;
    MI_U8 u8IIR2Div;
} MI_ISP_AF_HwPrefilterType_t;

名称

变量名称	描述
u8IIR1En	IIR1使用PreFilter的开关。
u8IIR1Cor	IIR1设定周围对角方向，四个像素的比例。 0：* 0 1：* 1 2：* 2 3：* 4
u8IIR1Hor	IIR1设定周围水平方向，两个像素的比例。 0：* 0 1：* 1 2：* 2 3：* 4
u8IIR1Vert	IIR1设定周围垂直方向，两个像素的比例。 0：* 0 1：* 1 2：* 2 3：* 4
u8IIR1Cent	IIR1设定当前像素的比例。 0：* 1 1：* 2 2：* 4 3：* 8
u8IIR1Div	IIR1将上述像素结果累加起来，作除法的动作。 0：/ 8 1：/ 16 2：/ 32 3：/ 64
u8IIR2En	IIR2使用PreFilter的开关。
u8IIR2Cor	IIR2设定周围对角方向，四个像素的比例。 0：* 0 1：* 1 2：* 2 3：* 4
u8IIR2Hor	IIR2设定周围水平方向，两个像素的比例。 0：* 0 1：* 1 2：* 2 3：* 4
u8IIR2Vert	IIR2设定周围垂直方向，两个像素的比例。 0：* 0 1：* 1 2：* 2 3：* 4
u8IIR2Cent	IIR2设定当前像素的比例。 0：* 1 1：* 2 2：* 4 3：* 8
u8IIR2Div	IIR2将上述像素结果累加起来，作除法的动作。 0：/ 8 1：/ 16 2：/ 32 3：/ 64

注意事项

像素排列如下：

Cor Vert Cor

Hor Center Hor

Cor Vert Cor

则做以下动作：

Out = (u8Cor * (Cor+Cor+Cor+Cor) + u8Hor * (Hor+Hor) + u8Vert * (Vert+Ver) + u8Cent * (Cent)) / u8Div

相关结构类型与函式

MI_S32 MI_ISP_AF_SetHwPreFilter(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwPrefilterType_t *data);

MI_S32 MI_ISP_AF_GetHwPreFilter(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwPrefilterType_t *data);

3.121. MI_ISP_AF_HwYMap结构体¶

3.121.1. 类型结构体（Type Structure）

说明

设定AF filter y mapping系数。

定义

typedef struct MI_ISP_AF_HwYMapType_s
{
    MI_U8   u8YMapEn;
    MI_U8   u8YMapLumaSource;
    MI_U8   u8YMapX[AF_YMAP_X_NUM];
    MI_U16  u16YMapY[AF_YMAP_Y_NUM];
    MI_U8   u8LumaSrc;
} MI_ISP_AF_HwYMapType_t;

名称

变量名称	描述
u8YMapEn	YMap的开关。
u8YMapLumaSource	选择FIR/IIR统计值，是否经过YMap的效果 0：在YMap前 1：在YMap后
u8YMapX[AF_YMAP_X_NUM]	YMap的横轴，以二的幂次方累加，最后一点累加完需大于等于1023。AF_YMAP_X_NUM = 8。
u16YMapY[AF_YMAP_Y_NUM]	YMap的纵轴，0 ~ 1023。AF_YMAP_Y_NUM = 9。
u8LumaSrc	选择Luma统计值位置 0：在YMap前统计Luma 1：在YMap后统计Luma

注意事项

.ymap_x = {4, 4, 4, 4, 6, 7, 8, 9},

实际横轴为0、16、32、48、64、128、256、512、1024。

.ymap_y = {0, 72, 135, 183, 222, 340, 501, 722, 1023},

相关结构类型与函式

MI_S32 MI_ISP_AF_SetHwYMap(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwYMapType_t *data);

MI_S32 MI_ISP_AF_GetHwYMap(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwYMapType_t *data);

3.122. MI_ISP_AF_HwLdg结构体¶

3.122.1. 类型结构体（Type Structure）

说明

设定AF filter LDG系数。

定义

typedef struct MI_ISP_AF_HwLdgType_s

{

    MI_U8  u8IIR1En;

    MI_U8  u8IIR2En;

    MI_U8  u8FIRHEn;

    MI_U8  u8FIRVEn;

    MI_U16  u16IIRCurveX[AF_LDG_LUT_NUM];

    MI_U8  u8IIRCurveY[AF_LDG_LUT_NUM];

    MI_U16  u16FIRCurveX[AF_LDG_LUT_NUM];

    MI_U8  u8FIRCurveY[AF_LDG_LUT_NUM];

} MI_ISP_AF_HwLdgType_t;

名称

变量名称	描述
u8IIR1En	IIR1使用LDG功能的开关。
u8IIR2En	IIR2使用LDG功能的开关。
u8FIRHEn	FIRH使用LDG功能的开关。
u8FIRVEn	FIRV使用LDG功能的开关。
u16IIRCurveX[AF_LDG_LUT_NUM]	IIR LDG横轴，输入为亮度值，0 ~ 1023。 AF_LDG_LUT_NUM = 6。
u8IIRCurveY[AF_LDG_LUT_NUM]	IIR LDG纵轴，输出为统计值比例，0 ~ 255，255代表不衰减。 AF_LDG_LUT_NUM = 6。
u16FIRCurveX[AF_LDG_LUT_NUM]	FIR LDG横轴，输入为亮度值，0 ~ 1023。 AF_LDG_LUT_NUM = 6。
u8FIRCurveY[AF_LDG_LUT_NUM]	FIR LDG纵轴，输出为统计值比例，0 ~ 255，255代表不衰减。 AF_LDG_LUT_NUM = 6。

注意事项

.curve_x = {0, 300, 1023, 1023, 1023, 1023},

.curve_y = {255, 255, 40, 40, 40, 40},

此设定，针对亮度300以上的统计值，开始递减，到亮度1023时，递减为40/255=0.156左右。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetHwLdg(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwLdgType_t *data);

MI_S32 MI_ISP_AF_GetHwLdg(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwLdgType_t *data);

3.123. MI_ISP_AF_HwPeakMode结构体¶

3.123.1. 类型结构体（Type Structure）

说明

设定AF filter peak mode系数。

定义

typedef struct MI_ISP_AF_HwPeakModeType_s

{

    MI_U8  u8IIR1En;

    MI_U8  u8IIR2En;

    MI_U8  u8SubSample;

    MI_U8  u8Overlap;

} MI_ISP_AF_HwPeakModeType_t;

名称

变量名称	描述
u8IIR1En	IIR1使用peak mode功能的开关。
u8IIR2En	IIR2使用peak mode功能的开关。
u8SubSample	间隔多少个像素取值，0 ~ 31。
u8Overlap	当前像素扩大为（2n+1）像素做取值，0 ~ 7。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetHwPeakMode(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwPeakModeType_t *data);

MI_S32 MI_ISP_AF_GetHwPeakMode(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_HwPeakModeType_t *data);

3.124. MI_ISP_AF_Attr结构体¶

3.124.1. 类型结构体（Type Structure）

说明

设定AF属性的类型结构体。

定义

typedef struct MI_ISP_AF_AttrType_s
{
    MI_ISP_AF_SmStateType_e eState;
    MI_ISP_AF_OpType_e          eType;
    MI_U16                  u16ManualMotorPos;
    MI_ISP_AF_AlgoType_e        eAlgo;
} MI_ISP_AF_AttrType_t;

名称

变量名称	描述
eState	设定AF属性功能的工作模式。正常：E_SS_AF_STATE_NORMAL = 0。暂停：E_SS_AF_STATE_PAUSE = 1。
eType	设定AF属性的工作模式。自动模式：E_SS_AF_OP_TYP_AUTO = 0。手动模式：E_SS_AF_OP_TYP_MANUAL = 1。
u16ManualMotorPos	设定AF属性的手动模式属性结构体，值域0 ~ 1023。
eAlgo	自动对焦算法类型设定，共有以下两种选择：1. OneShot, 2. Continuous

相关结构类型与函式

MI_S32 MI_ISP_AF_SetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_AttrType_t *data);

MI_S32 MI_ISP_AF_GetAttr(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_AttrType_t *data);

3.125. MI_ISP_AF_Motor结构体¶

3.125.1. 类型结构体（Type Structure）

说明

设定AF motor结构体。

定义

typedef struct MI_ISP_AF_MotorType_s

{

    MI_U16 u16MinMotorPos;

    MI_U16 u16MaxMotorPos;

    MI_U16 u16MinMotorStep;

    MI_U16 u16MaxMotorStep;

} MI_ISP_AF_MotorType_t;

名称

变量名称	描述
u16MinMotorPos	Motor可移动到的最小位置，值域0 ~ 1023。
u16MaxMotorPos	Motor可移动到的最大位置，值域0 ~ 1023。
u16MinMotorStep	Motor在一帧的时间内，可移动的最小步伐，值域0 ~ 1023。
u16MaxMotorStep	Motor在一帧的时间内，可移动的最大步伐，值域0 ~ 1023。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetMotor(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_MotorType_t *data);

MI_S32 MI_ISP_AF_GetMotor(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_MotorType_t *data);

3.126. MI_ISP_AF_AccWeight结构体¶

3.126.1. 类型结构体（Type Structure）

说明

设定AF acc weight结构体。

定义

typedef struct MI_ISP_AF_AccWeightType_s
{
    MI_U8               u8WinNumX;
    MI_U8               u8WinNumY;
    MI_ISP_AF_bool_e    bEqualWinWgt;
    MI_U8           u8WinWgt[MI_ISP_AF_WIN_CNT];
    MI_ISP_AF_bool_e    bIIRHBlendEn;
    MI_U8               u8IIRHWgt_FirstBlendIIRL;
    MI_U8               u8IIRHWgt_SecondBlendSBLV;
    MI_U8           u8IIRHWgt_ThirdBlendSBLH;
} MI_ISP_AF_AccWeightType_t;

名称

变量名称	描述
u8WinNumX	X方向window总数，值域1 ~ 16。
u8WinNumY	Y方向window总数，值域1 ~ 16。
bEqualWinWgt	统计值等权重开关，值域0 ~ 1。
u8WinWgt[MI_ISP_AF_WIN_CNT]	统计值权重表，只有在EqualWinWgtEn为false时才有效果，值域0 ~ 255。MI_ISP_AF_WIN_CNT = 256。
bIIRHBlendEn	IIRH混合开关，并依照下列三个值来做混和，值域0 ~ 1
u8IIRHWgt_FirstBlendIIRL	IIRH最先跟IIRL做混合，此值为IIRH比例，值域0 ~ 255。
u8IIRHWgt_SecondBlendSBLV	IIRH再次跟SobelV做混合，此值为IIRH比例，值域0 ~ 255。
u8IIRHWgt_ThirdBlendSBLH	IIRH最后跟SobelH做混合，此值为IIRH比例，值域0 ~ 255。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetAccWeight(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_AccWeightType_t *data);

MI_S32 MI_ISP_AF_GetAccWeight(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_AccWeightType_t *data);

3.127. MI_ISP_AF_OneShot结构体¶

3.127.1. 类型结构体（Type Structure）

说明

设定AF OneShot结构体，只有在Algo为OneShot时才有效果。

定义

typedef struct MI_ISP_AF_OneShotType_s

{

    MI_ISP_AF_AccSelType_e eAccSel;

    MI_U16       u16MotorStep;

} MI_ISP_AF_OneShotType_t;

名称

变量名称 描述

eAccSel 统计值种类，值域0 ~ 3。

u16MotorStep 每一帧Motor的移动步伐，值域0 ~ 1023。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetOneShot(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_OneShotType_t *data);

MI_S32 MI_ISP_AF_GetOneShot(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_OneShotType_t *data);

3.128. MI_ISP_AF_SceneChange结构体¶

3.128.1. 类型结构体（Type Structure）

说明

设定AF Scene Change结构体，只有在Algo为Continuous时才有效果。

定义

typedef struct MI_ISP_AF_SceneChangeType_s
{
    MI_ISP_AF_AccSelType_e  ePreAfAccSel;
    MI_U8                   u8PreAeAccDiffThOft;
    MI_U8                   u8PreAeAccDiffThSlp;
    MI_U8                   u8PreAeAccCntThOft;
    MI_U8                   u8PreAeAccCntThSlp;
    MI_U8                   u8PreAfAccDiffThOft;
    MI_U8                   u8PreAfAccDiffThSlp;
    MI_U8                   u8PreAfAccCntThOft;
    MI_U8                   u8PreAfAccCntThSlp;
    MI_ISP_AF_AccSelType_e  eFocusAfAccSel;
    MI_U8                   u8FocusAeAccDiffTh;
    MI_U8                   u8FocusAeAccCntTh;
    MI_U8                   u8FocusAfAccDiffTh;
    MI_U8                   u8FocusAfAccCntTh;
    MI_U8                   u8StableCntTh;
} MI_ISP_AF_SceneChangeType_t;

名称

变量名称	描述
ePreAfAccSel	统计值种类，依照跟前一帧统计值的差异来判断环境是否改变，值域0 ~ 3。
u8PreAeAccDiffThOft	统计值Luma差异比例阀值，会统计超过此阀值的总数，值域0 ~ 100。
u8PreAeAccDiffThSlp	统计值Luma差异比例阀值斜率，可以依据motor step来增大阀值，值域0 ~ 100。
u8PreAeAccCntThOft	统计值Luma总数比例阀值，若大于此阀值，则判断为不稳定，值域0 ~ 100。
u8PreAeAccCntThSlp	统计值Luma总数比例阀值斜率，可以依据motor step来增大阀值，值域0 ~ 100。
u8PreAfAccDiffThOft	统计值（PreAccSel）差异比例阀值，会统计超过此阀值的总数，值域0 ~ 100。
u8PreAfAccDiffThSlp	统计值（PreAccSel）差异比例阀值斜率，可以依据motor step来增大阀值，值域0 ~ 100。
u8PreAfAccCntThOft	统计值（PreAccSel）总数比例阀值，若大于此阀值，则判断为不稳定，值域0 ~ 100。
u8PreAfAccCntThSlp	统计值（PreAccSel）总数比例阀值斜率，可以依据motor step来增大阀值，值域0 ~ 100。
eFocusAfAccSel	统计值种类，依照跟前一次收敛结束的统计值的差异来判断环境是否改变，值域0 ~ 3。
u8FocusAeAccDiffTh	统计值Luma差异比例阀值，会统计超过此阀值的总数，值域0 ~ 100。
u8FocusAeAccCntTh	统计值Luma总数比例阀值，若大于此阀值，则判断为不稳定，值域0 ~ 100。
u8FocusAfAccDiffTh	统计值（FocusAccSel）差异比例阀值，会统计超过此阀值的总数，值域0 ~ 100。
u8FocusAfAccCntTh	统计值（FocusAccSel）总数比例阀值，若大于此阀值，则判断为不稳定，值域0 ~ 100。
u8StableCntTh	连续稳定帧数阀值，超过此值则判断为环境已经稳定，开始移动马达来进行对焦，值域0 ~ 255。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetSceneChange(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_SceneChangeType_t *data);

MI_S32 MI_ISP_AF_GetSceneChange(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_SceneChangeType_t *data);

3.129. MI_ISP_AF_SearchStart结构体¶

3.129.1. 类型结构体（Type Structure）

说明

设定AF Search Start结构体，只有在Algo为Continuous时才有效果。

定义

typedef struct MI_ISP_AF_SearchStartType_s
{
    MI_U16              u16SearchMotorStep
    MI_U16              u16SearchMotorDirByPosTh;
    MI_ISP_AF_AccSelType_e  eSearchAccSel;
} MI_ISP_AF_SearchStartType_t;

名称

变量名称	描述
u16SearchMotorStep	每一帧Motor的移动步伐，值域0 ~ 1023。
u16SearchMotorDirByPosTh	依据当前Motor位置来决定移动方向，若大于此值，则往位置较小处移动，反之亦然，值域0 ~ 1023。
eSearchAccSel	统计值种类，值域0 ~ 3。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetSearchStart(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_SearchStartType_t *data);

MI_S32 MI_ISP_AF_GetSearchStart(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_SearchStartType_t *data);

3.130. MI_ISP_AF_Search结构体¶

3.130.1. 类型结构体（Type Structure）

说明

设定AF Search结构体，只有在Algo为Continuous时才有效果。

定义

typedef struct MI_ISP_AF_SearchType_s

{

    MI_U8    u8MinMaxAccRatioPeakThOft;

    MI_U8    u8MinMaxAccRatioPeakThSlp;

    MI_U8    u8AccDecCntPeakTh;

    MI_U8    u8NowFakeMaxAccRatioPeakTh;

    MI_U8    u8AccDecCntWrongDirTh;

    MI_U8    u8NowFakeMaxAccRatioWrongDirTh;

} MI_ISP_AF_SearchType_t;

名称

变量名称	描述
u8MinMaxAccRatioPeakThOft	最小最大统计值差异比例阀值，用来判断peak，值域0 ~ 100。
u8MinMaxAccRatioPeakThSlp	最小最大统计值差异比例阀值斜率，可以依据经过总路径来降低阀值，值域0 ~ 100。
u8AccDecCntPeakTh	统计值连续下降次数阀值，用来判断peak，值域0 ~ 255。
u8NowFakeMaxAccRatioPeakTh	统计值下降比例阀值，用来判断peak，值域0 ~ 100。
u8AccDecCntWrongDirTh	统计值连续下降次数阀值，用来判断是否走错方向，值域0 ~ 255。
u8NowFakeMaxAccRatioWrongDirTh	统计值连续下降次数阀值，用来判断是否走错方向，值域0 ~ 100。

相关结构类型与函式

MI_S32 MI_ISP_AF_SetSearch(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_SearchType_t *data);

MI_S32 MI_ISP_AF_GetSearch(MI_U32 DevId, MI_U32 Channel, 
MI_ISP_AF_SearchType_t *data);

3.131. MI_ISP_AF_VerInfo结构体¶

3.131.1. 类型结构体（Type Structure）

说明

AF Version Information结构体。

定义

typedef struct MI_ISP_AF_VerInfoType_s
{
    MI_U32  u32ReleaseDate;
    MI_U32  u32ReportID;
    MI_U8   u8Major;
    MI_U8   u8Minor;
    MI_U8   u8TestVer;
} MI_ISP_AF_VerInfoType_t;

名称

变量名称	描述
u32ReleaseDate	打印AF FW更新日期。
u32ReportID	打印AF FW反馈问题的数值编号，default：0。
u8Major	打印AF FW主要版本编号。
u8Minor	打印AF FW次要版本编号。
u8TestVer	打印AF FW测试版本编号，default：0。

相关结构类型与函式

MI_S32 MI_ISP_AF_GetVersionInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_VerInfoType_t *data);

4. 错误码¶

参数名称	数值	描述
MI_ISP_IQ_OK	0	成功。
MI_ISP_IQ_ERR_NOT_SUPPORT	0xA0212201	此芯片不支持。
MI_ISP_IQ_ERR_NULL_POINTER	0xA0212202	指标为空。
MI_ISP_IQ_ERR_3A_FAIL	0xA0212203	3A错误。
MI_ISP_IQ_ERR_OUT_OF_ARRAY	0xA0212204	超出矩阵大小。
MI_ISP_IQ_ERR_BUFFER_TOO_SMALL	0xA0212205	缓冲过小。
MI_ISP_IQ_ERR_EMPTY_VARIABLE	0xA0212206	变数为空。
MI_ISP_IQ_ERR_CALIB_VERSION_FAIL	0xA0212207	Calib 版本错误。
MI_ISP_IQ_ERR_API_STRUCTURE_SIZE_NOT_MATCH	0xA0212208	结构体大小不合。
MI_ISP_IQ_ERR_API_NOT_FOUND	0xA0212209	无此API。

参数名称	描述
DevId	ISP设备号（目前chip设置为为0）。
Channel	影像输入的信道号（一般为0）。
*data	曝光策略参数值的指针。

变量名称	描述
E_SS_IQ_FALSE	布尔值等于0。
E_SS_IQ_TRUE	布尔值等于1。
E_SS_IQ_BOOL_MAX	判断布尔值列举列表的最大值。

变量名称	描述
E_SS_IQ_OP_TYP_AUTO	自动工作模式。
E_SS_IQ_OP_TYP_MANUAL	手动工作模式。
E_SS_IQ_OP_TYP_MODE_MAX	判断工作模式列举列表的最大值。

变量名称	描述
bEnable	设定色彩转换功能的布尔值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
stManual	设定色彩转换的手动模式属性结构体。

变量名称	描述
bEnable	设定色彩转换功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stManual	设定色彩转换的手动模式属性结构体。

变量名称	描述
bEnable	设定PFC_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stManual	设定PFC_EX的手动模式属性结构体。

变量名称	描述
bEnable	设定HDR_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stManual	设定HDR_EX的手动模式属性结构体。

变量名称	描述
bEnable	设定NR3D_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stManual	设定NR3D_EX的手动模式属性结构体。

变量名称	描述
E_SS_AE_FALSE	布尔值等于0。
E_SS_AE_TRUE	布尔值等于1。
E_SS_AE_BOOL_MAX	判断布尔值列举列表的最大值。

变量名称	描述
E_SS_AE_OP_TYP_AUTO	自动工作模式。
E_SS_AE_OP_TYP_MANUAL	手动工作模式。
E_SS_AE_OP_TYP_MODE_MAX	判断工作模式列举列表的最大值。

参数名称	描述
MI_ISP_OK	成功。
MI_ISP_FAILURE	失败。

参数名称	描述
MI_ISP_OK	成功。
MI_ISP_FAILURE	失败。

参数名称	描述
MI_ISP_OK	成功。
MI_ISP_FAILURE	失败。

参数名称	描述
MI_ISP_OK	成功。
MI_ISP_FAILURE	失败。

变量名称	描述
E_SS_AE_STATE_NORMAL	正常模式。
E_SS_AE_STATE_PAUSE	暂停模式。
E_SS_AE_STATE_MAX	判断状态机列举清单的最大值。

变量名称	描述
s32EV	额外的增减曝光能量的分子。值域范围：-10 ~ 10。
u32Grad	额外的增减曝光能量的分母。值域范围：1 ~ 10。

变量名称	描述
stConvThrd	设定自动曝光启动收敛或判断收敛完成的区间。
stConvSpeed	设定自动曝光的收敛速度。

变量名称	描述
u32NumPoints	曝光行程表的节点数。值域范围：1 ~ 16。
stExpoTbl[MI_ISP_AE_LUT_16]	曝光行程表的节点参数数据。 MI_ISP_AE_LUT_16 = 16。

变量名称	描述
E_SS_AE_WEIGHT_AVERAGE	切换至平均测光的权重表
E_SS_AE_WEIGHT_CENTER	切换至中央测光的权重表
E_SS_AE_WEIGHT_SPOT	切换至点状测光的权重表

变量名称	描述
E_SS_AE_FLICKER_TYPE_DETECT_60HZ	设定侦测抗闪烁环境为60Hz。
E_SS_AE_FLICKER_TYPE_DETECT_50HZ	设定侦测抗闪烁环境为50Hz。

变量名称	描述
E_SS_AE_STRATEGY_EX_BRIGHTTONE	亮阶优先（过曝抑制）。
E_SS_AE_STRATEGY_EX_DARKTONE	暗阶优先（过暗抑制）。

变量名称	描述
bEnable	PowerLine Flicker功能开关。
u16Ratio	调整PowerLine的补偿倍率，值域范围 : 0 ~ 1024 (128 = 1x)。

变量名称	描述
E_SS_AWB_FALSE	布尔值等于0。
E_SS_AWB_TRUE	布尔值等于1。
E_SS_AWB_BOOL_MAX	判断布尔值列举列表的最大值。

变量名称	描述
E_SS_AWB_OP_TYP_AUTO	自动工作模式。
E_SS_AWB_OP_TYP_MANUAL	手动工作模式。
E_SS_AWB_OP_TYP_MODE_MAX	判断工作模式列举列表的最大值。

变量名称	描述
E_SS_AWB_STATE_NORMAL	正常模式。
E_SS_AWB_STATE_PAUSE	暂停模式。
E_SS_AWB_STATE_MAX	判断状态机列举清单的最大值。

变量名称	描述
uAvgR	个别统计值的R平均值。值域0~255。
uAvgG	个别统计值的G平均值。值域0~255。
uAvgB	个别统计值的B平均值。值域0~255。

变量名称	描述
u16StartIdx	亮区开始索引。
u16EndIdx	亮区结束索引。
u16CtParams[MI_ISP_AWB_CT_CALI_CNT]	色温cali参数。MI_ISP_AWB_CT_CALI_CNT = 40。

变量名称	描述
E_SS_AF_FALSE	布尔值等于0。
E_SS_AF_TRUE	布尔值等于1。
E_SS_AF_BOOL_MAX	判断布尔值列举列表的最大值。

变量名称	描述
E_SS_AF_OP_TYP_AUTO	自动工作模式。
E_SS_AF_OP_TYP_MANUAL	手动工作模式。
E_SS_AF_OP_TYP_MODE_MAX	判断工作模式列举列表的最大值。

变量名称	描述
E_SS_AF_STATE_NORMAL	正常模式。
E_SS_AF_STATE_PAUSE	暂停模式。
E_SS_AF_STATE_MAX	判断状态机列举清单的最大值。

变量名称	描述
bIsStable	获取目前AF是否在收敛状态。
u16CurMotorPos	获取目前Motor位置。

变量名称	描述
u8BnrEn	Bayer降噪开关，值域0 ~ 1。
u8FilterStr	Bayer降噪强度，值域范围：0 ~ 63，值越大则NR越强。

变量名称	描述
u8R	Bayer to Y的R channel比例（0~255）。
u8G	Bayer to Y的G channel比例（0~255）。
u8B	Bayer to Y的B channel比例（0~255）。

变量名称	描述
eAccSel	统计值种类，值域0 ~ 3。
u16MotorStep	每一帧Motor的移动步伐，值域0 ~ 1023。