ISP软件开发参考

REVISION HISTORY¶

Revision No.	Description	Date
1.0 (API Ver. 1.0)	Initial release	12/20/2023
1.1 (API Ver. 1.0)	Added AEConvergeSpeedEX API Added AEStabilizerEx API	01/04/2024
1.2 (API Ver. 1.0)	Added FDAWB and FDAWBInfo API Added AWB FWST Strategy API	01/04/2024
1.3 (API Ver. 1.0)	Added GroupHold API Added Hue API Added AlscAdj API Updated FDAWB and FDAWBInfo API Updated AWB FWST Strategy API Updated Dummy API Updated Dummy EX API	01/17/2024
1.4 (API Ver. 1.0)	Removed no longer used API (Nr3dEx, PfcEx) Updated MI_ISP_ApiCmdLoadBinFile API Updated Dummy EX API	02/05/2024
1.5 (API Ver. 1.0)	Updated description of Sharpness and SharpnessEx	02/19/2024
1.6 (API Ver. 1.0)	Added AWBRunPeriod API	03/14/2024
1.7 (API Ver. 1.0)	Added FDAE API Added FDAE_EX API Added FDAF API Added AF_Adjust API Added AF_AdjustII API Added AF_AdjustIII API Added AF_BackUpPosition API Added AF_Offset API Added FDAF API Added AF_DetectFlatZone API Added AF_StartVCMPos API	05/14/2024
1.8 (API Ver. 1.0)	Revised FDAE_EX API	05/20/2024
1.9 (API Ver. 1.0)	Added AE FastMode API	05/31/2024
1.10 (API Ver. 1.0)	Added description of scene mode API	05/31/2024
1.11 (API Ver. 1.0)	Revised description of FDAE_EX API	06/20/2024
1.12 (API Ver. 1.0)	Revised description of FDAE_EX API	06/26/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缩写。
HDR

High Dynamic Range缩写，双帧合成的高动态范围影像。
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 IQ版本号信息的指针。
返回值

参数名称 描述

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_SaturationType_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_SetObcP1¶

目的

设定Pipeline 1黑电平参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetObcP1¶

目的

取得Pipeline 1黑电平参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetObcP2¶

目的

设定Pipeline 2黑电平参数值。
语法

MI_S32 MI_ISP_IQ_SetObcP2(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ObcType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetObcP2¶

目的

取得Pipeline 2黑电平参数值。
语法

MI_S32 MI_ISP_IQ_GetObcP2(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ObcType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

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_SetWdrLtm¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetWdrLtm¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

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_SetWDRCurveAlignHDRtoLDR¶

目的

设定WDRCurveAlignHDRtoLDR参数值。
语法

MI_S32 MI_ISP_IQ_SetWDRCurveAlignHDRtoLDR(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_WDRCurveAlignHDRtoLDRType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetWDRCurveAlignHDRtoLDR¶

目的

取得WDRCurveAlignHDRtoLDR参数值。
语法

MI_S32 MI_ISP_IQ_GetWDRCurveAlignHDRtoLDR(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_WDRCurveAlignHDRtoLDRType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetWDRCurveAlignLDRtoHDR¶

目的

设定WDRCurveAlignLDRtoHDR参数值。
语法

MI_S32 MI_ISP_IQ_SetWDRCurveAlignLDRtoHDR(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_WDRCurveAlignLDRtoHDRType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetWDRCurveAlignLDRtoHDR¶

目的

取得WDRCurveAlignLDRtoHDR参数值。
语法

MI_S32 MI_ISP_IQ_GetWDRCurveAlignLDRtoHDR(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_WDRCurveAlignLDRtoHDRType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

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_SetRgbir¶

目的

设定RGB-IR参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetRgbir¶

目的

取得RGB-IR参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

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_SetHdr¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetHdr¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetHdrEx¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetHdrEx¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

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_SetROI¶

目的

可以根据需求设定画面中特定区域（ROI）的锐化/降躁/YUVGAMMA参数值，支援8个ROI。
语法

MI_S32 MI_ISP_IQ_SetROI(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ROIType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetROI¶

目的

取得ROI的位置，锐化/降躁/YUVGAMMA参数值。
语法

MI_S32 MI_ISP_IQ_GetROI(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ROIType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

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_IQ_SetGroupHold¶

目的

使得API在同一帧内生效。
语法

MI_ISP_IQ_SetGroupHold(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_Bool_e *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

在呼叫需要同一帧生效的API前设定GroupHold为TRUE，呼叫需要的API后再设定GroupHold为FALSE。

举例

MI_ISP_IQ_Bool_e GroupHold = E_SS_IQ_TRUE;
MI_ISP_IQ_SetGroupHold(DevId, Channel, &GroupHold);
while (datalen > 0)
{
    memcpy(&sParam, pPacket, sizeof(MI_ISP_IQ_ApiParam_t));
    MI_ISP_IQ_ApiDumpParam(sParam);

    ret = MI_ISP_IQ_ApiExecuteCmd(DevId, Channel, sParam.sCmdheader.CmdType,
                                pPacket + sizeof(MI_U32) + sizeof(MI_ISP_IQ_CmdHeader_t));
    datalen -= (sizeof(MI_U32) + sizeof(MI_ISP_IQ_CmdHeader_t) + sParam.sCmdheader.CmdLen);
    if (datalen != 0)
    {
        pPacket += (sizeof(MI_U32) + sizeof(MI_ISP_IQ_CmdHeader_t) + sParam.sCmdheader.CmdLen);
    }
}
GroupHold = E_SS_IQ_FALSE;
MI_ISP_IQ_SetGroupHold(DevId, Channel, &GroupHold);

MI_ISP_IQ_SetHue¶

目的

转Hue。
语法

MI_S32 MI_ISP_IQ_SetHue(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_Hue_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetHue¶

目的

取得转Hue数值。
语法

MI_S32 MI_ISP_IQ_GetHue(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_Hue_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetSceneDecision¶

目的

设定场景决策的参数。
语法

MI_S32 MI_ISP_IQ_SetSceneDecision(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneDecisionType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetSceneDecision¶

目的

取得场景决策的参数。
语法

MI_S32 MI_ISP_IQ_GetSceneDecision(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneDecisionType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetSceneAdj¶

目的

设定SceneAdj的参数。
语法

MI_S32 MI_ISP_IQ_SetSceneAdj(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneAdjType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetSceneAdj¶

目的

取得SceneAdj的参数。
语法

MI_S32 MI_ISP_IQ_GetSceneAdj(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneAdjType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetSceneStatis¶

目的

设定SceneStatis的参数。
语法

MI_S32 MI_ISP_IQ_SetSceneStatis(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneStatisType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_QuerySceneCurLevelInfo¶

目的

获取目前所有IQ等级的参数。
语法

MI_S32 MI_ISP_IQ_QuerySceneCurLevelInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneCurLevelType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_QuerySceneInfo¶

目的

获取目前场景模式以及目前所有IQ/AE/AWB等级的参数。
语法

MI_S32 MI_ISP_IQ_QuerySceneInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneInfoType_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_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_SetFastMode¶

目的

设定AE快速收敛参数值。
语法

MI_S32 MI_ISP_AE_SetFastMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_bool_e *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 快速收敛参数值的指标。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetFastMode¶

目的

取得AE快速收敛参数值。
语法

MI_S32 MI_ISP_AE_GetFastMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_bool_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_SetPlainShortExpoTable¶

目的

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

MI_S32 MI_ISP_AE_SetPlainShortExpoTable(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_GetPlainShortExpoTable¶

目的

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

MI_S32 MI_ISP_AE_GetPlainShortExpoTable(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_GetStrategyExAdv¶

目的

取得HDR_Auto模式的曝光策略参数值。
语法

MI_S32 MI_ISP_AE_GetStrategyExAdv(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_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_SetFaceDetectInfo¶

目的

设置FDAE所需信息。
语法

MI_S32 MI_ISP_AE_SetFaceDetectInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDInfoType_t *data)
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 人脸FD信息数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetFaceDetectParam¶

目的

设置FDAE调整参数。
语法

MI_S32 MI_ISP_AE_SetFaceDetectParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDParamType_t *data)
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetFaceDetectParam¶

目的

取得FDAE调整参数。
语法

MI_S32 MI_ISP_AE_GetFaceDetectParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDParamType_t *data)
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetFaceDetectParam_EX¶

目的

设置FDAE_EX调整参数。
语法

MI_S32 MI_ISP_AE_SetFaceDetectParam_EX(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDParamEXType_t *data)
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetFaceDetectParam_EX¶

目的

取得FDAE_EX调整参数。
语法

MI_S32 MI_ISP_AE_GetFaceDetectParam_EX(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDParamEXType_t *data)
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetFDExInfo¶

目的

设置FDEx_Info调整参数。
语法

MI_S32 MI_ISP_AE_SetFDExInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDEXInfoType_t *data)
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetFDExInfo¶

目的

取得FDEx_Info调整参数。
语法

MI_S32 MI_ISP_AE_GetFDExInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDEXInfoType_t *data)
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetFDExParam¶

目的

设置FDEx_Param调整参数。
语法

MI_S32 MI_ISP_AE_SetFDExParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDEXParamType_t *data)
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetFDExParam¶

目的

取得FDEx_Param调整参数。
语法

MI_S32 MI_ISP_AE_GetFDExParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDEXParamType_t *data)
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

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_AE_SetSceneInd¶

目的

设定AE Scene Flag的参数。
语法

MI_S32 MI_ISP_AE_SetSceneInd(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_SceneIndType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetSceneInd¶

目的

取得AE Scene Flag的参数。
语法

MI_S32 MI_ISP_AE_GetSceneInd(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_SceneIndType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_SetSceneAdj¶

目的

设定AE SceneAdj的参数。
语法

MI_S32 MI_ISP_AE_SetSceneAdj(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_SceneAdjType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_GetSceneAdj¶

目的

取得AE SceneAdj的参数。
语法

MI_S32 MI_ISP_AE_GetSceneAdj(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_SceneAdjType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AE_QuerySceneCurLevelInfo¶

目的

获取目前所有AE等级的参数。
语法

MI_S32 MI_ISP_AE_QuerySceneCurLevelInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_SceneCurLevelType_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_AWB_SetRunPeriod¶

目的

设定AWB运行频率。默认为3帧运行一次AWB。
语法

MI_S32 MI_ISP_AWB_SetRunPeriod(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_RunPeriodParam_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetRunPeriod¶

目的

取得AWB运行频率的设定。
语法

MI_S32 MI_ISP_AWB_GetRunPeriod(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_RunPeriodParam_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetSceneInd¶

目的

设定AWB Scene Flag的参数。
语法

MI_S32 MI_ISP_AWB_SetSceneInd(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SceneIndType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetSceneInd¶

目的

取得AWB Scene Flag的参数。
语法

MI_S32 MI_ISP_AWB_GetSceneInd(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SceneIndType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_SetSceneAdj¶

目的

设定AWB SceneAdj的参数。
语法

MI_S32 MI_ISP_AWB_SetSceneAdj(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SceneAdjType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 参数值指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_GetSceneAdj¶

目的

取得AWB SceneAdj的参数。
语法

MI_S32 MI_ISP_AWB_GetSceneAdj(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SceneAdjType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AWB_QuerySceneCurLevelInfo¶

目的

获取目前所有AWB等级的参数。
语法

MI_S32 MI_ISP_AWB_QuerySceneCurLevelInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SceneCurLevelType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

*data 数值的指针。
返回值

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetAdjust¶

目的

设置调整AF参数值。
语法

MI_S32 MI_ISP_AF_SetAdjust(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetAdjust¶

目的

取得调整AF参数值。
语法

MI_S32 MI_ISP_AF_GetAdjust(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetAdjustII¶

目的

设置调整AF参数值。
语法

MI_S32 MI_ISP_AF_SetAdjustII(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetAdjustII¶

目的

取得调整AF参数值。
语法

MI_S32 MI_ISP_AF_GetAdjustII(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetAdjustIII¶

目的

设置调整AF参数值。
语法

MI_S32 MI_ISP_AF_SetAdjustIII(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetAdjustIII¶

目的

取得调整AF参数值。
语法

MI_S32 MI_ISP_AF_GetAdjustIII(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetBackUpPosition¶

目的

设置FDAF开启并有认到人脸时，没人脸到有人脸时，VCM会先移动到上次有人脸时对焦到的位置参数。
语法

MI_S32 MI_ISP_AF_SetBackUpPosition(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_BackUpPositionType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetBackUpPosition¶

目的

取得FDAF开启并有认到人脸时，没人脸到有人脸时，VCM会先移动到上次有人脸时对焦到的位置参数。
语法

MI_S32 MI_ISP_AF_GetBackUpPosition(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_BackUpPositionType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetOffset¶

目的

设置AF找到焦点后，是否把焦点做一个位移。
语法

MI_S32 MI_ISP_AF_SetOffset(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_OffsetType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetOffset¶

目的

取得AF找到焦点后，是否把焦点做一个位移。
语法

MI_S32 MI_ISP_AF_GetOffset(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_OffsetType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetFDAF¶

目的

设置FDAF调整参数。
语法

MI_S32 MI_ISP_AF_SetFDAF(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_FDAFype_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetFDAF¶

目的

取得FDAF调整参数。
语法

MI_S32 MI_ISP_AF_GetFDAF(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_FDAFype_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetDetectFlatZone¶

目的

设置测平坦区的开关参数。
语法

MI_S32 MI_ISP_AF_SetDetectFlatZone(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_DetectFlatZoneype_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetDetectFlatZone¶

目的

取得测平坦区的开关参数。
语法

MI_S32 MI_ISP_AF_GetDetectFlatZone(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_DetectFlatZoneype_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetStartVCMPos¶

目的

设置决定开机默认VCM推到的位置参数。
语法

MI_S32 MI_ISP_AF_SetStartVCMPos(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_StartVCMPosType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetStartVCMPos¶

目的

取得决定开机默认VCM推到的位置参数。
语法

MI_S32 MI_ISP_AF_GetStartVCMPos(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_StartVCMPosType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
- 头文件：mi_isp_af.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 QueryInfo属性参数值的指针。
返回值

参数名称 描述

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_AF_AdjustIIIType_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 *data);

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

自动模式属性结构体（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_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 u8M2SHistDelayByDiff[NR3D_BY_MOT_NUM];

MI_U8 u8ShdMotSensitivity[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 ~ 127，值越大denoise强度越强。
u8TfStrC	控制去color noise的temporal denoise 强度，值域0 ~ 127，值越大denoise强度越强。
u8MdThd	MD侦测，控制motion阀值，小于此阀值判断为静止物体，值越大3D降噪越强。值域范围：0 ~ 255。
u16MdGain	MD侦测，控制motion程度，值越大越容易判断为静止物体，3D降噪越强。值域范围：0 ~ 10230。
u16MotEdgeRefineStr	抑制移动物体前缘被判定为动态区的强度。值域0 ~ 1023，越大移动物体前缘越不容易被判定为动态区，但须同时注意避免造成严重拖影。
u8MdThdByY[NR3D_BY_Y_NUM]	根据亮度控制motion阀值，值越大3D降噪越强。值域范围：0 ~ 255。NR3D_BY_Y_NUM = 16。
u8MdGainByY[NR3D_BY_Y_NUM]	根据亮度控制motion程度，值越大3D降噪越强。值域范围：0 ~ 255。NR3D_BY_Y_NUM = 16。
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。
u8M2SHistDelayByDiff[NR3D_BY_MOT_NUM]	Motion信息延迟时间，值域范围：0 ~ 7。横轴为当前帧和前一帧的motion信息差异，纵轴为motion信息往后级传的额外延迟时间，值越大则延迟越久，希望静态的motion信息有延迟，让运动过后的区域的motion信息持续久一些，在3DNR还未收敛前，让后级的2DNR能保持在较强的强度（动区通常强度较强）久一些。
u8ShdMotSensitivity[NR3D_BY_MOT_NUM]	调整shadow判断成motion的敏感度，值越大影子越容易被判断成动，3DNR会越弱。值域范围：0 ~ 15。
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_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_NrDespikeAutoAttr_t stAuto;

MI_ISP_IQ_NrDespikeManualAttr_t stManual;

} MI_ISP_IQ_NrDespikeType_t;

名称

变量名称	描述
bEnable	设定DeSpike降噪功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定DeSpike降噪的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定DeSpike降噪的自动模式属性结构体。
stManual	设定DeSpike降噪的手动模式属性结构体。

注意事项

无。
相关结构类型与函式

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

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

自动模式属性结构体（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_U8 u8StrengthCenterNeighbor;

MI_U8 u8StrengthMeanStd;

MI_U8 u8StrengthCornerCross;

MI_U8 u8DiffGainMeanStd;

MI_U8 u8DiffGainCenterNeighbor;

MI_U8 u8DiffThdCornerCross;

MI_U16 u16BlendLut[NRDESPIKE_BLEND_LUT_NUM];

MI_U8 u8StrengthByY[NRDESPIKE_BY_Y_NUM];

} MI_ISP_IQ_NrDespikeParam_t;

名称

变量名称	描述
u8BlendRatio	调整NRDeSpike去噪整体强度，此数值越大去噪效果越强。值域范围：0 ~ 15。
u8StrengthMeanStd	调整中心点与周围端点平均差值的强度。值域范围：0 ~ 5。
u8StrengthCenterNeighbor	调整中心点与十字或对角十字端点平均差值的强度。值域范围：0 ~ 5。
u8StrengthCornerCross	调整对角十字和十字端点平均值相减值的强度。值域范围：0 ~ 5。
u8DiffGainMeanStd	调整中心点与周围端点平均差值乘上的Gain值。值域范围：0 ~ 31。
u8DiffThdCenterNeighbor	调整中心点与十字或对角十字端点平均差值的threshold数值。值域范围：0 ~ 255。
u8DiffThdCornerCross	调整对角十字和十字端点平均值相减值的threshold数值。值域范围：0 ~ 255。
u16BlendLut[NRDESPIKE_BLEND_LUT_NUM]	根据亮度选用median/mean的混合比例，值越大越偏向median设定，值越小越偏向mean设定。值域范围：0 ~ 2047。NRDESPIKE_BLEND_LUT_NUM = 5。
u8StrengthByY[NRDESPIKE_BY_Y_NUM]	根据亮度给予不同强度，64为不调整，越小越弱。值域范围：0 ~ 64。NRDESPIKE_BY_Y_NUM = 16。

注意事项

根据中心点与周围的端点差异，差异越大，越容易中心点抹除的动作。

当DiffGain设定越小、Strength设定越大，越容易将中心点抹除。
相关结构类型与函式

无。

MI_ISP_IQ_Sharpness结构体¶

类型结构体（Type Structure）¶

说明

设定锐度的类型结构体。
定义

typedef struct MI_ISP_IQ_SharpnessType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_Bool_e bDbgEn;

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。
bDbgEn	Debug模式，值域范围：0 ~ 1。灰色代表没上edge，白/黑色分别代表白/黑边。
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 u8DerRmNRCnt[SHARPNESS_DER_Y_NUM];

MI_U8 u8DerOverShootGain[SHARPNESS_LUT_Y_NUM];

MI_U8 u8DerUnderShootGain[SHARPNESS_LUT_Y_NUM];

MI_U8 u8DerGainByMot[SHARPNESS_BY_MOT_NUM];

MI_U16 u16DerOverShootLimitByY[SHARPNESS_BY_Y_NUM];

MI_U16 u16DerUnderShootLimitByY[SHARPNESS_BY_Y_NUM];

MI_U8 u8StrengthByHue[SHARPNESS_BY_HUE_NUM];

MI_U8 u8StrengthBySat[SHARPNESS_BY_SAT_NUM];

MI_U8 u8BranchStrength;

MI_U8 u8BranchGainByStd[SHARPNESS_LUT_Y_NUM];

MI_ISP_IQ_Bool_e bROIEn;

MI_U8 u8ROIStr[SHARPNESSEX_ROI_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。
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。
bROIEn	ROI模式开关，值域范围：0 ~ 1。
u8ROIStr[SHARPNESSEX_ROI_NUM]	8个ROI的Sharpness强度，值域范围：0 ~ 255。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_SharpnessEx结构体¶

类型结构体（Type Structure）¶

说明

设定锐度的类型结构体。
定义

typedef struct MI_ISP_IQ_SharpnessExType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_Bool_e bDbgEn;

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。
bDbgEn	Debug模式，值域范围：0 ~ 1。灰色代表没上edge，白/黑色分别代表白/黑边。
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_Bool_e bROIEn;

MI_U8 u8ROIStr[SHARPNESSEX_ROI_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。
bROIEn	ROI模式开关，值域范围：0 ~ 1。
u8ROIStr[SHARPNESSEX_ROI_NUM]	8个ROI的Sharpness EX强度，值域范围：0 ~ 255。

注意事项

无。
相关结构类型与函式

无。

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_Obc结构体¶

类型结构体（Type Structure）¶

说明

设定黑电平的类型结构体。
定义

typedef struct MI_ISP_IQ_ObcType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_ObcAutoAttr_t stAuto;

MI_ISP_IQ_ObcManualAttr_t stManual;

} MI_ISP_IQ_ObcType_t;

名称

变量名称	描述
bEnable	设定黑电平功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定黑电平的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定黑电平的自动模式属性结构体。
stManual	设定黑电平的手动模式属性结构体。

注意事项

无。
相关结构类型与函式

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

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

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

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

自动模式属性结构体（Automatic Mode Attribute Structure）¶

说明

设定黑电平的自动模式属性结构体。
定义

typedef struct MI_ISP_IQ_ObcAutoAttr_s

{

MI_ISP_IQ_ObcParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_ObcAutoAttr_t;
名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

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

说明

设定黑电平的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_ObcManualAttr_s

{

MI_ISP_IQ_ObcParam_t stParaAPI;

} MI_ISP_IQ_ObcManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定黑电平的参数结构体。
定义

typedef struct MI_ISP_IQ_ObcParam_s

{

MI_U16 u16ValR;

MI_U16 u16ValGr;

MI_U16 u16ValGb;

MI_U16 u16ValB;

} MI_ISP_IQ_ObcParam_t;

名称

变量名称	描述
u16ValR	R通道黑电平的可控制数值。 Pipeline 0值域范围：0 ~ 65535。 Pipeline 1值域范围：0 ~ 65535。
u16ValGr	Gr通道黑电平的可控制数值。 Pipeline 0值域范围：0 ~ 65535。 Pipeline 1值域范围：0 ~ 65535。
u16ValGb	Gb通道黑电平的可控制数值。 Pipeline 0值域范围：0 ~ 65535。 Pipeline 1值域范围：0 ~ 65535。
u16ValB	B通道黑电平的可控制数值。 Pipeline 0值域范围：0 ~ 65535。 Pipeline 1值域范围：0 ~ 65535。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Wdr结构体¶

类型结构体（Type Structure）¶

说明

设定宽动态的类型结构体。
定义

typedef struct MI_ISP_IQ_WdrType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_WdrAutoAttr_t stAuto;

MI_ISP_IQ_WdrManualAttr_t stManual;

} MI_ISP_IQ_WdrType_t;

名称

变量名称	描述
bEnable	设定宽动态功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定宽动态的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定宽动态的自动模式属性结构体。
stManual	设定宽动态的手动模式属性结构体。

注意事项

无。
相关结构类型与函式

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

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

自动模式属性结构体（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 u8GlobalDarkToneEnhance;

MI_U16 u16WDRStrByY[WDR_BY_Y_NUM];

MI_U8 u8WDRStrByYSft[WDR_BY_Y_SFT_NUM];

MI_U16 u16WDRStrByYOft;

MI_U8 u8Strength;

MI_U8 u8DarkLimit;

MI_U8 u8BrightLimit;

MI_U8 u8DeSatSrcSel;

MI_U8 u8DesSatYMode;

MI_ISP_IQ_Bool_e bDeSatCrEn;

MI_U8 u8DeSatCbLut[WDR_BY_Y_NUM];

MI_U8 u8DeSatCrLut[WDR_BY_Y_NUM];

MI_U8 u8DeSatSft[WDR_BY_Y_SFT_NUM];

MI_U16 u16DeSatOft;

MI_U8 u8DeSatBlendV;

} MI_ISP_IQ_WdrParam_t;

名称

变量名称	描述
u8GlobalDarkToneEnhance	控制post global tone mapping，提供16条curve可供选择，值域范围：0 ~ 15。数字越大则暗处会拉越亮。
u16WDRStrByY[WDR_BY_Y_NUM]	依据亮度控制WDR blending强度，值域范围：0 ~ 4095，横轴为亮度，越右边越亮，纵轴为WDR blending强度，值越大则WDR越强，blending WDR Curve1越少。 WDR_BY_Y_NUM = 33。
u8WDRStrByYSft[WDR_BY_Y_SFT_NUM]	WDRStrByY的横轴节点，值域范围：1 ~ 15
u16WDRStrByYOft	WDRStrByY的Offset，值域范围：0 ~ 4095
u8Strength	WDR blending整体强度，值域范围：0 ~ 255，值越大则WDR越强，blending WDR Curve1越少。
u8DarkLimit	限制WDR在暗处作用的强度，值域范围：0 ~ 255，值越大则暗处WDR越弱。
u8BrightLimit	限制WDR在亮处作用的强度，值域范围：0 ~ 255，值越大则亮处WDR越弱。
u8DeSatSrcSel	去色彩功能的亮度来源，值域范围：0 ~ 2，0代表过完Curve1的亮度，1代表过完global tone的亮度，2代表未经过WDR处理前的亮度。
u8DesSatYMode	去色彩功能的亮度模式选择，值域范围：0 ~ 1，0代表YCbCr模式，1代表RGB模式。
bDeSatCrEn	去色彩功能的独立设定Cr色域开关，值域范围：0 ~ 1，0为Cr色域不独立设定，Cb与Cr相同设定，1为Cr色域独立设定。
u8DeSatCbLut[WDR_BY_Y_NUM]	依据亮度调整Cb色域去色彩功能的程度，值域范围：0 ~ 255，横轴为亮度，越右边越偏亮，纵轴为色彩增益（128 = 1x），值越小则去色彩越强，影像越偏灰。 WDR_BY_Y_NUM = 33。
u8DeSatCrLut[WDR_BY_Y_NUM]	依据亮度调整Cr色域去色彩功能的程度，值域范围：0 ~ 255，横轴为亮度，越右边越偏亮，纵轴为色彩增益（128 = 1x），值越小则去色彩越强，影像越偏灰。 WDR_BY_Y_NUM = 33。
u8DeSatSft[WDR_BY_Y_SFT_NUM]	DeSatCbLut/ DeSatCrLut的横轴节点，值域范围：1 ~ 15。
u16DeSatOft	DeSatCbLut/ DeSatCrLut的Offset，值域范围：0 ~ 4095。
u8DeSatBlendV	去色彩功能的Y亮度值与HSV的V亮度值混合的强度，值越大V亮度值混合越多，DeSatSrcSel设为3才有作用，值域范围：0 ~ 255。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_WdrLtm结构体¶

类型结构体（Type Structure）¶

说明

设定宽动态LTM的类型结构体。
定义

typedef struct MI_ISP_IQ_WdrLtmType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_Bool_e bDbgEn;

MI_ISP_IQ_OpType_e enOpType;

MI_U8 u8CoarseBoxNum;

MI_U8 u8MediumBoxNum;

MI_U8 u8FineBoxNum;

MI_ISP_IQ_WdrLtmAutoAttr_t stAuto;

MI_ISP_IQ_WdrLtmManualAttr_t stManual;

} MI_ISP_IQ_WdrLtmType_t;

名称

变量名称	描述
bEnable	设定宽动态功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
bDbgEn	Debug模式，显示LTM作用的区域与强度，值域范围：0 ~ 1。
enOpType	设定宽动态的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
u8CoarseBoxNum	提供4种size，可依据场景要关注的物体尺度大小进行调整，Box Num越大则box size越小，越适合当画面中关注的对象较小的时候，不可by ISO变动。Coarse对应的box size > Medium对应的box size > Fine对应的box size。值域：1 ~ 4。
u8MediumBoxNum	提供4种size，可依据场景要关注的物体尺度大小进行调整，Box Num越大则box size越小，越适合当画面中关注的对象较小的时候，不可by ISO变动。Coarse对应的box size > Medium对应的box size > Fine对应的box size。值域：1 ~ 4。
u8FineBoxNum	提供5种size，可依据场景要关注的物体尺度大小进行调整，Box Num越大则box size越小，越适合当画面中关注的对象较小的时候，不可by ISO变动。Coarse对应的box size > Medium对应的box size > Fine对应的box size。值域：1 ~ 5。
stAuto	设定宽动态的自动模式属性结构体。
stManual	设定宽动态的手动模式属性结构体。

注意事项

无。
相关结构类型与函式

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

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

自动模式属性结构体（Automatic Mode Attribute Structure）¶

说明

设定宽动态LTM的自动模式属性结构体。
定义

typedef struct MI_ISP_IQ_WdrLtmAutoAttr_s

{

MI_ISP_IQ_WdrLtmParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_WdrLtmAutoAttr_t;
名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

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

说明

设定宽动态LTM的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_WdrLtmManualAttr_s

{

MI_ISP_IQ_WdrLtmParam_t stParaAPI;

} MI_ISP_IQ_WdrLtmManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定宽动态LTM的参数结构体。
定义

typedef struct MI_ISP_IQ_WdrLtmParam_s

{

MI_U8 u8LocalStr;

MI_U8 u8LevelStr;

MI_U8 u8LocalDetailEnhance;

MI_U8 u8CoarseFltCoef;

MI_U8 u8CoarseToneMapStr;

MI_U8 u8FineFltCoef;

MI_U8 u8FineToneMapStr;

} MI_ISP_IQ_WdrLtmParam_t;

名称

变量名称	描述
u8LocalStr	Local tone mapping kernel强度，值域范围：0 ~ 255，值越大越强。
u8LevelStr	Level强度。值域：0 ~ 255。值越大，亮暗区contrast加强效果越强。
u8LocalDetailEnhance	Local细节增强，值域范围：0 ~ 4，值越大越强。
u8CoarseFltCoef	提供5种filter size，值越大local contrast加强效果越明显，但物体边缘越容易出现光晕。
u8CoarseToneMapStr	Coarse local tone mapping强度。值域：0 ~ 255。值越大，local contrast加强效果越明显，但物体边缘越容易出现光晕。
u8FineFltCoef	提供5种filter size，值越大local contrast加强效果越明显，但物体边缘越容易出现光晕。
u8FineToneMapStr	Fine local tone mapping强度。值域：0 ~ 255。值越大，local contrast加强效果越明显，但物体边缘越容易出现光晕。

注意事项

无。
相关结构类型与函式

无。

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_U8 u8VNDNosMot[WDR_BY_MOT_NUM];

MI_U8 u8VNDSft[WDR_VND_LUT_X_NUM];

MI_U16 u16VNDThd[WDR_VND_LUT_Y_NUM];

MI_U16 u16VNDGain[WDR_VND_LUT_Y_NUM];

MI_ISP_IQ_Bool_e bVNDByPass;

} MI_ISP_IQ_WdrNrParam_t;

名称

变量名称	描述
u8Strength	WDR降噪强度控制。值域范围：0 ~ 255。
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程度对降噪阀值做倍率调整。值域范围：0 ~ 255。16为1倍。WDR_BY_MOT_NUM = 16。
u8VNDNosMot[WDR_BY_MOT_NUM]	根据motion程度对VNDThd做倍率调整。值域范围：0 ~ 255。16为1倍。WDR_BY_MOT_NUM = 16。
u8VNDSft[WDR_VND_LUT_X_NUM]	VNDThd，VNDGain的横轴节点，以二的幂次方累加，值域范围：1 ~ 11。WDR_VND_LUT_X_NUM = 8。
u16VNDThd[WDR_VND_LUT_Y_NUM]	根据亮度控制VND降噪阀值，大于此阀值判断为噪声，值越小降噪越强。值域范围：0 ~ 4095。WDR_VND_LUT_Y_NUM = 9。
u16VNDGain[WDR_VND_LUT_Y_NUM]	根据亮度控制VND降噪程度，值越大降噪越强。值域范围：0 ~ 4095。WDR_VND_LUT_Y_NUM = 9。
bVNDByPass	VND功能开关。1为VND关闭，0为VND开启。

注意事项

无。
相关结构类型与函式

无。

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_U16 u16DPCTH;

MI_ISP_IQ_Bool_e bBlendEn;

MI_U16 u16DiffLut[DYNAMIC_DP_LUT_NUM];

MI_U16 u16YLut[DYNAMIC_DP_LUT_NUM];

} MI_ISP_IQ_DynamicDpParam_t;

名称

变量名称	描述
bHotPixEn	设定动态补偿hot pixel功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16HotPixCompSlpoe	调整动态补偿hot pixel的阀值。值域范围：0 ~ 255。
bDarkPixEn	设定动态补偿dark pixel功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16DarkPixCompSlpoe	调整动态补偿dark pixel的阀值。值域范围：0 ~ 255。
u16DPCTH	设定动态补偿坏点阀值。值域范围：0 ~ 255。
bBlendEn	设定blending功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16DiffLut[DYNAMIC_DP_LUT_NUM]	依据DPC补偿结果和原来的点的差异来做混和。值域范围：0 ~ 1024。DYNAMIC_DP_LUT_NUM = 6。
u16YLut[DYNAMIC_DP_LUT_NUM]	依据亮度来做混和。值域范围：0 ~ 1024。 DYNAMIC_DP_LUT_NUM = 6。

注意事项

无。
相关结构类型与函式

无。

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

MI_U16 u16NeiDeltaTh;

MI_U8 u8NeiSmooth;

MI_ISP_IQ_Bool_e bSortEn;

MI_ISP_IQ_Bool_e bSortRGGBEn[DYNAMIC_DP_CLUSTER_CH_NUM];

MI_ISP_IQ_Bool_e bSort1x3ModeEn;

MI_U16 u16SortLumTblL[DYNAMIC_DP_CLUSTER_TBL_NUM];

MI_U16 u16SortLumTblD[DYNAMIC_DP_CLUSTER_TBL_NUM];

MI_U16 u16SortLumTblS[DYNAMIC_DP_CLUSTER_TBL_NUM];

} MI_ISP_IQ_DynamicDpClusterAttr_t;

名称

变量名称	描述
bEdgeMode	设定Edge Mode功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16NeiDeltaTh	中心点与周围8点的差异阀值。值域范围：0 ~ 4095。
u8NeiSmooth	累计阀值。值域范围：0 ~ 8。
bSortEn	Sort mode总开关
bSortRGGBEn[DYNAMIC_DP_CLUSTER_CH_NUM]	Sort mode各自channel开关。 DYNAMIC_DP_CLUSTER_CH_NUM = 4。
bSort1x3ModeEn	1x3 mode开关。
u16SortLumTblL[DYNAMIC_DP_CLUSTER_TBL_NUM]	最亮点和次亮点阀值。值域范围：0 ~ 4095。 DYNAMIC_DP_CLUSTER_TBL_NUM = 6。
u16SortLumTblD[DYNAMIC_DP_CLUSTER_TBL_NUM]	最暗点和次暗点阀值。值域范围：0 ~ 4095。 DYNAMIC_DP_CLUSTER_TBL_NUM = 6。
u16SortLumTblS[DYNAMIC_DP_CLUSTER_TBL_NUM]	次亮（暗）点和第三亮（暗）点阀值。值域范围：0 ~ 4095。 DYNAMIC_DP_CLUSTER_TBL_NUM = 6。

注意事项

无。
相关结构类型与函式

无。

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 s16HueByHueLut[HSV_HUE_NUM];

MI_U16 u16HueBySatLut[HSV_SAT_NUM];

MI_U16 u16HueByYLut[HSV_Y_NUM];

MI_U16 u16SatByHueLut[HSV_HUE_NUM];

MI_S16 s16SatBySatLut[HSV_SAT_NUM];

MI_U16 u16SatByYLut[HSV_Y_NUM];

MI_S16 s16SatBySYLut[HSV_Y_NUM];

MI_S16 s16YByHueLut[HSV_HUE_NUM];

MI_U16 u16YBySatLut[HSV_SAT_NUM];

MI_U16 u16YByYLut[HSV_Y_NUM];

MI_S16 s16HueByHueLut_ByIso[HSV_HUE_NUM];

MI_U16 u16HueBySatLut_ByIso[HSV_SAT_NUM];

MI_U16 u16HueByYLut_ByIso[HSV_Y_NUM];

MI_U16 u16SatByHueLut_ByIso[HSV_HUE_NUM];

MI_S16 s16SatBySatLut_ByIso[HSV_SAT_NUM];

MI_U16 u16SatByYLut_ByIso[HSV_Y_NUM];

MI_S16 s16SatBySYLut_ByIso[HSV_Y_NUM];

MI_S16 s16YByHueLut_ByIso[HSV_HUE_NUM];

MI_U16 u16YBySatLut_ByIso[HSV_SAT_NUM];

MI_U16 u16YByYLut_ByIso[HSV_Y_NUM];

MI_ISP_IQ_Bool_e bVibranceEn;

MI_U8 u8GrayProtectStrength;

MI_U16 u16GrayProtectTh;

} MI_ISP_IQ_HsvParam_t;

名称

变量名称	描述
s16HueByHueLut[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相旋转角度，自动模式下根据色温作切换。值域范围：-127 ~ 127。（0为不调整） HSV_HUE_NUM = 36。
u16HueBySatLut[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的色相旋转角度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_SAT_NUM = 9。
u16HueByYLut[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的色相旋转角度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
u16SatByHueLut[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相的饱和度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_HUE_NUM = 36。
s16SatBySatLut[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的饱和度增减，自动模式下根据色温作切换。值域范围：-511 ~ 511。（0为不调整） HSV_SAT_NUM = 9。
u16SatByYLut[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的饱和度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
s16SatBySYLut[HSV_Y_NUM]	将亮度与饱和度的乘积等分为9份，分别控制每个等分乘积的饱和度增减，自动模式下根据色温作切换。值域范围：-511 ~ 511。（0为不调整） HSV_Y_NUM = 9。
s16YByHueLut[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相的亮度，自动模式下根据色温作切换。值域范围：值域范围：-511 ~ 511。（0为不调整） HSV_HUE_NUM = 36。
u16YBySatLut[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的亮度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_SAT_NUM = 9。
u16YByYLut[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的亮度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
s16HueByHueLut_ByIso[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相旋转角度，自动模式下根据色温作切换。值域范围：-127 ~ 127。（0为不调整） HSV_HUE_NUM = 36。
u16HueBySatLut_ByIso[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的色相旋转角度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_SAT_NUM = 9。
u16HueByYLut_ByIso[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的色相旋转角度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
u16SatByHueLut_ByIso[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相的饱和度，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_HUE_NUM = 36。
s16SatBySatLut_ByIso[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的饱和度增减，自动模式下根据色温作切换。值域范围：-511 ~ 511。（0为不调整） HSV_SAT_NUM = 9。
u16SatByYLut_ByIso[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的饱和度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
s16SatBySYLut_ByIso[HSV_Y_NUM]	将亮度与饱和度的乘积等分为9份，分别控制每个等分乘积的饱和度增减，自动模式下根据色温作切换。值域范围：-511 ~ 511。（0为不调整） HSV_Y_NUM = 9。
s16YByHueLut_ByIso[HSV_HUE_NUM]	将360度色相分为36份，分别控制每个色相的亮度，自动模式下根据色温作切换。值域范围：值域范围：-511 ~ 511。（0为不调整） HSV_HUE_NUM = 36。
u16YBySatLut_ByIso[HSV_SAT_NUM]	将饱和度等分为9份，分别控制每个等分饱和度的亮度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_SAT_NUM = 9。
u16YByYLut_ByIso[HSV_Y_NUM]	将亮度等分为9份，分别控制每个等分亮度的亮度增减，自动模式下根据色温作切换。值域范围：0 ~ 255。（128 = 1x） HSV_Y_NUM = 9。
bVibranceEn	自然饱和度功能开关。开启后此模块内与饱和度相关的控制皆会失效。取而代之的是韧体内部内定的饱和度相关调整曲线，可再增加饱和度的同时保持肤色饱和度少量改变。
u8GrayProtectStrength	灰色物颜色保护强度。值域范围：0 ~ 63。接近灰色物体可利用此参数来确保色相，饱和度，以及亮度不被调整
u16GrayProtectTh	定义灰色物体的阈值。值域范围：0 ~ 1023。数值越大越容易被定义为灰色物，可利用此参数来确保色相，饱和度，以及亮度不被调整

注意事项

H与Y的调整都是基于Hue的调整量，再针对ByS以及ByY做调整。换句话说，若HbyH的调整量为0，那么HbyS以及HbyY则失效。若YbyH的调整量为0，那么YbyS以及YbyY则失效。
相关结构类型与函式

无。

MI_ISP_IQ_Rgbir结构体¶

类型结构体（Type Structure）¶

说明

设定RGB-IR的类型结构体。
定义

typedef struct MI_ISP_IQ_RgbirType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_RgbirAutoAttr_t stAuto;

MI_ISP_IQ_RgbirManualAttr_t stManual;

} MI_ISP_IQ_RgbirType_t;

名称

变量名称	描述
bEnable	设定RGB-IR功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定RGB-IR的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定RGB-IR的自动模式属性结构体。
stManual	设定RGB-IR的手动模式属性结构体。

注意事项

无。
相关结构类型与函式

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

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

自动模式属性结构体（Automatic Mode Attribute Structure）¶

说明

设定RGB-IR的自动模式属性结构体。
定义

typedef struct MI_ISP_IQ_RgbirAutoAttr_s

{

MI_ISP_IQ_RgbirParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_RgbirAutoAttr_t;
名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

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

说明

设定RGB-IR的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_RgbirManualAttr_s

{

MI_ISP_IQ_RgbirParam_t stParaAPI;

} MI_ISP_IQ_RgbirManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定RGB-IR的参数结构体。
定义

typedef struct MI_ISP_IQ_RgbirParam_s

{

MI_U8 u8IrPosType;

MI_ISP_IQ_Bool_e bRemovelEn;

MI_U16 u16Ratio_R[RGBIR_BY_Y_NUM];

MI_U16 u16Ratio_G[RGBIR_BY_Y_NUM];

MI_U16 u16Ratio_B[RGBIR_BY_Y_NUM];

} MI_ISP_IQ_RgbirParam_t;

名称

变量名称	描述
u8IrPosType	RGB-IR分布型态。值域范围：0 ~ 7，默认值：0。
bRemovelEn	设定减IR功能的布尔值，默认值：1。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16Ratio_R[RGBIR_BY_Y_NUM]	红色减IR比例，由暗至亮区@12-bit。 RGBIR_BY_Y_NUM = 6。
u16Ratio_G[RGBIR_BY_Y_NUM]	绿色减IR比例，由暗至亮区@12-bit。 RGBIR_BY_Y_NUM = 6。
u16Ratio_B[RGBIR_BY_Y_NUM]	蓝色减IR比例，由暗至亮区@12-bit。 RGBIR_BY_Y_NUM = 6。

注意事项

无。
相关结构类型与函式

无。

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

MI_U8 u8SmoRange;

MI_U8 u8SmoStrength;

MI_U8 u8VarThX[8];

MI_U8 u8VarThY[8];

} MI_ISP_IQ_DemosaicParam_t;

名称

变量名称	描述
u8GradientTh	方向性区域判断阀值，值域范围：0 ~ 63，值越大则越少区域被判断成方向性区域，可能导致细节模糊和拉链状artifacts，值太小则会使细节区偏有向。
bDetailIntpEn	开启细节内插，值域范围：0 ~ 1。
u8BRatio	越大越可以让一些弱的边连续,但高频就越可能插错，值域范围：0 ~ 15。
bSmoEn	抹平功能开关，值域范围：0 ~ 1。
u8SmoRange	抹平范围，值域范围：0 ~ 7，值越大则越多区域被抹平。
u8SmoStrength	抹平强度，值域范围：0 ~ 255，值越大则抹平的强度越强。
u8VarThX[8]	设定不同noiselevel区间，值域范围：0 ~ 7。
u8VarThY[8]	根据noiselevel区间，设定判为平坦区的阀值，值域范围：0 ~ 255。

注意事项

无。
相关结构类型与函式

无。

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_Hdr结构体¶

类型结构体（Type Structure）¶

说明

设定高动态范围的类型结构体。
定义

typedef struct MI_ISP_IQ_HdrType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_HdrAutoAttr_t stAuto;

MI_ISP_IQ_HdrManualAttr_t stManual;

} MI_ISP_IQ_HdrType_t;

名称

变量名称	描述
bEnable	设定高动态范围功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定高动态范围的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定高动态范围的自动模式属性结构体。
stManual	设定高动态范围的手动模式属性结构体。

注意事项

无。
相关结构类型与函式

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

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

自动模式属性结构体（Automatic Mode Attribute Structure）¶

说明

设定高动态范围的自动模式属性结构体。
定义

typedef struct MI_ISP_IQ_HdrAutoAttr_s

{

MI_ISP_IQ_HdrParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_HdrAutoAttr_t;
名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

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

说明

设定高动态范围的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_HdrManualAttr_s

{

MI_ISP_IQ_HdrParam_t stParaAPI;

} MI_ISP_IQ_HdrManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定高动态范围的参数结构体。
定义

typedef struct MI_ISP_IQ_HdrParam_s

{

MI_U16 u16YwtTh1;

MI_U16 u16YwtTh2;

MI_U16 u16NoiseLevel[HDR_BY_Y_NUM];

MI_U8 u8YSrcStr[HDR_BLEND_V_NUM];

MI_U8 u8NrStr;

MI_U8 u8NrPreStr;

MI_U16 u16NrYTh1;

MI_U16 u16NrYTh2;

MI_U8 u8NrYGain[HDR_LUT_Y_NUM];

MI_U8 u8NrYSft[HDR_LUT_X_NUM];

MI_U8 u8NrKernelStr;

MI_U8 u8NrKernelStrWei[HDR_STR_BY_DIFF];

MI_U8 u8MotAdjSft1[HDR_MOT_LUT_X_NUM];

MI_U8 u8MoLuBlendSft[HDR_BLEND_LUT_X_NUM];

MI_U16 u16MotAdj1[HDR_MOT_LUT_Y_NUM];

MI_U16 u16MotAdj2[HDR_MOT_LUT_Y_NUM];

MI_U16 u16MotAdj3[HDR_MOT_LUT_Y_NUM];

MI_U16 u16MoLuBlendY[HDR_BLEND_LUT_Y_NUM];

} MI_ISP_IQ_HdrParam_t;

名称

变量名称	描述
u16YwtTh1	长曝曝光的最低亮度门阀，Th1以下亮度选用长曝资料。值域范围：0 ~ 1023。
u16YwtTh2	长曝曝光的最高亮度门阀，Th2以上亮度选用短曝数据。Th1至Th2之间为blending方式。值域范围：0 ~ 1023。
u16NoiseLevel[HDR_BY_Y_NUM]	噪声程度，用于判断动静，横轴为亮度，值越大越容易判断为静。值域范围：0 ~ 16383。 HDR_BY_Y_NUM = 16。
u8YSrcStr[HDR_BLEND_V_NUM]	依据亮度融合的亮度值，再与 max(R,G,B) 混合的强度，值域范围：0 ~ 255，值越大 max(R,G,B) 混合越多。u8YSrcStr[0]为长曝强度，u8YSrcStr[1]为短曝强度。HDR_BLEND_V_NUM = 2
u8NrStr	短曝降噪强度，值域范围：0 ~ 63。值越大NR越强。
u8NrPreStr	短曝前置降噪强度，值域范围：0 ~ 63。值越大NR越强。
u16NrYTh1	短曝降噪的最低亮度门阀，Th1以下亮度使用完整NR。值域范围：0 ~ 1023。
u16NrYTh2	短曝降噪的最高亮度门阀，Th2以上亮度不使用NR。Th1至Th2之间为blending方式。值域范围：0 ~ 1023。
u8NrYGain[HDR_LUT_Y_NUM]	短曝根据亮度差值控制降噪强度，值越小NR越强。值域范围：0 ~ 255，1倍为16。HDR_LUT_Y_NUM = 7。
u8NrYSft[HDR_LUT_X_NUM]	短曝NrYGain的横轴节点，以二的幂次方累加，值域范围：0 ~ 7。HDR_LUT_X_NUM = 6。
u8NrKernelStr	短曝降噪Filter强度，值域范围：0 ~ 7。值越大NR越强。
u8NrKernelStrWei[HDR_STR_BY_DIFF]	短曝降噪Filter混合权重表，值域范围：0 ~ 31，值越大NR越强，横轴为与中心点的差异，纵轴为权重，正常情况下，差异越小权重设越大。HDR_STR_BY_DIFF = 32。
u8MotAdjSft1[HDR_MOT_LUT_X_NUM]	MotAdj1的横轴节点，以二的幂次方累加，值域范围：0 ~ 7。 HDR_MOT_LUT_X_NUM = 6。
u8MoLuBlendSft[HDR_BLEND_LUT_X_NUM]	MoLuBlendY的横轴节点，以二的幂次方累加，值域范围：0 ~ 7。HDR_BLEND_LUT_X_NUM = 6。
u16MotAdj1[HDR_MOT_LUT_Y_NUM]	依据运动程度融合的LUT1，依亮度采用长曝的比例，横轴为亮度，越右边越偏亮。值域范围：0 ~ 256。 HDR_MOT_LUT_Y_NUM = 7。
u16MotAdj2[HDR_MOT_LUT_Y_NUM]	依据运动程度融合的LUT2，运动区采用长曝的比例，横轴为运动程度，越右边越动。值域范围：0 ~ 256。HDR_MOT_LUT_Y_NUM = 7。
u16MotAdj3[HDR_MOT_LUT_Y_NUM]	依据运动程度融合的LUT3，运动区采用长曝的比例，横轴为运动程度，越右边越动。值域范围：0 ~ 256。HDR_MOT_LUT_Y_NUM = 7。
u16MoLuBlendY[HDR_BLEND_LUT_Y_NUM]	依据亮度融合与依据运动程度融合的混和比例表，横轴为运动程度，越右边越动，纵轴为混合比例，值越大采用依据运动程度融合的比例越高。值域范围：0 ~ 256。 HDR_BLEND_LUT_Y_NUM = 7。

注意事项

无。
相关结构类型与函式

无。

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_Hue结构体¶

类型结构体（Type Structure）¶

说明

设定转Hue的类型结构体。
定义

typedef struct MI_ISP_IQ_HueType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_HueAutoAttr_t stAuto;

MI_ISP_IQ_HueManualAttr_t stManual;

} MI_ISP_IQ_HueType_t;

名称

变量名称	描述
bEnable	设定转Hue功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
enOpType	设定转Hue的工作模式。自动模式：E_SS_IQ_OP_TYP_AUTO = 0。手动模式：E_SS_IQ_OP_TYP_MANUAL = 1。
stAuto	设定转Hue的自动模式属性结构体。
stManual	设定转Hue的手动模式属性结构体。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetHue(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_HueType_t *data);

MI_S32 MI_ISP_IQ_GetHue(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_HueType_t *data);

自动模式属性结构体（Automatic Mode Attribute Structure）¶

说明

设定转Hue的自动模式属性结构体。
定义

typedef struct MI_ISP_IQ_HueAutoAttr_s

{

MI_ISP_IQ_LevelBaseParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_HueAutoAttr_t;
名称

变量名称 描述

stParaAPI[MI_ISP_AUTO_NUM] 自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。
注意事项

无。
相关结构类型与函式

无。

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

说明

设定转Hue的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_HueManualAttr_s

{

MI_ISP_IQ_LevelBaseParam_t paraAPI;

} MI_ISP_IQ_HueManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定转Hue的参数结构体。
定义

typedef struct MI_ISP_IQ_LevelBaseParam_s

{

MI_U32 u32Lev;

} MI_ISP_IQ_LevelBaseParam_t;
名称

变量名称 描述

u32Lev 设定转Hue的大小，值域范围：0 ~ 63。
注意事项

无。
相关结构类型与函式

无。

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_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。
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	对比区判断的Mask大小选择。值域0 ~ 2，Mask 0范围较小，Mask 2范围较大。
u8UStrength	PFC/BLCC作用在U channel的强度。值域0 ~ 255，值越大越强。
u8VStrength	PFC/BLCC作用在V channel的强度。值域0 ~ 255，值越大越强。
u8UStrengthLimit	PFC/BLCC作用在U channel的强度上限。值域0 ~ 63。
u8VStrengthLimit	PFC/BLCC作用在V channel的强度上限。值域0 ~ 63。
u16PFCByY[PFC_BY_Y_NUM]	紫边 (Purple Fringing) 通常出现在较暗的地方，且周围是高亮区域，所以可针对不同亮度，给予不同PFC的强度，横轴越右边代表亮度越大。值域0 ~ 4095，值越大越强。 PFC_BY_Y_NUM = 14。
u8PFCByHue[PFC_BY_HUE_NUM]	根据不同的Hue，给予不同强度的PFC处理。值域0 ~ 255，值越大PFC越强。 PFC_BY_HUE_NUM = 32。
u16PFCByContrast[PFC_BY_CONTRAST_NUM]	针对对比的程度，给予不同强度的PFC，横轴越右边代表对比越强。值域0 ~ 511，值越大PFC越强。 PFC_BY_CONTRAST_NUM = 10。
u8BLCCByY[PFC_BY_Y_NUM]	背光颜色 (Backlit Color) 通常出现在较暗的地方，且周围是高亮区域，所以可针对不同亮度，给予不同BLCC的强度，横轴越右边代表亮度越大。值域0 ~ 4095，值越大越强。 PFC_BY_Y_NUM = 14。
u8BLCCByHue[PFC_BY_HUE_NUM]	根据不同的Hue，给予不同强度的BLCC处理。值域0 ~ 255，值越大BLCC越强。 PFC_BY_HUE_NUM = 32。
u16BLCCByContrast[PFC_BY_CONTRAST_NUM]	针对对比的程度，给予不同强度的BLCC，横轴越右边代表对比越强。值域0 ~ 511，值越大BLCC越强。 PFC_BY_CONTRAST_NUM = 10。
u8ByYSft[PFC_BY_Y_SFT_NUM]	PFCByY/BLCCByY的横轴节点，以二的幂次方累加，值域范围：1 ~ 15。 PFC_BY_Y_SFT_NUM = 13。
u8ByContrastSft[PFC_BY_CONTRAST_SFT_NUM]	PFCByContrast/BLCCByContrast的横轴节点，以二的幂次方累加，值域范围：1 ~ 11。 PFC_BY_CONTRAST_SFT_NUM = 9。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_HdrEx结构体¶

类型结构体（Type Structure）¶

说明

设定HDR_EX的类型结构体。
定义

typedef struct MI_ISP_IQ_HdrExType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_HdrExManualAttr_t stManual;

} MI_ISP_IQ_HdrExType_t;
名称

变量名称 描述

bEnable 设定HDR_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。

stManual 设定HDR_EX的手动模式属性结构体。
注意事项

无。
相关结构类型与函式

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

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

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

说明

设定HDR_EX的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_HdrExManualAttr_s

{

MI_ISP_IQ_HdrExParam_t stParaAPI;

} MI_ISP_IQ_HdrExManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

设定HDR_EX的参数结构体。
定义

typedef struct MI_ISP_IQ_HdrExParam_s

{

MI_ISP_IQ_Bool_e bDbgEn;

MI_ISP_IQ_Bool_e bDynRatioEn;

MI_ISP_IQ_Bool_e bNrEn;

MI_U16 u16SensorExpRatio;

MI_U8 u8DynRatioSrcSel;

MI_U8 u8YSrcSel;

MI_U8 u8NoiseLevelSrcSel;

MI_U8 u8MotionMaxVal;

MI_U8 u8MotAdjSft2[HDR_EX_MOT_LUT_X_NUM];

} MI_ISP_IQ_HdrExParam_t;

名称

变量名称	描述
bDbgEn	Debug mode。值域范围：0 ~ 1。
bDynRatioEn	动态曝光补偿开关。值域范围：0 ~ 1。
bNrEn	控制短曝NR开关。值域范围：0 ~ 1。
u16SensorExpRatio	长曝与短曝HDR曝光比，建议和AE设定一致。值域范围：1024 ~ 65535。
u8DynRatioSrcSel	动态曝光补偿亮度来源，0代表长曝，1代表短曝。值域范围：0 ~ 1。
u8YSrcSel	依据亮度融合的亮度来源，0代表长曝，1代表短曝。值域范围：0 ~ 1。
u8NoiseLevelSrcSel	噪声亮度来源。0代表长曝，1代表短曝，2代表两者最小值，3代表两者最大值。值域范围：0 ~ 3。
u8MotionMaxVal	运动程度上限值，值越大越不容易把噪声误判成运动，不建议调整。值域范围：0 ~ 7。
u8MotAdjSft2[HDR_EX_MOT_LUT_X_NUM]	MotAdj2，MotAdj3的横轴节点，以二的幂次方累加，不建议调整。值域范围：0 ~ 7。 HDR_EX_MOT_LUT_X_NUM = 6。

注意事项

无。
相关结构类型与函式

无。

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 ~ 1023。 DUMMY_NUM = 256。
s16Dummy1[DUMMY_NUM]	目前没作用，预设为-1，值域范围：-1 ~ 3071。 DUMMY_NUM = 256。
s16Dummy2[DUMMY_NUM]	Dummy2[0]默认值-1为关闭3DNR静态区域增强功能，若设置为64以上，则开启此功能，设置的愈大能改善静态区扰动，但纯色的移动物体可能变得更穿透，建议高倍增益下再打开此功能，配合3DNR debug mode从64开始往上调整，调整至静态区扰动有减少即可。Dummy2[1-3]为WDR LTM中coarse coef的微调功能，Dummy2[1 / 2 / 3]分别为低/中/高度区coef微调控制，16为1x，数字越大越强，需注意Dummy2[1]越大暗区越容易死黑，Dummy2[3]越大亮区越容易死白。预设为-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]	Dummy0[2]为HDR mode任意混合比设置，设置为0为全短曝光输出，256为全长曝光输出，128为长短曝光1:1输出。需注意该功能会无视HDR blending（Yth、MotAdj1 / 2 / 3、MoLuBlend）的设置，强制以固定比例的长短曝光混合输出。Dummy0[3]为强制3DNR重新收敛开关，设置一次非-1的值3DNR会重新收敛一次。Dummy0[4 / 5 / 6]为Sharpness低中高频滤波器重新分配的功能，Dummy0[4 / 5 / 6]分别为设置底层的高/中/中低频滤波，设置为-1为不重新分配，设置为0 / 1 / 2分别为赋予其高/中/中低频滤波器，预设为-1，值域范围：-1 ~ 255。 DUMMY_EX_NUM = 256。
s16DummyEx1[DUMMY_EX_NUM]	Dummy1[0]为关闭WDR亮度补偿功能，需注意此功能仅供特殊用途非必要勿开启。Dummy1[1]为Sharpness Debug Map功能选择，-1 / 1 / 2 / 3分别为原DebugMap/StdMap/EdgeStateMap以及D/UD Map。Dummy1[2]为SharpnessEX Debug Map功能选择，-1 / 1 / 2分别为原DebugMap/StdMap/EdgeStateMap，预设为-1，值域范围：-1 ~ 255。 DUMMY_EX_NUM = 256。
s16DummyEx2[DUMMY_EX_NUM]	目前没作用，预设为-1，值域范围：-1 ~ 255。 DUMMY_EX_NUM = 256。
s16DummyEx3	调整扣OBC的位置，设为2后会将OBC的位置往后移，有助于Bayer NR以及3DNR的动静判断，需注意该功能无法根据增益开关，且开启此功能后3DNR MdTh/GainbyY的数值必须重新调整。预设为-1，值域范围：-1 ~ 255。
s16DummyEx4	目前没作用，预设为-1，值域范围：-1 ~ 255。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_ROI结构体¶

类型结构体（Type Structure）¶

说明

设定ROI的类型结构体。

可依据需求定义画面中的ROI区块，进行不同的锐化，降躁，已及yuvgamma调整。
定义

typedef struct MI_ISP_IQ_ROIType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_ROIWinType_t stROI[ROI_WIN_NUM];

MI_U8 u8SharpStr[ROI_WIN_NUM];

MI_U8 u8SharpEXStr[ROI_WIN_NUM];

MI_U8 u8NRStr[ROI_WIN_NUM];

MI_ISP_IQ_YuvGammaParam_t stYUVGamma;

} MI_ISP_IQ_ROIType_t;

名称

变量名称	描述
bEnable	设定ROI功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stROI	设定ROI的位置讯息。ROI_WIN_NUM = 8。
u8SharpStr	设定各ROI基于Sharpness模块的设定调整锐化强度。值域范围：0 ~ 255。64 = 1x，ROI_WIN_NUM = 8。
u8SharpEXStr	设定各ROI基于SharpnessEX模块的设定调整锐化强度。值域范围：0 ~ 255。64 = 1x，ROI_WIN_NUM = 8。
u8NRStr	设定各ROI基于NRLuma_Adv模块的设定调整降躁的强度。值域范围：0 ~ 127。64 = 1x，ROI_WIN_NUM = 8。
stYUVGamma	设定ROI的YUV Gamma curve。注意: 8个ROI皆套用此YUVGamma的设定

注意事项

SharpStr是作用在stdv上(放大/缩小该ROI区块内各像素的stdv值)，若Sharpness模块中的GainbyStd皆设为一致，该参数则无效果，SharpEXStr亦然。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetROI(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ROIType_t *data);

MI_S32 MI_ISP_IQ_GetROI(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ROIType_t *data);

ROI窗类型结构体（ROI Window Type Structure）¶

说明

设定ROI的位置。
定义

typedef struct MI_ISP_IQ_ROIWinType_s

{

MI_U32 u16StartX;

MI_U32 u16StartY;

MI_U32 u16Width;

MI_U32 u16Height;

} MI_ISP_IQ_ROIWinType_t;

名称

变量名称	描述
u16StartX	ROI起始位置的实际X坐标值，值域0 ~ 输入影像的宽度。
u16StartY	ROI起始位置的实际Y坐标值，值域0 ~ 输入影像的高度。
u16Width	ROI框的宽度值，值域0 ~ 输入影像的宽度。
u16Height	ROI框的高度值，值域0 ~ 输入影像的高度。

注意事项

无。
相关结构类型与函式

MI_ISP_IQ_ROIType_t

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的横轴节点，值域范围：3 ~ 15，有31个节点，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[31]，若X轴的最后一个节点大于65535，则Y轴的最后一个节点为GlobalToneLut[30]+GlobalToneLut[31]，主要是为了让global tone能完全使用所有动态区间，也就是解决最后一个节点不一定刚好落在(x, y) = (65535, 4095)的问题，假设X轴的最后一个节点超过65535，那Y轴也要超过4095，才能让此节点和前一个节点的线段刚好通过(x, y) = (65535, 4095)。如需调整，建议用Excel画出原本的曲线，调整GlobalToneSft将想要细调的区间切细后，找到对应的GlobalToneLut，确认效果和先前一致后，再调整GlobalToneLut。WDR_CURVE_FULL_LUT_X_NUM = 31。
u16GlobalToneLut [WDR_CURVE_FULL_LUT_Y_NUM]	Global tone的纵轴节点，值域范围：0 ~ 4095。功能和DarkToneEnhance相同。WDR_CURVE_FULL_LUT_Y_NUM = 32。
u16Curve1 [WDR_CURVE_FULL_CURVE_NUM]	前级亮度调整曲线，值域范围：0 ~ 4095。横轴为输入亮度，纵轴为输出亮度，值越大则「没有经过直方图均衡化处理的影像」越亮。输出结果会依据Strength和WDRStrByY的比例来混合经过直方图均衡化处理的结果，剩下的比例会混合经过Curve1处理的结果。 WDR_CURVE_FULL_CURVE_NUM = 33。
u16Curve2 [WDR_CURVE_FULL_CURVE_NUM]	后级亮度调整曲线，值域范围：0 ~ 4095。横轴为输入亮度，纵轴为输出亮度，值越大则最终影像越亮。 WDR_CURVE_FULL_CURVE_NUM = 33。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_WDRCurveAlignHDRtoLDR结构体¶

类型结构体（Type Structure）¶

说明

设定WDRCurveAlignHDRtoLDR的类型结构体。
定义

typedef struct MI_ISP_IQ_WDRCurveAlignHDRtoLDR_TYPE_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U32 u16HDRRatio;

MI_U8 u8CompleteFlag;

MI_U16 u16WDRCurve2[WDR_CONVERT_WDR_CURVE_2_NUM];

MI_U8 u8WDRCurveSft[WDR_CONVERT_WDR_CURVE_F_SFT_NUM];

MI_ISP_IQ_IntpLut_t strWDRCompStrLut;

MI_ISP_IQ_IntpLut_t strWDRImproveDRStrLut;

MI_U16 u16WDRCurve[WDR_CONVERT_WDR_CURVE_F_NUM];

} MI_ISP_IQ_WDRCurveAlignHDRtoLDR_TYPE_t;

名称

变量名称	描述
bEnable	设定WDRCurveAlignHDRtoLDR功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16HDRRatio	HDR Ratio 数值，值域范围 : 1024 ~ 65535 (1x = 1024)。
u8CompleteFlag	显示转换WDRAlignHDRtoLDR的状况旗标(仅限读取)，值域范围：0 ~ 1。
u16WDRCurve2[WDR_CONVERT_WDR_CURVE_2_NUM]	调整WDR后级亮度调整曲线，值域范围：0 ~ 4095。 WDR_CONVERT_WDR_CURVE_2_NUM = 33。
u8WDRCurveSft[WDR_CONVERT_WDR_CURVE_F_SFT_NUM]	WDR Curve的横轴节点，值域范围： 3 ~ 15。 WDR_CONVERT_WDR_CURVE_F_SFT_NUM = 31。
strWDRCompStrLut.u16NumOfPoints	设置WDR Compensate Strength的节点个数。值域范围：0 ~ 16。
strWDRCompStrLut.s32Y[INTP_LUT_NUM]	设置WDR Compensate Strength的强度，值越大表示整体越偏亮；值越小表示整体越偏暗，值域范围：1 ~ 255 (默认值为1x = 128)。 INTP_LUT_NUM = 16。
strWDRCompStrLut.s32X[INTP_LUT_NUM]	设置HDR长短曝的曝光比例（1024 = 1x）。INTP_LUT_NUM = 16。
strWDRImproveDRStrLut.u16NumOfPoints	设置WDR Improve DR Strength节点个数。值域范围：0 ~ 16。
strWDRImproveDRStrLut.s32Y[INTP_LUT_NUM]	设置WDR Improve DR Strength的强度，值越大表示亮区动态范围越好；值越小表示亮区动态范围越差，值域范围：0 ~ 100。INTP_LUT_NUM = 16。
strWDRImproveDRStrLut.s32X[INTP_LUT_NUM]	设置HDR长短曝的曝光比例（1024 = 1x）。INTP_LUT_NUM = 16。
u16WDRCurve[WDR_CONVERT_WDR_CURVE_F_NUM]	产生输出的WDR Curve，值域范围：0 ~ 4095。 WDR_CONVERT_WDR_CURVE_F_NUM = 32。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetWDRCurveAlignHDRtoLDR(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_WDRCurveAlignHDRtoLDRType_t *data);

MI_S32 MI_ISP_IQ_GetWDRCurveAlignHDRtoLDR(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_WDRCurveAlignHDRtoLDRType_t *data);

MI_ISP_IQ_WDRCurveAlignLDRtoHDR结构体¶

类型结构体（Type Structure）¶

说明

设定WDRCurveAlignLDRtoHDR的类型结构体。
定义

typedef struct MI_ISP_IQ_WDRCurveAlignLDRtoHDR_TYPE_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_U16 u16HDRRatio;

MI_U8 u8ImproveStr;

MI_U8 u8CompleteFlag;

MI_U16 u16WDRCurve2[WDR_CONVERT_WDR_CURVE_2_NUM];

MI_U16 u16HDRAvgYx10;

MI_U16 u16LDRAvgYx10;

MI_U8 u8WDRCurveSft[WDR_CONVERT_WDR_CURVE_F_SFT_NUM];

MI_U16 u16HDRWDRCurve[WDR_CONVERT_WDR_CURVE_F_NUM];

MI_U16 u16LDRWDRCurve[WDR_CONVERT_WDR_CURVE_F_NUM];

} MI_ISP_IQ_WDRCurveAlignLDRtoHDR_TYPE_t;

名称

变量名称	描述
bEnable	设定WDRCurveAlignLDRtoHDR功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16HDRRatio	HDR Ratio 数值，值域范围 : 1024 ~ 65535 (1x = 1024)。
u8ImproveStr	此参数微调一组改善强度，值域范围 : 0 ~ 5 (此建议可填str = 3)。
u8CompleteFlag	显示转换WDRAlignLDRtoHDR的状况旗标(仅限读取)，值域范围：0 ~ 1。
u16WDRCurve2[WDR_CONVERT_WDR_CURVE_2_NUM]	调整WDR后级亮度调整曲线，值域范围：0 ~ 4095。 WDR_CONVERT_WDR_CURVE_2_NUM = 33。
u16HDRAvgYx10	填入HDR目标亮度，值域范围：1 ~ 2550。
u16LDRAvgYx10	填入LDR目标亮度，值域范围：1 ~ 2550。
u8WDRCurveSft[WDR_CONVERT_WDR_CURVE_F_SFT_NUM]	WDR Curve的横轴节点，值域范围： 3 ~ 15。 WDR_CONVERT_WDR_CURVE_F_SFT_NUM = 31。
u16HDRWDRCurve[WDR_CONVERT_WDR_CURVE_F_NUM]	填入HDR使用的WDR Curve，值域范围：0 ~ 4095。 WDR_CONVERT_WDR_CURVE_F_NUM = 32。
u16LDRWDRCurve[WDR_CONVERT_WDR_CURVE_F_NUM]	产生输出的WDR Curve，值域范围：0 ~ 4095。 WDR_CONVERT_WDR_CURVE_F_NUM = 32。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetWDRCurveAlignLDRtoHDR(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_WDRCurveAlignLDRtoHDRType_t *data);

MI_S32 MI_ISP_IQ_GetWDRCurveAlignLDRtoHDR(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_WDRCurveAlignLDRtoHDRType_t *data);

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_SceneDecision结构体¶

类型结构体（Type Structure）¶

说明

设定SceneDecision的类型结构体。
定义

typedef struct MI_ISP_IQ_SceneDecisionType_s {

MI_ISP_IQ_Bool_e bEnable;

MI_U16 u16EffectiveThd[SCENE_NUM];

MI_U16 u16ReliableThd;

MI_U16 u16DebounceThd;

} MI_ISP_IQ_SceneDecisionType_t;

名称

变量名称	描述
bEnable	设定SceneDecision功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16EffectiveThd[SCENE_NUM]	场景模式最高分数大于该阈值，则场景模式有效。值域范围：0 ~ 100。SCENE_NUM = 16。
u16ReliableThd	第一和第二分数之间的差值大于此阈值且第一个分数大于EffectiveThd则将选择第一个场景模式。值域范围：0 ~ 100。
u16DebounceThd	如果现在选择场景模式，它将关闭，直到其分数低于（EffectiveThd – DebounceThd）。值域范围：0 ~ 100。备注 : DebounceThd 应小于 effectiveThd。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetSceneDecision (MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneDecisionType_t *data);

MI_S32 MI_ISP_IQ_GetSceneDecision (MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneDecisionType_t *data)

MI_ISP_IQ_SceneAdj结构体¶

类型结构体（Type Structure）¶

说明

设定SceneAdjType的类型结构体。
定义

typedef struct MI_ISP_IQ_SceneAdjType_s {

MI_ISP_IQ_Bool_e bEnable;

MI_U16 u16ConvSpeed;

MI_U16 u16AdjItem[SCENE_NUM][SCENE_ADJ_NUM];

MI_U16 u16Level[SCENE_NUM][SCENE_ADJ_NUM];

} MI_ISP_IQ_SceneAdjType_t;

名称

变量名称	描述
bEnable	设定IQ SceneAdj功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16ConvSpeed	IQ调整项的收敛速度从目前水平收敛到目标水平。值域范围：0 ~ 100。
u16AdjItem[SCENE_NUM][SCENE_ADJ_NUM]	IQ支持选择9个参数。下面表格是各个索引值对应的参数。横轴参数 - 每项的IQ调整选择，最多支持8个IQ项目。值域范围：0 ~ 8。SCENE_ADJ_NUM = 8。纵轴参数 - 场景侦测模式，目前支持背光、顺光、混光共3种场景模式，最多支持16个场景模式。SCENE_NUM = 16。
u16Level[SCENE_NUM][SCENE_ADJ_NUM]	设定对应参数的调整等级，AdjItem未选择的参数等级将为100(Level数值100表示不调整)。值域范围：0 ~ 200。SCENE_ADJ_NUM = 8。SCENE_NUM = 16。

Index	Parameter	Description
0	ByPass	无调整参数。
1	Denoise_Bayer	调整Bayer denoise的强度。
2	Denoise_Y	调整Luma denoise的强度。
3	Denoise_C	调整Chroma denoise的强度。
4	Sharpness	调整Edge enhancement的强度。
5	Saturation	调整Saturation的强度。
6	Brightness	调整Brightness的强度。
7	Contrast	调整Contrast的强度。
8	Lightness	调整Lightness的强度。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetSceneAdj (MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneAdjType_t *data);

MI_S32 MI_ISP_IQ_GetSceneAdj (MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneAdjType_t *data);

MI_ISP_IQ_SceneStatis结构体¶

类型结构体（Type Structure）¶

说明

设定SceneStatis的类型结构体。
定义

typedef struct MI_ISP_IQ_SceneStatisType_s {

MI_U16 u16ModeScore[SCENE_NUM];

} MI_ISP_IQ_SceneStatisType_t;
名称

变量名称 描述

u16ModeScore[SCENE_NUM] 依据场景模式的分数。值域范围：0 ~ 100。SCENE_NUM = 16。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetSceneStatis (MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneStatisType_t *data);

MI_ISP_IQ_SceneCurLevel结构体¶

类型结构体（Type Structure）¶

说明

设定IQ SceneCurLevel的类型结构体。
定义

typedef struct MI_ISP_IQ_SceneCurLevelType_s {

MI_U16 u16Level[SCENE_PARAM_NUM];

} MI_ISP_IQ_SceneCurLevelType_t;
名称

变量名称 描述

u16Level[SCENE_PARAM_NUM] 显示所有IQ参数的目前强度，100 表示不调整。值域范围：0 ~ 200。SCENE_PARAM_NUM = 16。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_QuerySceneCurLevelInfo (MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneCurLevelType_t *data);

MI_ISP_IQ_SceneInfo结构体¶

类型结构体（Type Structure）¶

说明

设定SceneInfo的类型结构体。
定义

typedef struct MI_ISP_IQ_SceneInfoType_s {

MI_U16 u16Flag[SCENE_NUM];

MI_U16 u16IQCurLevel[SCENE_PARAM_NUM];

MI_U16 u16AECurLevel[SCENE_PARAM_NUM];

MI_U16 u16AWBCurLevel[SCENE_PARAM_NUM];

} MI_ISP_IQ_SceneInfoType_t;

名称

变量名称	描述
u16Flag[SCENE_NUM]	显示现在选择的场景模式。所选场景模式的旗标将变为1。SCENE_NUM = 16。
u16IQCurLevel[SCENE_PARAM_NUM]	显示所有IQ参数的目前强度，100 表示不调整。值域范围：0 ~ 200。SCENE_PARAM_NUM = 16。
u16AECurLevel[SCENE_PARAM_NUM]	显示所有AE参数的目前强度，100 表示不调整。值域范围：0 ~ 200。SCENE_PARAM_NUM = 16。
u16AWBCurLevel[SCENE_PARAM_NUM]	显示所有AWB参数的目前强度，100 表示不调整。值域范围：0 ~ 200。SCENE_PARAM_NUM = 16。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_QuerySceneInfo (MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SceneInfoType_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_S32 MI_ISP_AE_SetFastMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_bool_e *data);

MI_S32 MI_ISP_AE_GetFastMode(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_bool_e *data);

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_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_FDCorParam结构体¶

类型结构体（Type Structure）¶

说明

FDAE所需信息。
定义

typedef struct MI_ISP_AE_FDCorParam_s

{

MI_U16 u16MinX;

MI_U16 u16MinY;

MI_U16 u16MaxX;

MI_U16 u16MaxY;

MI_U8 u8Brightness;

MI_U32 u32Area;

} MI_ISP_AE_FDCorParam_t;

名称

变量名称	描述
u16MinX	FD框左边X的位置。
u16MinY	FD框上面Y的位置。
u16MaxX	FD框右边X的位置。
u16MaxY	FD框下面Y的位置。
u8Brightness	FD框的人脸亮度。
u32Area	FD框的面积。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetFaceDetectInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDInfoType_t *data);

MI_S32 MI_ISP_AE_SetFDExInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDEXInfoType_t *data);

MI_S32 MI_ISP_AE_GetFDExInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDEXInfoType_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);

MI_S32 MI_ISP_AE_SetPlainShortExpoTable(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableType_t *data);

MI_S32 MI_ISP_AE_GetPlainShortExpoTable(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ExpoTableType_t *data);

曝光行程节点参数结构体¶

说明

设定曝光行程中各节点的曝光时间、光圈及增益值。
定义

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_StrategyExAdvType结构体¶

类型结构体 (Type Structure)¶

说明

设定HDR自动曝光之曝光策略。
定义

typedef struct MI_ISP_AE_StrategyExAdvType_s

{

MI_S16 u16WeightRatio1;

MI_S16 u16WeightRatio2;

} MI_ISP_AE_StrategyExAdvType_t;

名称

变量名称	描述
u16WeightRatio1	调整暗阶优先或亮阶优先的权重数值，值域0~1024。当小于512时，即越小越偏重于亮阶优先（Bright Tone Priority）当大于512时，则越大越偏重于暗阶优先（Dark Tone Priority）
u16WeightRatio2	调整AE Target的权重数值，值域0~1024。当值等于0时，即AE Target权重无效，则画面亮度依照Weight1结果为主。当值大于0时，即AE Target权重越大，则画面亮度接近AE Target。

注意事项

无。
相关结构类型与函式

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

MI_S32 MI_ISP_AE_GetStrategyExAdv(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_StrategyExAdvType_t *data);

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_RgbirAe结构体¶

类型结构体（Type Structure）¶

说明

RGBIR mode 的相关AE控制参数
定义

typedef struct MI_ISP_AE_RgbirAeType_s

{

MI_ISP_AE_bool_e bEnable;

MI_U16 u16MaxYWithIR;

MI_U16 u16MinISPGainCompRatio;

} MI_ISP_AE_RgbirAeType_t;

名称

变量名称	描述
bEnable	Enable / disable RGB-IR AE
u16MaxYWithIR	减IR前R、G、B分块容许的最大亮度（Y）值。值域范围：0 ~ 2550
u16MinISPGainCompRatio	使用ISP gain作为画面亮度补偿时的最小转换率，使用的最大ISP gain = 10000/ u16MinISPGainCompRatio （ex：10000 = 1x、1000 = 10x）。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetRgbirAe(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_RgbirAeType_t *data);

MI_S32 MI_ISP_AE_GetRgbirAe(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_RgbirAeType_t *data);

MI_ISP_AE_Hdr结构体¶

类型结构体（Type Structure）¶

说明

具结点内插功能的参数数据设定表。

可用于设定随总增益变化的HDR的长短曝光比例（ex：X轴－total gain；Y轴－HDR长短曝光比例）。
定义

typedef struct MI_ISP_AE_HdrType_s

{

MI_ISP_AE_IntpLutType_t stAeHdrRatio;

} MI_ISP_AE_HdrType_t;
名称

变量名称 描述

stAeHdrRatio 可设定不同总增益下的HDR长短曝曝光倍率，使用方法同MI_ISP_AE_IntpLutType_t
注意事项

无。
相关结构类型与函式

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

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

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_HdrDynamicRatio结构体¶

类型结构体（Type Structure）¶

说明

HDR dynamic ratio结构体。
定义

typedef struct MI_ISP_AE_HdrDynamicRatioType_s

{

MI_ISP_AE_OpType_e enOpType;

MI_ISP_AE_IntpLutType_t ExpoRatio;

MI_ISP_AE_IntpLutType_t ExpoRatioOffset;

MI_U16 u2ExpoRatioSensitivity;

MI_U16 u2ExpoRatioTolerance;

MI_U16 u2ExpoRatio_NodeNum;

MI_U32 u4ExpoRatio_Min[MI_ISP_AE_LUT_16];

MI_U32 u4ExpoRatio_Max[MI_ISP_AE_LUT_16];

MI_S32 u4ExpoRatio_NodeBV[MI_ISP_AE_LUT_16];

MI_ISP_AE_OpType_e enOpTypeShortExpTab;

MI_U32 u4ShortShutterMax;

} MI_ISP_AE_HdrDynamicRatioType_t;

名称

变量名称	描述
enOpType	HDR Dynamic Ratio的工作模式，分别为Auto、Manual模式可选择。设为Auto会自动依据场景动态范围计算出HDR ratio。设为Manual会依据ExpoRatio LUT查出对应HDR ratio。
ExpoRatio	X轴为HDR曝光比例依总增益。 Y轴为HDR长短曝的曝光比例（1024 = 1x）。
ExpoRatioOffset	X轴为HDR长短曝的曝光比例（1024 = 1x）。 Y轴为HDR曝光改变比例上/下限值依HDR Ratio，避免变化剧烈导致画面闪烁。需依据每颗Sensor进行微调此参数，数值越大则HDR Ratio变化越快；数值越小则HDR Ratio变化越慢。
u2ExpoRatioSensitivity	调整HDR比例的灵敏度，数值越小表示越动态范数值越小，值域范围：1 ~ 99。
u2ExpoRatioTolerance	调整HDR比例的收敛条件，数值越小表示越容易收敛，值域范围：1 ~ 100。
u2ExpoRatio_NodeNum	设置HDR比例变化的节点个数。
u4ExpoRatio_Min[MI_ISP_AE_LUT_16]	设置HDR比例的最小值（1024 = 1x）。 MI_ISP_AE_LUT_16 = 16。
u4ExpoRatio_Max[MI_ISP_AE_LUT_16]	设置HDR比例的最大值（1024 = 1x）。 MI_ISP_AE_LUT_16 = 16。
u4ExpoRatio_NodeBV[MI_ISP_AE_LUT_16]	设置HDR比例最小/最大值依BV数值。 MI_ISP_AE_LUT_16 = 16。
enOpTypeShortExpTab	短曝曝光最大值的工作模式，分别为Auto、Manual模式可选择。设为Auto可取得sensor driver短曝曝光的最大数值。设为Manual可自行设定短曝曝光的最大数值。
u4ShortShutterMax	设置短曝曝光最大的数值。

注意事项

无。
相关结构类型与函式

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

MI_S32 MI_ISP_AE_GetHDRMLDynamicRatio(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_HdrDynamicRatioType_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。

注意事项

无。
相关结构类型与函式

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_QueryHDRDynamicRatioInfo结构体¶

类型结构体（Type Structure）¶

说明

HDR dynamic ratio信息结构体。
定义

typedef struct MI_ISP_AE_QueryHdrDynamicRatioInfoType_s

{

MI_U32 u4ExpoRatio[E_SS_AE_HDR_COMB_MODE_MAX];

MI_ISP_AE_bool_e IsHDRRatioChange[E_SS_AE_HDR_COMB_MODE_MAX];

} MI_ISP_AE_QueryHdrDynamicRatioInfoType_t;

名称

变量名称	描述
u4ExpoRatio[E_SS_AE_HDR_COMB_MODE_MAX]	读取当下Exposure Ratio数值。 E_SS_AE_HDR_COMB_MODE_MAX = 1。
IsHDRRatioChange[E_SS_AE_HDR_COMB_MODE_MAX]	读取当下Exposure Ratio是否已变化完成，0表示已变化稳定，1表示正在变化。 E_SS_AE_HDR_COMB_MODE_MAX = 1。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_QueryHDRDynamicRatioInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_QueryHdrDynamicRatioInfoType_t *data);

MI_ISP_AE_HdrComb_Mode结构体¶

类型结构体（Type Structure）¶

说明

HDR Comb mode的类型结构体。
定义

typedef enum

{

E_SS_AE_HDR_COMB_MODE_ML = 0,

E_SS_AE_HDR_COMB_MODE_MAX

} MI_ISP_AE_HdrComb_ModeType_e;
名称

变量名称 描述

E_SS_AE_HDR_COMB_MODE_ML 索引值 = 0。

E_SS_AE_HDR_COMB_MODE_MAX HDR Comb mode列举清单的最大值。
注意事项

无。
相关结构类型与函式

MI_ISP_AE_QueryHdrDynamicRatioInfoType_t

MI_ISP_AE_FDInfo结构体¶

类型结构体（Type Structure）¶

说明

FDAE信息的结构体。
定义

typedef struct MI_ISP_AE_FDInfoType_s

{

MI_U16 u16FDNum;

MI_U32 u32FDInitTarget;

MI_ISP_AE_FDCorParam_t stFDCor[4];

} MI_ISP_AE_FDInfoType_t;
名称

变量名称 描述

u16FDNum 判断有无人脸，0为没人脸，1为有人脸。

u32FDInitTarget 需设置为0。

stFDCor[4] 人脸信息。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetFaceDetectInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDInfoType_t *data);

MI_ISP_AE_FDParam结构体¶

类型结构体（Type Structure）¶

说明

FDAE参数调整。
定义

typedef struct MI_ISP_AE_FDParamType_s

{

MI_ISP_AE_bool_e bEnable;

MI_U8 u8FacetargetY;

MI_U8 u8Tolerance;

MI_U8 u8Speed;

MI_U8 u8FaceChangePcnt;

MI_U8 u8EnvChangePcnt;

MI_U16 u16Upper;

MI_U16 u16Lower;

} MI_ISP_AE_FDParamType_t;

名称

变量名称	描述
bEnable	启动/关闭FDAE。
u8FacetargetY	人脸目标亮度。
u8Tolerance	人脸亮度的收敛区间。
u8Speed	人脸收敛速度。(目前无效)
u8FaceChangePcnt	FDAE跳出收敛区间的人脸亮度变化量。
u8EnvChangePcnt	FDAE跳出收敛区间的环境变化量。
u16Upper	调整人脸亮度变化的上限。
u16Lower	调整人脸亮度变化的下限。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetFaceDetectParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDParamType_t *data);

MI_S32 MI_ISP_AE_GetFaceDetectParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDParamType_t *data);

MI_ISP_AE_FDParamEX结构体¶

类型结构体（Type Structure）¶

说明

FDAE_EX参数调整。
定义

typedef struct MI_ISP_AE_FDParamEXType_s

{

MI_U16 u16DetectEnvChangeRatio;

MI_U16 u16DetectOverExposureDiff;

MI_U16 u16DetectBlackDiff;

MI_U16 u16ConvSpeedX[4];

MI_U16 u16ConvSpeedY[4];

MI_U16 u16UnStableArea[4];

MI_U8 u8StableXTh_UnStableArea;

MI_U8 u8StableYTh_UnStableArea;

MI_U8 u8StableXTh;

MI_U8 u8StableYTh;

MI_U8 u8StableAreaTh;

MI_U8 u8StableCnt;

MI_U8 u8FaceToNoFaceSpeed;

MI_U8 u8CompensationArea;

MI_U8 u8CompensationRatio;

MI_U8 u8ExcludeFaceRatio;

} MI_ISP_AE_FDParamEXType_t;

名称

变量名称	描述
u16DetectEnvChangeRatio	FDAE跳出收敛区间的环境变化量。
u16DetectOverExposureDiff	定义人脸亮度过曝值。
u16DetectBlackDiff	定义人脸亮度偏暗值。
u16ConvSpeedX[4]	人脸亮度收敛速度表X轴。
u16ConvSpeedY[4]	人脸亮度收敛速度表的Y轴。
u16UnStableArea[4]	设置人脸框较不稳定区域。
u8StableXTh_UnStableArea	人脸框在不稳定区域，要判X方向稳定的Th，值越大越容易判为稳定。
u8StableYTh_UnStableArea	人脸框在不稳定区域，要判Y方向稳定的Th，值越大越容易判为稳定。
u8StableXTh	人脸框在稳定区域，要判X方向稳定的Th，值越大越容易判为稳定。
u8StableYTh	人脸框在稳定区域，要判Y方向稳定的Th，值越大越容易判为稳定。
u8StableAreaTh	判断人脸框是否稳定，值越大越容易判为稳定。
u8StableCnt	设置连续判为稳定的次数，满足此Th，才会进行人脸亮度调整。
u8FaceToNoFaceSpeed	从有人脸的AETarget切换到没人脸的AETarget速度，值越大，切换速度越快。
u8CompensationArea	设置人脸目标亮度需补偿的区域，大于此Th代表需补偿。
u8CompensationRatio	设置人脸目标亮度需补偿的大小，值越大代表需补偿越多。
u8ExcludeFaceRatio	判为人脸的Th，值越大，越容易判为人脸。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetFaceDetectParam_EX(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE__FDParamEXType_t *data);

MI_S32 MI_ISP_AE_GetFaceDetectParam_EX(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDParamEXType_t *data);

MI_ISP_AE_FDEXInfo结构体¶

类型结构体（Type Structure）¶

说明

FDEx_Info信息的结构体。
定义

typedef struct MI_ISP_AE_FDEXInfoType_s

{

MI_U8 uIsAEStable;

MI_U8 uIsAFStable;

MI_U8 uIsAEReset;

MI_U8 bTriggerFlag;

MI_U8 bRetriggerFlag;

MI_U8 bForceTriggerFlag;

MI_U16 u16FDNum;

MI_ISP_AE_FDCorParam_t stFDCor[4];

} MI_ISP_AE_FDEXInfoType_t;

名称

变量名称	描述
uIsAEStable	AE Stable的状态。
uIsAFStable	AF Stable的状态。
uIsAEReset	AE Reset的状态。
bTriggerFlag	触发FDAE的旗标。
bRetriggerFlag	重新触发FDAE的旗标。
bForceTriggerFlag	强制触发FDAE的旗标。
u16FDNum	人脸数量。
stFDCor[4]	人脸坐标信息。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetFDExInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDEXInfoType_t *data);

MI_S32 MI_ISP_AE_GetFDExInfo(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDEXInfoType_t *data);

MI_ISP_AE_FDEXParam结构体¶

类型结构体（Type Structure）¶

说明

FDEx_Param信息的结构体。
定义

typedef struct MI_ISP_AE_FDEXParamType_s

{

MI_ISP_AE_Bool_e bEnable;

MI_ISP_AE_Bool_e bEnDbgMsg;

MI_ISP_AE_Bool_e bIgnoreAFStable;

MI_U8 u8FDCalCycleNum;

MI_U16 u16FDStableCountThr;

MI_U16 u16FDUnstableCountThr;

MI_U16 u16FDFastTriggerCountThr

MI_U16 u16FDLumaNodeNum;

MI_S32 u32FDLumaTarget[MI_ISP_AE_LUT_16];

MI_S32 u32FDLumaTolerance[MI_ISP_AE_LUT_16];

MI_S32 u32FDSceneTargetMin[MI_ISP_AE_LUT_16];

MI_S32 u32FDSceneTargetMax[MI_ISP_AE_LUT_16];

MI_S32 u32FDLumaNodeBV[MI_ISP_AE_LUT_16];

} MI_ISP_AE_FDEXParamType_t;

名称

变量名称	描述
bEnable	启动、关闭FDAE_Ex功能。
bEnDbgMsg	启动、关闭FDAE_Ex除错信息。
bIgnoreAFStable	启动、关闭忽略AF稳定状态。
u8FDCalCycleNum	设定人脸侦测每几帧执行一次FDAE_Ex。
u16FDStableCountThr	设定有人脸连续侦测几次后执行FDAE_Ex。
u16FDUnstableCountThr	设定无人脸连续侦测几次后执行Non-FDAE_Ex。
u16FDFastTriggerCountThr	设定快速触发FDAE_Ex机制。
u16FDLumaNodeNum	设定人脸亮度的节点个数。
u32FDLumaTarget[MI_ISP_AE_LUT_16]	设定人脸亮度的目标值。 MI_ISP_AE_LUT_16 = 16。
u32FDLumaTolerance[MI_ISP_AE_LUT_16]	设定人脸亮度的收敛区间。 MI_ISP_AE_LUT_16 = 16。
u32FDSceneTargetMin[MI_ISP_AE_LUT_16]	设定人脸目标亮度的最小值。 MI_ISP_AE_LUT_16 = 16。
u32FDSceneTargetMax[MI_ISP_AE_LUT_16]	设定人脸目标亮度的最大值。 MI_ISP_AE_LUT_16 = 16。
u32FDLumaNodeBV[MI_ISP_AE_LUT_16]	设定人脸亮度依BV数值。 MI_ISP_AE_LUT_16 = 16。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetFDExParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDEXParamType_t *data);

MI_S32 MI_ISP_AE_GetFDExParam(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_FDEXParamType_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_AE_SceneInd结构体¶

类型结构体（Type Structure）¶

说明

设定AE SceneIndType的类型结构体。
定义

typedef struct MI_ISP_AE_SceneIndType_s {

MI_U16 u16Flag[MI_ISP_AE_SCENE_NUM];

} MI_ISP_AE_SceneIndType_t;
名称

变量名称 描述

u16Flag[MI_ISP_AE_SCENE_NUM] AE场景模式的旗标参数。MI_ISP_AE_SCENE_NUM = 16。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetSceneInd (MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_SceneIndType_t *data);

MI_S32 MI_ISP_AE_GetSceneInd (MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_SceneIndType_t *data);

MI_ISP_AE_SceneAdj结构体¶

类型结构体（Type Structure）¶

说明

设定AE SceneAdjType的类型结构体。
定义

typedef struct MI_ISP_AE_SceneAdjType_s {

MI_ISP_AE_bool_e bEnable;

MI_U16 u16ConvSpeed;

MI_U16 u16AdjItem[MI_ISP_AE_SCENE_NUM][MI_ISP_AE_SCENE_ADJ_NUM];

MI_U16 u16Level[MI_ISP_AE_SCENE_NUM][MI_ISP_AE_SCENE_ADJ_NUM];

} MI_ISP_AE_SceneAdjType_t;

名称

变量名称	描述
bEnable	设定AE SceneAdj功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16ConvSpeed	AE调整项的收敛速度从目前水平收敛到目标水平。值域范围：0 ~ 100。
u16AdjItem[MI_ISP_AE_SCENE_NUM][MI_ISP_AE_SCENE_ADJ_NUM]	AE支持选择2个参数。下面表格是各个索引值对应的参数。横轴参数 - 每项的AE调整选择，最多支持8个AE项目。值域范围：0 ~ 1。纵轴参数 - 场景侦测模式，目前支持背光、顺光、混光共3种场景模式，最多支持16个场景模式。MI_ISP_AE_SCENE_NUM = 16。
u16Level[MI_ISP_AE_SCENE_NUM][MI_ISP_AE_SCENE_ADJ_NUM]	设定对应参数的调整等级，AdjItem未选择的参数等级将为100(Level数值100表示不调整)。值域范围：0 ~ 200。MI_ISP_AE_SCENE_ADJ_NUM = 8。MI_ISP_AE_SCENE_NUM = 16。

Index	Parameter	Description
0	ByPass	无调整参数。
1	Exposure	调整自动曝光的目标亮度。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetSceneAdj (MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_SceneAdjType_t *data);

MI_S32 MI_ISP_AE_GetSceneAdj (MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_SceneAdjType_t *data);

MI_ISP_AE_SceneCurLevel结构体¶

类型结构体（Type Structure）¶

说明

设定AE SceneCurLevel的类型结构体。
定义

typedef struct MI_ISP_AE_SceneCurLevelType_s {

MI_U16 u16Level[MI_ISP_AE_SCENE_PARAM_NUM];

} MI_ISP_AE_SceneCurLevelType_t;
名称

变量名称 描述

u16Level[MI_ISP_AE_SCENE_PARAM_NUM] 显示所有AE参数的目前强度，100 表示不调整。值域范围：0 ~ 200。MI_ISP_AE_SCENE_PARAM_NUM = 16。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_QuerySceneCurLevelInfo (MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_SceneCurLevelType_t *data);

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_AWB_RunPeriodParam结构体¶

类型结构体 (Type Structure)¶

说明

AWB RunPeriodParam的类型结构体。
定义

typedef struct MI_ISP_AWB_RunPeriodParam_s

{

MI_U8 u8Period;

} MI_ISP_AWB_RunPeriodParam_t;
名称

变量名称 描述

u8Period 设置AWB几帧执行一次。值域：1~255。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AWB_SetRunPeriod(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_RunPeriodParam_t *data);

MI_S32 MI_ISP_AWB_GetRunPeriod(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_RunPeriodParam_t *data);

MI_ISP_AWB_SceneInd结构体¶

类型结构体（Type Structure）¶

说明

设定AWB SceneIndType的类型结构体。
定义

typedef struct MI_ISP_AWB_SceneIndType_s {

MI_U16 u16Flag[MI_ISP_AWB_SCENE_NUM];

} MI_ISP_AWB_SceneIndType_t;
名称

变量名称 描述

u16Flag[MI_ISP_AWB_SCENE_NUM] AWB场景模式的旗标参数。MI_ISP_AWB_SCENE_NUM = 16。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AWB_SetSceneInd (MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SceneIndType_t *data);

MI_S32 MI_ISP_AWB_GetSceneInd (MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SceneIndType_t *data);

MI_ISP_AWB_SceneAdj结构体¶

类型结构体（Type Structure）¶

说明

设定AWB SceneAdjType的类型结构体。
定义

typedef struct MI_ISP_AWB_SceneAdjType_s {

MI_ISP_AWB_bool_e bEnable;

MI_U16 u16ConvSpeed;

MI_U16 u16AdjItem[MI_ISP_AWB_SCENE_NUM][MI_ISP_AWB_SCENE_ADJ_NUM];

MI_U16 u16Level[MI_ISP_AWB_SCENE_NUM][MI_ISP_AWB_SCENE_ADJ_NUM];

} MI_ISP_AWB_SceneAdjType_t;

名称

变量名称	描述
bEnable	设定AWB SceneAdj功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
u16ConvSpeed	AWB调整项的收敛速度从目前水平收敛到目标水平。值域范围：0 ~ 100。
u16AdjItem[MI_ISP_AWB_SCENE_NUM][MI_ISP_AWB_SCENE_ADJ_NUM]	AWB支持选择11个参数。下面表格是各个索引值对应的参数。横轴参数 - 每项的AWB调整选择，最多支持8个AWB项目。值域范围：0 ~ 10。纵轴参数 - 场景侦测模式，目前支持背光、顺光、混光共3种场景模式，最多支持16个场景模式。MI_ISP_AWB_SCENE_NUM = 16。
u16Level[MI_ISP_AWB_SCENE_NUM][MI_ISP_AWB_SCENE_ADJ_NUM]	设定对应参数的调整等级，AdjItem未选择的参数等级将为100(Level数值100表示不调整)。值域范围：0 ~ 200。MI_ISP_AWB_SCENE_ADJ_NUM = 8。MI_ISP_AWB_SCENE_NUM = 16。

Index	Parameter	Description
0	ByPass	无调整参数。
1	20000K Weight	调整色温20000K的区域权重。
2	15000K Weight	调整色温15000K的区域权重。
3	10000K Weight	调整色温10000K的区域权重。
4	6500K Weight	调整色温 6500K的区域权重。
5	5000K Weight	调整色温 5000K的区域权重。
6	4000K Weight	调整色温 4000K的区域权重。
7	3000K Weight	调整色温 3000K的区域权重。
8	2300K Weight	调整色温 2300K的区域权重。
9	1500K Weight	调整色温 1500K的区域权重。
10	1000K Weight	调整色温 1000K的区域权重。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AWB_SetSceneAdj (MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SceneAdjType_t *data);

MI_S32 MI_ISP_AWB_GetSceneAdj (MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SceneAdjType_t *data);

MI_ISP_AWB_SceneCurLevel结构体¶

类型结构体（Type Structure）¶

说明

设定AWB SceneCurLevel的类型结构体。
定义

typedef struct MI_ISP_AWB_SceneCurLevelType_s {

MI_U16 u16Level[MI_ISP_AWB_SCENE_PARAM_NUM];

} MI_ISP_AWB_SceneCurLevelType_t;
名称

变量名称 描述

u16Level[MI_ISP_AWB_SCENE_PARAM_NUM] 显示所有AWB参数的目前强度，100 表示不调整。值域范围：0 ~ 200。MI_ISP_AWB_SCENE_PARAM_NUM = 16。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AWB_QuerySceneCurLevelInfo (MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_SceneCurLevelType_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_BackUpPositionType_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_StartVCMPosModeType结构体¶

列举结构体（Enum Structure）¶

说明

AF开机位置的列举结构体。
定义

typedef enum

{

E_SS_AF_POS_MIN = 0,

E_SS_AF_POS_MAX = 1,

E_SS_AF_POS_CUSTOMIZE = 2

} MI_ISP_AF_StartVCMPosModeType_e;
名称

变量名称 描述

E_SS_AF_POS_MIN 推到远焦。

E_SS_AF_POS_MAX 推到近焦。

E_SS_AF_POS_CUSTOMIZE 推到指定位置。
注意事项

无。
相关结构类型与函式

MI_ISP_AF_StartVCMPosType_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_Adjust结构体¶

类型结构体（Type Structure）¶

说明

调整AF参数。
定义

typedef struct MI_ISP_AF_AdjustType_s

{

MI_U16 u16AFTable[5];

MI_U16 u16SearchMotorStep_ADJ[5];

MI_U16 u16FocusAfAccCntTh_ADJ[5];

MI_U16 u16FocusAfAccDiffTh_ADJ[5];

MI_U8 u8CheckMotionCnt;

MI_U8 u8MotionAeAccDiffTh;

MI_U8 u8MotionAeAccCntTh;

MI_U8 u8MotionAfAccDiffTh;

MI_U8 u8MotionAfAccCntTh;

MI_U8 u8TriggerWinWgt[256];

MI_U8 u8UnStableCntTh;

MI_U8 u8AEStableCntTh;

MI_U8 u8AfAccDelay;

} MI_ISP_AF_AdjustType_t;

名称

变量名称	描述
u16AFTable[5]	记录VCM对焦位置。
u16SearchMotorStep_ADJ[5]	根据AFTable调整AFContinuous_SearchStart:MotorStep速度（远到近，速度慢到快）。
u16FocusAfAccCntTh_ADJ[5]	根据AFTable调整AFContinuous_SceneChange:FocusAfAccCntTh（建议:远到近，条件逐渐放松）。
u16FocusAfAccDiffTh_ADJ[5]	根据AFTable调整AFContinuous_SceneChange:FocusAfAccDiffTh（建议:远到近，条件逐渐放松）。
u8CheckMotionCnt	每隔多少Frame检查AF触发条件。
u8MotionAeAccDiffTh	AE统计值（Luma）差异比例阀值。
u8MotionAeAccCntTh	AE统计值（Luma）符合的window总数比例阀值。
u8MotionAfAccDiffTh	AF统计值（PreAccSel）差异比例阀值。
u8MotionAfAccCntTh	AF统计值（PreAccSel）符合的window总数比例阀值。
u8TriggerWinWgt[256]	触发权重表。
u8UnStableCntTh	不检查几张不稳定画面的Frame。
u8AEStableCntTh	连续检查几张AE稳定的Frame，才会做AF。
u8AfAccDelay	统计值生效延迟使用。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AF_SetAdjust(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustType_t *data);

MI_S32 MI_ISP_AF_GetAdjust(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustType_t *data);

MI_ISP_AF_AdjustII结构体¶

类型结构体（Type Structure）¶

说明

调整AF参数。
定义

typedef struct MI_ISP_AF_AdjustIIType_s

{

MI_U16 u16VariationTh;

MI_U16 u16FocusAfAccCntTh_ByGain[16];

MI_U16 u16FocusAfAccDiffTh_ByGain[16];

MI_U8 u8DetectFlatTh;

MI_U8 u8FlatStep;

MI_U8 u8AddStep;

MI_U8 u8DecStep;

MI_U8 u8LocalMotionAfTh;

MI_U8 u8LocalMotionAeTh;

MI_U8 u8LocalBlurDetectAfTh;

MI_U8 u8LocalBlurDetectAeTh;

MI_U8 u8AvoidAccJumpTh;

MI_U8 u8AvoidFlatTh;

} MI_ISP_AF_AdjustIIType_t;

名称

变量名称	描述
u16VariationTh	判断为平坦区的Th，越大越容易判为平坦区。
u16FocusAfAccCntTh_ByGain[16]	FocusAfAccCntTh可以随着Total Gain调整，越大代表把原本条件增加。
u16FocusAfAccDiffTh_ByGain[16]	FocusAfAccDiffTh可以随着Total Gain调整，越大代表把原本条件增加。
u8DetectFlatTh	判断为侦测到平坦区的Th，越大越容易侦测到平坦区。
u8FlatStep	平坦区移动的步伐。
u8AddStep	步伐动态变化决定一次增加的量。
u8DecStep	步伐动态变化决定一次减少的量。
u8LocalMotionAfTh	没开启FDAF时，AF统计值侦测是否有Motion，越小越容易判为Motion。
u8LocalMotionAeTh	没开启FDAF时，AE统计值侦测是否有Motion，越小越容易判为Motion。
u8LocalBlurDetectAfTh	AF统计值判断Af是否触发，越小越容易触发。（FDAF开启时，并侦测到人脸，不参考此项）。
u8LocalBlurDetectAeTh	AE统计值判断Af是否触发，越小越容易触发。（FDAF开启时，并侦测到人脸，不参考此项）。
u8AvoidAccJumpTh	避免统计值跳动，干扰找焦点，越大效果越强。
u8AvoidFlatTh	避免误判为平坦区，越小效果越强。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AF_SetAdjustII(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustIIType_t *data);

MI_S32 MI_ISP_AF_GetAdjustII(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustIIType_t *data);

MI_ISP_AF_AdjustIII结构体¶

类型结构体（Type Structure）¶

说明

调整AF参数。
定义

typedef struct MI_ISP_AF_AdjustIIIType_s

{

MI_ISP_AF_AccSelType_e eFDAccSel;

MI_ISP_AF_AccSelType_e eNoFDAccSel;

MI_ISP_AF_AccSelType_e eSearchLowLuxAccSel;

MI_U16 u16BlendLowLuxFilterTh;

MI_U16 u16ProtectTh_Low;

MI_U16 u16ProtectTh_High;

MI_U16 u16StableAWBTh;

MI_U8 u8CompensationRatio;

MI_U8 u8SearchParamScaleUp;

MI_U8 u8LocalBlurDetectAfThUp;

MI_U8 u8LocalStableAfTh;

MI_U8 u8LocalStableAeTh;

} MI_ISP_AF_AdjustIIIType_t;

名称

变量名称	描述
eFDAccSel	FDAF开启并有认到人脸时，选择找焦点的统计值种类。
eNoFDAccSel	FDAF没开启或有开启但没认到人脸时，选择找焦点的统计值种类。
eSearchLowLuxAccSel	低照度时，选择找焦点的统计值种类。
u16BlendLowLuxFilterTh	决定从多少SensorGain要开始混低照度选择的统计值。
u16ProtectTh_Low	设一个保护区间，不要因为LocalBlurDetectAfTh触发AF。
u16ProtectTh_High	设一个保护区间，不要因为LocalBlurDetectAfThUp触发AF。
u16StableAWBTh	根据AWB统计值，判断环境是否稳定，越大越容易判为稳定。
u8CompensationRatio	FDAF开启时，用来补偿人脸在画面中间跟在画面旁边，得到的人脸统计值落差。
u8SearchParamScaleUp	低照度时，能放大判断为焦点的条件。
u8LocalBlurDetectAfThUp	AF统计值判断Af是否触发，越小越容易触发。（FDAF开启时，并侦测到人脸，不参考此项）。
u8LocalStableAfTh	根据AF统计值，判断环境是否稳定，越大越容易判为稳定。
u8LocalStableAeTh	根据Ae统计值，判断环境是否稳定，越大越容易判为稳定。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AF_SetAdjustIII(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustIIIType_t *data);

MI_S32 MI_ISP_AF_GetAdjustIII(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_AdjustIIIType_t *data);

MI_ISP_AF_BackUpPosition结构体¶

类型结构体（Type Structure）¶

说明

FDAF开启并有认到人脸时，没人脸到有人脸时，VCM会先移动到上次有人脸时对到焦的位置。
定义

typedef struct MI_ISP_AF_BackUpPositionType_s

{

MI_ISP_AF_bool_e bEnable;

MI_U8 u8Step;

} MI_ISP_AF_BackUpPositionType_t;

名称

变量名称	描述
bEnable	FDAF开启并有认到人脸时，没人脸到有人脸时，VCM会先移动到上次有人脸时对到焦的位置。
u8Step	设定VCM移动到上次有人脸时对到焦的位置的步伐。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AF_SetBackUpPosition(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_BackUpPositionType_t *data);

MI_S32 MI_ISP_AF_GetBackUpPosition(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_BackUpPositionType_t *data);

MI_ISP_AF_Offset结构体¶

类型结构体（Type Structure）¶

说明

AF找到焦点后，是否把焦点做一个位移。
定义

typedef struct MI_ISP_AF_OffsetType_s

{

MI_ISP_AF_bool_e bEnable;

MI_S16 s16Offset;

} MI_ISP_AF_OffsetType_t;
名称

变量名称 描述

bEnable 开关AF找到焦点后，是否把焦点做一个位移。

s16Offset 决定焦点位移的量。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AF_SetOffset(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_OffsetType_t *data);

MI_S32 MI_ISP_AF_GetOffset(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_OffsetType_t *data);

MI_ISP_AF_FDAF结构体¶

类型结构体（Type Structure）¶

说明

调整FDAF参数。
定义

typedef struct MI_ISP_AF_FDAFType_s

{

MI_ISP_AF_bool_e bEnable;

MI_U16 u16LegacyAF[4];

MI_U16 u16FDStableArea[4];

MI_U8 u8FDSensitivity;

MI_U8 u8FDYSensitivity;

MI_U8 u8FDReTriggerSensitivity;

MI_U8 u8FDStableCntTh;

MI_U8 u8FDAreaStableTh;

MI_U8 u8FDAccStableTh;

MI_U8 u8FDYStableTh;

MI_U8 u8FDCoorXInStableTh;

MI_U8 u8FDCoorYInStableTh;

MI_U8 u8FDCoorXOutStableTh;

MI_U8 u8FDCoorYOutStableTh;

MI_U8 u8PreFDAccStableTh;

MI_U8 u8PreFDMotionStableTh;

MI_U8 u8PreFDYStableTh;

MI_U8 u8PreFDAreaDetectMotion;

MI_U8 u8PreFDCoorDetectMotion;

} MI_ISP_AF_FDAFType_t;

名称

变量名称	描述
bEnable	启用FDAF的开关。
u16LegacyAF[4]	没人脸时，中心对焦位置。
u16FDStableArea[4]	设定FD框稳定范围。
u8FDSensitivity	根据人脸大小，设定FDAF灵敏度，越大越灵敏。
u8FDYSensitivity	根据人脸亮度，设定FDAF灵敏度，越小越灵敏。
u8FDReTriggerSensitivity	判断是否需要重新对焦，越小越容易重新对焦。
u8FDStableCntTh	等待FD框稳定时间，越大越久。
u8FDAreaStableTh	判断人脸框面积是否稳定，越大越容易判为稳定。
u8FDAccStableTh	判断人脸框统计值是否稳定，越大越容易判为稳定。
u8FDYStableTh	判断人脸框亮度是否稳定，越大越容易判为稳定。
u8FDCoorXInStableTh	判断FD框在稳定范围内是否稳定，越大越容易判为稳定。
u8FDCoorYInStableTh	判断FD框在稳定范围内是否稳定，越大越容易判为稳定。
u8FDCoorXOutStableTh	判断FD框在不稳定范围内是否稳定，越大越容易判为稳定。
u8FDCoorYOutStableTh	判断FD框在不稳定范围内是否稳定，越大越容易判为稳定。
u8PreFDAccStableTh	判断AF在做动时，是否需要重新对焦，越大越容易重新对焦。
u8PreFDMotionStableTh	判断AF在做动时，是否需要重新对焦，越大越容易重新对焦。
u8PreFDYStableTh	判断AF在做动时，是否需要重新对焦，越小越容易重新对焦。
u8PreFDAreaDetectMotion	判断AF在做动时，是否需要重新对焦，越小越容易重新对焦。
u8PreFDCoorDetectMotion	判断AF在做动时，是否需要重新对焦，越小越容易重新对焦。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AF_SetFDAF(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_FDAFType_t *data);

MI_S32 MI_ISP_AF_GetFDAF(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_FDAFType_t *data);

MI_ISP_AF_DetectFlatZone结构体¶

类型结构体（Type Structure）¶

说明

侦测平坦区。
定义

typedef struct MI_ISP_AF_DetectFlatZoneType_s

{

MI_ISP_AF_bool_e bEnable;

MI_U16 u16Th;

MI_U16 u16MotorPos;

} MI_ISP_AF_DetectFlatZoneType_t;

名称

变量名称	描述
bEnable	启用侦测平坦区的开关。
u16Th	当SearchPeak过程中，统计值都小于这个Th，即判断为平坦区。
u16MotorPos	当判断为平坦区，VCM移到的位置。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AF_SetDetectFlatZone(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_DetectFlatZoneType_t *data);

MI_S32 MI_ISP_AF_GetDetectFlatZone(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_DetectFlatZoneType_t *data);

MI_ISP_AF_StartVCMPos结构体¶

类型结构体（Type Structure）¶

说明

决定开机默认VCM推到的位置。
定义

typedef struct MI_ISP_AF_StartVCMPosType_s

{

MI_ISP_AF_StartVCMPosModeType_e eMode;

MI_U16 u16Pos;

} MI_ISP_AF_StartVCMPosType_t;
名称

变量名称 描述

eMode 决定开机默认VCM推到的位置，0：MinPos、1：MaxPos、2：客制化。

u16Pos Mode ＝ Customize时，决定移动到的位置。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AF_SetStartVCMPos(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_StartVCMPosType_t *data);

MI_S32 MI_ISP_AF_GetStartVCMPos(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_StartVCMPosType_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	设定色彩转换的手动模式属性结构体。

变量名称	描述
bEnable	设定HDR_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stManual	设定HDR_EX的手动模式属性结构体。

变量名称	描述
E_SS_AE_FALSE	布尔值等于0。
E_SS_AE_TRUE	布尔值等于1。
E_SS_AE_BOOL_MAX	判断布尔值列举列表的最大值。

变量名称	描述
E_SS_AE_OP_TYP_AUTO	自动工作模式。
E_SS_AE_OP_TYP_MANUAL	手动工作模式。
E_SS_AE_OP_TYP_MODE_MAX	判断工作模式列举列表的最大值。

变量名称	描述
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。

参数名称	描述
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_WEIGHT_AVERAGE	切换至平均测光的权重表
E_SS_AE_WEIGHT_CENTER	切换至中央测光的权重表
E_SS_AE_WEIGHT_SPOT	切换至点状测光的权重表

变量名称	描述
E_SS_AE_FLICKER_TYPE_DETECT_60HZ	设定侦测抗闪烁环境为60Hz。
E_SS_AE_FLICKER_TYPE_DETECT_50HZ	设定侦测抗闪烁环境为50Hz。

变量名称	描述
E_SS_AE_STRATEGY_EX_BRIGHTTONE	亮阶优先（过曝抑制）。
E_SS_AE_STRATEGY_EX_DARKTONE	暗阶优先（过暗抑制）。

变量名称	描述
bEnable	PowerLine Flicker功能开关。
u16Ratio	调整PowerLine的补偿倍率，值域范围 : 0 ~ 1024 (128 = 1x)。

变量名称	描述
E_SS_AE_HDR_COMB_MODE_ML	索引值 = 0。
E_SS_AE_HDR_COMB_MODE_MAX	HDR Comb mode列举清单的最大值。

变量名称	描述
u16FDNum	判断有无人脸，0为没人脸，1为有人脸。
u32FDInitTarget	需设置为0。
stFDCor[4]	人脸信息。

变量名称	描述
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	判断状态机列举清单的最大值。

变量名称	描述
E_SS_AF_POS_MIN	推到远焦。
E_SS_AF_POS_MAX	推到近焦。
E_SS_AF_POS_CUSTOMIZE	推到指定位置。

变量名称	描述
bIsStable	获取目前AF是否在收敛状态。
u16CurMotorPos	获取目前Motor位置。

变量名称	描述
bEnable	开关AF找到焦点后，是否把焦点做一个位移。
s16Offset	决定焦点位移的量。

变量名称	描述
eMode	决定开机默认VCM推到的位置，0：MinPos、1：MaxPos、2：客制化。
u16Pos	Mode ＝ Customize时，决定移动到的位置。