ISP软件开发参考

REVISION HISTORY¶

Revision No.	Description	Date
1.0 (API Ver. 1.0)	Initial release	03/27/2024
1.1 (API Ver. 1.0)	Added description of AlscAdj	05/29/2024

概述¶

模块说明¶

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

流程框图¶

ISP Block Diagram

关键词说明¶

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缩写。
WDR

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

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_SetNrLumaAdv

MI_ISP_IQ_SetNrChromaPre

MI_ISP_IQ_SetNrChromaAdv

MI_ISP_IQ_SetDarkShading

MI_ISP_IQ_SetPfc

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。

MI ISP API参考¶

MI_ISP_IQ_GetVersionInfo¶

目的

取得IQ版本号信息。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetVersionInfo¶

目的

设定IQ版本号信息。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetParaInitStatus¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*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;

}

}

MI_ISP_IQ_SetColorToGray¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetColorToGray¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetContrast¶

目的

设定对比度参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetContrast¶

目的

取得对比度参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetBrightness¶

目的

设定亮度参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetBrightness¶

目的

取得亮度参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetLightness¶

目的

设定灰度参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetLightness¶

目的

取得灰度参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetSaturation¶

目的

设定饱和度参数值。
语法

MI_S32 MI_ISP_IQ_SetSaturation(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_YuvGammaType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetSaturation¶

目的

取得饱和度参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetDefog¶

目的

设定Defog参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetDefog¶

目的

取得Defog参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetRgbMatrix¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetRgbMatrix¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetFalseColor¶

目的

设定去伪彩参数值。
语法

MI_S32 MI_ISP_IQ_SetFalseColor(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_FalseColorType_t
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetFalseColor¶

目的

取得去伪彩参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetNr3d¶

目的

设定3D降噪参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetNr3d¶

目的

取得3D降噪参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetNrDeSpike¶

目的

设定DeSpike降噪参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetNrDeSpike¶

目的

取得DeSpike降噪参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetSharpness¶

目的

设定锐度参数值。
语法

MI_S32 MI_ISP_IQ_SetSharpness(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SharpnessType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetSharpness¶

目的

取得锐度参数值。
语法

MI_S32 MI_ISP_IQ_GetSharpness(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SharpnessType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetShpEx¶

目的

设定锐度参数值。
语法

MI_S32 MI_ISP_IQ_SetShpEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SharpnessExType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetShpEx¶

目的

取得锐度参数值。
语法

MI_S32 MI_ISP_IQ_GetShpEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SharpnessExType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetCrossTalk¶

目的

设定串扰参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetCrossTalk¶

目的

取得串扰参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetDobc¶

目的

设定Dobc参数值。
语法

MI_S32 MI_ISP_IQ_SetDobc(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DobcType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetDobc¶

目的

取得Dobc参数值。
语法

MI_S32 MI_ISP_IQ_GetDobc(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DobcType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetWdr¶

目的

设定宽动态参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetWdr¶

目的

取得宽动态参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetWdrNr¶

目的

设定宽动态降噪参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetWdrNr¶

目的

取得宽动态降噪参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetWdrCurveFull¶

目的

设定WDRCurveFull参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetWdrCurveFull¶

目的

取得WDRCurveFull参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetDynamicDp¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetDynamicDp¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetDynamicDpCluster¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetDynamicDpCluster¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetHsv¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetHsv¶

目的

取得HSV参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetDarkFrame¶

目的

设定DarkFrame参数值。
语法

MI_S32 MI_ISP_IQ_SetDarkFrame(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DarkFrameType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetDarkFrame¶

目的

取得DarkFrame参数值。
语法

MI_S32 MI_ISP_IQ_GetDarkFrame (MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DarkFrameType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetPfc¶

目的

设定PFC参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetPfc¶

目的

取得PFC参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetDemosaic¶

目的

设定去马赛克参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetDemosaic¶

目的

取得去马赛克参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetR2Y¶

目的

设定色彩转换参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetR2Y¶

目的

取得色彩转换参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetColorTrans¶

目的

设定色彩转换参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetColorTrans¶

目的

取得色彩转换参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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设备号。

Channel 影像输入的信道号。

*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则失效。
举例

无。

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设备号。

Channel 影像输入的信道号。

*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则失效。
举例

无。

MI_ISP_IQ_SetLsc¶

目的

设定LSC参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetLsc¶

目的

取得LSC参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetLscCtrl¶

目的

设定LSC CTRL参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetLscCtrl¶

目的

取得LSC CTRL参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetAlsc¶

目的

设定ALSC参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetAlsc¶

目的

取得ALSC参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetAlscCtrl¶

目的

设定ALSC CTRL参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetAlscCtrl¶

目的

取得ALSC CTRL参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetAlscAdj¶

目的

设定ALSC ADJ参数值。
语法

MI_S32 MI_ISP_IQ_SetAlscAdj(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_AlscAdjType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetAlscAdj¶

目的

取得ALSC ADJ参数值。
语法

MI_S32 MI_ISP_IQ_GetAlscAdj(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_AlscAdjType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetDarkShading¶

目的

设定Dark Shading参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetDarkShading¶

目的

取得Dark Shading参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetNrLumaAdv¶

目的

设定NRLuma_Adv参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetNrLumaAdv¶

目的

取得NRLuma_Adv参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetNrChromaAdv¶

目的

设定NRChroma_Adv参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetNrChromaAdv¶

目的

取得NRChroma_Adv参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetNrChromaPre¶

目的

设定NRChroma_Pre参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetNrChromaPre¶

目的

取得NRChroma_Pre参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetDummy¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetDummy¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetDummyEx¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetDummyEx¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetIqInd¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_QueryCcmInfo¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetAdaptiveGamma¶

目的

设定Adaptive Gamma curve参数值。此功能需搭配StrategyEx，让Gamma可以根据AE SceneTarget做动态的调整，以达到增加动态范围的效果。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

MI_ISP_IQ_SetTemp¶

目的

设定Temperature参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetTemp¶

目的

取得Temperature参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetTempInfo¶

目的

取得 Temperature Info参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetDayNightDetection¶

目的

设定Day/Night侦测数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetDayNightDetection¶

目的

取得Day/Night侦测数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_QueryDayNightInfo¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_QueryExposureInfo¶

目的

取得自动曝光参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetHistoWghtY¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetEvComp¶

目的

设定曝光补偿参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetEvComp¶

目的

取得曝光补偿参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetExpoMode¶

目的

设定曝光模式参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetExpoMode¶

目的

取得曝光模式参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetManualExpo¶

目的

设定手动曝光参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetManualExpo¶

目的

取得手动曝光参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetManualShortExpo¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetManualShortExpo¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetManualVeryShortExpo¶

目的

设定手动极短曝(very short)曝光参数值。
语法

MI_S32 MI_ISP_AE_SetManualVeryShortExpo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoValueType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 手动极短曝(very short)曝光参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetManualVeryShortExpo¶

目的

取得手动极短曝(very short)曝光参数值。
语法

MI_S32 MI_ISP_AE_GetManualVeryShortExpo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoValueType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 手动极短曝(very short)曝光参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetState¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetState¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetConverge¶

目的

设定曝光收敛参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetConverge¶

目的

取得曝光收敛参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetExposureLimit¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetExposureLimit¶

目的

取得自动曝光变化范围限制参数值。
语法

MI_S32 MI_ISP_AE_GetExposureLimit(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoLimitType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetPlainLongExpoTable¶

目的

设定长曝曝光表参数值。
语法

MI_S32 MI_ISP_AE_SetPlainLongExpoTable(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 长曝曝光表参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetPlainLongExpoTable¶

目的

取得长曝曝光表参数值。
语法

MI_S32 MI_ISP_AE_GetPlainLongExpoTable(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 长曝曝光表参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetWinWgtType¶

目的

设定曝光权重表种类参数值。
语法

MI_S32 MI_ISP_AE_SetWinWgtType(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_WinWeightModeType_e *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 曝光权重表种类参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetWinWgtType¶

目的

取得曝光权重表种类参数值。
语法

MI_S32 MI_ISP_AE_GetWinWgtType(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_WinWeightModeType_e *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 曝光权重表种类参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetWinWgt¶

目的

设定曝光权重表参数值。
语法

MI_S32 MI_ISP_AE_SetWinWgt(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_WinWeightType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 曝光权重表参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetWinWgt¶

目的

取得曝光权重表参数值。
语法

MI_S32 MI_ISP_AE_GetWinWgt(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_WinWeightType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 曝光权重表参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetFlicker¶

目的

设定抗闪烁参数值，支持50Hz和60Hz抗闪烁。
语法

MI_S32 MI_ISP_AE_SetFlicker(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FlickerType_e *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 抗闪烁参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

支持50Hz和60Hz抗闪烁。
举例

无。

MI_ISP_AE_GetFlicker¶

目的

取得抗闪烁参数值，支持50Hz和60Hz抗闪烁。
语法

MI_S32 MI_ISP_AE_GetFlicker(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FlickerType_e *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 抗闪烁参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetFlickerEx¶

目的

设定侦测抗闪烁参数值，支持50Hz和60Hz抗闪烁。
语法

MI_S32 MI_ISP_AE_SetFlickerEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FlickerExType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 侦测抗闪烁参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

支持50Hz和60Hz抗闪烁。
举例

无。

MI_ISP_AE_GetFlickerEx¶

目的

取得侦测抗闪烁参数值，支持50Hz和60Hz抗闪烁。
语法

MI_S32 MI_ISP_AE_GetFlickerEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FlickerExType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 侦测抗闪烁参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_QueryFlickerInfo¶

目的

取得抗闪烁参数值的相关信息，分别为抗闪烁的有效状态、抗闪烁模式（50/60Hz）、抗闪烁模式的有效分数。
语法

MI_S32 MI_ISP_AE_QueryFlickerInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FlickerExInfoType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 侦测抗闪烁相关参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetStrategy¶

目的

设定曝光策略参数值。
语法

MI_S32 MI_ISP_AE_SetStrategy(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetStrategy¶

目的

取得曝光策略参数值。
语法

MI_S32 MI_ISP_AE_GetStrategy(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyType_t
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetStrategyEx¶

目的

设定曝光策略参数值。
语法

MI_S32 MI_ISP_AE_SetStrategyEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyExType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetStrategyEx¶

目的

取得曝光策略参数值。
语法

MI_S32 MI_ISP_AE_GetStrategyEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyExType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetStrategyExAdv¶

目的

设定HDR_Auto模式的曝光策略参数值。
语法

MI_S32 MI_ISP_AE_SetStrategyExAdv(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyExAdvType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_QueryStrategyExInfo¶

目的

取得曝光策略信息。
语法

MI_S32 MI_ISP_AE_QueryStrategyExInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyExInfoType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 曝光策略信息的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data RGB-IR mode曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data RGB-IR mode曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetHdr¶

目的

设定HDR mode曝光策略参数值。
语法

MI_S32 MI_ISP_AE_SetHdr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_HdrType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data HDR mode曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetHdr¶

目的

取得HDR mode曝光策略参数值。
语法

MI_S32 MI_ISP_AE_GetHdr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_HdrType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data HDR mode曝光策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetStabilizer¶

目的

设置Stabilizer策略参数值。此功能可降低AE受画面局部变化的影响而被触发，让画面亮度更稳定。
语法

MI_S32 MI_ISP_AE_SetStabilizer(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StabilizerType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data Stabilizer策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetStabilizer¶

目的

取得Stabilizer策略参数值。
语法

MI_S32 MI_ISP_AE_GetStabilizer(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StabilizerType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data Stabilizer策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data PowerLine Flicker参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetPowerLine¶

目的

取得PowerLine Flicker参数值。
语法

MI_S32 MI_ISP_AE_GetPowerLine(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_PowerLineType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data PowerLine Flicker参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_QueryPowerLineInfo¶

目的

取得PowerLine Flicker信息。
语法

MI_S32 MI_ISP_AE_QueryPowerLineInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_PowerLineInfoType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data PowerLine Flicker参数值的指标。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data Weight by luminance参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data Weight by luminance参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetHDRMLDynamicRatio¶

目的

设置ML - HDR dynamic ratio参数值。
语法

MI_S32 MI_ISP_AE_SetHDRMLDynamicRatio(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_HdrDynamicRatioType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data ML - HDR dynamic ratio参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetHDRMLDynamicRatio¶

目的

取得ML - HDR dynamic ratio参数值。
语法

MI_S32 MI_ISP_AE_GetHDRMLDynamicRatio(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_HdrDynamicRatioType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data ML - HDR dynamic ratio参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetHDRSMDynamicRatio¶

目的

设置SM - HDR dynamic ratio参数值。
语法

MI_S32 MI_ISP_AE_SetHDRSMDynamicRatio(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_HdrDynamicRatioType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data SM - HDR dynamic ratio参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetHDRSMDynamicRatio¶

目的

取得SM - HDR dynamic ratio参数值。
语法

MI_S32 MI_ISP_AE_GetHDRSMDynamicRatio(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_HdrDynamicRatioType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data SM - HDR dynamic ratio参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetExpoTableMode¶

目的

设置曝光表操作模式参数值。
语法

MI_S32 MI_ISP_AE_SetExpoTableMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableMode_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetExpoTableMode¶

目的

取得曝光表操作模式参数值。
语法

MI_S32 MI_ISP_AE_GetExpoTableMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableMode_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_QueryHDRDynamicRatioInfo¶

目的

取得HDR dynamic ratio信息参数值。
语法

MI_S32 MI_ISP_AE_QueryHDRDynamicRatioInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_QueryHdrDynamicRatioInfoType_t *data)
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data HDRDynamicRatio信息参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetVersionInfo¶

目的

取得AE版本信息参数值。
语法

MI_S32 MI_ISP_AE_GetVersionInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_VerInfoType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AE版本信息参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetStabilizerEx¶

目的

设置StabilizerEx策略参数值。此功能可降低AE受画面局部变化的影响而被触发，让画面亮度更稳定。
语法

MI_S32 MI_ISP_AE_SetStabilizerEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StabilizerExType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data StabilizerEx策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetStabilizerEx¶

目的

取得StabilizerEx策略参数值。
语法

MI_S32 MI_ISP_AE_GetStabilizerEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StabilizerExType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data StabilizerEx策略参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetConvergeSpeedEx¶

目的

设定曝光收敛参数值。
语法

MI_S32 MI_ISP_AE_SetConvergeSpeedEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ConvSpeed_Ex_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetConvergeSpeedEx¶

目的

取得曝光收敛参数值。
语法

MI_S32 MI_ISP_AE_GetConvergeSpeedEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ConvSpeed_Ex_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_QueryInfo¶

目的

取得自动白平衡参数值。
语法

MI_S32 MI_ISP_AWB_QueryInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_QueryInfoType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetCtStats¶

目的

取得自动白平衡校正统计值。
语法

MI_S32 MI_ISP_AWB_GetCtStats(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_CtStatisticsType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡校正统计值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetAttr¶

目的

设定自动白平衡属性参数值。
语法

MI_S32 MI_ISP_AWB_SetAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_AttrType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetAttr¶

目的

取得自动白平衡属性参数值。
语法

MI_S32 MI_ISP_AWB_GetAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_AttrType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetAttrEx¶

目的

设定自动白平衡增强属性参数值。
语法

MI_S32 MI_ISP_AWB_SetAttrEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_AttrExType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡增强属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

只有当MI_ISP_AWB_AttrParam_t中的eAlgType = SS_AWB_ALG_ADVANCE时，此函式设定的参数才会生效。
举例

无。

MI_ISP_AWB_GetAttrEx¶

目的

取得自动白平衡增强属性参数值。
语法

MI_S32 MI_ISP_AWB_GetAttrEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_AttrExType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡增强属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetMultiLsAttr¶

目的

设定自动白平衡混光偏校正参数值。
语法

MI_S32 MI_ISP_AWB_SetMultiLsAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_MultiLsType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡混光偏校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

只有当MI_ISP_AWB_AttrParam_t中的bWpWeightEnable = 1时，此函式设定的参数才会生效。
举例

无。

MI_ISP_AWB_GetMultiLsAttr¶

目的

取得自动白平衡混光偏校正参数值。
语法

MI_S32 MI_ISP_AWB_GetMultiLsAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_MultiLsType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡混光偏校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetCtCaliAttr¶

目的

设定自动白平衡校正参数值。
语法

MI_S32 MI_ISP_AWB_SetCtCaliAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_CtCaliType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetCtCaliAttr¶

目的

取得自动白平衡校正参数值。
语法

MI_S32 MI_ISP_AWB_GetCtCaliAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_CtCaliType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetCurCtCaliAttr¶

目的

取得自动白平衡套用校正数据后的色温框数据。
语法

MI_S32 MI_ISP_AWB_GetCurCtCaliAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_CurCtCaliType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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设备号。

Channel 影像输入的信道号。

*data 自动白平衡校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetCtMwbAttr¶

目的

取得手动色温白平衡的色温设定。
语法

MI_S32 MI_ISP_AWB_GetCtMwbAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_CtmwbParam_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 自动白平衡校正参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetStabilizer¶

目的

设定AWB stabilizer。当环境稳定下，却发现AWB一直不断被trigger，导致画面颜色不断来回变化时，建议可以开启此功能来让AWB变化更稳定。
语法

MI_S32 MI_ISP_AWB_SetStabilizer(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StabilizerType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AWB Stabilizer参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetStabilizer¶

目的

取得AWB stabilizer的设定。
语法

MI_S32 MI_ISP_AWB_GetStabilizer(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StabilizerType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AWB stabilizer参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetSpecialCase¶

目的

设定AWB SpecialCase。此功能提供用户使用三个条件定义case，并可决定case达成时AWB对应要的行为，用来提升特定场景AWB的准确性。总共可定义四种case，每种case的效果会迭加。
语法

MI_S32 MI_ISP_AWB_SetSpecialCase(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SpecialCaseType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AWB SpecialCase参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetSpecialCase¶

目的

取得AWB SpecialCase的设定。
语法

MI_S32 MI_ISP_AWB_GetSpecialCase(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SpecialCaseType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AWB SpecialCase参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_QuerySpecialCaseInfo¶

目的

取得AWB SpecialCase各项统计信息。
语法

MI_S32 MI_ISP_AWB_QuerySpecialCaseInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SpecialCaseInfoType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AWB QuerySpecialCase参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetStatisFilter¶

目的

设定AWB StatisFilter。此功能可根据BV设定统计值有效亮度区间来排除过暗或过亮的统计值，避免AWB受到noise或过曝区域影响。
语法

MI_S32 MI_ISP_AWB_SetStatisfilter(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StatisFilterType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AWB StatisFilter参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetStatisFilter¶

目的

取得AWB StatisFilter 的设定。
语法

MI_S32 MI_ISP_AWB_GetStatisFilter(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StatisFilterType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AWB StatisFilter参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetVersionInfo¶

目的

取得AWB版本信息参数值。
语法

MI_S32 MI_ISP_AWB_GetVersionInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_VerInfoType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AWB版本信息参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetFDAWBParam¶

目的

设定face detection AWB相关参数。此功能能让白平衡算法利用人脸侦测的信息，增加白平衡及肤色的准确性及稳定性。使用前须先确认已支持人脸侦测功能，若没有支持人脸侦测功能此API是无效的。
语法

MI_S32 MI_ISP_AWB_SetFDAWBParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_FdAwbParam_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetFDAWBParam¶

目的

取得FDAWB的设定。
语法

MI_S32 MI_ISP_AWB_GetFDAWBParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_FdAwbParam_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetFDAWBInfo¶

目的

使用者可以透过此API来读取当下FDAWB的相关信息。
语法

MI_S32 MI_ISP_AWB_GetFDAWBInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_FdAwbInfoType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetFewStatisStrategy¶

目的

设定AWB FewStatisStrategy参数。此功能提供用户三个选择，决定当统计值不足时AWB将采取的行为。
语法

MI_S32 MI_ISP_AWB_SetFewStatisStrategy(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_FwstStrategyParam_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetFewStatisStrategy¶

目的

取得FewStatisStrategy的设定。
语法

MI_S32 MI_ISP_AWB_GetFewStatisStrategy(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_FwstStrategyParam_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_QueryInfo¶

目的

取得AF参数值。
语法

MI_S32 MI_ISP_AF_QueryInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_QueryInfoType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF ROI mode属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetHwWin¶

目的

设定AF win。
语法

MI_S32 MI_ISP_AF_SetHwWin(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwWinType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF win属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetHwWin¶

目的

取得AF win。
语法

MI_S32 MI_ISP_AF_GetHwWin(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwWinType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF win属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetHwFilterAttr¶

目的

设定AF filter系数。
语法

MI_S32 MI_ISP_AF_SetHwFilterAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwFilterAttrType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetHwFilterAttr¶

目的

取得AF filter系数。
语法

MI_S32 MI_ISP_AF_GetHwFilterAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwFilterAttrType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter 属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter square属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter square属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetHwBnr¶

目的

设定AF Bayer降噪系数。
语法

MI_S32 MI_ISP_AF_SetHwBnr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwBnrType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*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时才有作用。
举例

无。

MI_ISP_AF_GetHwBnr¶

目的

取得AF Bayer降噪系数。
语法

MI_S32 MI_ISP_AF_GetHwBnr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwBnrType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*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时才有作用。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter Bayer to Y属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter Bayer to Y属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetHwSource¶

目的

设定AF filter抽取统计值位置。
语法

MI_S32 MI_ISP_AF_SetHwSource(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwSourceType_e *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter抽取统计值位置属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetHwSource¶

目的

取得AF filter抽取统计值位置。
语法

MI_S32 MI_ISP_AF_GetHwSource(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwSourceType_e *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter抽取统计值位置属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter pre-filter属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter pre-filter属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter y mapping属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter y mapping属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter ldg属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter ldg属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter peak mode属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF filter peak mode属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetAttr¶

目的

设定AF属性参数值。
语法

MI_S32 MI_ISP_AF_SetAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AttrType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetAttr¶

目的

取得AF属性参数值。
语法

MI_S32 MI_ISP_AF_GetAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AttrType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetMotor¶

目的

设定AF Motor属性参数值。
语法

MI_S32 MI_ISP_AF_SetMotor(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_MotorType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF Motor属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetMotor¶

目的

取得AF Motor属性参数值。
语法

MI_S32 MI_ISP_AF_GetMotor(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_MotorType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF Motor属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF Acc Weight属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF Acc Weight属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetOneShot¶

目的

设定AF OneShot属性参数值。
语法

MI_S32 MI_ISP_AF_SetOneShot(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_OneShotType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF OneShot属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetOneShot¶

目的

取得AF OneShot属性参数值。
语法

MI_S32 MI_ISP_AF_GetAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_OneShotType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF OneShot属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF Scene Change属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF Scene Change属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetSearchStart¶

目的

设定AF SearchStart属性参数值。
语法

MI_S32 MI_ISP_AF_SetSearchStart(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_SearchStartType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF SearchStart属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetSearchStart¶

目的

取得AF SearchStart属性参数值。
语法

MI_S32 MI_ISP_AF_GetAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_SearchStartType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF SearchStart属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetSearch¶

目的

设定AF Search属性参数值。
语法

MI_S32 MI_ISP_AF_SetSearch(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_SearchType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF Search属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetSearch¶

目的

取得AF Search属性参数值。
语法

MI_S32 MI_ISP_AF_GetSearch(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_SearchType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF Search属性参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetVersionInfo¶

目的

取得AF版本信息参数值。
语法

MI_S32 MI_ISP_AF_GetVersionInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_VerInfoType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data AF版本信息参数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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设备号。
Channel	影像输入的信道号。
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
注意

必须在ISP初始化、3A初始化状态为ready (1)时，才能进行load ISP API bin file。
- 取得ISP初始化ready状态：MI_ISP_IQ_GetParaInitStatus
- 取得3A初始化ready状态：CUS3A_GetAlgoStatus
举例

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所示。

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设备号。

Channel 影像输入的信道号。

eCaliItem 校正项目的列举结构体。

filepath 校正参数档案的路径位置。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI ISP API数据类型¶

MI_ISP_IQ_Bool结构体¶

列举结构体（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

MI_ISP_IQ_OpType结构体¶

列举结构体（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 判断工作模式列举列表的最大值。
注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_ParamMode结构体¶

列举结构体（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);

MI_ISP_IQ_BypassMode结构体¶

列举结构体（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);

MI_ISP_IQ_Index结构体¶

列举结构体（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);

MI_ISP_IQ_ApiId结构体¶

列举结构体（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);

MI_ISP_AF_AlgoType结构体¶

列举结构体（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

MI_ISP_AF_AccSelType结构体¶

列举结构体（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

MI_ISP_IQ_CaliItem结构体¶

列举结构体（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_FPN = 6,

E_SS_CALI_ITEM_NE = 7,

E_SS_CALI_ITEM_MAX,

} MI_ISP_IQ_CaliItem_e;

名称

变量名称	描述
E_SS_CALI_ITEM_AWB	白平衡补偿校正（SOUFFLE不支持）。
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	白平衡补偿校正（SOUFFLE只能使用此模式）。
E_SS_CALI_ITEM_FPN	Fixed Pattern Noise补偿校正。
E_SS_CALI_ITEM_NE	3DNR Noise 型态分析校正。
E_SS_CALI_ITEM_MAX	判断校正选项列举列表的最大值。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_ApiCmdLoadCaliData(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_CaliItem_e eCaliItem, char *filepath);

MI_ISP_IQ_VersionInfo结构体¶

类型结构体（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);

参数结构体（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

MI_ISP_IQ_ParamInitInfo结构体¶

类型结构体（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);

参数结构体（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

MI_ISP_IQ_IntpLut结构体¶

类型结构体（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);

MI_ISP_IQ_ColorToGray结构体¶

类型结构体（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);

MI_ISP_IQ_Contrast结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定对比度的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_ContrastManualAttr_s

{

MI_ISP_IQ_LevelBaseParam_t stParaAPI;

} MI_ISP_IQ_ContrastManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定对比度、亮度、灰度的参数结构体。
定义

typedef struct MI_ISP_IQ_LevelBaseParam_s

{

MI_U32 u32Lev;

} MI_ISP_IQ_LevelBaseParam_t;
名称

变量名称描述

u32Lev 设定对比度、亮度、灰度的可变强度数值。值域范围：0 ~ 100。
注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Brightness结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定亮度的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_BrightnessManualAttr_s

{

MI_ISP_IQ_LevelBaseParam_t stParaAPI;

} MI_ISP_IQ_BrightnessManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Lightness结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定灰度的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_LightnessManualAttr_s

{

MI_ISP_IQ_LevelBaseParam_t stParaAPI;

} MI_ISP_IQ_LightnessManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_RgbGamma结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（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 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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。
相关结构类型与函式

无。

MI_ISP_IQ_YuvGamma结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（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 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定YUV Gamma curve的参数结构体。
定义

typedef struct MI_ISP_IQ_YuvGammaParam_s

{

MI_U16 u16LutY[YUVGAMMA_Y_NUM];

MI_S16 s16LutU[YUVGAMMA_U_NUM];

MI_S16 s16LutV[YUVGAMMA_V_NUM];

} MI_ISP_IQ_YuvGammaParam_t;

名称

变量名称	描述
u16LutY[YUVGAMMA_Y_NUM]	Y通道分量。值域范围：0 ~ 1023。YUVGAMMA_Y_NUM = 256
s16LutU[YUVGAMMA_U_NUM]	U通道分量。值域范围：0 ~ 511。YUVGAMMA_U_NUM = 128
s16LutV[YUVGAMMA_V_NUM]	V通道分量。值域范围：0 ~ 511。YUVGAMMA_V_NUM = 128

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_AdaptiveGamma结构体¶

类型结构体（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);

MI_ISP_IQ_Saturation结构体¶

类型结构体（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_YuvGammaType_t *data);

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

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定饱和度的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_SaturationManualAttr_s

{

MI_ISP_IQ_SaturationParam_t stParaAPI;

} MI_ISP_IQ_SaturationManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_RgbMatrix结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。

注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（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表示为色彩校正的矩阵数值。
相关结构类型与函式

无。

参数结构体（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表示为色彩校正的矩阵数值。
相关结构类型与函式

无。

MI_ISP_IQ_CcmInfo结构体¶

类型结构体（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_Rsum u16CCM[4 ~ 7] → CCM10, CCM11, CCM12, CCM_Gsum u16CCM[8 ~ 11] → CCM20, CCM21, CCM22, CCM_Bsum
u16CCT	获取目前色温数值。

注意事项

无。
相关结构类型与函式

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

MI_ISP_IQ_FalseColor结构体¶

类型结构体（Type Structure）¶

说明

设定去伪彩的类型结构体。
定义

typedef struct MI_ISP_IQ_FalseColorType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_Bool_e bDbgEn;

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。
bDbgEn	Debug模式，值域范围：0 ~ 1，影像越亮则去伪彩强度越强。此debug模式和Demosiac的debug模式会有冲突，以最后呼叫的api为主。
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

MI_S32 MI_ISP_IQ_GetFalseColor(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_FalseColorType_t

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定去伪彩的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_FalseColorManualAttr_s

{

MI_ISP_IQ_FalseColorParam_t stParaAPI;

} MI_ISP_IQ_FalseColorManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定去伪彩的参数结构体。
定义

typedef struct MI_ISP_IQ_FalseColorParam_s

{

MI_U8 u8ColorSpaceSel;

MI_U8 u8Preserve;

MI_U8 u8Strength;

} MI_ISP_IQ_FalseColorParam_t;

名称

变量名称	描述
u8ColorSpaceSel	去伪彩模式，值域范围：0 ~ 1，0代表在RGB domain做灰，对齐G通道的值，1代表在yuv domain做灰，不会影响到亮度。
u8Preserve	边缘保护强度，值域范围：0 ~ 7，值越大则边缘区域越不容易被判断成moire区域，去伪彩强度越弱。
u8Strength	整体强度，值域范围：0 ~ 31，值越大则moire区域愈容易被降饱和度，去伪彩强度越强。

相关结构类型与函式

无。

MI_ISP_IQ_Nr3d结构体¶

类型结构体（Type Structure）¶

说明

设定3D降噪的类型结构体。
定义

typedef struct MI_ISP_IQ_Nr3dType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_Bool_e bDbgEn;

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。
bDbgEn	Debug模式，值域范围：0 ~ 1。影像颜色越黑则代表越被判断成动区。使用前务必将AE停掉。
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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定3D降噪的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_Nr3dManualAttr_s

{

MI_ISP_IQ_Nr3dParam_t stParaAPI;

} MI_ISP_IQ_Nr3dManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定3D降噪的参数结构体。
定义

typedef struct MI_ISP_IQ_Nr3dParam_s

{

MI_U8 u8TfStrY;

MI_U8 u8TfStrC;

MI_U8 u8MdThd;

MI_U8 u8MdSft;

MI_U16 u16MdGain;

MI_U16 u16MotEdgeRefineStr;

MI_U8 u8MdThdByY[NR3D_BY_Y_NUM];

MI_U8 u8MdGainByY[NR3D_BY_Y_NUM];

MI_U8 u8MdThdByMot[NR3D_BY_MOT];

MI_U8 u8MdGainByMot[NR3D_BY_Y_MOT];

MI_U16 u16M2SLut[NR3D_BY_MOT_NUM];

MI_U8 u8S2MLumaTh;

MI_U8 u8S2MLumaStep;

MI_U8 u8S2MLumaStr0;

MI_U8 u8S2MLumaStr1;

MI_U16 u16S2MMotTh;

MI_U8 u8S2MMotStep;

MI_U8 u8S2MMotStr0;

MI_U8 u8S2MMotStr1;

MI_U8 u8StillAreaEnhance;

MI_U8 u8M2SHistDelayByDiff[NR3D_BY_MOT_NUM];

MI_U8 u8TfLut[15];

MI_U8 u8MotShpBlendLut[NR3D_BY_MOT_NUM];

} MI_ISP_IQ_Nr3dParam_t;

名称

变量名称	描述
u8TfStrY	控制去Y noise的temporal denoise 强度，值域0 ~ 63，值越大denoise强度越强。
u8TfStrC	控制去color noise的temporal denoise 强度，值域0 ~ 15，值越大denoise强度越强。
u8MdThd	MD侦测，控制motion阀值，小于此阀值判断为静止物体，值越大3D降噪越强。值域范围：0 ~ 255。
u8MdSft	针对MdThd与MdGain的算法运算结果后再做shift，值越大越容易判断为静。值域范围：0 ~ 7。
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。
u8MdThdByMot[NR3D_BY_MOT_NUM]	根据motion控制motion阀值, 左到右是动到静, 值越大3DNR越强。值域范围：0 ~ 63。
u8MdGainByMot[NR3D_BY_Y_MOT_NUM]	根据motion控制motion程度, 左到右是动到静, 值越大3DNR越强。值域范围：0 ~ 48。
u16M2SLut[NR3D_BY_MOT_NUM]	移动到静止过程中，3D降噪的收敛速度，值越小，收敛越慢，可用来避免拖影。值域范围：0 ~ 4095。 NR3D_BY_MOT_NUM = 16。
u8S2MLumaTh	根据亮度微调静到动的判断，亮度小于u8S2MLumaTh的值会套用u8S2MLumaStr0。值域范围：0 ~ 255。
u8S2MLumaStep	根据亮度微调静到动的判断，亮度大于u8S2MLumaTh + 2^u8S2MLumaStep 的值会套用u8S2MLumaStr1，介于u8S2MLumaTh及u8S2MLumaTh + 2^u8S2MLumaStep中间的值则为u8S2MLumaStr0与u8S2MLumaStr1内插。值域范围：0 ~ 7。
u8S2MLumaStr0	根据亮度微调静到动的判断，值越大越容易维持静。值域范围：0 ~ 15。
u8S2MLumaStr1	根据亮度微调静到动的判断，值越大越容易维持静。值域范围：0 ~ 15。
u16S2MMotTh	根据Motion程度调静到动的判断，Motion小于u16S2MMotTh的值会套用u8S2MMotStr0。值域范围：0 ~ 16383。
u8S2MMotStep	根据Motion程度调静到动的判断，Motion大于u16S2MMotTh+ 2^u8S2MMotStep的值会套用u8S2MMotStr1，介于u16S2MMotTh及u16S2MMotTh+ 2^u8S2MMotStep中间的值则为u8S2MMotStr0与u8S2MMotStr1内插。值域范围：0 ~ 15
u8S2MMotStr0	根据motion微调静到动的判断，值越大越容易维持静。值域范围：0 ~ 15
u8S2MMotStr1	根据motion微调静到动的判断，值越大越容易维持静。值域范围：0 ~ 15
u8StillAreaEnhance	压抑静态区域扰动，值越大扰动越小。值域范围：64 ~ 255。 64 = 1x
u8M2SHistDelayByDiff[NR3D_BY_MOT_NUM]	Motion信息延迟时间，值域范围：0 ~ 7。横轴为当前帧和前一帧的motion信息差异，纵轴为motion信息往后级传的额外延迟时间，值越大则延迟越久，希望静态的motion信息有延迟，让运动过后的区域的motion信息持续久一些，在3DNR还未收敛前，让后级的2DNR能保持在较强的强度（动区通常强度较强）久一些。
u8TfLut[15]	根据移动程度，控制3D降噪的强度。值域范围：0 ~ 255。 NR3D_BY_MOT_NUM = 16。
u8MotShpBlendLut[NR3D_BY_MOT_NUM]	根据移动程度，控制2D降噪的强度。值域范围：0 ~ 64。 NR3D_BY_MOT_NUM = 16。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_NrDespike结构体¶

类型结构体（Type Structure）¶

说明

设定DeSpike降噪的类型结构体。
定义

typedef struct MI_ISP_IQ_NrDespikeType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U8 u8DbgMode

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。
u8DbgMode	设定DeSpike Debug模式，值域范围：0 ~ 2。0为关闭，1为edge map，2为NR Strength Map。
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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定DeSpike降噪的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_NrDespikeManualAttr_s

{

MI_ISP_IQ_NrDespikeParam_t stParaAPI;

} MI_ISP_IQ_NrDespikeManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定DeSpike降噪的参数结构体。
定义

typedef struct MI_ISP_IQ_NrDespikeParam_s

{

MI_U8 u8BlendRatio;

MI_U16 u16EdgeThByY[NRDESPIKE_BY_Y_NUM];

MI_U16 u16EdgeGain;

MI_U8 u8StrengthByEdge[NRDESPIKE_BY_EDGE_NUM];

MI_U8 u8NrSlope;

MI_U8 u8NrLowerBound;

MI_U16 u16NrThByY[NRDESPIKE_BY_Y_NUM];

MI_U8 u8StrengthByY[NRDESPIKE_STR_BY_Y_NUM];

} MI_ISP_IQ_NrDespikeParam_t;

名称

变量名称	描述
u8BlendRatio	调整NRDeSpike去噪整体强度，此数值越大去噪效果越强，值域范围：0 ~ 16。
u16EdgeThByY[NRDESPIKE_BY_Y_NUM]	根据不同亮度调整该区块是否为edge，值越大越不容易被判断为Edge，值域范围：0 ~ 4096。NRDESPIKE_BY_Y_NUM:12
u16EdgeGain	大于u16EdgeThByY的值会再经过EdgeGain的remap，让edge与noise分得更开，值越大u8StrengthByEdge的index也越大。值域范围：0 ~ 8191。
u8StrengthByEdge[NRDESPIKE_BY_EDGE_NUM]	根据u16EdgeThByY以及u16EdgeGain 将算法内部计算出的edge score做remap，remap的结果作为横轴(edge强度)，调整不同edge程度的denoise强度，值域范围：0 ~ 64。NRDESPIKE_BY_EDGE_NUM:16
u8NrSlope	小于u16NrThByY门坎值的像素，会依照u8NrSlope大小来决定 NRstrengh下降的速度，调越大下降的越快，值域范围：0 ~ 15。
u8NrLowerBound	NR强度的下限值，设为0则有些区域可以不除躁，设为64则用全强度的除躁，值域范围：0 ~ 64。
u16NrThByY[NRDESPIKE_BY_Y_NUM]	根据不同亮度调整Noise的门坎值，大于门坎值则会用全强度的除躁，小于门坎值则依照设定的u8NrSlope做递减，递减到最弱的强度会卡在u8NrLowerBound，值域范围：0 ~ 1023。
u8StrengthByY[NRDESPIKE_STR_BY_Y_NUM]	根据不同亮度调整NRDeSpike去噪强度，此数值越大去噪效果越强，值域范围：0 ~ 64。

注意事项

根据中心点与周围的端点差异，差异越大，越容易中心点抹除的动作。
相关结构类型与函式

无。

MI_ISP_IQ_Sharpness结构体¶

类型结构体（Type Structure）¶

说明

设定锐度的类型结构体。
定义

typedef struct MI_ISP_IQ_SharpnessType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U8 u8DbgMode;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_SharpnessAutoAttr_t stAuto;

MI_ISP_IQ_SharpnessManualAttr_t stManual;

} MI_ISP_IQ_SharpnessType_t;

名称

变量名称	描述
bEnable	设定锐度功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u8DbgMode	Debug模式选择，值域范围：0 ~ 4。设置为1(final edge):灰色代表没上edge，白/黑色分别代表白/黑边。设置为2(std map):越亮的区域表示std越大。设置为3(state map):经过state gain及state offset调整后的state状态。设置为4(D/UD map):经过state gain及state offset调整后的D/UD状态。
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_SharpnessType_t *data);

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

自动模式属性结构体（Automatic Mode Attribute Structure）¶

说明

设定锐度的自动模式属性结构体。
定义

typedef struct MI_ISP_IQ_SharpnessAutoAttr_s

{

MI_ISP_IQ_SharpnessParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_SharpnessAutoAttr_t;
名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定锐度的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_SharpnessManualAttr_s

{

MI_ISP_IQ_SharpnessParam_t stParaAPI;

} MI_ISP_IQ_SharpnessManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定锐度的参数结构体。
定义

typedef struct MI_ISP_IQ_SharpnessParam_s

{

MI_U8 u8SharpnessUD[SHARPNESS_FREQ_NUM];

MI_U8 u8SharpnessD[SHARPNESS_FREQ_NUM];

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 u8MotGainByY[SHARPNESS_BY_Y_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_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。
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。
u8MotGainByY[SHARPNESS_BY_Y_NUM]	根据不同亮度微调u8GainByMot的结果。值越大则则edge越强。值域范围：0 ~ 255。 SHARPNESS_BY_Y_NUM = 7。
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 ~ 127。横轴为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。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_SharpnessEx结构体¶

类型结构体（Type Structure）¶

说明

设定锐度的类型结构体。
定义

typedef struct MI_ISP_IQ_SharpnessExType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U8 u8DbgMode;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_SharpnessExAutoAttr_t stAuto;

MI_ISP_IQ_SharpnessExManualAttr_t stManual;

} MI_ISP_IQ_SharpnessExType_t;

名称

变量名称	描述
bEnable	设定锐度功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u8DbgMode	Debug模式选择，值域范围：0 ~ 3。设置为1(final edge):灰色代表没上edge，白/黑色分别代表白/黑边。设置为2(std map):越亮的区域表示std越大。设置为3(state map):经过state gain及state offset调整后的state状态。
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_SharpnessExType_t *data);

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

自动模式属性结构体（Automatic Mode Attribute Structure）¶

说明

设定锐度的自动模式属性结构体。
定义

typedef struct MI_ISP_IQ_SharpnessExAutoAttr_s

{

MI_ISP_IQ_SharpnessExParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_SharpnessExAutoAttr_t;
名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定锐度的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_SharpnessExManualAttr_s

{

MI_ISP_IQ_SharpnessExParam_t stParaAPI;

} MI_ISP_IQ_SharpnessExManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定锐度的参数结构体。
定义

typedef struct MI_ISP_IQ_SharpnessExParam_s

{

MI_U8 u8Sharpness[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_U16 u16DerUnderShootLimitByY[SHARPNESSEX_BY_Y_NUM];

MI_U16 u16EdgeKillLutUp[SHARPNESSEX_LUT_Y_NUM];

MI_U16 u16EdgeKillLutDown[SHARPNESSEX_LUT_Y_NUM];

MI_U8 u8EdgeKillLutSft[SHARPNESSEX_LUT_X_NUM];

MI_U8 u8StrengthByHue[SHARPNESSEX_BY_HUE_NUM];

MI_U8 u8StrengthBySat[SHARPNESSEX_BY_SAT_NUM];

} MI_ISP_IQ_SharpnessExParam_t;

名称

变量名称	描述
u8Sharpness[SHARPNESSEX_FREQ_NUM]	无向性edge的强度，用于提高发丝和草地等细小纹理清晰度，值域范围：0 ~ 127。横轴依序为高频/中频，纵轴为无向性edge的强度增益，值越大则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。
u16EdgeKillLutUp[SHARPNESSEX_LUT_Y_NUM]	根据edge强度调整白边的edge强度，值域范围：0 ~ 1023。横轴为输入edge，纵轴为输出edge，值越大则edge越强。
u16EdgeKillLutDown[SHARPNESSEX_LUT_Y_NUM]	根据edge强度调整黑边的edge强度，值域范围：0 ~ 1023。横轴为输入edge，纵轴为输出edge，值越大则edge越强。
u8EdgeKillLutSft[SHARPNESSEX_LUT_X_NUM]	EdgeKillLutUp/Down的横轴节点，值域范围：0 ~ 15。
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 ~ 127。横轴为saturation，当saturation小于StrengthBySat[0]，则StrengthByHue失效，也就是edge强度的调整不受到饱和度太低的hue影响，当saturation大于StrengthBySat[1]，则完全依据StrengthByHue调整edge强度，过度区则线性变化。SHARPNESSEX_BY_SAT_NUM = 2。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Crosstalk结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定串扰的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_CrosstalkManualAttr_s

{

MI_ISP_IQ_CrosstalkParam_t stParaAPI;

} MI_ISP_IQ_CrosstalkManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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。

注意事项

此功能开强会造成细节损失，因此如果没有串扰问题则不需要开启。
相关结构类型与函式

无。

MI_ISP_IQ_Dobc结构体¶

类型结构体（Type Structure）¶

说明

设定黑电平的类型结构体。
定义

typedef struct MI_ISP_IQ_DobcType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_DobcAutoAttr_t stAuto;

MI_ISP_IQ_DobcManualAttr_t stManual;

} MI_ISP_IQ_DobcType_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_SetDobc(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DobcType_t *data);

MI_S32 MI_ISP_IQ_GetDobc(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DobcType_t *data);

自动模式属性结构体（Automatic Mode Attribute Structure）¶

说明

设定黑电平的自动模式属性结构体。
定义

typedef struct MI_ISP_IQ_DobcAutoAttr_s

{

MI_ISP_IQ_DobcParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_DobcAutoAttr_t;
名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定串扰的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_DobcManualAttr_s

{

MI_ISP_IQ_DobcParam_t stParaAPI;

} MI_ISP_IQ_DobcManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定黑电平的参数结构体。
定义

typedef struct MI_ISP_IQ_DobcParam_s

{

MI_U16 u16ValR;

MI_U16 u16ValGr;

MI_U16 u16ValGb;

MI_U16 u16ValB;

MI_ISP_IQ_Bool_e bValByYEn;

MI_U16 u16ValByYR[8];

MI_U16 u16ValByYG[8];

MI_U16 u16ValByYB[8];

MI_U8 u16ValByYRSft[7];

MI_U8 u16ValByYGSft[7];

MI_U8 u16ValByYBSft[7];

} MI_ISP_IQ_DobcParam_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。
bValByYEn	byY功能开启值域范围：0 ~ 1。该功能打开后上方4项参数会失效。
u16ValByYR[8]	ByY的R通道黑电平的可控制数值。值域范围：0 ~ 65535。
u16ValByYG[8]	ByY的G通道黑电平的可控制数值。值域范围：0 ~ 65535
u16ValByYB[8]	ByY的B通道黑电平的可控制数值。值域范围：0 ~ 65535
u16ValByYRSft[7]	ByY的横轴截点。值域范围：0 ~ 31
u16ValByYGSft[7]	值域范围：0 ~ 31
u16ValByYBSft[7]	值域范围：0 ~ 31

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Wdr结构体¶

类型结构体（Type Structure）¶

说明

设定宽动态的类型结构体。
定义

typedef struct MI_ISP_IQ_WdrType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_Bool_e bDbgEn;

MI_ISP_IQ_OpType_e enOpType;

MI_U8 u8BoxNum;

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。
bDbgEn	设定debug功能的布尔值。Debug模式，显示local tone作用的区域与强度。关闭：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。
u8BoxNum	Local Tone的分析范围。值越大local tone越强。值域范围1~4。
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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定宽动态的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_WdrManualAttr_s

{

MI_ISP_IQ_WdrParam_t stParaAPI;

} MI_ISP_IQ_WdrManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定宽动态的参数结构体。
定义

typedef struct MI_ISP_IQ_WdrParam_s

{

MI_U8 u8Strength;

MI_U8 u8LocalStrength;

MI_U8 u8LevelStrength;

MI_U8 u8GlobalDarkToneEnhance;

MI_ISP_IQ_Bool_e bDetailEnhance;

MI_U16 u16WDRStrByY[WDR_BY_Y_NUM];

MI_U16 u16WDRStrByYOft;

MI_U8 u8WDRStrByYSft[WDR_BY_Y_SFT_NUM];

MI_U8 u8DarkLimit;

MI_U8 u8BrightLimit; } MI_ISP_IQ_WdrParam_t;

名称

变量名称	描述
u8Strength	WDR blending整体强度，值域范围：0 ~ 255，值越大则WDR越强，blending WDR Curve1越少。
u8LocalStrength	WDR Local Tone Mapping的强度，值域范围：0 ~ 255，值越大则WDR Local Tone 越强。
u8LevelStrength	WDR Local Tone 中，避免死黑死白的曲线强度。值域范围：0 ~ 255，值越大则越不容易死黑死白，但画面会偏蒙。
u8GlobalDarkToneEnhance	控制post global tone mapping，提供16条curve可供选择，值域范围：0 ~ 15。数字越大则暗处会拉越亮。
bDetailEnhance	加强细节的开关，值域范围：0 ~ 1。
u16WDRStrByY[WDR_BY_Y_NUM]	依据亮度控制WDR blending强度，值域范围：0 ~ 4095，横轴为亮度，越右边越亮，纵轴为WDR blending强度，值越大则WDR越强，blending WDR Curve1越少。 WDR_BY_Y_NUM = 33。
u16WDRStrByYOft	WDRStrByY的Offset，值域范围：0 ~ 65535
u8WDRStrByYSft[WDR_BY_Y_SFT_NUM]	WDRStrByY的横轴节点，值域范围：1 ~ 19
u8DarkLimit	限制WDR在暗处作用的强度，值域范围：0 ~ 255，值越大则暗处WDR越弱。
u8BrightLimit	限制WDR在亮处作用的强度，值域范围：0 ~ 255，值越大则亮处WDR越弱。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_WdrNr结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定宽动态降噪的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_WdrNrManualAttr_s

{

MI_ISP_IQ_WdrNrParam_t stParaAPI;

} MI_ISP_IQ_WdrNrManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定宽动态降噪的参数结构体。
定义

typedef struct MI_ISP_IQ_WdrNrParam_s

{

MI_U8 u8Strength;

MI_U8 u8NrStrMot[WDR_BY_MOT_NUM];

MI_U8 u8NrSlp[WDR_BY_MOT_NUM];

MI_U8 u8NoiseLevelLut_X[WDR_NOISE_LEVEL_NUM];

MI_U16 u16NoiseLevelLut_Y[WDR_NOISE_LEVEL_NUM];

MI_U8 u8NoiseLevelMot[WDR_BY_MOT_NUM];

} MI_ISP_IQ_WdrNrParam_t;

名称

变量名称	描述
u8Strength	WDR降噪强度控制。值域范围：0 ~ 255。
u8NrStrMot[WDR_BY_MOT_NUM]	根据motion程度再加一个offset到最终的降噪强度上。值域范围：0 ~ 255。WDR_BY_MOT_NUM = 16。
u8NrSlp[WDR_BY_MOT_NUM]	定义两种降噪强度，3代表较强的降噪强度，2代表较弱的降噪强度。值域范围：2 ~ 3。
u8NoiseLevelLut_X[WDR_NOISE_LEVEL_NUM]	NoiseLevelLut_Y的横轴节点，值域范围：0 ~ 255。
u16NoiseLevelLut_Y[WDR_NOISE_LEVEL_NUM]	根据亮度控制，小于此阀值判断为噪声，值越大降噪越强。值域范围：0 ~ 65535，横轴由左至右为由暗到亮。
u8NoiseLevelMot[WDR_BY_MOT_NUM]	根据motion程度对NrXThd做倍率调整。值域范围：0 ~ 255。16为1倍。WDR_BY_MOT_NUM = 16。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_DynamicDp结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定动态补偿坏点的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_DynamicDpManualAttr_s

{

MI_ISP_IQ_DynamicDpParam_t stParaAPI;

} MI_ISP_IQ_DynamicDpManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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_U8 u8DpcThSft[DYNAMIC_DP_TH_SFT_NUM]

MI_U16 u16DpcThLut[DYNAMIC_DP_TH_LUT_NUM]

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。
u8DpcThSft[DYNAMIC_DP_TH_SFT_NUM]	调整亮度节点。值域范围：0 ~ 15
u16DpcThLut	根据亮度设定动态补偿坏点阀值。值域范围：0 ~ 4095
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。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_DynamicDpCluster结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定动态补偿坏点的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_DynamicDpClusterManualAttr_s

{

MI_ISP_IQ_DynamicDpClusterAttr_t stParaAPI;

} MI_ISP_IQ_DynamicDpClusterManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定动态补偿坏点的参数结构体。
定义

typedef struct MI_ISP_IQ_DynamicDpClusterAttr_s

{

MI_ISP_IQ_Bool_e bSortEn;

MI_ISP_IQ_Bool_e bSortRGGBEn[DYNAMIC_DP_CLUSTER_CH_NUM];

MI_U16 u16SortLumTblL[DYNAMIC_DP_CLUSTER_TBL_NUM];

MI_U16 u16SortLumTblD[DYNAMIC_DP_CLUSTER_TBL_NUM];

} MI_ISP_IQ_DynamicDpClusterAttr_t;

名称

变量名称	描述
bSortEn	Sort mode总开关
bSortRGGBEn[DYNAMIC_DP_CLUSTER_CH_NUM]	Sort mode各自channel开关。 DYNAMIC_DP_CLUSTER_CH_NUM = 4。
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。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Hsv结构体¶

类型结构体（Type Structure）¶

说明

设定HSV的类型结构体。
定义

typedef struct MI_ISP_IQ_HsvType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_Bool_e u8DebugMode;

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。
u8DebugMode	除错模式。值域范围：0 ~ 4 可分别显示画面中特定的1.色相，2.饱和度，3.亮度，以及4.亮度与饱和度的乘积（S*Y）。
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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定HSV的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_HsvManualAttr_s

{

MI_ISP_IQ_HsvParam_t stParaAPI;

} MI_ISP_IQ_HsvManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定HSV的参数结构体。
定义

typedef struct MI_ISP_IQ_HsvParam_s

{

MI_S16 s16HueLut[HSV_HUE_NUM];

MI_U16 u16SatLut[HSV_SAT_NUM];

MI_S16 s16HueLut_ForUnitCCM[HSV_Y_NUM];

MI_U16 u16SatLut_ForUnitCCM[HSV_HUE_NUM];

MI_U16 u8GlobalSat;

} MI_ISP_IQ_HsvParam_t;

名称

变量名称	描述
s16HueLut[HSV_HUE_NUM]	将360度色相分为24份，分别控制每个色相旋转角度，自动模式下根据色温作切换。值域范围：-64 ~ 64。（0为不调整） HSV_HUE_NUM = 24。
u16SatLut[HSV_SAT_NUM]	将360度色相分为24份，分别控制每个色相的饱和度，自动模式下根据色温作切换。值域范围： 0 ~ 255。（64 = 1x） HSV_HUE_NUM = 24。
s16HueLut_ForUnitCCM[HSV_Y_NUM]	与s16HueLut功能相同，差别在于该参数仅作用于CCM模块中saturation < 100的情况，韧体内部会以saturation数值来与s16HueLut参数内插。若CCM模块中的saturation设置为0，则全用s16HueLut_ForUnitCCM的结果。将360度色相分为24份，分别控制每个色相旋转角度，自动模式下根据色温作切换。值域范围：-64 ~ 64。（0为不调整） HSV_HUE_NUM = 24。
u16SatLut_ForUnitCCM[HSV_HUE_NUM]	与u16SatLut功能相同，差别在于该参数仅作用于CCM模块中saturation < 100的情况，韧体内部会以saturation数值来与u16SatLut参数内插。若CCM模块中的saturation设置为0，则全用u16SatLut_ForUnitCCM的结果。将360度色相分为24份，分别控制每个色相的饱和度，自动模式下根据色温作切换。值域范围： 0 ~ 255。（64 = 1x） HSV_HUE_NUM = 24。
u8GlobalSat	整体的饱和度调整。值域范围：0 ~ 255。（64=1x）。

注意事项

H与Y的调整都是基于Hue的调整量，再针对ByS以及ByY做调整。换句话说，若HbyH的调整量为0，那么HbyS以及HbyY则失效。若YbyH的调整量为0，那么YbyS以及YbyY则失效。
相关结构类型与函式

无。

MI_ISP_IQ_Fpn结构体¶

类型结构体（Type Structure）¶

说明

设定FPN的类型结构体。
定义

typedef struct MI_ISP_IQ_FpnType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U8 u8FpnFormat;

MI_U8 u8DecompEnable;

MI_U8 u8DecompRange0;

MI_U8 u8DecompRange1;

MI_U8 u8DecompRange2;

MI_U8 u8DecompRange3;

MI_U8 u8DecompRange0F0;

MI_U8 u8DecompRange1F0;

MI_U8 u8DecompRange2F0;

MI_U8 u8DecompRange3F0;

MI_U8 u8DecompRange0F1;

MI_U8 u8DecompRange1F1;

MI_U8 u8DecompRange2F1;

MI_U8 u8DecompRange3F1;

MI_U16 u16DecompRange0F2;

MI_U16 u16DecompRange1F2;

MI_U16 u16DecompRange2F2;

MI_U16 u16DecompRange3F2;

MI_U8 u8Table[3840];

} MI_ISP_IQ_FpnType_t;

名称

变量名称	描述
bEnable	设定FPN功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u8FpnFormat	FPN 的位深度（0 / 1 / 2 / 3 = 12 / 14 / 16 / 10b）
u8DecompEnable	设定对FPN table Decompress的布尔值。
u8DecompRange0	Decompress 参数
u8DecompRange1	Decompress 参数
u8DecompRange2	Decompress 参数
u8DecompRange3	Decompress 参数
u8DecompRange0F0	Decompress 参数
u8DecompRange1F0	Decompress 参数
u8DecompRange2F0	Decompress 参数
u8DecompRange3F0	Decompress 参数
u8DecompRange0F1	Decompress 参数
u8DecompRange1F1	Decompress 参数
u8DecompRange2F1	Decompress 参数
u8DecompRange3F1	Decompress 参数
u16DecompRange0F2	Decompress 参数
u16DecompRange1F2	Decompress 参数
u16DecompRange2F2	Decompress 参数
u16DecompRange3F2	Decompress 参数
u8Table[3840]	FPN Table，最大支持宽度为3840 pixels

注意事项

Decompress参考以下公式

((value - f0_r0) ≪ f1_r0) + f2_r0, if value ≤ r0

((value - f0_r1) ≪ f1_r1) + f2_r1, if r0 < value ≤ r1

((value - f0_r2) ≪ f1_r2) + f2_r2, if r1 < value ≤ r2

((value - f0_r3) ≪ f1_r3) + f2_r3, if r2 < value
相关结构类型与函式

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);

MI_ISP_IQ_Demosaic结构体¶

类型结构体（Type Structure）¶

说明

设定去马赛克的类型结构体。
定义

typedef struct MI_ISP_IQ_DemosaicType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U8 u8DbgMode;

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。
u8DbgMode	Debug模式，值域范围：0 ~ 2，1代表方向判断影像，红/蓝/绿/白/黑色区域分别对应到垂直/水平/细节非加强/细节加强/无向性区域，2代表non-smooth影像，只有开启SmoEn才会有效果，影像越亮代表越不会被抹平，影像越黑代表越会被抹平。此debug模式和FalseColor的debug模式会有冲突，以最后呼叫的api为主。
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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定去马赛克的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_DemosaicManualAttr_s

{

MI_ISP_IQ_DemosaicParam_t paraAPI;

} MI_ISP_IQ_DemosaicManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定去马赛克的参数结构体。
定义

typedef struct MI_ISP_IQ_DemosaicParam_s

{

MI_U8 u8GradientTh;

MI_ISP_IQ_Bool_e bDetailIntpEn;

MI_U8 u8BRatio;

MI_ISP_IQ_Bool_e bSmoEn2;

MI_U8 u8SmoRange;

MI_U8 u8SmoStrength;

MI_U8 u8VarThX[8];

MI_U16 u16VarThY[8];

MI_ISP_IQ_Bool_e bSmoEn1;

} MI_ISP_IQ_DemosaicParam_t;

名称

变量名称	描述
u8GradientTh	方向性区域判断阀值，值域范围：0 ~ 63，值越大则越少区域被判断成方向性区域，可能导致细节模糊和拉链状artifacts，值太小则会使细节区偏有向。
bDetailIntpEn	开启细节内插，值域范围：0 ~ 1。
u8BRatio	越大越可以让一些弱的边连续,但高频就越可能插错，值域范围：0 ~ 15。
bSmoEn2	抹平功能开关，在demosaic后先进行抹平动作，值域范围：0 ~ 1。
u8SmoRange	抹平范围，值域范围：0 ~ 7，值越大则越多区域被抹平。
u8SmoStrength	抹平强度，值域范围：0 ~ 255，值越大则抹平的强度越强。
u8VarThX[8]	设定不同noiselevel区间，值域范围：0 ~ 7。
u16VarThY[8]	根据noiselevel区间，设定判为平坦区的阀值，值域范围：0 ~ 511。
bSmoEn1	抹平功能开关，在demosaic前先进行抹平动作，只作用在平坦区，值域范围：0 ~ 1。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_R2Y结构体¶

类型结构体 (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);

手动模式属性结构体 (Manual Mode Attribute Structure)¶

说明

设定色彩转换的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_R2YManualAttr_s

{

MI_ISP_IQ_R2YParam_t stParaAPI;

} MI_ISP_IQ_R2YManualAttr_t;
名称

变量名称描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体 (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。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_ColorTrans结构体¶

类型结构体（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);

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定色彩转换的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_ColorTransManualAttr_s

{

MI_ISP_IQ_ColorTransParam_t stParaAPI;

} MI_ISP_IQ_ColorTransManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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）

相关结构类型与函式

无。

MI_ISP_IQ_CTEx结构体¶

类型结构体（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);

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定色彩转换的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_CTExManualAttr_s

{

MI_ISP_IQ_CTEx_t stParaAPI;

} MI_ISP_IQ_CTExManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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则失效。
相关结构类型与函式

无。

MI_ISP_IQ_Lsc结构体¶

类型结构体（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);

MI_ISP_IQ_LscCtrl结构体¶

类型结构体（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);

MI_ISP_IQ_Alsc结构体¶

类型结构体（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);

MI_ISP_IQ_AlscCtrl结构体¶

类型结构体（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);

MI_ISP_IQ_AlscAdj结构体¶

类型结构体（Type Structure）¶

说明

设定ALSC ADJ的类型结构体。
定义

typedef struct MI_ISP_IQ_AlscAdjType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U16 u16ComplexTH;

MI_U16 u16MaxAdjustR;

MI_U16 u16MinAdjustR;

MI_U16 u16MaxAdjustB;

MI_U16 u16MinAdjustB;

MI_U8 u8CheckRange;

MI_U8 u8UniformLineTH;

MI_U8 u8DebugLevel;

MI_ISP_IQ_IntpLut_t RatioByBv;

} MI_ISP_IQ_AlscAdjType_t;

名称

变量名称	描述
bEnable	设定ALSC ADJ功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16ComplexTH	值域0 ~ 65536，若搜寻范围内的区域，复杂度小于Complex Thr，则会被列入判定color shading 的评估候选区域。
u16MaxAdjustR	值域256 ~ 512，限制算法对ALSC table中R的最大拉升量，256为1倍。建议在灯箱内调适到适当的值，不建议太大或太小，以避免算法误判时画面偏色。
u16MinAdjustR	值域128 ~ 256，限制算法对ALSC table中R的最大降低量，256为1倍。建议在灯箱内调适到适当的值，不建议太大或太小，以避免算法误判时画面偏色。
u16MaxAdjustB	值域256 ~ 512，限制算法对ALSC table中B的最大拉升量，256为1倍。建议在灯箱内调适到适当的值，不建议太大或太小，以避免算法误判时画面偏色。
u16MinAdjustB	值域128 ~ 256，限制算法对ALSC table中B的最大降低量，256为1倍。建议在灯箱内调适到适当的值，不建议太大或太小，以避免算法误判时画面偏色。
u8CheckRange	值域8 ~ 16，画面切分为水平垂直方向各32区域，该值代表从画面中心出发往外搜寻的范围，建议设置为该镜头模块明显有color shading的区域内。自适应算法是总和check range内的shading表现来决定是否要进行补偿，range设置太大，可能会造成纳入太多无明显shading的区域，影响整体评估结果。
u8UniformLineTH	值域:8 ~ 128，画面中的候选区域（<Complex Thr）大于Uniform line count TH才会进行画面的shading评估，若一般场景容易出现算法误判，建议可以调高该参数，候选区域够多时才做运算。
u8DebugLevel	打印相关Debug log。
RatioByBv	各节点BV，在较低光源场景，可依照BV调降补偿量，该参数会直接在算法内部改变Increase/Decrease R/B Gain。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetAlscAdj(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_AlscAdjType_t *data);

MI_S32 MI_ISP_IQ_GetAlscAdj(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_AlscAdjType_t *data);

MI_ISP_IQ_DarkShading结构体¶

类型结构体（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);

手动模式属性结构体（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 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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。值越大则影像边缘过度区间越大。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_DaynightDetection结构体¶

类型结构体（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);

MI_ISP_IQ_DaynightInfo结构体¶

类型结构体（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);

MI_ISP_IQ_NrLumaAdv结构体¶

类型结构体（Type Structure）¶

说明

设定Luma_Adv降噪的类型结构体。
定义

typedef struct MI_ISP_IQ_NrLumaAdvType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U8 u8DbgMode;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_Bool_e bLowPowerModeEn;

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。
u8DbgMode	Debug模式，值域范围：0 ~ 2，1为edge判断的模式，影像越亮代表越被判断成edge区，影像越暗则代表越被判断成non-edge区，这边只做Luma处理，影像颜色没有意义。2为defect detection的模式，可以观察白点defect出现的地方。
enOpType	设定Luma_Adv降噪的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
bLowPowerModeEn	设定Luma_Adv省电模式开关。关：0 开: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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（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 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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_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 EdgeThByRadius_Sft[NRLUMA_ADV_RADIUSSFT_NUM];

MI_U8 EdgeThByRadius[NRLUMA_ADV_RADIUS_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_StrByDir_Sft[NRLUMA_ADV_BY_DIR_SFT_NUM];

MI_U8 u8SF3_StrByDir[NRLUMA_ADV_BY_DIR_LUT_NUM];

MI_U8 u8SF4_KerStr;

MI_U8 u8SF4_KerWei[NRLUMA_ADV_KERWEI_NUM];

MI_U8 u8SF4_StrByLuma[NRLUMA_ADV_BY_LUMA_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_U8 u8CombinationRatio;

} 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
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
u8EdgeThByRadius_Sft[NRLUMA_ADV_RADIUSSFT_NUM]	与中心点距离的尺度大小，值域范围：0 ~ 7，可以根据不同距离区间调整尺度大小。NRLUMA_ADV_RADIUSSFT_NUM=5
u8EdgeThByRadius[NRLUMA_ADV_RADIUS_NUM]	依据与中心点距离调整强度，值域范围：0 ~ 127，横轴为与中心点的距离大小，越右边离中心点越远。NRLUMA_ADV_RADIUS_NUM=6
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_StrByDir_Sft[NRLUMA_ADV_BY_DIR_SFT_NUM]	有方向性的去躁参数，判定方向性程度的尺度大小，值域范围：0 ~ 7，可以根据不同距离区间调整尺度大小。NRLUMA_ADV_BY_DIR_SFT_NUM=7
u8SF3_StrByDir[NRLUMA_ADV_BY_DIR_LUT_NUM]	有方向性的去躁参数，依据方向性程度决定强度，值域范围：0 ~ 127。NRLUMA_ADV_BY_DIR_LUT_NUM=8
u8SF4_KerStr	无方向性的去躁参数，与中心点差异的横移量，值域范围：0 ~ 9，值越大则去躁效果越强。
u8SF4_KerWei[NRLUMA_ADV_KERWEI_NUM]	无方向性的去躁参数，混合权重表，值域范围：0 ~ 63，横轴为与中心点的差异，纵轴为权重，正常情况下，差异越小则权重设越大。NRLUMA_ADV_KERWEI_NUM = 16
u8SF4_StrByLuma[NRLUMA_ADV_BY_LUMA_NUM]	无方向性的去躁参数，依据亮度调整强度，值域范围：0 ~ 127，横轴为亮度，越右边越偏亮。 NRLUMA_ADV_BY_LUMA_NUM = 8
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
u8CombinationRatio	决定有向无向的混和比例，值越大有向的比例越多，值域范围：0 ~ 255

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_NrChromaAdv结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（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 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Pfc结构体¶

类型结构体（Type Structure）¶

说明

设定PFC的类型结构体。
定义

typedef struct MI_ISP_IQ_PfcType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U8 u8DbgEn;

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。
u8DbgEn	值域范围：0 ~ 8。 0: Debug off 1: PFC ByHue strength 2: PFC ByY strength 3: PFC ByContrast strength 4: BLCC ByHue strength 5: BLCC ByY strength 6: BLCC ByContrast strength 7: PFC final strength 8: PFC/BLCC final strength
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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定PFC的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_PfcManualAttr_s

{

MI_ISP_IQ_PfcParam_t stParaAPI;

} MI_ISP_IQ_PfcManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定PFC的参数结构体。
定义

typedef struct MI_ISP_IQ_PfcParam_s

{

MI_U8 u8MaskSel;

MI_U8 u8UStrength;

MI_U8 u8VStrength;

MI_U8 u8UStrengthLimit;

MI_U8 u8VStrengthLimit;

MI_U16 u16PFCByY[PFC_BY_Y_NUM];

MI_U8 u8PFCByHue[PFC_BY_HUE_NUM];

MI_U16 u16PFCByContrast[PFC_BY_CONTRAST_NUM];

MI_U8 u8BLCCByY[PFC_BY_Y_NUM];

MI_U8 u8BLCCByHue[PFC_BY_HUE_NUM];

MI_U16 u16BLCCByContrast[PFC_BY_CONTRAST_NUM];

MI_U8 u8ByYSft[PFC_BY_Y_SFT_NUM];

MI_U8 u8ByContrastSft[PFC_BY_CONTRAST_SFT_NUM];

} MI_ISP_IQ_PfcParam_t;

名称

变量名称	描述
u8MaskSel	值域范围：0 ~ 2
u8UStrength	去紫边作用在U channel的强度。值越大越强，值域：0 ~ 255。
u8VStrength	去紫边作用在V channel的强度。值越大越强，值域：0 ~255。
u8UStrengthLimit	值域范围：0 ~ 63
u8VStrengthLimit	值域范围：0 ~ 63
u16PFCByY[PFC_BY_Y_NUM]	值域范围：0 ~ 4095
u8PFCByHue[PFC_BY_HUE_NUM]	值域范围：0 ~ 255
u16PFCByContrast[PFC_BY_CONTRAST_NUM]	值域范围：0 ~ 511
u8BLCCByY[PFC_BY_Y_NUM]	值域范围：0 ~ 4095
u8BLCCByHue[PFC_BY_HUE_NUM]	值域范围：0 ~ 255
u16BLCCByContrast[PFC_BY_CONTRAST_NUM]	值域范围：0 ~ 511
u8ByYSft[PFC_BY_Y_SFT_NUM]	值域范围：1 ~ 19
u8ByContrastSft[PFC_BY_CONTRAST_SFT_NUM]	值域范围：1 ~ 15

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Dummy结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定DUMMY的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_DummyManualAttr_s

{

MI_ISP_IQ_DummyParam_t stParaAPI;

} MI_ISP_IQ_DummyManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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 ~ 255。 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。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_DummyEx结构体¶

类型结构体（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);

手动模式属性结构体（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 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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	调整扣OBC的位置，默认为-1，设为1后会将OBC的位置往后移，有助于Bayer NR以及3DNR的动静判断，需注意该功能无法根据增益开关，且开启此功能后3DNR MdTh/GainbyY的数值必须重新调整，值域范围：-1 ~ 255。
s16DummyEx4	目前没作用，预设为-1，值域范围：-1 ~ 255。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_WDRCurveFull结构体¶

类型结构体（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);

曲线列举结构体（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	曲线列举列表的最大值。

注意事项

无。
相关结构类型与函式

无。

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定WDRCurveFull的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_WdrCurveFullManualAttr_s

{

MI_ISP_IQ_WdrCurveFullParam_t stParaAPI;

} MI_ISP_IQ_WdrCurveFullManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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的横轴节点，值域范围：1 ~ 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 ~ 65535。功能和DarkToneEnhance相同。WDR_CURVE_FULL_LUT_Y_NUM = 32。
u16Curve1 [WDR_CURVE_FULL_CURVE_NUM]	前级亮度调整曲线，值域范围：0 ~ 65535。横轴为输入亮度，纵轴为输出亮度，值越大则「没有经过直方图均衡化处理的影像」越亮。输出结果会依据Strength和WDRStrByY的比例来混合经过直方图均衡化处理的结果，剩下的比例会混合经过Curve1处理的结果。 WDR_CURVE_FULL_CURVE_NUM = 33。
u16Curve2 [WDR_CURVE_FULL_CURVE_NUM]	后级亮度调整曲线，值域范围：0 ~ 65535。横轴为输入亮度，纵轴为输出亮度，值越大则最终影像越亮。 WDR_CURVE_FULL_CURVE_NUM = 33。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Defog结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定Defog的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_DefogManualAttr_s

{

MI_ISP_IQ_DefogParam_t stParaAPI;

} MI_ISP_IQ_DefogManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定Defog的参数结构体。
定义

typedef struct MI_ISP_IQ_DefogParam_s

{

MI_U16 u16StrengthByY[7];

MI_U8 u8StrengthByYSft[6] ;

MI_U16 u16ATMColor[3];

} MI_ISP_IQ_DefogParam_t;

名称

变量名称	描述
u16StrengthByY[7]	依据亮度控制去雾强度，值域范围：0 ~ 4095。
u8StrengthByYSft[6]	StrengthByY的横轴节点，以二的幂次方累加，值域范围：1 ~ 11。
u16ATMColor[3]	去雾的雾气颜色，RGB 12bit数值，值域范围：0 ~ 4095。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Temp结构体¶

类型结构体（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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（Manual Mode Attribute Structure）¶

说明

设定Temperature的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_TempManualAttr_s

{

MI_ISP_IQ_TempParam_t stParaAPI;

} MI_ISP_IQ_TempManualAttr_t;
名称

变量名称 描述

stParaAPI 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（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。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_TempInfo结构体¶

类型结构体（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);

MI_ISP_IQ_NrChromaPre结构体¶

类型结构体（Type Structure）¶

说明

设定Chroma_Pre降噪的类型结构体。
定义

typedef struct MI_ISP_IQ_NrChromaPreType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_Bool_e bDbgEn;

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。
bDbgEn	Debug模式，值域范围：0 ~ 1，使用前务必将Strength设为最大值256，影像的U/V信道值越小则代表越使用mean filter的结果，U/V通道值越大则代表越使用median filter的结果。
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);

自动模式属性结构体（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个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

手动模式属性结构体（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 手动模式属性结构体。
注意事项

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定Chroma_Pre降噪的参数结构体。
定义

typedef struct MI_ISP_IQ_NrChromaPreParam_s

{

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;

名称

变量名称	描述
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的结果。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_ApiBypass结构体¶

类型结构体（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);

MI_ISP_IQ_DarkFrame结构体¶

类型结构体（Type Structure）¶

说明

设定DarkFrame降噪的类型结构体。
定义

typedef struct MI_ISP_IQ_DarkFrameType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U32 u32TableSize;

MI_PHY phyDFTable;

} MI_ISP_IQ_DarkFrameType_t;

名称

变量名称	描述
bEnable	设定DarkFrame功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u32TableSize	画面宽高2 (2 byte)，最大支持宽高1280*1024
phyDFTable	代表DarkFrame table的物理内存位置 (要调用MI sys API去取得)

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDarkFrame (MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DarkFrameType_t *data);

MI_S32 MI_ISP_IQ_GetDarkFrame(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_DarkFrameType_t *data);

MI_ISP_AE_bool结构体¶

列举结构体（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_FlickerExInfoType_t

MI_ISP_AE_StrategyExType_t

MI_ISP_AE_RgbirAeType_t

MI_ISP_AE_StabilizerType_t

MI_ISP_AE_PowerLineType_t

MI_ISP_AE_OpType结构体¶

列举结构体（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

MI_ISP_AE_SmStateType结构体¶

列举结构体（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);

MI_ISP_AE_ExpoValue结构体¶

类型结构体（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_ISP_AE_VeryShortExpoInfoType_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);

MI_ISP_AE_HistWeightY结构体¶

类型结构体（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);

MI_ISP_AE_ExpoInfo结构体¶

类型结构体（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);

MI_ISP_AE_EvComp结构体¶

类型结构体（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);

MI_ISP_AE_Mode结构体¶

类型结构体（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);

MI_ISP_AE_IntpLut结构体¶

类型结构体（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);

MI_ISP_AE_ConvConditon结构体¶

类型结构体（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);

收敛区间结构体¶

说明

设定自动曝光启动收敛或判断收敛完成的区间。
定义

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

收敛速度结构体¶

说明

设定自动曝光的收敛速度。

共提供四组节点，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

MI_ISP_AE_ExpoLimit结构体¶

类型结构体（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);

MI_ISP_AE_ExpoTable结构体¶

类型结构体（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);

曝光行程节点参数结构体¶

说明

设定曝光行程中各节点的曝光时间、光圈及增益值。
定义

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

MI_ISP_AE_WinWeightMode结构体¶

类型结构体（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);

MI_ISP_AE_WinWeight结构体¶

类型结构体（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);

测光权重表参数结构体¶

说明

设定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

MI_ISP_AE_Flicker结构体¶

类型结构体（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);

MI_ISP_AE_FlickerEx结构体¶

类型结构体（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);

侦测抗闪烁模式结构体¶

说明

选择侦测抗闪烁的模式。
定义

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_t

MI_ISP_AE_QueryFlickerExInfo结构体¶

类型结构体（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);

MI_ISP_AE_Strategy结构体¶

类型结构体（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

MI_S32 MI_ISP_AE_GetStrategy(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyType_t

曝光策略模式结构体¶

说明

选择曝光策略的模式。
定义

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

MI_ISP_AE_StrategyEx结构体¶

类型结构体（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。

注意事项
相关结构类型与函式

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);

曝光策略模式结构体¶

说明

选择曝光策略的模式。
定义

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

曝光策略优先权模式结构体¶

说明

选择曝光策略优先权模式。
定义

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

MI_ISP_AE_StrategyExInfo结构体¶

类型结构体（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千分比统计值的平均亮度。

注意事项
相关结构类型与函式

MI_S32 MI_ISP_AE_QueryStrategyExInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyExInfoType_t *data);

MI_ISP_AE_Stabilizer结构体¶

类型结构体（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);

MI_ISP_AE_PowerLine结构体¶

类型结构体（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);

MI_ISP_AE_PowerLineInfo结构体¶

类型结构体（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);

MI_ISP_AE_LumaWgt结构体¶

类型结构体（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);

MI_ISP_AE_ExpoTableMode结构体¶

类型结构体（Type Structure）¶

说明

AE曝光表操作模式的结构体。
定义

typedef struct MI_ISP_AE_ExpoTableMode_s

{

MI_ISP_AE_OpType_e enOpType;

} MI_ISP_AE_ExpoTableMode_t;

名称

变量名称	描述
enOpType	AE曝光行程表模式选项，分别为Auto、Manual模式可选择。设为Auto会自动依据HDR ratio产生对应的AE曝光表。设为Manual则由使用者设定AE曝光表。适用于AEPlainTbl、AEPlainShortTbl、AEPlainVeryShortTbl。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetExpoTableMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableMode_t *data);

MI_S32 MI_ISP_AE_GetExpoTableMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableMode_t *data);

MI_ISP_AE_VerInfo结构体¶

类型结构体（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);

MI_ISP_AE_StabilizerEx结构体¶

类型结构体（Type Structure）¶

说明

StabilizerEx结构体。
定义

typedef struct MI_ISP_AE_StabilizerExType_s

{

MI_U8 u8StableCnt;

MI_U8 u8StableTh;

MI_U8 u8DetectMotionSensitivity;

} MI_ISP_AE_StabilizerExType_t;

名称

变量名称	描述
u8StableCnt	设定要连续判断几次环境稳定，才会开始做AE。
u8StableTh	设定判为环境稳定的条件。
u8DetectMotionSensitivity	设定侦测环境是否稳定的频率。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetStabilizerEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StabilizerExType_t *data);

MI_S32 MI_ISP_AE_GetStabilizerEx(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StabilizerExType_t *data);

MI_ISP_AE_ConvSpeed_Ex结构体¶

类型结构体（Type Structure）¶

说明

设定自动曝光的收敛条件。
定义

typedef struct MI_ISP_AE_ConvSpeed_Ex_s

{ MI_ISP_AE_bool_e bEnable;

MI_ISP_AE_ConvSpeedParam_Ex_t stConvSpeedEx;

} MI_ISP_AE_ConvSpeed_Ex_t;
名称

变量名称 描述

bEnable 开关ConvSpeed_Ex。

stConvSpeedEx 设定自动曝光的收敛速度。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetConvergeSpeed_Ex(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ConvSpeed_Ex_t *data);

MI_S32 MI_ISP_AE_GetConvergeSpeed_EX(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ConvSpeed_Ex_t *data);

收敛区间结构体¶

说明

设定自动曝光启动收敛或判断收敛完成的区间。
定义

typedef struct MI_ISP_AE_ConvSpeedParam_Ex_s

{

MI_U32 u32SpeedX[MI_ISP_AE_LUT_16];

MI_U32 u32SpeedY[MI_ISP_AE_LUT_16];

} MI_ISP_AE_ConvSpeedParam_Ex_t;
名称

变量名称 描述

u32SpeedX 设定不同的亮度区间。值域范围：1 ~ 2550。

u32SpeedY 设定不同的亮度区间，给予收敛速度。值域范围：1 ~ 1024。
注意事项

无。
相关结构类型与函式

MI_ISP_AE_ConvSpeed_Ex_t

MI_ISP_AWB_bool结构体¶

列举结构体（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

MI_ISP_AWB_OpType结构体¶

列举结构体（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 判断工作模式列举列表的最大值。
注意事项

无。
相关结构类型与函式

无。

MI_ISP_AWB_AlgoType结构体¶

列举结构体（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

MI_ISP_AWB_AdvType结构体¶

列举结构体（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

MI_ISP_AWB_SmStateType结构体¶

列举结构体（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

MI_ISP_AWB_FdAwb_Mode结构体¶

列举结构体（Enum Structure）¶

说明

Face detection AWB算法的列举结构体。
定义

typedef enum

{

E_SS_FDAWB_REFER_TO_SKIN,

E_SS_FDAWB_ASSIGN_SKIN_COLOR

} MI_ISP_AWB_FdAwb_Mode_e;

名称

变量名称	描述
E_SS_FDAWB_REFER_TO_SKIN	此模式会根据人脸信息的分析结果，锁定最有可能的白点范围去做白平衡法。
E_SS_FDAWB_ASSIGN_SKIN_COLOR	此模式会将人脸的统计值落点(白平衡前)，强制移到使用者设定的肤色落点(白平衡后)位置。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_FdAwbParam_t

MI_ISP_AWB_Fwst_AlgoType结构体¶

列举结构体（Enum Structure）¶

说明

FewStatisStrategy 算法的列举结构体。
定义

typedef enum

{

E_SS_AWB_FWST_KEEP = 0,

E_SS_AWB_FWST_MIX_PREFERGAIN = 1,

E_SS_AWB_FWST_MIX_GRAYWORLD = 2,

} MI_ISP_AWB_Fwst_AlgoType_e;

名称

变量名称	描述
E_SS_AWB_FWST_KEEP	维持在前次有足够统计值时得到的WB gain。
E_SS_AWB_FWST_MIX_PREFERGAIN	根据PreferCT设定色温算出的WB Gain。
E_SS_AWB_FWST_MIX_GRAYWORLD	使用GrayWorld算法算出的WB gain。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_FwstStrategyParam_t

MI_ISP_AWB_QueryInfo结构体¶

类型结构体（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);

MI_ISP_AWB_CtStatistics结构体¶

类型结构体（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);

个别AWB硬件统计值结构体¶

说明

个别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。
注意事项

无。
相关结构类型与函式

无。

MI_ISP_AWB_Attr结构体¶

类型结构体（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);

AWB工作模式列举结构体¶

说明

设定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

手动模式参数结构体（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

自动模式参数结构体（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

参数结构体（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

参数结构体（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

参数结构体（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

MI_ISP_AWB_AttrEx结构体¶

类型结构体（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);

白平衡独立光源点参数结构体（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

MI_ISP_AWB_MultiLs结构体¶

类型结构体（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);

MI_ISP_AWB_CtCali结构体¶

类型结构体（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);

MI_ISP_AWB_CurCtCali结构体¶

类型结构体（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);

MI_ISP_AWB_Ctmwb结构体¶

类型结构体（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);

MI_ISP_AWB_Stabilizer结构体¶

类型结构体（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);

MI_ISP_AWB_SpecialCase结构体¶

类型结构体 (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);

参数结构体 (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

列举结构体 (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

MI_ISP_AWB_SpecialCaseInfo结构体¶

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);

MI_ISP_AWB_StatisFilter结构体¶

类型结构体 (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);

MI_ISP_AWB_VerInfo结构体¶

类型结构体（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);

MI_ISP_AWB_FdAwbParam结构体¶

类型结构体 (Type Structure)¶

说明

AWB FdAwbParam的类型结构体。
定义

typedef struct MI_ISP_AWB_FdAwbParam_s

{

MI_ISP_AWB_bool_e bEnable;

MI_ISP_AWB_FdAwb_Mode_e eMode;

MI_U16 u16SkinAreaNum;

MI_U16 u16SkinAreaCntThd;

MI_U16 u16SkinAreaCT[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8SkinAreaCenterX[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8SkinAreaCenterY[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8SkinAreaRadius[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8SkinAreaSkipRadius[MI_ISP_FDAWB_SKIN_NUM];

MI_U16 u16UnStbCntThd;

MI_U8 u8GrayNum[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8GrayCenterX[MI_ISP_FDAWB_SKIN_NUM][MI_ISP_FDAWB_Gray_NUM];

MI_U8 u8GrayCenterY[MI_ISP_FDAWB_SKIN_NUM][MI_ISP_FDAWB_Gray_NUM];

MI_U8 u8GrayRadius[MI_ISP_FDAWB_SKIN_NUM][MI_ISP_FDAWB_Gray_NUM];

MI_U8 u8AssignSkinX[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8AssignSkinY[MI_ISP_FDAWB_SKIN_NUM];

MI_ISP_AWB_bool_e bFwstWbFromSkin;

} MI_ISP_AWB_FdAwbParam_t;

名称

变量名称	描述
bEnable	FDAWB算法开关。开启FDAWB功能，建议搭配AWB Blance AlgType使用，增加稳定性。
eMode	FDAWB算法模式选择。目前提供两种算法：1.Refer To Skin：此模式会根据人脸信息的分析结果，锁定最有可能的白点范围去做白平衡。2.Assign Skin Color：此模式会将人脸的统计值落点(白平衡前)，强制移到使用者设定的肤色落点(白平衡后)位置。
u16SkinAreaNum	使用者设定不同色温的肤色区域数量。值域0~8。注意不管选择哪种模式，此SkinArea的设定是必定要填的，否则FDAWB将无法分析人脸信息。
u16SkinAreaCntThd	人脸信息的稳定阀值。此阀值代表当人脸出现时，需要连续几次人脸信息都是有效的，FDAWB才会认为该信息是有效的，FDAWB才会开始动作；当人脸消失时，需要连续几次人脸信息都是无效的，FDAWB才会认为该信息是无效的，FDAWB才会停止。值域：0~255，值越大会越稳定，但会延迟FDAWB开始或结束动作的时间，应根据使用者需求设定适合的大小。
u16SkinAreaCT[MI_ISP_FDAWB_SKIN_NUM]	对应各自定义肤色区域的色温。此色温只是为了让使用者标示该肤色index是对应哪个色温环境，并无实际作用。设定上也没有任何规则，不用一定要从小到大或从大到小。值域0~20000。MI_ISP_FDAWB_SKIN_NUM = 8。
u8SkinAreaCenterX/Y[MI_ISP_FDAWB_SKIN_NUM]	对应各自定义肤色区域的中心坐标(R/G-B/G plane)。值域：0~255。MI_ISP_FDAWB_SKIN_NUM = 8。
u8SkinAreaRadius[MI_ISP_FDAWB_SKIN_NUM]	对应各自定义肤色区域的半径。值域：0_{255。值域：0}255。MI_ISP_FDAWB_SKIN_NUM = 8。
u16UnStbCntThd	避免Skin index在不同值间来回变化的阀值。当从目前的Skin index要切换到另一个index，需要连续几次侦测出来的Skin index都不等于现在的index才会做切换，否则会一直维持使用目前的index。值域0~255，值越大越能增加稳定性，但当环境色温变化后需要延迟更久才会反应。
u8GrayNum[MI_ISP_FDAWB_SKIN_NUM]	每个肤色index需要使用几个对应的灰阶区域。值域：0~10。注意此灰阶区域只有在选择Refer To Skin模式才有作用。MI_ISP_FDAWB_SKIN_NUM = 8。
u8GrayCenterX/Y[MI_ISP_FDAWB_SKIN_NUM][MI_ISP_FDAWB_Gray_NUM]	设定每个灰阶区域的中心坐标。根据GrayNum填入对应组数的坐标。值域：0~255。MI_ISP_FDAWB_SKIN_NUM = 8，MI_ISP_FDAWB_Gray_NUM = 10。
u8GrayRadius[MI_ISP_FDAWB_SKIN_NUM][MI_ISP_FDAWB_Gray_NUM]	设定每个灰阶区域的半径。灰阶区域是可以重迭的，因此当想要设定一个非圆形区域时，可以利用多个区域去达成。值域：0~255。MI_ISP_FDAWB_SKIN_NUM = 8，MI_ISP_FDAWB_Gray_NUM = 10。
u8AssignSkinX/Y[MI_ISP_FDAWB_SKIN_NUM]	设定人脸信息的目标坐标。值域：0~255。当选择Assign Skin Color模式时，会强制将人脸落点移到此目标坐标，建议可以在不同色温下去确认color checker patch 2的肤色落点来协助标定此坐标，再根据实际状况去作微调。此外，当选择Refer To Skin模式时，若有勾选FwstWbFromSkin，当遇到统计值不足的而无法计算白平衡的状况，会改用Assign Skin Color来做白平衡。MI_ISP_FDAWB_SKIN_NUM = 8。
bFwstWbFromSkin	当统计值不足时，是否要使用Assign Skin Color模式去计算白平衡的开关。此机制需搭配MI_ISP_AWB_SetFewStatisStrategy的设定，可参考该API的说明。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AWB_SetFDAWBParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_FdAwbParam_t *data);

MI_S32 MI_ISP_AWB_GetFDAWBParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_FdAwbParam_t *data);

MI_ISP_AWB_FdAwbInfoType结构体¶

类型结构体 (Type Structure)¶

说明

AWB FdAwbInfoType的类型结构体。
定义

typedef struct MI_ISP_AWB_FdAwbInfoType_s

{

MI_U8 u8FaceNum;

MI_U8 u8FaceCor[4];

MI_ISP_AWB_bool_e bEffective;

MI_U32 u32EffectiveCnt;

MI_U32 u32FaceAvgX;

MI_U32 u32FaceAvgY;

MI_U16 u16FaceSkinInd;

MI_U32 u32FaceTarRgain;

MI_U32 u32FaceTarBgain;

} MI_ISP_AWB_FdAwbInfoType_t;

名称

变量名称	描述
u8FaceNum	透过人脸侦测功能得到的人脸数量，目前只支持一个人脸。若此值为0表示没有支持人脸侦测功能或是有支持人脸侦测功能但没侦测到人脸。
u8FaceCor[4]	人脸在AWB 128x90个统计值上的坐标，四个值依序为人脸框起始点X坐标、起始点Y坐标、结束点X坐标、结束点Y坐标。
bEffective	表示目前FDAWB是否有作动。
u32EffectiveCnt	显示连续几次人脸信息是有效的，最高只会到SkinAreaCntThd+1。
u32FaceAvgX/Y	根据人脸信息分析出的人脸落点坐标(R/G-B/G plane)。
u16FaceSkinInd	根据人脸信息分析出的用户定义肤色index。
u32FaceTarR/Bgain	根据人脸信息以及AssignSkinX/Y得到的目标WB gain。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AWB_GetFDAWBInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_FdAwbInfoType_t *data);

MI_ISP_AWB_FwstStrategyParam结构体¶

类型结构体 (Type Structure)¶

说明

AWB FwstStrategyParam的类型结构体。
定义

typedef struct MI_ISP_AWB_FwstStrategyParam_s

{

MI_ISP_AWB_Fwst_AlgoType_e eAlgType;

MI_U32 u32CntThd;

MI_U32 u32SmoothWidth;

MI_U32 u32PreferCT;

} MI_ISP_AWB_FwstStrategyParam_t;

名称

变量名称	描述
eAlgType	用来决定当统计值不足时的行为，共有Keep、MixPreferGain及MixGrayWorld三种选择。
u32CntThd	最小有效统计值的阀值。当统计值数量小于此值，AWB无法计算。此时使用的WB gain会根据AlgType的选择而有所不同。值域：0 ~ 5000。Keep：维持在前次有足够统计值时得到的WB gain。MixPreferGain：根据PreferCT设定色温算出的WB Gain。MixGrayWorld：使用GrayWorld算法算出的WB gain。
u32SmoothWidth	当算法选择MixPreferGain和MixGrayWorld，或是FDAWB中FwstWbFromSkin有开启且作用时，在统计值数量在CntThd到CntThd + SmoothWidth间会根据选择的AlgoType拿不同的WB gain与AWB算出的target WB gain做混和。注意当FwstWbFromSkin有开启且作用时，拥有最高优先级。值域：0 ~ 5000。
u32PreferCT	eAlgType选择MixPreferGain时会使用，使用者可以决定当统计值不足时要使用哪个色温的WB gain。值域：0~20000。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AWB_SetFewStatisStrategy(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_FwstStrategyParam_t *data);

MI_S32 MI_ISP_AWB_GetFewStatisStrategy(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_FwstStrategyParam_t *data);

MI_ISP_AF_bool结构体¶

列举结构体（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

MI_ISP_AF_OpType结构体¶

列举结构体（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

MI_ISP_AF_SmStateType结构体¶

列举结构体（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

MI_ISP_AF_QueryInfo结构体¶

类型结构体（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);

MI_ISP_AF_HwWin结构体¶

类型结构体（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);

模式列举结构体（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

窗类型结构体（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

MI_ISP_AF_HwFilterAttr结构体¶

类型结构体（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);

MI_ISP_AF_HwFilterSq结构体¶

类型结构体（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);

MI_ISP_AF_HwBnr结构体¶

类型结构体（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);

MI_ISP_AF_HwYParam结构体¶

类型结构体（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);

MI_ISP_AF_HwSource结构体¶

类型结构体（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);

MI_ISP_AF_HwPrefilter结构体¶

类型结构体（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);

MI_ISP_AF_HwYMap结构体¶

类型结构体（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);

MI_ISP_AF_HwLdg结构体¶

类型结构体（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);

MI_ISP_AF_HwPeakMode结构体¶

类型结构体（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);

MI_ISP_AF_Attr结构体¶

类型结构体（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);

MI_ISP_AF_Motor结构体¶

类型结构体（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);

MI_ISP_AF_AccWeight结构体¶

类型结构体（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);

MI_ISP_AF_OneShot结构体¶

类型结构体（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);

MI_ISP_AF_SceneChange结构体¶

类型结构体（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);

MI_ISP_AF_SearchStart结构体¶

类型结构体（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);

MI_ISP_AF_Search结构体¶

类型结构体（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);

MI_ISP_AF_VerInfo结构体¶

类型结构体（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);

错误码¶

参数名称	数值	描述
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。

变量名称	描述
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	设定色彩转换的手动模式属性结构体。

变量名称	描述
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	判断工作模式列举列表的最大值。

变量名称	描述
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	切换至点状测光的权重表

参数名称	描述
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_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)。

变量名称	描述
bEnable	开关ConvSpeed_Ex。
stConvSpeedEx	设定自动曝光的收敛速度。

变量名称	描述
u32SpeedX	设定不同的亮度区间。值域范围：1 ~ 2550。
u32SpeedY	设定不同的亮度区间，给予收敛速度。值域范围：1 ~ 1024。

变量名称	描述
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。