ISP软件开发参考

REVISION HISTORY¶

Revision No.	Description	Date
1.0 (API Ver 1.0)	Initial release	04/25/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，固定位置坏点补偿。
STA

Statistics缩写。
WDR

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

YUV Path IQ Description¶

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

MI_ISP_IQ_SetColorToGray

MI_ISP_IQ_SetYuvGamma

MI_ISP_IQ_SetSaturation

MI_ISP_IQ_SetNrChroma

MI_ISP_IQ_SetSharpness

MI_ISP_IQ_SetColorTrans

MI_ISP_IQ_SetNRLumaAdv

MI_ISP_IQ_SetNRChromaAdv

MI_ISP_IQ_SetDefog

MI_ISP_IQ_GetTempInfo

注意事项：

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

举例：

参数	描述
u8MotGain[16]	根据移动程度，调整最终Edge，横轴代表移动程度，越左边代表越移动，值为128，代表不做调整，值越大，Edge越强。值域范围：0 ~ 255。

以sharpness的API内的这个参数为例，此功能只会作用在横轴的最左边，也就是index=0的地方(u8MotGain[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_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_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_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.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.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_SetHsv¶

目的

设定色调参数值。
语法

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¶

目的

取得色调参数值。
语法

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

参数名称 描述

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 影像输入的信道号（一般为0）。

*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_SetNrLuma¶

目的

设定Luma降噪参数值。
语法

MI_S32 MI_ISP_IQ_SetNrLuma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_NrLumaType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetNrLuma¶

目的

取得Luma降噪参数值。
语法

MI_S32 MI_ISP_IQ_GetNrLuma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_NrLumaType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetNrChroma¶

目的

设定颜色降噪参数值。
语法

MI_S32 MI_ISP_IQ_SetNrChroma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_NrChromaType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetNrChroma¶

目的

取得颜色降噪参数值。
语法

MI_S32 MI_ISP_IQ_GetNrChroma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_NrChromaType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

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_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_SetObc¶

目的

设定黑电平参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetObc¶

目的

取得黑电平参数值。
语法

MI_S32 MI_ISP_IQ_GetObc(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_ObcType_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_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_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_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_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_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_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_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_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.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_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_SetPfcEx¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetPfcEx¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetShpEx¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetShpEx¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_SetNr3dEx¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_IQ_GetNr3dEx¶

目的

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

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

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_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_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_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_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_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
参数

参数名称 描述

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_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_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_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
注意

只有当AWB_ATTR_PARAM_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
注意

只有当AWB_ATTR_PARAM_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一直不断被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¶

目的

此功能提供用者使用三个条件定义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¶

目的

此功能可根据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_AF_QueryInfo¶

目的

取得AF参数值。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetHwWin¶

目的

设定AF win。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetHwWin¶

目的

取得AF win。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetHwFilterAttr¶

目的

设定AF filter系数。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetHwFilterAttr¶

目的

取得AF filter系数。
语法

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

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_SetHwFilterSq¶

目的

设定AF filter square系数。
语法

MI_S32 MI_ISP_AF_SetHwFilterSq(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwFilterSqType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_GetHwFilterSq¶

目的

取得AF filter square系数。
语法

MI_S32 MI_ISP_AF_GetHwFilterSq(MI_U32 DevId, MI_U32 Channel, MI_ISP_AF_HwFilterSqType_t *data);
参数

参数名称 描述

DevId ISP设备号。

Channel 影像输入的信道号。

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

参数名称 描述

MI_ISP_OK 成功。

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

无。
举例

无。

MI_ISP_AF_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_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.h
- 库文件：libmi_isp.so
注意

无。
举例

Filepath是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.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_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_MAX = 52,

} MI_ISP_API_ID_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_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_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_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_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_IQ_CaliItem结构体¶

列举结构体 (Enum Structure)¶

说明

校正选项的列举结构体。
定义

typedef enum

{

E_SS_CALI_ITEM_AWB = 0,

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,

E_SS_CALI_ITEM_MAX,

} MI_ISP_CALI_ITEM_e;

名称

变量名称	描述
E_SS_CALI_ITEM_AWB	白平衡补偿校正。
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	白平衡补偿校正，有亮度补偿的功能。
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_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_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_Constrast结构体¶

类型结构体（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设定，建议三个通道设定一样，如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_SaturationType_t *data);

MI_S32 MI_ISP_IQ_GetSaturation(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_SaturationType_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_Hsv结构体¶

类型结构体（Type Structure）¶

说明

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

typedef struct MI_ISP_IQ_HsvType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_HsvAutoAttr_t stAuto;

MI_ISP_IQ_HsvManualAttr_t stManual;

} MI_ISP_IQ_HsvType_t;

名称

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

注意事项

无。
相关结构类型与函式

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

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

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

说明

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

typedef struct MI_ISP_IQ_HsvManualAttr_s

{

MI_ISP_IQ_HsvParam_t stParaAPI;

} MI_ISP_IQ_HsvManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

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_OpType_e enOpType;

MI_ISP_IQ_FalseColorAutoAttr_t stAuto;

MI_ISP_IQ_FalseColorManualAttr_t stManual;

} MI_ISP_IQ_FalseColorType_t;

名称

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

注意事项

无。
相关结构类型与函式

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

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

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

MI_U8 u8EdgeScoreThrd;

MI_U8 u8ChromaThrdOfStrengthMax;

MI_U8 u8ChromaThrdOfStrengthMid;

MI_U8 u8ChromaThrdOfStrengthMin;

MI_U8 u8StrengthMid;

MI_U8 u8StrengthMin;

} MI_ISP_IQ_FalseColorParam_t;

名称

变量名称	描述
u8FreqThrd	摩尔纹的判断频率阀值，超过此阀值判断为摩尔纹。值域范围：0 ~ 255，预设：140。
u8EdgeScoreThrd	摩尔纹的判断Edge阀值，小于此阀值判断为摩尔纹。值域范围：0 ~ 255，预设：31。
u8ChromaThrdOfStrengthMax	最大强度的阀值。值域范围：0 ~ 127，预设：10。
u8ChromaThrdOfStrengthMid	中间强度的阀值。值域范围：0 ~ 127，预设： 40。
u8ChromaThrdOfStrengthMin	最小强度的阀值。值域范围：0 ~ 127，预设：80。
u8StrengthMid	中间强度。值域范围：0 ~ 7，预设：7。
u8StrengthMin	最小强度。值域范围：0 ~ 7，预设：7。

Chroma强度的阀值限制条件示意图

相关结构类型与函式

无。

MI_ISP_IQ_Nr3d结构体¶

类型结构体（Type Structure）¶

说明

设定3D降噪的类型结构体。
定义

typedef struct MI_ISP_IQ_Nr3dType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_Nr3dAutoAttr_t stAuto;

MI_ISP_IQ_Nr3dManualAttr_t stManual;

} MI_ISP_IQ_Nr3dType_t;

名称

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

注意事项

无。
相关结构类型与函式

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

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

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

MI_U16 u16MdGain;

MI_U8 u8TfStr;

MI_U8 u8TfStrEx;

MI_U8 u8MdThdByY[NR3D_BY_Y_NUM];

MI_U8 u8MdGainByY[NR3D_BY_Y_NUM];

MI_U8 u8M2SLut[NR3D_BY_MOT_NUM];

MI_U16 u16TfLut[NR3D_BY_MOT_NUM ];

MI_U8 u8YSfBlendLut[NR3D_BY_MOT_NUM ];

MI_U8 u8YSfBlendOffset;

} MI_ISP_IQ_Nr3dParam_t;

名称

变量名称	描述
u8MdThd	MD侦测，控制motion阀值，小于此阀值判断为静止物体，值越大3D降噪越强。值域范围：0~255。
u16MdGain	MD侦测，控制motion程度，值越大越容易判断为静止物体，3D降噪越强。值域范围：0~1023。
u8TfStr	3D降噪强度控制。值域范围：0~64。
u8TfStrEx	3D降噪强度控制Ex，开此设定强度会更强，但拖影更明显。值域范围：0~64。
u8MdThdByY[NR3D_BY_Y_NUM]	根据亮度控制motion阀值，值越大3D降噪越强。值域范围：0~255。NR3D_BY_Y_NUM = 16
u8MdGainByY[NR3D_BY_Y_NUM]	根据亮度控制motion程度，值越大3D降噪越强。值域范围：0~255。NR3D_BY_Y_NUM = 16
u8M2SLut[NR3D_BY_MOT_NUM]	移动到静止过程中，3D降噪的收敛速度，值越大，收敛越慢，可用来避免拖影。值域范围：0~31。NR3D_BY_MOT_NUM = 16
u16TfLut[NR3D_BY_MOT_NUM]	根据移动程度，控制3D降噪的强度。值域范围：0~4095。NR3D_BY_MOT_NUM = 16
u8YSfBlendLut[NR3D_BY_MOT_NUM]	根据移动程度，控制2D降噪的强度。值域范围：0~16。NR3D_BY_MOT_NUM = 16
u8YSfBlendOffset	根据移动程度，控制写回参考帧，额外补偿3D的比例，值越大补偿3D越多。值域范围：0~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_NrLuma结构体¶

类型结构体（Type Structure）¶

说明

设定Luma降噪的类型结构体。
定义

typedef struct MI_ISP_IQ_NrLumaType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_NrLumaAutoAttr_t stAuto;

MI_ISP_IQ NrLumaManualAttr_t stManual;

} MI_ISP_IQ_NrLumaType_t;

名称

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

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNRLuma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_NrLumaType_t *data);

MI_S32 MI_ISP_IQ_GetNRLuma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_NrLumaType_t *data);

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

说明

设定Luma降噪的自动模式属性结构体。
定义

typedef struct MI_ISP_IQ_NrLumaAutoAttr_s

{

MI_ISP_IQ_NrLumaParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_NrLumaAutoAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

手动模式属性结构体 (Manual Mode Attribute Structure)¶

说明

设定Luma降噪的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_NrLumaManualAttr_s

{

MI_ISP_IQ_NrLumaParam_t stParaAPI;

} MI_ISP_IQ_NrLumaManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体 (Parameter Structure)¶

说明

设定Luma降噪的参数结构体。
定义

typedef struct MI_ISP_IQ_NrLumaParam_s

{

MI_U8 u8Strength;

MI_U8 u8GMaskSel;

MI_U16 u16SpfBlendLut[2];

} MI_ISP_IQ_NrLumaParam_t;

名称

变量名称	描述
u8Strength	最终强度控制，值越大越强，值域范围：0~63。
u8GMaskSel	选择Gaussian Filter size，0代表较小范围，1代表较大范围，值域范围：0~1。
u16SpfBlendLut[NRLUMA_SPF_LUT]	使用Gaussian Filter (SPF) 和Biliteral Filter做blending，若中心点与周围相似，可选用较多Gaussian结果，以取得较平滑效果，若差异较大，则选用Biliteral结果，以保留细节部分。横轴代表相似程度，越右边越相似，纵轴代表Gaussian blending强度，值越大blending越多，值域范围：0~256。NRLUMA_SPF_LUT = 2

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_NRChroma结构体¶

类型结构体 (Type Structure)¶

说明

设定颜色降噪的类型结构体。
定义

typedef struct MI_ISP_IQ_NrChromaType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_NrChromaAutoAttr_t stAuto;

MI_ISP_IQ_NrChromaManualAttr_t stManual;

} MI_ISP_IQ_NrChromaType_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_SetNrChroma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_NrChromaType_t *data);

MI_S32 MI_ISP_IQ_GetNrChroma(MI_U32 DevId, MI_U32 Channel, MI_ISP_IQ_NrChromaType_t *data);

自动模式属性结构体 (Automatic Mode Attribute Structure)¶

说明

设定颜色降噪的自动模式属性结构体。
定义

typedef struct MI_ISP_IQ_NrChromaAutoAttr_s

{

MI_ISP_IQ_NrChromaParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_NrChromaAutoAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

手动模式属性结构体 (Manual Mode Attribute Structure)¶

说明

设定颜色降噪的手动模式属性结构体。
定义

typedef struct MI_ISP_IQ_NrChromaManualAttr_s

{

MI_ISP_IQ_NrChromaParam_t stParaAPI;

} MI_ISP_IQ_NrChromaManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体 (Parameter Structure)¶

说明

设定颜色降噪的参数结构体。
定义

typedef struct MI_ISP_IQ_NrChromaParam_s

{

MI_U8 u8MatchRatio;

MI_U16 u16UvTh;

MI_U16 u16StrengthByCEdge[NRCHROMA_BY_CEDGE_NUM];

} MI_ISP_IQ_NrChromaParam_t;

名称

变量名称	描述
u8MatchRatio	符合比例阀值。值域范围：0 ~ 31。
u16UvTh	U/V 噪声阀值。值域范围：0 ~ 256。
u16StrengthByCEdge[NRCHROMA_BY_CEDGE_NUM]	根据Color Edge强度控制颜色降噪的强度。值域范围：0 ~ 511。NRCHROMA_BY_CEDGE_NUM = 6

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Sharpness结构体¶

类型结构体（Type Structure）¶

说明

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

typedef struct MI_ISP_IQ_SharpnessType_s

{

MI_ISP_IQ_Bool_e bEnable;

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。
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 u8OverShootGain;

MI_U8 u8UnderShootGain;

MI_U8 u8CorLUT[SHARPNESS_LUT_NUM];

MI_U8 u8SclLUT[SHARPNESS_LUT_NUM];

MI_U16 u16EdgeKillLUT[SHARPNESS_LUT_NUM];

MI_U8 u8CornerReduce;

MI_U8 u8DirTh;

MI_U16 u16SharpnessUD[SHARPNESS_DIRECTION_NUM];

MI_U16 u16SharpnessD[SHARPNESS_DIRECTION_NUM];

MI_U8 u8PreCorUD[SHARPNESS_DIRECTION_NUM];

MI_U8 u8PreCorD[SHARPNESS_DIRECTION_NUM];

MI_U8 u8PreCorMotGain;

MI_U8 u8LpfEdgeGainUD;

MI_U8 u8LpfEdgeGainD;

MI_U8 u8WeakDetailEnhance;

MI_U16 u16DetailTh;

MI_U8 u8DetailMotOffset;

MI_U8 u8DetailByY[SHARPNESS_LUT_NUM];

MI_U16 u16OverShootLimit;

MI_U16 u16UnderShootLimit;

MI_U8 u8MotGain[SHARPNESS_BY_MOT_NUM];

} MI_ISP_IQ_SharpnessParam_t;

名称

变量名称	描述
u8OverShootGain	调整edge overshoot的强度程度，值越大锐化越强。值域范围：0 ~ 255。
u8UnderShootGain	调整edge undershoot的强度程度，值越大锐化越强。值域范围：0 ~ 255。
u8CorLUT[SHARPNESS_LUT_NUM]	抑制高亮度平坦区。值域范围：0 ~ 255。 SHARPNESS_LUT_NUM = 6
u8SclLUT[SHARPNESS_LUT_NUM]	根据亮度调整edge输出。值域范围：0 ~ 255。 SHARPNESS_LUT_NUM = 6
u16EdgeKillLUT[SHARPNESS_LUT_NUM]	设定edge的强度输出。值域范围：0 ~ 1023。 SHARPNESS_LUT_NUM = 6
u8CornerReduce	调整周围edge的锐化程度。值域范围：0 ~ 32。
u8DirTh	方向性判断的阀值，大于此阀值，使用有方向性滤波器强化边缘，好处是edge较连续，坏处是小细节的edge被强化，图像不自然。值域范围：0 ~ 255。
u16SharpnessUD[SHARPNESS_DIRECTION_NUM]	增强无方向性的细节纹理，可用于提高发丝、草地…等细小纹理清晰度，SharpnessUD[0]可针对高频做处理，SharpnessUD[1]可针对低频做处理，值越大，Edge越强。值域范围：0 ~ 1023。SHARPNESS_DIRECTION_NUM = 2
u16SharpnessD[SHARPNESS_DIRECTION_NUM]	根据边缘方向强化锐化度，整体增强图像边缘，但调的太强会导致锯齿状，SharpnessD[0]可针对高频做处理，SharpnessD[1]可针对低频做处理，值越大，Edge越强。值域范围：0 ~ 1023。SHARPNESS_DIRECTION_NUM = 2
u8PreCorUD[SHARPNESS_DIRECTION_NUM]	针对无方向性，做coring处理，SharpnessUD[0]针对高频，SharpnessUD[1]针对低频，值越大，Edge越弱。值域范围：0 ~ 63。SHARPNESS_DIRECTION_NUM = 2
u8PreCorD[SHARPNESS_DIRECTION_NUM]	针对方向性，做coring处理，SharpnessUD[0]针对高频，SharpnessUD[1]针对低频，值越大，Edge越弱。值域范围：0 ~ 63。SHARPNESS_DIRECTION_NUM = 2
u8PreCorMotGain	针对移动区域，基于PreCorUD, PreCorD的设定值，做加强coring的动作，值越大，移动区Edge越弱。值域范围：0 ~ 255。
u8LpfEdgeGainUD	选择无方向性的高频、低频的输出比例控制，以SharpnessUD, PreCorUD, PreCorMotGain的结果，再做EdgeGain的控制，值越大，低频的强度越强，高频的强度越弱。值域范围：0 ~ 255。
u8LpfEdgeGainD	选择方向性的高频、低频的输出比例控制，以SharpnessD, PreCorD, PreCorMotGain的结果，再做EdgeGain的控制，值越大，低频的强度越强，高频的强度越弱。值域范围：0 ~ 255。
u8WeakDetailEnhance	针对弱纹理做加强Edge的动作。值域范围：0 ~ 15。
u16DetailTh	SharpnessUD阀值。值域范围：0 ~ 4095。
u8DetailMotOffset	根据移动程度调整SharpnessUD。值域范围：0 ~ 255。
u8DetailByY[SHARPNESS_LUT_NUM]	根据亮度调整SharpnessUD。值域范围：0 ~ 255。SHARPNESS_LUT_NUM = 6
u16OverShootLimit	参考周围最亮点做调整，设0则edge上限为周围最亮点的Y值。值域范围：0 ~ 1023。
u16UndreShootLimit	参考周围最暗点做调整，设0则edge下限为周围最暗点的Y值，也就是不会undershoot。值域范围：0 ~ 1023。
u8MotGain[SHARPNESS_BY_MOT_NUM]	根据移动程度，调整最终Edge，横轴代表移动程度，越左边代表越移动，值为128，代表不做调整，值越大，Edge越强。值域范围：0 ~ 255。SHARPNESS_BY_MOT_NUM = 16

注意事项

无。
相关结构类型与函式

无。

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_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 u8BoxNum;

MI_U8 u8PreEnhance;

MI_ISP_BOOL_e bAutoDetailEnhance;

MI_U8 u8ManualDetailEnhance;

MI_U8 u8GlobalDarkToneEnhance;

MI_U8 u8WDRStrByY[WDR_BY_Y_NUM];

MI_U8 u8Strength;

MI_U8 u8DarkLimit;

MI_U8 u8BrightLimit;

MI_ISP_BOOL_e bGammaSyncEn;

} MI_ISP_IQ_WdrParam_t;

名称

变量名称	描述
u8BoxNum	区域宽动态作用范围的大小。值域范围：0 ~ 4。
u8PreEnhance	亮区动态区间比例。值域范围：1 ~ 6, 11 ~ 15。若开启GammaSyncEn，则PreEnhance会失效。
bAutoDetailEnhance	额外的细节加强。值域范围：0 ~ 1。
u8ManualDetailEnhance	bAutoDetailEnhance = 1时，可控制亮暗处细节的强度，值域范围：0 ~ 255。
u8GlobalDarkToneEnhance	全局宽动态的强度。值域范围：0 ~ 15。
u8WDRStrByY[WDR_BY_Y_NUM]	根据亮度控制宽动态强度。值域范围：0 ~ 255。WDR_BY_Y_NUM = 33
u8Strength	区域宽动态的强度。值域范围：0 ~ 255。
u8DarkLimit	限制暗区的强度。值域范围：0 ~ 255。
u8BrightLimit	限制亮区的强度。值域范围：0 ~ 255。
bGammaSyncEn	WDR和Gamma连动开关。值域范围：0 ~ 1。

注意事项

无。
相关结构类型与函式

无。

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_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_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_DemosaicAutoAttr_t stAuto;

MI_ISP_IQ_DemosaicManualAttr_t stManual;

} MI_ISP_IQ_DemosaicType_t;

名称

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

注意事项

无。
相关结构类型与函式

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

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

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

MI_U8 u8EdgeSmoothThrdY;

MI_U8 u8EdgeSmoothThrdC;

} MI_ISP_IQ_DemosaicParam_t;

名称

变量名称	描述
u8DirThrd	方向性的阀值，超过此阀值，去马赛克会取方向性的结果来替代。值域范围：0 ~ 63，默认值：35。
u8EdgeSmoothThrdY	Smooth edge的亮度阀值，值越小边缘越不清晰，但假边可减少。值域范围：0 ~ 255，默认值：230。
u8EdgeSmoothThrdC	Smooth edge的颜色阀值，值越小边缘越不清晰，但假边可减少。值域范围：0 ~ 127，默认值：20。

注意事项

无。
相关结构类型与函式

无。

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

typedef struct

{

MI_U16 u16NumOfPoints;

MI_S32 s32Y[INTP_LUT_NUM];

MI_S32 s32X[INTP_LUT_NUM];

} MI_ISP_IQ_IntpLut_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。
u16NumOfPoints	RatioByBv节点个数。值域范围：0 ~ 16。
s32Y[INTP_LUT_NUM]	各节点Ratio。值域范围：0 ~ 128（128 = 1x）。 INTP_LUT_NUM = 16。
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 GlobalStrengthByBv;

} MI_ISP_IQ_AlscAdjType_t;

typedef struct

{

MI_U16 u16NumOfPoints;

MI_S32 s32Y[INTP_LUT_NUM];

MI_S32 s32X[INTP_LUT_NUM];

} MI_ISP_IQ_IntpLut_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。
GlobalStrengthByBv	各节点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_DaynightDetection结构体¶

类型结构体（Type Structure）¶

说明

设定Day/Night侦测的类型结构体。
定义

typedef struct MI_ISP_IQ_DaynightDetectionType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_S32 s32D2N_BvThd;

MI_U32 u32N2D_VsbLtScoreThd;

} MI_ISP_IQ_DaynightDetectionType_t;

名称

变量名称	描述
bEnable	设定Day/Night侦测功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
s32D2N_BvThd	用来判断是否要切为Night mode的BV阀值，当Current BV（BV in AEInfo）小于此阀值，则DayNightInfo中的D2N会显示TRUE。值域范围：-1048576 ~ 1048576。
u32N2D_VsbLtScoreThd	用来判断是否要切为Day mode的Score阀值，Score是由可见光与IR光比例所算出的一个分数，分数越高表示可见光成分越多。当目前Score (N2D_VsbLtScore in DayNightInfo)大于此阀值时，DayNightInfo中的N2D会显示TRUE。值域：0 ~ 2000。

注意事项

无。
相关结构类型与函式

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

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

MI_ISP_IQ_DaynightInfo结构体¶

类型结构体（Type Structure）¶

说明

取得Day/Night侦测结果的类型结构体。
定义

typedef struct MI_ISP_IQ_DaynightInfoType_s

{

MI_ISP_IQ_Bool_e bD2N;

MI_ISP_IQ_Bool_e bN2D;

MI_U32 u32N2D_VsbLtScore;

} MI_ISP_IQ_DaynightInfoType_t;

名称

变量名称	描述
bD2N	目前是否需要转为Night mode的flag，值为1时表示目前环境亮度已达要切Night mode标准。注意此flag只有当目前在Day mode的状态下才具有参考意义。
bN2D	目前是否需要转为Day mode的flag，值为1时表示目前环境亮度已达要切Day mode标准。注意此flag只有当目前在Night mode的状态下才具有参考意义。
u32N2D_VsbLtScore	显示目前可见光与IR光比例所算出的分数，分数越高代表环境中可见光的比例越高。使用者可以在认为该切回Day mode的环境下读取此值来决定N2D_VsbLtScoreThd该设多少。

注意事项

无。
相关结构类型与函式

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

MI_ISP_IQ_NrLumaAdv结构体¶

类型结构体（Type Structure）¶

说明

设定Luma_Adv降噪的类型结构体。
定义

typedef struct MI_ISP_IQ_NrLumaAdvType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_NrLumaAdvAutoAttr_t stAuto;

MI_ISP_IQ_NrLumaAdvManualAttr_t stManual;

} MI_ISP_IQ_NrLumaAdvType_t;

名称

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

注意事项

无。
相关结构类型与函式

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

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

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

MI_U8 u8Strength;

MI_U8 u8StrengthByY[NRLUMA_ADV_BY_Y_NUM];

MI_U8 u8StrengthByMot[NRLUMA_ADV_BY_MOT_NUM];

MI_U16 u16EdgeTh[NRLUMA_ADV_EDGE];

MI_U32 u32EdgeGain[NRLUMA_ADV_EDGE];

MI_U8 u8StrengthByType[NRLUMA_ADV_LEVEL_NUM];

} MI_ISP_IQ_NrLumaAdvParam_t;

名称

变量名称	描述
bDbgEn	显示NRLuma_Adv所侦测到的Edge强度，值域范围：0~1。
u8Strength	最终的强度控制，值域范围：0~255。
u8StrengthByY[NRLUMA_ADV_BY_Y_NUM]	针对不同亮度，给予不同NR强度的控制，横轴越右边代表亮度越大，值越大越强，但初始值为0，代表不调整该亮度的强度，所以这边只能把强度作加强的动作，值域范围：0~32。 NRLUMA_ADV_BY_Y_NUM = 10
u8StrengthByMot[NRLUMA_ADV_BY_MOT_NUM]	针对不同motion，给予不同NR强度的控制，横轴越右边代表motion越大。值越大越强，但初始值为0，代表不调整该亮度的强度，所以这边只能把强度作加强的动作，值域范围：0~32。 NRLUMA_ADV_BY_MOT_NUM = 16
u16EdgeTh[NRLUMA_ADV_EDGE]	控制Edge的判断，横轴越右边代表亮度越大。当Edge小于Th，认为是噪声部分，做NR处理，超过Th则判断为Edge，Edge越强则NR越弱。值越大，越不容易判断为Edge。值域范围：0~16383。NRLUMA_ADV_EDGE = 8
u32EdgeGain[NRLUMA_ADV_EDGE]	控制Edge的判断，横轴越右边代表亮度越大。对大于Th的Edge，做Edge强度的控制，Edge越强则NR越弱，值越大，Edge强度越强。值域范围：0~65535。 NRLUMA_ADV_EDGE = 8
u8StrengthByType[NRLUMA_ADV_LEVEL_NUM]	NR内部有两种filter，Type[0]为保留细节的filter强度，Type [1]为去躁效果较好，但会伤细节的filter强度，然后依据edge强度，来对这两种filter结果做blending。值越大NR效果越强。值域范围：0 ~ 9。NRLUMA_ADV_LEVEL_NUM = 2

注意事项

无。
相关结构类型与函式

无。

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

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，值越大越强，值域范围：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。
u8StaticLimitRatio	控制静止区域，NR的强度。值越大越强，值域范围：0~63。
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_ISP_IQ_OpType_e enOpType;

MI_ISP_IQ_PfcAutoAttr_t stAuto;

MI_ISP_IQ_PfcManualAttr_t stManual;

} MI_ISP_IQ_PfcType_t;

名称

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

注意事项

无。
相关结构类型与函式

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

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

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

MI_U8 u8UStrength;

MI_U8 u8VStrength;

MI_U8 u8StrengthByY[PFC_BY_Y_NUM];

MI_U8 u8FlatProtect;

MI_U8 u8SatByY[PFC_LUT_NUM];

MI_U8 u8SatSrcSel;

MI_U8 u8StrengthByContrast[PFC_BY_CONTRAST_NUM];

} MI_ISP_IQ_PfcParam_t;

名称

变量名称	描述
u8Strength	去紫边的强度控制。值越大越强，值域范围：0 ~ 255。
u8UStrength	去紫边作用在U channel的强度。值越大越强，值域范围：0 ~ 63。
u8VStrength	去紫边作用在V channel的强度。值越大越强，值域范围：0 ~ 63。
u8StrengthByY[PFC_BY_Y_NUM]	紫边通常出现在较暗的地方，且周围是高亮区域，所以可针对不同亮度，给予不同去紫边的强度，横轴越右边代表亮度越大。值越大越强，值域范围：0 ~ 255。PFC_BY_Y_NUM = 8
u8FlatProtect	平坦区的判断，避免大面积的紫色被判断为紫边，而做的保护。值越大越多地方不做PFC，值域范围：0 ~ 127。
u8SatByY[PFC_LUT_NUM]	高对比度区的判断，紫边通常出现在对比较高的区域，所以使用SatByY[0]来判断对比的程度。值越大，代表侦测到的对比度需超过SatByY[0]才为高对比度。SatByY[1]用来判断亮度饱和区的程度。值越大，代表越亮的地方越不做PFC，值域范围：0 ~ 25。PFC_LUT_NUM = 2
u8SatSrcSel	判断高对比度区时，可选用是否做NR的前处理。0代表不做NR，1代表有做NR，建议低照下可开启此功能，值域范围：0 ~ 1。
u8StrengthByContrast[PFC_BY_CONTRAST_NUM]	针对对比的程度，给予不同强度的PFC，横轴越右边代表对比越强。值越大PFC越强，值域范围：0 ~ 63。PFC_BY_CONTRAST_NUM = 8

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_PfcEx结构体¶

类型结构体（Type Structure）¶

说明

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

typedef struct MI_ISP_IQ_PfcExType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_PfcExManualAttr_t stManual;

} MI_ISP_IQ_PfcExType_t;
名称

变量名称 描述

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

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

无。
相关结构类型与函式

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

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

手动模式属性结构体 (Manual Mode Attribute Structure)¶

说明

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

typedef struct MI_ISP_IQ_PfcExManualAttr_s

{

MI_ISP_IQ_PfcExParam_t stParaAPI;

} MI_ISP_IQ_PfcExManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体 (Parameter Structure)¶

说明

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

typedef struct MI_ISP_IQ_PfcExParam_s

{

MI_ISP_IQ_Bool_e bDbgEn;

MI_ISP_IQ_Bool_e bGSkipEn;

MI_U8 u8SatMaskSel;

MI_ISP_IQ_Bool_e bSatAmpEn;

MI_U8 u8StrengthByHue[PFC_EX_BY_HUE_NUM];

} MI_ISP_IQ_PfcExParam_t;

名称

变量名称	描述
bDbgEn	显示PFC的作用范围。值域0 ~ 1，1代表开启。
bGSkipEn	对G Channel不做FPC的处理，以保护部分边缘损失的问题。值域0 ~ 1，1代表开启。
u8SatMaskSel	对比区判断的Mask大小选择。值域0 ~ 1，Mask 0范围较小，Mask 1范围较大。
bSatAmpEn	对比区判断时，勾选此功能，可将增加判断对比度时的精确度。
u8StrengthByHue[PFC_EX_BY_HUE_NUM]	根据不同的Hue，给予不同强度的PFC处理，值域范围：0 ~ 255。PFC_EX_BY_HUE_NUM = 12

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_SharpnessEx结构体¶

类型结构体（Type Structure）¶

说明

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

typedef struct MI_ISP_IQ_SharpnessExType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_SharpnessExManualAttr_t stManual;

} MI_ISP_IQ_SharpnessExType_t;
名称

变量名称 描述

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

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

无。
相关结构类型与函式

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

手动模式属性结构体 (Manual Mode Attribute Structure)¶

说明

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

typedef struct MI_ISP_IQ_SharpnessExManualAttr_s

{

MI_ISP_IQ_SharpnessExParam_t stParaAPI;

} MI_ISP_IQ_SharpnessExManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体 (Parameter Structure)¶

说明

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

typedef struct MI_ISP_IQ_SharpnessExParam_s

{

MI_ISP_IQ_BOOL_e bDbgEn;

MI_U8 u8DirSel;

MI_U8 u8DirOffA;

MI_U8 u8MaxRatio;

MI_U8 u8LpfY;

MI_U8 u8SblLutY[6];

MI_U8 u8Sbl2LutY[6];

MI_U8 u8StrengthByHue[24];

} MI_ISP_IQ_SharpnessExParam_t;

名称

变量名称	描述
bDbgEn	debug模式，只显示要补偿的edge于画面上。
u8DirSel	SharpnessD的方向性判断，值为0代表，以各方向的最大值来代表方向，值为1代表，以简单的抗躁方法，判断出来的方向为主。
u8DirOffA	SharpnessD与SharpnessUD，会根据方向的强弱，来决定两边blending的比例，而DirOffA参数，可将SharpnessUD的输出做加强的动作。值域0 ~ 255，值越高，非方向性edge越强。
u8MaxRatio	若线段不连续，可先调整DirTh，若帮助不大，再适当提升此参数。值域0 ~ 255，值越高，edge越强。
u8LpfY	对于CorLut、SclLut的横轴亮度，做LPF的处理，避免亮度因躁点跳动而使用到不同的Cor、Scl结果。值为0，代表关闭LPF，值为1，代表开启。
u8SblLutY[SHARPNESSEX_LUT_Y_NUM]	SharpnessD的低频部分，会先经过Sobel滤波来判断强度，而此参数可根据不同亮度，调整不同的强度，横轴代表亮度，越右边代表越亮。值域0 ~ 255，值越高，判断到的强度越强。 SHARPNESSEX_LUT_Y_NUM = 6
u8Sbl2LutY[SHARPNESSEX_LUT_Y_NUM]	SharpnessD的高频部分，会先经过Sobel滤波来判断强度，而此参数可根据不同亮度，调整不同的强度，横轴代表亮度，越右边代表越亮。值域0 ~ 255，值越高，判断到的强度越强。 SHARPNESSEX_LUT_Y_NUM = 6
u8StrengthByHue[SHARPNESSEX_BY_HUE_NUM]	根据Hue调整Sharpness，可针对特定颜色，加强或减弱edge程度，横轴为Hue，从0度 ~ 360度分为24等分，值越大，edge越强，值为64，代表不做调整。 SHARPNESSEX_BY_HUE_NUM = 24

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Nr3dEx结构体¶

类型结构体（Type Structure）¶

说明

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

typedef struct MI_ISP_IQ_Nr3dExType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_Nr3dExManualAttr_t stManual;

} MI_ISP_IQ_Nr3dExType_t;
名称

变量名称 描述

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

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

无。
相关结构类型与函式

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

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

手动模式属性结构体 (Manual Mode Attribute Structure)¶

说明

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

typedef struct MI_ISP_IQ_Nr3dExManualAttr_s

{

MI_ISP_IQ_Nr3dExParam_t stParaAPI;

} MI_ISP_IQ_Nr3dExManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体 (Parameter Structure)¶

说明

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

typedef struct MI_ISP_IQ_Nr3dExParam_s

{

MI_ISP_IQ_BOOL_e bAREn;

MI_U8 u8ARLumaTh[NR3D_EX_AR_LUMA_NUM];

MI_U8 u8ARMotTh[NR3D_EX_AR_MOT_NUM];

MI_ISP_IQ_BOOL_e bPREn;

MI_U16 u16PRDiffTh;

MI_U8 u8PRRatioConf[NR3D_EX_PR_RATIO_CONF_NUM];

MI_U8 u8PRContrastTh[NR3D_EX_PR_CONTRAST_TH_NUM];

MI_U8 u8PRMotTh[NR3D_EX_PR_MOT_TH_NUM];

} MI_ISP_IQ_Nr3dExParam_t;

名称

变量名称	描述
bAREn	根据亮度与motion信息，限制NR3D强度的开关，值域0 ~ 1。
u8ARLumaTh[NR3D_EX_AR_LUMA_NUM]	当Luma < LumaTh[0]，则NR3D强度不变，当Luma > LumaTh[1]时，NR3D强度为0，值域0 ~ 255。 NR3D_EX_AR_LUMA_NUM = 2
u8ARMotTh[NR3D_EX_AR_MOT_NUM]	当motion < MotTh[0]，则NR3D强度不变，当motion > MotTh[1]时，NR3D强度为0，值域0 ~ 255。NR3D_EX_AR_MOT_NUM = 2
bPREn	辅助NR3D判断紫边的motion开关。
u16PRDiffTh	根据PFC补偿的结果，若该点PFC补偿 > PRDiffTh，则判断为紫边。值域0 ~ 4095，值越小，越容易判断为紫边。
u8PRRatioConf[NR3D_EX_PR_RATIO_CONF_NUM]	判断颜色是否与紫边相似。值域0 ~ 16，横轴为颜色相关性，越右边，越相似紫边，纵轴为紫边判断程度，值越大，越容易判断为紫边。NR3D_EX_PR_RATIO_CONF_NUM = 4
u8PRContrastTh[NR3D_EX_PR_CONTRAST_TH_NUM]	判断对比程度，高对比度时，较有可能出现紫边。值域0 ~ 16，该区对比小于ContrastTh1，则不做处理，大于ContrastTh2，则判断为紫边。NR3D_EX_PR_CONTRAST_TH_NUM = 2
u8PRMotTh[NR3D_EX_PR_MOT_TH_NUM]	若紫边程度高，会以下面设定，来重新决定motion信息，若不为紫边，则motion信息维持不变。设定MotTh1，将此程度以下的motion认为误判信息，所以motion会重新分配为0，代表静止，而大于MotTh2以上，代表正常的motion，则维持不动。值域0 ~ 255。 NR3D_EX_PR_MOT_TH_NUM = 2

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_Dummy结构体¶

类型结构体（Type Structure）¶

说明

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

typedef struct MI_ISP_IQ_DummyType_s

{

MI_ISP_BOOL_e bEnable;

MI_ISP_OP_TYPE_e enOpType;

DUMMY_AUTO_ATTR_t stAuto;

DUMMY_MANUAL_ATTR_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。
stAuto	设定DUMMY的自动模式属性结构体。
stManual	设定DUMMY的手动模式属性结构体。

注意事项

无。
相关结构类型与函式

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

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

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

说明

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

typedef struct MI_ISP_IQ_DummyAutoAttr_s

{

MI_ISP_IQ_DummyParam_t stParaAPI[MI_ISP_AUTO_NUM];

} MI_ISP_IQ_DummyAutoAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

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

说明

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

typedef struct MI_ISP_IQ_DummyManualAttr_s

{

MI_ISP_IQ_DummyParam_t stParaAPI;

} MI_ISP_IQ_DummyManualAttr_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

参数结构体（Parameter Structure）¶

说明

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

typedef struct MI_ISP_IQ_DummyParam_s

{

MI_S16 s16Dummy0[DUMMY_NUM];

MI_S16 s16Dummy1[DUMMY_NUM];

MI_S16 s16Dummy2[DUMMY_NUM];

MI_S16 s16Dummy3;

MI_S16 s16Dummy4;

} MI_ISP_IQ_DummyParam_t;

名称

变量名称	描述
s16Dummy0[DUMMY_NUM]	目前没作用，预设为-1，值域范围: -1 ~ 255。 DUMMY_NUM = 256
s16Dummy1[DUMMY_NUM]	NRLuma bilateral filter强度，s16Dummy1[0]为强度，值域范围: 0 ~ 7，s16Dummy1[1~32]为权重表，横轴为与中心点的差异，差异越小则权重越大，值域范围: 0 ~ 31。DUMMY_NUM = 256
s16Dummy2[DUMMY_NUM]	根据移动程度调整SharpnessUD，和Sharpness DetailMotOffset功能相同，但Sharpness DetailMotOffset只有一个值能调整，其他内部自动内差，而s16Dummy2能依据不同动静程度分别调整。若s16Dummy2有开启，则Sharpness DetailMotOffset自动失效，只有s16Dummy2[0~15]有作用，值域范围: 0 ~ 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_DummyExManualAttr_t stManual;

} MI_ISP_IQ_DummyExType_t;
名称

变量名称 描述

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

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]	Shaprness中的EdgeKillLut横轴节点，用2的幂次方垒加，只有s16DummyEx0 [0~5] 有作用，值域范围: 0 ~ 15。DUMMY_EX_NUM = 256
s16DummyEx1[DUMMY_EX_NUM]	让过完3DNR的结果往当前帧的结果靠近，s16DummyEx1[0]为开关，值域范围: 0 ~ 1，s16DummyEx1[1]为移动最大值，值越小越限制3DNR的结果往当前帧的结果靠近，值域范围: 0 ~ 255，s16DummyEx1[2]为移动阀值，若3DNR的结果和当前帧的差距小于此值，则此功能无作用，值域范围: 0 ~ 255。DUMMY_EX_NUM = 256
s16DummyEx2[DUMMY_EX_NUM]	目前没作用，预设为-1，值域范围: -1 ~ 255。 DUMMY_EX_NUM = 256
s16DummyEx3	3DNR把motion信息像后级传的方式，0代表直接依据当前帧和参考帧的差异，1代表多一个限制，在动到静的情况下，每帧motion信息至多变化1，也就是motion会变化的较慢，值域范围: 0 ~ 1。
s16DummyEx4	目前没作用，预设为-1，值域范围: -1 ~ 255。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_IQ_WDRCurveFull结构体¶

类型结构体（Type Structure）¶

说明

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

typedef struct MI_ISP_IQ_WdrCurveFullType_s

{

MI_ISP_IQ_Bool_e bEnable;

MI_ISP_IQ_OpType_e enOpType;

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

自动模式属性结构体（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_U16 u16FCurve[WDR_CURVE_FULL_CURVE_NUM];

} MI_ISP_IQ_WdrCurveFullParam_t;

名称

变量名称	描述
u16FCurve[WDR_CURVE_FULL_CURVE_NUM]	用来取代WDR中的Dark Tone Enhance Curve与WDRCurveAdv，提供自己修改曲线的功能。不建议改iso更换设定，因为Curve切换时可能出现闪烁。值域范围：0 ~ 4095。WDR_CURVE_FULL_CURVE_NUM = 256

注意事项

无。
相关结构类型与函式

无。

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_U8 u8Strength;

} MI_ISP_IQ_DefogParam_t;
名称

变量名称 描述

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

无。
相关结构类型与函式

无。

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

列举结构体（Enum Structure）¶

说明

布尔值的列举结构体。
定义

typedef enum

{

E_SS_AE_FALSE = 0,

E_SS_AE_TRUE = !E_SS_AE_FALSE,

E_SS_AE_BOOL_MAX

} MI_ISP_AE_bool_e;
名称

变量名称 描述

E_SS_AE_FALSE 布尔值等于0。

E_SS_AE_TRUE 布尔值等于1。

E_SS_AE_BOOL_MAX 判断布尔值列举列表的最大值。
注意事项

无。
相关结构类型与函式

MI_ISP_AE_ExpoInfoType_t

MI_ISP_AE_FlickerExType_t

MI_ISP_AE_FlickerExInfoType_t

MI_ISP_AE_StrategyExType_t

MI_ISP_AE_RgbirAeType_t

MI_ISP_AE_StabilizerType_t

MI_ISP_AE_PowerLineType_t

MI_ISP_AE_OpType结构体¶

列举结构体（Enum Structure）¶

说明

工作模式的列举结构体。
定义

typedef enum

{

E_SS_AE_OP_TYP_AUTO = 0,

E_SS_AE_OP_TYP_MANUAL = ! E_SS_AE_OP_TYP_AUTO,

E_SS_AE_OP_TYP_MODE_MAX

} MI_ISP_AE_OpType_e;
名称

变量名称 描述

E_SS_AE_OP_TYP_AUTO 自动工作模式。

E_SS_AE_OP_TYP_MANUAL 手动工作模式。

E_SS_AE_OP_TYP_MODE_MAX 判断工作模式列举列表的最大值。
注意事项

无。
相关结构类型与函式

MI_ISP_AE_FlickerExType_t

MI_ISP_AE_SmStateType结构体¶

列举结构体（Enum Structure）¶

说明

状态机（State Machine）的列举结构体。
定义

typedef enum

{

E_SS_AE_STATE_NORMAL = 0,

E_SS_AE_STATE_PAUSE = 1,

E_SS_AE_STATE_MAX

} MI_ISP_AE_SmStateType_e;
名称

变量名称 描述

E_SS_AE_STATE_NORMAL 正常模式。

E_SS_AE_STATE_PAUSE 暂停模式。

E_SS_AE_STATE_MAX 判断状态机列举清单的最大值。
注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AE_ExpoValue结构体¶

类型结构体（Type Structure）¶

说明

纪录曝光参数的类型结构体。
定义

typedef struct MI_ISP_AE_ExpoValueType_s

{

MI_U32 u32FNx10;

MI_U32 u32SensorGain;

MI_U32 u32ISPGain;

MI_U32 u32US;

} MI_ISP_AE_ExpoValueType_t;

名称

变量名称	描述
u32FNx10	光圈值×10（ex：光圈F1.8则此项等于18）。
u32SensorGain	Sensor增益值（含sensor模拟增益与sensor数字增益，1024等于1倍）。
u32ISPGain	ISP数字增益（1024等于1倍）。
u32US	曝光时间（μsec）。

注意事项

无。
相关结构类型与函式

MI_ISP_AE_ExpoInfoType_t

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

类型结构体（Type Structure）¶

说明

纪录当前画面亮度及直方统计数据的结构体。
定义

typedef struct MI_ISP_AE_HistWeightYType_s

{

MI_U32 u32LumY;

MI_U32 u32AvgY;

MI_U32 u32Hits[MI_ISP_AE_HIST_BIN];

} MI_ISP_AE_HistWeightYType_t;

名称

变量名称	描述
u32LumY	经区块权重表加权过后的当前画面亮度。
u32AvgY	当前画面的平均亮度（无加权）。
u32Hits[MI_ISP_AE_HIST_BIN]	画面值方图统计资料（共128柱对应到0 ~ 255）。 MI_ISP_AE_HIST_BIN = 128。

注意事项

无。
相关结构类型与函式

MI_ISP_AE_ExpoInfoType_t

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

MI_ISP_AE_ExpoInfo结构体¶

类型结构体（Type Structure）¶

说明

获取当前整体曝光信息的结构体。
定义

typedef struct MI_ISP_AE_ExpoInfoType_s

{

MI_ISP_AE_bool_e bIsStable;

MI_ISP_AE_bool_e bIsReachBoundary;

MI_ISP_AE_ExpoValueType_t stExpoValueLong;

MI_ISP_AE_ExpoValueType_t stExpoValueShort;

MI_ISP_AE_HistWeightYType_t stHistWeightY;

MI_U32 u32LVx10;

MI_S32 s32BV;

MI_U32 u32SceneTarget;

} MI_ISP_AE_ExpoInfoType_t;

名称

变量名称	描述
bIsStable	AE是否收敛（1：收敛，0：尚未收敛）。
bIsReachBoundary	当前曝光参数是否已顶到变动范围上下界（1：顶到，0：未顶到）。
stExpoValueLong	当前曝光参数（如为HDR mode则为长曝曝光参数）。
stExpoValueShort	HDR mode下的短曝曝光参数。
stHistWeightY	当前画面亮度及直方图统计资料。
u32LVx10	当前LV数值×10。
s32BV	当前BV数值×16384。
u32SceneTarget	当前AE目标亮度。

注意事项

无。
相关结构类型与函式

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

MI_ISP_AE_EvComp结构体¶

类型结构体（Type Structure）¶

说明

设定额外增减曝光补偿强度的结构体。
定义

typedef struct MI_ISP_AE_EvCompType_s

{

MI_S32 s32EV;

MI_U32 u32Grad;

} MI_ISP_AE_EvCompType_t;
名称

变量名称 描述

s32EV 额外的增减曝光能量的分子。值域范围：-10 ~ 10。

u32Grad 额外的增减曝光能量的分母。值域范围：1 ~ 10。
注意事项

Ex：s32EV = 1、u32Grad = 2，则曝光能量会较原订自动模式再额外增加½ EV。
相关结构类型与函式

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

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

MI_ISP_AE_Mode结构体¶

类型结构体（Type Structure）¶

说明

设定全自动、半自动或手动曝光模式。
定义

typedef enum

{

E_SS_AE_MODE_A,

E_SS_AE_MODE_AV,

E_SS_AE_MODE_SV,

E_SS_AE_MODE_TV,

E_SS_AE_MODE_M,

E_SS_AE_MODE_MAX

} MI_ISP_AE_ModeType_e;

名称

变量名称	描述
E_SS_AE_MODE_A	全自动曝光模式。
E_SS_AE_MODE_AV	光圈先决模式。
E_SS_AE_MODE_SV	增益先决模式。
E_SS_AE_MODE_TV	快门先决模式。
E_SS_AE_MODE_M	手动模式。

注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AE_IntpLut结构体¶

类型结构体（Type Structure）¶

说明

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

可用于设定随环境亮度变化的画面目标亮度（ex：X轴：BV、Y轴：画面目标亮度）。

或随环境亮度变化的画面目标亮度浮动范围（ex：X轴：BV、Y轴：画面目标亮度的浮动范围）。
定义

typedef struct MI_ISP_AE_IntpLutType_s

{

MI_U16 u16NumOfPoints;

MI_S32 s32Y[MI_ISP_AE_LUT_16];

MI_S32 s32X[MI_ISP_AE_LUT_16];

} MI_ISP_AE_IntpLutType_t;

名称

变量名称	描述
u16NumOfPoints	实际表中数据的有效节点数，最大支持16个节点，也就是可填入16笔X、Y数据。
s32Y[MI_ISP_AE_LUT_16]	对应每一节点的Y 轴参数，如不使用的节点可将参数设0。 MI_ISP_AE_LUT_16 = 16。
s32X[MI_ISP_AE_LUT_16]	对应每一节点的X 轴参数，如不使用的节点可将参数设0。 MI_ISP_AE_LUT_16 = 16。

注意事项

无。
相关结构类型与函式

MI_ISP_AE_HdrType_t

MI_ISP_AE_StrategyType_t

MI_ISP_AE_LumaWgtType_t

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

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

MI_ISP_AE_ConvConditon结构体¶

类型结构体（Type Structure）¶

说明

设定自动曝光的收敛条件。
定义

typedef struct MI_ISP_AE_ConvConditonType_s

{

MI_ISP_AE_ConvThdParam_t stConvThrd;

MI_ISP_AE_ConvSpeedParam_t stConvSpeed;

} MI_ISP_AE_ConvConditonType_t;
名称

变量名称 描述

stConvThrd 设定自动曝光启动收敛或判断收敛完成的区间。

stConvSpeed 设定自动曝光的收敛速度。
注意事项

无。
相关结构类型与函式

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

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

收敛区间结构体¶

说明

设定自动曝光启动收敛或判断收敛完成的区间。
定义

typedef struct MI_ISP_AE_ConvThdParam_s

{

MI_U32 u32InThd;

MI_U32 u32OutThd;

} MI_ISP_AE_ConvThdParam_t;

名称

变量名称	描述
u32InThd	若画面加权亮度与画面目标亮度的差小于此数值，则判断为自动曝光已收敛。值域范围：1 ~ 100。
u32OutThd	若画面加权亮度与画面目标亮度的差大于此数值，则判断为自动曝光未收敛，自动曝光将启动收敛程序。值域范围：2 ~ 100。

注意事项

无。
相关结构类型与函式

MI_ISP_AE_ConvConditonType_t

收敛速度结构体¶

说明

设定自动曝光的收敛速度。

共提供四组节点，X轴为对应的画面亮度，Y轴为对应画面亮度的收敛速度。
定义

typedef struct MI_ISP_AE_ConvSpeedParam_s

{

MI_U32 u32SpeedX[MI_ISP_AE_LUT_4];

MI_U32 u32SpeedY[MI_ISP_AE_LUT_4];

} MI_ISP_AE_ConvSpeedParam_t;

名称

变量名称	描述
u32SpeedX[MI_ISP_AE_LUT_4]	选择要对到的当前画面加权亮度。值域范围：1 ~ 2550。 MI_ISP_AE_LUT_4 = 4。
u32SpeedY[MI_ISP_AE_LUT_4]	收敛速度，基础为1024。（ex：若Y设为500，则当画面亮度刚好落到对应Y的X节点时，自动曝光往曝光目标逼近一次的幅度为500/1024）。值域范围：1 ~ 1024。 MI_ISP_AE_LUT_4 = 4。

注意事项

u32SpeedX[1] & u32SpeedX[2]中间两节点固定内定为当前的画面目标亮度，以便在目标亮度不固定的状况下能自动对应到相应的数值，故手动修改这两项将无效果。
相关结构类型与函式

无。

MI_ISP_AE_ExpoLimit结构体¶

类型结构体（Type Structure）¶

说明

设定自动曝光运作的极值。
定义

typedef struct MI_ISP_AE_ExpoLimitType_s

{

MI_U32 u32MinShutterUS;

MI_U32 u32MaxShutterUS;

MI_U32 u32MinFNx10;

MI_U32 u32MaxFNx10;

MI_U32 u32MinSensorGain;

MI_U32 u32MinISPGain;

MI_U32 u32MaxSensorGain;

MI_U32 u32MaxISPGain;

} MI_ISP_AE_ExpoLimitType_t;

名称

变量名称	描述
u32MinShutterUS	最短Shutter限制（μsec）。值域范围：1 ~ 1000000。
u32MaxShutterUS	最长Shutter限制（μsec）。值域范围：1 ~ 1000000。
u32MinFNx10	最小光圈值（ex：F1.8等于18）。值域范围：10 ~ 220。
u32MaxFNx10	最大光圈值（ex：F1.8等于18）。值域范围：10 ~ 220。
u32MinSensorGain	最小Sensor gain（1024等于1倍）。值域范围：1024 ~ 5242880。
u32MinISPGain	最小ISP gain（1024等于1倍）。值域范围：1024 ~ 262144。
u32MaxSensorGain	最大Sensor gain（1024等于1倍）。值域范围：1024 ~ 5242880。
u32MaxISPGain	最大ISP gain（1024等于1倍）。值域范围：1024 ~ 262144。

注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AE_ExpoTable结构体¶

类型结构体（Type Structure）¶

说明

曝光行程表。
定义

typedef struct MI_ISP_AE_ExpoTableType_s

{

MI_U32 u32NumPoints;

MI_ISP_AE_ExpoPointParam_t stExpoTbl[MI_ISP_AE_LUT_16];

} MI_ISP_AE_ExpoTableType_t;
名称

变量名称 描述

u32NumPoints 曝光行程表的节点数。值域范围：1 ~ 16。

stExpoTbl[MI_ISP_AE_LUT_16] 曝光行程表的节点参数数据。 MI_ISP_AE_LUT_16 = 16。
注意事项

无。
相关结构类型与函式

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

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

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

说明

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

typedef struct MI_ISP_AE_ExpoPointParam_s

{

MI_U32 u32FNumx10;

MI_U32 u32Shutter;

MI_U32 u32TotalGain;

MI_U32 u32SensorGain;

} MI_ISP_AE_ExpoPointParam_t;

名称

变量名称	描述
u32FNumx10	光圈值（ex：F1.8等于18）。值域范围：10 ~ 220。
u32Shutter	快门时间（μsec）。值域范围：1 ~ 1000000。
u32TotalGain	总增益 = sensor增益×ISP数字增益（1024等于1倍）。值域范围：1024 ~ 5242880。
u32SensorGain	Sensor增益（1024等于1倍）。值域范围：1024 ~ 5242880。

注意事项

无。
相关结构类型与函式

无。

MI_ISP_AE_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_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,

E_SS_AE_STRATEGY_EX_AUTO,

} MI_ISP_AE_StrategyExPriority_e;

名称

变量名称	描述
E_SS_AE_STRATEGY_EX_BRIGHTTONE	亮阶优先（过曝抑制）。
E_SS_AE_STRATEGY_EX_DARKTONE	暗阶优先（过暗抑制）。
E_SS_AE_STRATEGY_EX_AUTO	HDR模式时，自动选择最佳曝光策略。

注意事项

无。
相关结构类型与函式

无。

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

类型结构体（Type Structure）¶

说明

Stabilizer结构体。
定义

typedef struct MI_ISP_AE_StabilizerType_s

{

MI_ISP_AE_bool_e bEnable;

MI_U16 u16DiffThd;

MI_U16 u16Percent;

} MI_ISP_AE_StabilizerType_t;

名称

变量名称	描述
bEnable	Stabilizer功能开关。
u16DiffThd	判断目前画面与参考画面是否有变化的阀值，Y差异超过此阀值则判为有变化，小于此阀值则当作无变化。值域0 ~ 20（精度8bits），建议值为2。不建议设定太大，容易导致光线渐亮渐暗的情况下不够连续。
u16Percent	画面比例阀值，当AE在收敛的状况下，画面中被判断为有变化区域占全画面的比例小于此值，则AE维持不变。值域0 ~ 100，默认值为50。

注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AE_PowerLine结构体¶

类型结构体（Type Structure）¶

说明

PowerLine结构体。
定义

typedef struct MI_ISP_AE_PowerLineType_s

{

MI_ISP_AE_bool_e bEnable;

MI_U16 u16Ratio;

} MI_ISP_AE_PowerLineType_t;
名称

变量名称 描述

bEnable PowerLine Flicker功能开关。

u16Ratio 调整PowerLine的补偿倍率，值域范围 : 0 ~ 1024 (128 = 1x)。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetPowerLine(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_PowerLineType_t *data);

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

MI_ISP_AE_PowerLineInfo结构体¶

类型结构体（Type Structure）¶

说明

PowerLineInfo结构体。
定义

typedef struct MI_ISP_AE_PowerLineInfoType_s

{

MI_S16 s2Direction;

MI_U16 u2IsEffective;

MI_U32 u4PreShutter;

} MI_ISP_AE_PowerLineInfoType_t;

名称

变量名称	描述
s2Direction	判断当前shutter由暗变亮或者亮变暗的作用状态，值域范围：-1 ~ 1。当Direction = 1表示此功能生效；当Direction = -1或0表示此功能无生效。
u2IsEffective	显示此功能是否进入工作区间，值域范围 : 0 ~ 1。0表示PowerLine function无做动；1表示PowerLine function有做动。
u4PreShutter	记录前一次的曝光时间数值。

注意事项

无。
相关结构类型与函式

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

MI_ISP_AE_LumaWgt结构体¶

类型结构体（Type Structure）¶

说明

Weight by luminance结构体。
定义

typedef struct MI_ISP_AE_LumaWgtType_s

{

MI_ISP_AE_bool_e bEnable;

MI_ISP_AE_IntpLutType_t WeightLuma;

MI_ISP_AE_IntpLutType_t WeightSatCnt;

MI_U16 u2SatCntThd;

} MI_ISP_AE_LumaWgtType_t;

名称

变量名称	描述
bEnable	Weight by luminance功能开关。
WeightLuma	根据AE统计值-MxN的亮度设定相对应权重，M x N = 16 x 16。 X轴为亮度(x10)，Range : 0 ~ 2550。 Y轴为权重，Range : 0 ~ 256，1x = 256。
WeightSatCnt	根据AE统计值-MxN的亮度大于SatCntThd数量设定相对应权重，M x N = 16 x 16。 X轴为Saturate Count数量，Range : 0 ~ 256。 Y轴为权重，Range : 0 ~ 256，1x = 256。
u2SatCntThd	设定Saturate count的阀值，当此数值调整越大表示亮区权重下降。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetLumaWgt(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_LumaWgtType_t *data);

MI_S32 MI_ISP_AE_GetLumaWgt(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_LumaWgtType_t *data);

MI_ISP_AE_ExpoTableMode结构体¶

类型结构体（Type Structure）¶

说明

AE曝光表操作模式的结构体。
定义

typedef struct MI_ISP_AE_ExpoTableMode_s

{

MI_ISP_AE_OpType_e enOpType;

} MI_ISP_AE_ExpoTableMode_t;

名称

变量名称	描述
enOpType	AE曝光行程表模式选项，分别为Auto、Manual模式可选择。设为Auto会自动依据HDR ratio产生对应的AE曝光表。设为Manual则由使用者设定AE曝光表。适用于AEPlainTbl、AEPlainShortTbl、AEPlainVeryShortTbl。

注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AE_VerInfo结构体¶

类型结构体（Type Structure）¶

说明

AE Version Information结构体。
定义

typedef struct MI_ISP_AE_VerInfoType_s

{

MI_U32 u32ReleaseDate;

MI_U32 u32ReportID;

MI_U8 u8Major;

MI_U8 u8Minor;

MI_U8 u8TestVer;

} MI_ISP_AE_VerInfoType_t;

名称

变量名称	描述
u32ReleaseDate	打印AE FW更新日期。
u32ReportID	打印AE FW反馈问题的数值编号，default：0。
u8Major	打印AE FW主要版本编号。
u8Minor	打印AE FW次要版本编号。
u8TestVer	打印AE FW测试版本编号，default：0。

注意事项

无。
相关结构类型与函式

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

MI_ISP_AE_StabilizerEx结构体¶

类型结构体（Type Structure）¶

说明

StabilizerEx结构体。
定义

typedef struct MI_ISP_AE_StabilizerExType_s

{

MI_U8 u8StableCnt;

MI_U8 u8StableTh;

MI_U8 u8DetectMotionSensitivity;

} MI_ISP_AE_StabilizerExType_t;

名称

变量名称	描述
u8StableCnt	设定要连续判断几次环境稳定，才会开始做AE。
u8StableTh	设定判为环境稳定的条件。
u8DetectMotionSensitivity	设定侦测环境是否稳定的频率。

注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AE_ConvSpeed_Ex结构体¶

类型结构体（Type Structure）¶

说明

设定自动曝光的收敛条件。
定义

typedef struct MI_ISP_AE_ConvSpeed_Ex_s

{ MI_ISP_AE_bool_e bEnable;

MI_ISP_AE_ConvSpeedParam_Ex_t stConvSpeedEx;

} MI_ISP_AE_ConvSpeed_Ex_t;
名称

变量名称 描述

bEnable 开关ConvSpeed_Ex。

stConvSpeedEx 设定自动曝光的收敛速度。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetConvergeSpeed_Ex(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ConvSpeed_Ex_t *data);

MI_S32 MI_ISP_AE_GetConvergeSpeed_EX(MI_U32 DevId, MI_U32 Channel, MI_ISP_AE_ConvSpeed_Ex_t *data);

收敛区间结构体¶

说明

设定自动曝光启动收敛或判断收敛完成的区间。
定义

typedef struct MI_ISP_AE_ConvSpeedParam_Ex_s

{

MI_U32 u32SpeedX[MI_ISP_AE_LUT_16];

MI_U32 u32SpeedY[MI_ISP_AE_LUT_16];

} MI_ISP_AE_ConvSpeedParam_Ex_t;
名称

变量名称 描述

u32SpeedX 设定不同的亮度区间。值域范围：1 ~ 2550。

u32SpeedY 设定不同的亮度区间，给予收敛速度。值域范围：1 ~ 1024。
注意事项

无。
相关结构类型与函式

MI_ISP_AE_ConvSpeed_Ex_t

MI_ISP_AWB_bool结构体¶

列举结构体（Enum Structure）¶

说明

布尔值的列举结构体。
定义

typedef enum

{

E_SS_AWB_FALSE = 0,

E_SS_AWB_TRUE = !E_SS_AWB_FALSE,

E_SS_AWB_BOOL_MAX

} MI_ISP_AWB_bool_e;
名称

变量名称 描述

E_SS_AWB_FALSE 布尔值等于0。

E_SS_AWB_TRUE 布尔值等于1。

E_SS_AWB_BOOL_MAX 判断布尔值列举列表的最大值。
注意事项

无。
相关结构类型与函式

MI_ISP_AWB_QueryInfoType_t

MI_ISP_AWB_AttrExType_t

MI_ISP_AWB_MultiLsType_t

MI_ISP_AWB_StabilizerType_t

MI_ISP_AWB_OpType结构体¶

列举结构体（Enum Structure）¶

说明

工作模式的列举结构体。
定义

typedef enum

{

E_SS_AWB_OP_TYP_AUTO = 0,

E_SS_AWB_OP_TYP_MANUAL = ! E_SS_AWB_OP_TYP_AUTO,

E_SS_AWB_OP_TYP_MODE_MAX

} MI_ISP_AWB_OpType_e;
名称

变量名称 描述

E_SS_AWB_OP_TYP_AUTO 自动工作模式。

E_SS_AWB_OP_TYP_MANUAL 手动工作模式。

E_SS_AWB_OP_TYP_MODE_MAX 判断工作模式列举列表的最大值。
注意事项

无。
相关结构类型与函式

无。

MI_ISP_AWB_AlgoType结构体¶

列举结构体（Enum Structure）¶

说明

自动白平衡算法的列举结构体。
定义

typedef enum

{

E_SS_AWB_ALG_GRAYWORLD = 0,

E_SS_AWB_ALG_NORMAL = 1,

E_SS_AWB_ALG_BALANCE = 2,

E_SS_AWB_ALG_FOCUS = 3,

E_SS_AWB_ALG_MAX

} MI_ISP_AWB_AlgoType_e;

名称

变量名称	描述
E_SS_AWB_ALG_ GRAYWORLD	以所有统计值来计算WB gain。
E_SS_AWB_ALG_NORMAL	以落点数最高的2 ~ 3个色温框内的统计值来计算WB gain。
E_SS_AWB_ALG_BALANCE	以所有落入有效色温框的统计值来计算WB gain。
E_SS_AWB_ALG_FOCUS	WB gain计算会偏向单一色温为主。
E_SS_AWB_ALG_MAX	判断自动白平衡算法列举列表的最大值。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_AttrParam_t

MI_ISP_AWB_AdvType结构体¶

列举结构体（Enum Structure）¶

说明

自动白平衡进阶算法的列举结构体。
定义

typedef enum

{

E_SS_AWB_ADV_DEFAULT = 0,

E_SS_AWB_ADV_ADVANCE = 1,

E_SS_AWB_ADV_MAX

} MI_ISP_AWB_AdvType_e;

名称

变量名称	描述
E_SS_AWB_ADV_DEFAULT	默认的自动白平衡算法。
E_SS_AWB_ADV_ADVANCE	增强的自动白平衡算法，可以开启MI_ISP_AWB_SetAttrEx的设定功能。
E_SS_AWB_ADV_MAX	判断自动白平衡进阶算法列举列表的最大值。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_AttrParam_t

MI_ISP_AWB_SmStateType结构体¶

列举结构体（Enum Structure）¶

说明

状态机（State Machine）的列举结构体。
定义

typedef enum

{

E_SS_AWB_STATE_NORMAL = 0,

E_SS_AWB_STATE_PAUSE = 1,

E_SS_AWB_STATE_MAX

} MI_ISP_AWB_SmStateType_e;
名称

变量名称 描述

E_SS_AWB_STATE_NORMAL 正常模式。

E_SS_AWB_STATE_PAUSE 暂停模式。

E_SS_AWB_STATE_MAX 判断状态机列举清单的最大值。
注意事项

无。
相关结构类型与函式

MI_ISP_AWB_AttrType_t

MI_ISP_AWB_FdAwb_Mode结构体¶

列举结构体（Enum Structure）¶

说明

Face detection AWB算法的列举结构体。
定义

typedef enum

{

E_SS_FDAWB_REFER_TO_SKIN,

E_SS_FDAWB_ASSIGN_SKIN_COLOR

} MI_ISP_AWB_FdAwb_Mode_e;

名称

变量名称	描述
E_SS_FDAWB_REFER_TO_SKIN	此模式会根据人脸信息的分析结果，锁定最有可能的白点范围去做白平衡法。
E_SS_FDAWB_ASSIGN_SKIN_COLOR	此模式会将人脸的统计值落点(白平衡前)，强制移到使用者设定的肤色落点(白平衡后)位置。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_FdAwbParam_t

MI_ISP_AWB_Fwst_AlgoType结构体¶

列举结构体（Enum Structure）¶

说明

FewStatisStrategy 算法的列举结构体。
定义

typedef enum

{

E_SS_AWB_FWST_KEEP = 0,

E_SS_AWB_FWST_MIX_PREFERGAIN = 1,

E_SS_AWB_FWST_MIX_GRAYWORLD = 2,

} MI_ISP_AWB_Fwst_AlgoType_e;

名称

变量名称	描述
E_SS_AWB_FWST_KEEP	维持在前次有足够统计值时得到的WB gain。
E_SS_AWB_FWST_MIX_PREFERGAIN	根据PreferCT设定色温算出的WB Gain。
E_SS_AWB_FWST_MIX_GRAYWORLD	使用GrayWorld算法算出的WB gain。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_FwstStrategyParam_t

MI_ISP_AWB_QueryInfo结构体¶

类型结构体（Type Structure）¶

说明

设定当前整体白平衡信息的类型结构体。
定义

typedef struct MI_ISP_AWB_QueryInfoType_s

{

MI_ISP_AWB_bool_e bIsStable;

MI_U16 u16Rgain;

MI_U16 u16Grgain;

MI_U16 u16Gbgain;

MI_U16 u16Bgain;

MI_U16 u16ColorTemp;

MI_U8 u8WPInd;

MI_ISP_AWB_bool_e bMultiLSDetected;

MI_U8 u8FirstLSInd;

MI_U8 u8SecondLSInd;

} MI_ISP_AWB_QueryInfoType_t;

名称

变量名称	描述
bIsStable	获取目前AWB是否在收敛状态（1：收敛，0：尚未收敛）。
u16Rgain	获取目前设定的白平衡R通道增益。
u16Grgain	获取目前设定的白平衡Gr通道增益。
u16Gbgain	获取目前设定的白平衡Gb通道增益。
u16Bgain	获取目前设定的白平衡B通道增益。
u16ColorTemp	获取目前计算的色温值。
u8WPInd	当开启WpWeight功能，获取目前参考白点色温框index。
bMultiLSDetected	当开启混光色偏校正功能，获取目前是否侦测出混光。关闭：E_SS_AWB_FALSE = 0。开启：E_SS_AWB_TRUE = 1。
u8FirstLSInd	当开启混光色偏校正功能，获取混光中数量第一大光源index×2。
u8SecondLSInd	当开启混光色偏校正功能，获取混光中数量第二大光源index×2。

注意事项

u8FirstLSInd与u8SecondLSInd显示的index值是实际色温框Index值乘以2。也就是说，当u8FirstLSInd为8时，实际代表的色温框index是8/2 = 4 (5000K)；当u8FirstLSInd为9时，实际代表的色温框index是9/2 = 4.5，其中，「.5」的意思代表此光源色温落在index 4 (5000K)与5 (4000K)之间。
相关结构类型与函式

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

MI_ISP_AWB_CtStatistics结构体¶

类型结构体（Type Structure）¶

说明

设定自动白平衡校正统计值的类型结构体。
定义

typedef struct MI_ISP_AWB_CtStatisticsType_s

{

MI_U16 u16Width;

MI_U16 u16Height;

MI_U16 u16StatisX[MI_ISP_AWB_STAT_BLOCK / 2];

MI_U16 u16StatisY[MI_ISP_AWB_STAT_BLOCK / 2];

} MI_ISP_AWB_CtStatisticsType_t;

名称

变量名称	描述
u16Width	有效区宽度。
u16Height	有效区高度。
u16StatisX[MI_ISP_AWB_STAT_BLOCK / 2]	色温域的统计X。 MI_ISP_AWB_STAT_BLOCK / 2 = 128 * 90 / 2 = 5760。
u16StatisY[MI_ISP_AWB_STAT_BLOCK / 2]	色温域的统计Y。 MI_ISP_AWB_STAT_BLOCK / 2 = 128 * 90 / 2 = 5760。

注意事项

无。
相关结构类型与函式

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

个别AWB硬件统计值结构体¶

说明

个别AWB硬件统计值的结构体。
定义

typedef enum

{

MI_U8 uAvgR;

MI_U8 uAvgG;

MI_U8 uAvgB;

} MI_ISP_AWB_AVGS;
名称

变量名称 描述

uAvgR 个别统计值的R平均值。值域0~255。

uAvgG 个别统计值的G平均值。值域0~255。

uAvgB 个别统计值的B平均值。值域0~255。
注意事项

无。
相关结构类型与函式

无。

MI_ISP_AWB_Attr结构体¶

类型结构体（Type Structure）¶

说明

设定AWB属性的类型结构体。
定义

typedef struct MI_ISP_AWB_AttrType_s

{

MI_ISP_AWB_SmStateType_e eState;

MI_ISP_AWB_ModeType_e eOpType;

MI_ISP_AWB_MwbAttrParam_t stManualParaAPI;

MI_ISP_AWB_AttrParam_t stAutoParaAPI;

} MI_ISP_AWB_AttrType_t;

名称

变量名称	描述
eState	设定AWB属性的状态模式。正常：E_SS_AWB_STATE_NORMAL = 0。暂停：E_SS_AWB_STATE_PAUSE = 1。
enOpType	设定AWB属性的工作模式。自动模式：E_SS_AWB_MODE_AUTO = 0。手动模式：E_SS_AWB_MODE_MANUAL = 1。色温手动模式：E_SS_AWB_MODE_CTMANUAL = 2。
stAutoParaAPI	设定AWB属性的自动模式属性结构体。
stManualParaAPI	设定AWB属性的手动模式属性结构体。

注意事项

无。
相关结构类型与函式

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

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

AWB工作模式列举结构体¶

说明

设定AWB工作模式的列举结构体。
定义

typedef enum

{

E_SS_AWB_MODE_AUTO,

E_SS_AWB_MODE_MANUAL,

E_SS_AWB_MODE_CTMANUAL,

E_SS_AWB_MODE_MAX

} MI_ISP_AWB_ModeType_e;

名称

变量名称	描述
E_SS_AWB_MODE_AUTO	自动模式。
E_SS_AWB_MODE_MANUAL	手动模式。
E_SS_AWB_MODE_CTMANUAL	色温自动模式。选择此模式会根据CTMWB的色温设定来套用WB gain。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_AttrType_t

手动模式参数结构体（Manual Parameter Structure）¶

说明

设定的手动模式参数结构体。
定义

typedef struct MI_ISP_AWB_MwbAttrParam_s

{

MI_U16 u16Rgain;

MI_U16 u16Grgain;

MI_U16 u16Gbgain;

MI_U16 u16Bgain;

} MI_ISP_AWB_MwbAttrParam_t;

名称

变量名称	描述
u16Rgain	白平衡R通道增益。值域范围：0 ~ 8191。
u16Grgain	白平衡Gr通道增益。值域范围：0 ~ 8191。
u16Gbgain	白平衡Gb通道增益。值域范围：0 ~ 8191。
u16Bgain	白平衡B通道增益。值域范围：0 ~ 8191。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_AttrType_t

自动模式参数结构体（Automatic Parameter Structure）¶

说明

设定的自动模式参数结构体。
定义

typedef struct MI_ISP_AWB_AttrParam_s

{

MI_U8 u8Speed;

MI_U8 u8ConvInThd;

MI_U8 u8ConvOutThd;

MI_ISP_AWB_AlgoType_e eAlgType;

MI_ISP_AWB_AdvType_e eAdvType;

MI_U8 u8RGStrength;

MI_U8 u8BGStrength;

MI_ISP_AWB_CtLimitParam_t stCTLimit;

MI_ISP_AWB_CtWeightParam_t stLvWeight[MI_ISP_AWB_LV_CT_TBL_NUM];

MI_ISP_AWB_CtRatioParam_t stPreferRRatio[MI_ISP_AWB_LV_CT_TBL_NUM];

MI_ISP_AWB_CtRatioParam_t stPreferBRatio[MI_ISP_AWB_LV_CT_TBL_NUM];

MI_U16 u16WpWeight[MI_ISP_AWB_CT_TBL_NUM];

MS_U32 u32WeightWin[MI_ISP_AWB_WEIGHT_WIN_NUM];

} MI_ISP_AWB_AttrParam_t;

名称

变量名称	描述
u8Speed	自动白平衡算法收敛速度，值越大收敛速度越快。值域范围：0 ~ 100。
u8ConvInThd	设定白平衡的收敛区间，值越小则AWB收敛的与目标值越接近。值域范围：0 ~ 255，不建议将值设太小，容易导致AWB一直处在不稳定状态，建议值32。
u8ConvOutThd	设定要让白平衡离开收敛状态重新计算白平衡的阀值，值越大则AWB收敛稳定后，越不容易重新计算。值域范围：0 ~ 255，不建议将值设太大，建议值64。
eAlgType	自动白平衡算法类型设定，共有以下四种选择： 1. GrayWorld 2. Normal 3. Balance 4. Focus 详细说明请参考MI_ISP_AWB_AlgoType_e
eAdvType	自动白平衡进阶算法的类型，设定为SS_AWB_ADV_ADVANCE时，可以开启MI_ISP_AWB_SetAttrEx API设定功能。
u8RGStrength	自动白平衡R Gain的强度。等于0x80表示R Gain不变大于0x80表示R Gain变大偏红小于0x80表示R Gain变小
u8BGStrength	自动白平衡B Gain的强度。等于0x80表示B Gain不变大于0x80表示B Gain变大偏蓝小于0x80表示B Gain变小
stCTLimit	白平衡算法环境色温，不在色温曲线范围内时，设定增益限制的计算模式及手动增益值，此参数不建议调整。此参数是限制整个色温曲线坐标的范围，超出范围的统计值则不纳入白平衡算法计算。
stLvWeight[MI_ISP_AWB_LV_CT_TBL_NUM]	给定指定环境亮度下各色温的权重，权重越高，最后的目标R、B gain会越倾向该色温的R、B gain，共18组。值域范围：1 ~ 255。
stPreferRRatio[MI_ISP_AWB_LV_CT_TBL_NUM]	给定指定环境亮度下各色温的R ratio，用来微调目标R gain，共18组。值域范围：1 ~ 255。
stPreferBRatio[MI_ISP_AWB_LV_CT_TBL_NUM]	给定指定环境亮度下各色温的B ratio，用来微调目标B gain，共18组。值域范围：1 ~ 255。
u16WpWeight[MI_ISP_AWB_CT_TBL_NUM]	参考白点权重，权重越高的色温越容易被选为参考白点，共10组。值域范围：1 ~ 400，默认值100。
u32WeightWin[MI_ISP_AWB_WEIGHT_WIN_NUM]	将画面区分成9x9个区域，可以分别给定各区域的权重，让白平衡计算更偏向将该区域做灰。值域范围：0 ~ 16。

注意事项

u8RGStrength，u8BGStrength调整建议：依客户喜好调整，例如：某些场景下，客户希望偏绿，可以同时微调u8RGStrength和u8BGStrength，让这两个值同时小于128。
相关结构类型与函式

MI_ISP_AWB_AttrType_t

参数结构体（Parameter Structure）¶

说明

设定定义白平衡的增益范围限制的参数结构体。
定义

typedef struct MI_ISP_AWB_CtLimitParam_s

{

MI_U16 u16MaxRgain;

MI_U16 u16MinRgain;

MI_U16 u16MaxBgain;

MI_U16 u16MinBgain;

} MI_ISP_AWB_CtLimitParam_t;

名称

变量名称	描述
u16MaxRgain	设定高色温时的最大R Gain。值域范围：256 ~ 4095。
u16MinRgain	设定低色温时的最小R Gain。值域范围：256 ~ 4095。
u16MaxBgain	设定高色温时的最大B Gain。值域范围：256 ~ 4095。
u16MinBgain	设定低色温时的最小B Gain。值域范围：256 ~ 4095。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_AttrParam_t

参数结构体（Parameter Structure）¶

说明

设定计算目标R、B gain时各色温的权重的参数结构体。
定义

typedef struct MI_ISP_AWB_CtWeightParam_s

{

MI_U16 u16Weight[MI_ISP_AWB_CT_TBL_NUM];

} MI_ISP_AWB_CtWeightParam_t;

名称

变量名称	描述
u16Weight[MI_ISP_AWB_CT_TBL_NUM]	计算目标R、B gain时各色温的权重，权重越大，目标R、B gain会越倾向该色温R、B gain，MI_ISP_AWB_CT_TBL_NUM = 10。值域范围：1 ~ 255，默认值100。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_AttrParam_t

参数结构体（Parameter Structure）¶

说明

设定微调目标R、B gain所乘上的一个ratio的参数结构体。
定义

typedef struct MI_ISP_AWB_CtRatioParam_s

{

MI_U16 u16Ratio[MI_ISP_AWB_CT_TBL_NUM];

} MI_ISP_AWB_CtRatioParam_t;

名称

变量名称	描述
u16Ratio [MI_ISP_AWB_CT_TBL_NUM]	用来微调各环境色温目标R、B gain所乘上的一个ratio，MI_ISP_AWB_CT_TBL_NUM = 10。值域范围：1 ~ 255，默认值100。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_AttrParam_t

MI_ISP_AWB_AttrEx结构体¶

类型结构体（Type Structure）¶

说明

设定AWB增强属性的类型结构体。
定义

typedef struct MI_ISP_AWB_AttrExType_s

{

MI_ISP_AWB_bool_e bExtraLightEn;

MI_ISP_AWB_AttrExtraLightsourceParam_t stLightInfo[MI_ISP_AWB_EX_LIGHT_CNT];

} MI_ISP_AWB_AttrExType_t;

名称

变量名称	描述
bExtraLightEn	设定自动白平衡计算时是否考虑使用者设的独立色温范围功能的布尔值。关闭：E_SS_AWB_FALSE = 0。开启：E_SS_AWB_TRUE = 1。
stLightInfo[MI_ISP_AWB_EX_LIGHT_CNT]	使用者设定的独立光源点信息。 MI_ISP_AWB_EX_LIGHT_CNT = 4。

注意事项

无。
相关结构类型与函式

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

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

白平衡独立光源点参数结构体（AWB Extra LightSource Parameter Structure）¶

说明

设定白平衡独立光源点的参数结构体。
定义

typedef struct MI_ISP_AWB_AttrExtraLightsourceParam_s

{

MI_U16 u16WhiteRgain;

MI_U16 u16WhiteBgain;

MI_U8 u8AreaSize;

MI_ISP_AWB_bool_e bExclude;

} MI_ISP_AWB_AttrExtraLightsourceParam_t;

名称

变量名称	描述
u16WhiteRgain	此设定值会映像到色温坐标的某一个独立点，不需要参考色温，使用者设定的独立光源点的R Gain值（G × 1024 / R）。值域范围：256 ~ 4095。
u16WhiteBgain	此设定值会映像到色温坐标的某一个独立点，不需要参考色温，使用者设定的独立光源点的B Gain值（G × 1024 / B）。值域范围：256 ~ 4095。
u8AreaSize	使用者设定的独立光源点，在色温坐标的范围，值越大表示范围越广。值域范围：1 ~ 32。
bExclude	设定白平衡演算时排除或包含使用者设定的独立光源点功能的布尔值。在白平衡算法计算时，判定白点是否纳入或排除使用者设定的光源点范围。包含：E_SS_AWB_FALSE = 0。排除：E_SS_AWB_TRUE = 1。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_AttrExType_t

MI_ISP_AWB_MultiLs结构体¶

类型结构体（Type Structure）¶

说明

设定自动白平衡混光偏校正的类型结构体。
定义

typedef struct MI_ISP_AWB_MultiLsType_s

{

MI_ISP_AWB_bool_e bEnable;

MI_U8 u8Sensitive;

MI_U8 u8CaliStrength;

MI_U16 u16CcmForLow[MI_ISP_AWB_MULTILS_CNT];

MI_U16 u16CcmForHigh[MI_ISP_AWB_MULTILS_CNT];

} MI_ISP_AWB_MultiLsType_t;

名称

变量名称	描述
bEnable	设定混光色偏校正功能的布尔值。关闭：E_SS_AWB_FALSE = 0。开启：E_SS_AWB_TRUE = 1。
u8Sensitive	判断混光的敏感度，值越大越容易判断为混光场景。值域范围：1 ~ 10，默认值为5。
u8CaliStrength	最大混光色温差距的色偏校正强度，最大混光差距表示两个光源的落点刚好分别落在StartIdx与EndIdx。实际作用的强度会根据两光源色温差距与最大色温差距的比例做调整。值域范围：0 ~ 100，默认值为100。
u16CcmForLow[MI_ISP_AWB_MULTILS_CNT]	当判断出混光，且将高色温光源做灰时，用来补正低色温光源处色偏的CCM。注意u16CcmForLow[3] ~ [5]（G列）是无作用的，修改请以u16CcmForLow[0] ~ [2]（R列）及u16CcmForLow[6] ~ [8]（B列）为主。值域范围：0 ~ 8191。MI_ISP_AWB_MULTILS_CNT = 9。
u16CcmForHigh[MI_ISP_AWB_MULTILS_CNT]	当判断出混光，且将低色温光源做灰时，用来补正高色温光源处色偏的CCM。注意u16CcmForLow[3] ~ [5]（G列）是无作用的，修改请以u16CcmForLow[0] ~ [2]（R列）及u16CcmForLow[6] ~ [8]（B列）为主。值域范围：0 ~ 8191。MI_ISP_AWB_MULTILS_CNT = 9。

注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AWB_CtCali结构体¶

类型结构体（Type Structure）¶

说明

设定自动白平衡校正的类型结构体。
定义

typedef struct MI_ISP_AWB_CtCaliType_s

{

MI_U16 u16StartIdx;

MI_U16 u16EndIdx;

MI_U16 u16CtParams[MI_ISP_AWB_CT_CALI_CNT];

} MI_ISP_AWB_CtCaliType_t;
名称

变量名称 描述

u16StartIdx 亮区开始索引。

u16EndIdx 亮区结束索引。

u16CtParams[MI_ISP_AWB_CT_CALI_CNT] 色温cali参数。MI_ISP_AWB_CT_CALI_CNT = 40。
注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AWB_CurCtCali结构体¶

类型结构体（Type Structure）¶

说明

自动白平衡色温框数据的类型结构体。
定义

typedef struct MI_ISP_AWB_CurCtCaliType_s

{

MI_U16 u16CtParams[MI_ISP_AWB_CT_CALI_CNT];

} MI_ISP_AWB_CurCtCaliType_t;
名称

变量名称 描述

u16CtParams[MI_ISP_AWB_CT_CALI_CNT] 色温框资料。MI_ISP_AWB_CT_CALI_CNT = 40。
注意事项

无。
相关结构类型与函式

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

MI_ISP_AWB_Ctmwb结构体¶

类型结构体（Type Structure）¶

说明

手动色温白平衡色温的类型结构体。
定义

typedef struct MI_ISP_AWB_CtmwbParam_s

{

MI_U32 u32CT;

} MI_ISP_AWB_CtmwbParam_t;
名称

变量名称 描述

u32CT 色温设定。值域范围：1000 ~ 20000。
注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AWB_SetCtMwbAttr(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_CtmwbParam_t *data);

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

MI_ISP_AWB_Stabilizer结构体¶

类型结构体（Type Structure）¶

说明

AWB stabilizer的类型结构体。
定义

typedef struct MI_ISP_AWB_StabilizerType_s

{

MI_ISP_AWB_bool_e bEnable;

MI_U16 u16GlbGainThd;

MI_U16 u16CountThd;

MI_U16 u16ForceTriGainThd;

} MI_ISP_AWB_StabilizerType_t;

名称

变量名称	描述
bEnable	此功能开关。
u16GlbGainThd	整体WB gain变化的阀值控制。当AWB在收敛状态要重新被trigger，除了满足原有的条件之外（ConvOutThd），还需要整体WB gain变化超出此阀值才会被重新trigger。值域0 ~ 512，建议此值设的与ConvOutThd相同或更小一些即可，默认值是64。
u16CountThd	连续判定要重新trigger AWB的次数阀值。当此值为2则须连续三次满足重新trigger的条件才会重新触发AWB，否则AWB仍会维持在稳定状态。值域0 ~ 100。建议此值不需要设太高，因为会延迟AWB被触发的反应时间。默认值为2。
u16ForceTriGainThd	为了避免环境光源色温瞬间大幅度变化时AWB反应时间因CountThd变慢，我们又定义了一个强制Trigger的gain阀值，只要当Gain变化满足重新trigger AWB的条件，且变化量大于此阀值，则会忽略CountThd直接trigger AWB。值域0 ~ 8191。默认值150。

注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AWB_SpecialCase结构体¶

类型结构体 (Type Structure)¶

说明

AWB SpecialCase的类型结构体。
定义

typedef struct MI_ISP_AWB_SpecialCaseType_s

{

MI_U32 u32CaseNum;

MI_ISP_AWB_SpecialCaseParam_t stCase[MI_ISP_AWB_SPECIAL_CASE_NUM];

} MI_ISP_AWB_SpecialCaseType_t;

名称

变量名称	描述
u32CaseNum	欲使用Case数量。值域0 ~ 4，0等于此功能关闭。
stCase[MI_ISP_AWB_SPECIAL_CASE_NUM]	用来设定每个case的SpecialCase参数。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。

注意事项

无。
相关结构类型与函式

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

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

参数结构体 (Parameter Structure)¶

说明

个别case的参数结构体，用来设定每个case的SpecialCase参数。
定义

typedef struct MI_ISP_AWB_SpecialCaseParam_s

{

MI_U8 u8Group1_ZoneNum;

MI_U16 u16Group1_CenterX[MI_ISP_AWB_SPECIAL_ZONE_NUM];

MI_U16 u16Group1_CenterY[MI_ISP_AWB_SPECIAL_ZONE_NUM];

MI_U8 u8Group1_Radius[MI_ISP_AWB_SPECIAL_ZONE_NUM];

MI_U8 u8Group1_CntLutNodeNum;

MI_S32 s32Group1_CntLutX[MI_ISP_AWB_SPECIAL_NODE_NUM];

MI_S32 s32Group1_CntLutY[MI_ISP_AWB_SPECIAL_NODE_NUM];

MI_U8 u8Group2_ZoneNum;

MI_U16 u16Group2_CenterX[MI_ISP_AWB_SPECIAL_ZONE_NUM];

MI_U16 u16Group2_CenterY[MI_ISP_AWB_SPECIAL_ZONE_NUM];

MI_U8 u8Group2_Radius[MI_ISP_AWB_SPECIAL_ZONE_NUM];

MI_U8 u8Group2_CntLutNodeNum;

MI_S32 s32Group2_CntLutX[MI_ISP_AWB_SPECIAL_NODE_NUM];

MI_S32 s32Group2_CntLutY[MI_ISP_AWB_SPECIAL_NODE_NUM];

MI_U8 u8BvLutNodeNum;

MI_S32 s32BvLutX[MI_ISP_AWB_SPECIAL_NODE_NUM];

MI_S32 s32BvLutY[MI_ISP_AWB_SPECIAL_NODE_NUM];

MI_ISP_AWB_SpecialMode_e eMode;

MI_U16 u16Weight[MI_ISP_AWB_CT_TBL_NUM];

MI_U32 u32PreferCT;

MI_U16 u16PreferRgain;

MI_U16 u16PreferBgain;

} MI_ISP_AWB_SpecialCaseParam_t;

名称

变量名称	描述
u8Group1_ZoneNum	欲定义的zone数量，算法会分析落入所有zone的AWB统计值数量占全统计值数量的百分比。值域0 ~ 8，设0代表此条件无条件达成。
u16Group1_CenterX[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的中心点在R/G-B/G plane上的x坐标。值域0 ~ 1023。MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u16Group1_CenterY[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的中心点在R/G-B/G plane上的y坐标。值域0 ~ 1023。 MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u8Group1_Radius[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的半径大小。值域0 ~ 20。 MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u8Group1_CntLutNodeNum	决定CntLut欲使用的节点数量。值域0 ~ 4。
s32Group1_CntLutX[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定CntLut节点x值，代表落入所有zone的统计值总数占统计值总数的百分比。算法会分析出Group1的统计值百分比来查此表，得到Group1条件达标率Group1.CntRatio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
s32Group1_CntLutY[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定CntLut节点y值，代表ratio值。算法会分析出Group1的统计值百分比来查此表，得到Group1条件达标率Group1.CntRatio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
u8Group2_ZoneNum	欲定义的zone数量，算法会分析落入所有zone的AWB统计值数量占全统计值数量的百分比。值域0 ~ 8，设0代表此条件无条件达成。
u16Group2_CenterX[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的中心点在R/G-B/G plane上的x坐标。值域0 ~ 1023。MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u16Group2_CenterY[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的中心点在R/G-B/G plane上的y坐标。值域0 ~ 1023。 MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u8Group2_Radius[MI_ISP_AWB_SPECIAL_ZONE_NUM]	决定每个zone的半径大小。值域0 ~ 20。 MI_ISP_AWB_SPECIAL_ZONE_NUM = 8。
u8Group2_CntLutNodeNum	决定CntLut欲使用的节点数量。值域0 ~ 4。
s32Group2_CntLutX[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定CntLut节点x值，代表落入所有zone的统计值总数占统计值总数的百分比。算法会分析出Group2的统计值百分比来查此表，得到Group2条件达标率Group2.CntRatio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
s32Group2_CntLutY[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定CntLut节点y值，代表ratio值。算法会分析出Group2的统计值百分比来查此表，得到Group2条件达标率Group2.CntRatio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
u8BvLutNodeNum	BvLut节点数量。值域0 ~ 4，设0代表此条件无条件达成。
s32BvLutX[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定BvLut节点x值，代表Bv。值域-81920 ~ 245760。 MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
s32BvLutY[MI_ISP_AWB_SPECIAL_NODE_NUM]	决定BvLut节点y值，代表达标率。值域0 ~ 1024。 MI_ISP_AWB_SPECIAL_NODE_NUM = 4。
eMode	case达成时的行为模式选择，值域0 ~ 2。 0：WeightCtrl mode 1：PreferCT mode 2：PreferGain mode
u16Weight[MI_ISP_AWB_CT_TBL_NUM]	当Mode为0时有效，色温框会根据CaseRatio套用此weight设定。值域0 ~ 1024。 MI_ISP_AWB_CT_TBL_NUM = 10。
u32PreferCT	当Mode为1时有效，原来的Target WB gain会根据CaseRatio与PreferCT对应的WB gain做混和成为新的Target WB gain。值域0 ~ 20000。
u16PreferRgain	当Mode为2时有效，原来的Target WB gain会根据CaseRatio与PreferRgain做混和成为新的Target WB gain。值域0 ~ 8191。
u16PreferBgain	当Mode为2时有效，原来的Target WB gain会根据CaseRatio与PreferBgain做混和成为新的Target WB gain。值域0 ~ 8191。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_SpecialCaseType_t

列举结构体 (Enum Structure)¶

说明

SpecicalCase行为模式列举结构体。
定义

typedef enum

{

E_SS_AWB_SPECIAL_WEIGHTCTRL = 0,

E_SS_AWB_SPECIAL_PREFER_CT = 1,

E_SS_AWB_SPECIAL_PREFER_GAIN = 2

} MI_ISP_AWB_SpecialMode_e;

名称

变量名称	描述
E_SS_AWB_SPECIAL_WEIGHTCTRL	Weight控制模式。可调整当case达成时各色温框的weight。
E_SS_AWB_SPECIAL_PREFER_CT	PreferCT模式。可调整当case达成时欲与target WB gain混和的指定色温WB gain。
E_SS_AWB_SPECIAL_PREFER_GAIN	PreferGain模式。可调整当case达成时欲与target WB gain混和的指定WB gain。

注意事项

无。
相关结构类型与函式

MI_ISP_AWB_SpecialCaseParam_t

MI_ISP_AWB_SpecialCaseInfo结构体¶

SpecialCase Info类型结构体 (Type Structure)¶

说明

AWB SpecialCase Info的类型结构体。
定义

typedef struct MI_ISP_AWB_SpecialCaseInfoType_s

{

MI_U32 u32Group1Cnt[MI_ISP_AWB_SPECIAL_CASE_NUM];

MI_U32 u32Group1CntRatio[MI_ISP_AWB_SPECIAL_CASE_NUM];

MI_U32 u32Group2Cnt[MI_ISP_AWB_SPECIAL_CASE_NUM];

MI_U32 u32Group2CntRatio[MI_ISP_AWB_SPECIAL_CASE_NUM];

MI_U32 u32BvRatio[MI_ISP_AWB_SPECIAL_CASE_NUM];

MI_U32 u32CaseRatio[MI_ISP_AWB_SPECIAL_CASE_NUM];

MI_U16 u16CaseWeight[MI_ISP_AWB_SPECIAL_CASE_NUM][MI_ISP_AWB_CT_TBL_NUM];

MI_U16 u16SpecialWeight[MI_ISP_AWB_CT_TBL_NUM];

MI_U16 u16SpecialRgain[MI_ISP_AWB_SPECIAL_CASE_NUM];

MI_U16 u16SpecialBgain[MI_ISP_AWB_SPECIAL_CASE_NUM];

} MI_ISP_AWB_SpecialCaseInfoType_t;

名称

变量名称	描述
u32Group1Cnt[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case的Group1统计值落点总数。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u32Group1CntRatio[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case的Group1统计值落点总数查Group1.CntLut后得到的Ratio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u32Group2Cnt[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case的Group2统计值落点总数。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u32Group2CntRatio[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case的Group2统计值落点总数查Group2.CntLut后得到的Ratio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u32BvRatio[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case根据Bv查BvLut后得到的Ratio。值域0 ~ 1024。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u32CaseRatio[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case将Group1.CntRatio、Group1.CntRatio及BvRatio整合后的Ratio。值域0 ~ 100。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u16CaseWeight[MI_ISP_AWB_SPECIAL_CASE_NUM] [MI_ISP_AWB_CT_TBL_NUM]	显示各个case透过CaseRatio得到的CaseWeight。若Mode选择不为0的case其CaseWeight会全是100，代表没有作用。MI_ISP_AWB_SPECIAL_CASE_NUM = 4；MI_ISP_AWB_CT_TBL_NUM = 10。
u16SpecialWeight[MI_ISP_AWB_CT_TBL_NUM]	将四组CaseWeight整合起来最终成为一组SpecialWeight。MI_ISP_AWB_CT_TBL_NUM = 10。
u16SpecialRgain[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case要与Target WB gain做混和的R gain。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。
u16SpecialBgain[MI_ISP_AWB_SPECIAL_CASE_NUM]	显示各个case要与Target WB gain做混和的B gain。MI_ISP_AWB_SPECIAL_CASE_NUM = 4。

注意事项

无。
相关结构类型与函式

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

MI_ISP_AWB_StatisFilter结构体¶

类型结构体 (Type Structure)¶

说明

AWB StatisFilter的类型结构体。
定义

typedef struct MI_ISP_AWB_StatisFilterType_s

{

MI_U32 u32NodeNum;

MI_S32 s32LutX_BV[MI_ISP_AWB_STATISFILTER_NODE_NUM];

MI_S32 s32LutY_HighThd[MI_ISP_AWB_STATISFILTER_NODE_NUM];

MI_S32 s32LutY_LowThd[MI_ISP_AWB_STATISFILTER_NODE_NUM];

} MI_ISP_AWB_StatisFilterType_t;

名称

变量名称	描述
u32NodeNum	设定lookup table节点数量。值域0 ~ 4，设0会使用预设有效亮度区间4 ~ 224。
s32LutX_BV[MI_ISP_AWB_STATISFILTER_NODE_NUM]	设定lookup table的节点x坐标，也就是BV。值域-81920 ~ 245760。 MI_ISP_AWB_STATISFILTER_NODE_NUM = 4。
s32LutY_HighThd[MI_ISP_AWB_STATISFILTER_NODE_NUM]	设定lookup table的节点Y坐标，也就是最高亮度限制。统计值的RGB中只要任一值超过此限制，则该统计值即被忽略。值域0 ~ 255。 MI_ISP_AWB_STATISFILTER_NODE_NUM = 4。
s32LutY_LowThd[MI_ISP_AWB_STATISFILTER_NODE_NUM]	设定另一个lookup table的节点Y坐标，也就是最低亮度限制。统计值的RGB中只要任一值低于此限制，则该统计值即被忽略。值域0 ~ 255。注意LowThd要小于HighThd。MI_ISP_AWB_STATISFILTER_NODE_NUM = 4。

注意事项

无。
相关结构类型与函式

MI_S32 MI_ISP_AWB_SetStatisFilter(MI_U32 DevId, MI_U32 Channel, MI_ISP_AWB_StatisFilterType_t *data);

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

MI_ISP_AWB_VerInfo结构体¶

类型结构体（Type Structure）¶

说明

AWB Version Information结构体。
定义

typedef struct MI_ISP_AWB_VerInfoType_s

{

MI_U32 u32ReleaseDate;

MI_U32 u32ReportID;

MI_U8 u8Major;

MI_U8 u8Minor;

MI_U8 u8TestVer;

} MI_ISP_AWB_VerInfoType_t;

名称

变量名称	描述
u32ReleaseDate	打印AWB FW更新日期。
u32ReportID	打印AWB FW反馈问题的数值编号，default：0。
u8Major	打印AWB FW主要版本编号。
u8Minor	打印AWB FW次要版本编号。
u8TestVer	打印AWB FW测试版本编号，default：0。

注意事项

无。
相关结构类型与函式

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

MI_ISP_AWB_FdAwbParam结构体¶

类型结构体 (Type Structure)¶

说明

AWB FdAwbParam的类型结构体。
定义

typedef struct MI_ISP_AWB_FdAwbParam_s

{

MI_ISP_AWB_bool_e bEnable;

MI_ISP_AWB_FdAwb_Mode_e eMode;

MI_U16 u16SkinAreaNum;

MI_U16 u16SkinAreaCntThd;

MI_U16 u16SkinAreaCT[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8SkinAreaCenterX[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8SkinAreaCenterY[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8SkinAreaRadius[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8SkinAreaSkipRadius[MI_ISP_FDAWB_SKIN_NUM];

MI_U16 u16UnStbCntThd;

MI_U8 u8GrayNum[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8GrayCenterX[MI_ISP_FDAWB_SKIN_NUM][MI_ISP_FDAWB_Gray_NUM];

MI_U8 u8GrayCenterY[MI_ISP_FDAWB_SKIN_NUM][MI_ISP_FDAWB_Gray_NUM];

MI_U8 u8GrayRadius[MI_ISP_FDAWB_SKIN_NUM][MI_ISP_FDAWB_Gray_NUM];

MI_U8 u8AssignSkinX[MI_ISP_FDAWB_SKIN_NUM];

MI_U8 u8AssignSkinY[MI_ISP_FDAWB_SKIN_NUM];

MI_ISP_AWB_bool_e bFwstWbFromSkin;

} MI_ISP_AWB_FdAwbParam_t;

名称

变量名称	描述
bEnable	FDAWB算法开关。开启FDAWB功能，建议搭配AWB Blance AlgType使用，增加稳定性。
eMode	FDAWB算法模式选择。目前提供两种算法：1.Refer To Skin：此模式会根据人脸信息的分析结果，锁定最有可能的白点范围去做白平衡。2.Assign Skin Color：此模式会将人脸的统计值落点(白平衡前)，强制移到使用者设定的肤色落点(白平衡后)位置。
u16SkinAreaNum	使用者设定不同色温的肤色区域数量。值域0~8。注意不管选择哪种模式，此SkinArea的设定是必定要填的，否则FDAWB将无法分析人脸信息。
u16SkinAreaCntThd	人脸信息的稳定阀值。此阀值代表当人脸出现时，需要连续几次人脸信息都是有效的，FDAWB才会认为该信息是有效的，FDAWB才会开始动作；当人脸消失时，需要连续几次人脸信息都是无效的，FDAWB才会认为该信息是无效的，FDAWB才会停止。值域：0~255，值越大会越稳定，但会延迟FDAWB开始或结束动作的时间，应根据使用者需求设定适合的大小。
u16SkinAreaCT[MI_ISP_FDAWB_SKIN_NUM]	对应各自定义肤色区域的色温。此色温只是为了让使用者标示该肤色index是对应哪个色温环境，并无实际作用。设定上也没有任何规则，不用一定要从小到大或从大到小。值域0~20000。MI_ISP_FDAWB_SKIN_NUM = 8。
u8SkinAreaCenterX/Y[MI_ISP_FDAWB_SKIN_NUM]	对应各自定义肤色区域的中心坐标(R/G-B/G plane)。值域：0~255。MI_ISP_FDAWB_SKIN_NUM = 8。
u8SkinAreaRadius[MI_ISP_FDAWB_SKIN_NUM]	对应各自定义肤色区域的半径。值域：0~255。MI_ISP_FDAWB_SKIN_NUM = 8。
u16UnStbCntThd	避免Skin index在不同值间来回变化的阀值。当从目前的Skin index要切换到另一个index，需要连续几次侦测出来的Skin index都不等于现在的index才会做切换，否则会一直维持使用目前的index。值域0~255，值越大越能增加稳定性，但当环境色温变化后需要延迟更久才会反应。
u8GrayNum[MI_ISP_FDAWB_SKIN_NUM]	每个肤色index需要使用几个对应的灰阶区域。值域：0~10。注意此灰阶区域只有在选择Refer To Skin模式才有作用。MI_ISP_FDAWB_SKIN_NUM = 8。
u8GrayCenterX/Y[MI_ISP_FDAWB_SKIN_NUM][MI_ISP_FDAWB_Gray_NUM]	设定每个灰阶区域的中心坐标。根据GrayNum填入对应组数的坐标。值域：0~255。MI_ISP_FDAWB_SKIN_NUM = 8，MI_ISP_FDAWB_Gray_NUM = 10。
u8GrayRadius[MI_ISP_FDAWB_SKIN_NUM][MI_ISP_FDAWB_Gray_NUM]	设定每个灰阶区域的半径。灰阶区域是可以重迭的，因此当想要设定一个非圆形区域时，可以利用多个区域去达成。值域：0~255。MI_ISP_FDAWB_SKIN_NUM = 8，MI_ISP_FDAWB_Gray_NUM = 10。
u8AssignSkinX/Y[MI_ISP_FDAWB_SKIN_NUM]	设定人脸信息的目标坐标。值域：0~255。当选择Assign Skin Color模式时，会强制将人脸落点移到此目标坐标，建议可以在不同色温下去确认color checker patch 2的肤色落点来协助标定此坐标，再根据实际状况去作微调。此外，当选择Refer To Skin模式时，若有勾选FwstWbFromSkin，当遇到统计值不足的而无法计算白平衡的状况，会改用Assign Skin Color来做白平衡。MI_ISP_FDAWB_SKIN_NUM = 8。
bFwstWbFromSkin	当统计值不足时，是否要使用Assign Skin Color模式去计算白平衡的开关。此机制需搭配MI_ISP_AWB_SetFewStatisStrategy的设定，可参考该API的说明。

注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AWB_FdAwbInfoType结构体¶

类型结构体 (Type Structure)¶

说明

AWB FdAwbInfoType的类型结构体。
定义

typedef struct MI_ISP_AWB_FdAwbInfoType_s

{

MI_U8 u8FaceNum;

MI_U8 u8FaceCor[4];

MI_ISP_AWB_bool_e bEffective;

MI_U32 u32EffectiveCnt;

MI_U32 u32FaceAvgX;

MI_U32 u32FaceAvgY;

MI_U16 u16FaceSkinInd;

MI_U32 u32FaceTarRgain;

MI_U32 u32FaceTarBgain;

} MI_ISP_AWB_FdAwbInfoType_t;

名称

变量名称	描述
u8FaceNum	透过人脸侦测功能得到的人脸数量，目前只支持一个人脸。若此值为0表示没有支持人脸侦测功能或是有支持人脸侦测功能但没侦测到人脸。
u8FaceCor[4]	人脸在AWB 128x90个统计值上的坐标，四个值依序为人脸框起始点X坐标、起始点Y坐标、结束点X坐标、结束点Y坐标。
bEffective	表示目前FDAWB是否有作动。
u32EffectiveCnt	显示连续几次人脸信息是有效的，最高只会到SkinAreaCntThd+1。
u32FaceAvgX/Y	根据人脸信息分析出的人脸落点坐标(R/G-B/G plane)。
u16FaceSkinInd	根据人脸信息分析出的用户定义肤色index。
u32FaceTarR/Bgain	根据人脸信息以及AssignSkinX/Y得到的目标WB gain。

注意事项

无。
相关结构类型与函式

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

MI_ISP_AWB_FwstStrategyParam结构体¶

类型结构体 (Type Structure)¶

说明

AWB FwstStrategyParam的类型结构体。
定义

typedef struct MI_ISP_AWB_FwstStrategyParam_s

{

MI_ISP_AWB_Fwst_AlgoType_e eAlgType;

MI_U32 u32CntThd;

MI_U32 u32SmoothWidth;

MI_U32 u32PreferCT;

} MI_ISP_AWB_FwstStrategyParam_t;

名称

变量名称	描述
eAlgType	用来决定当统计值不足时的行为，共有Keep、MixPreferGain及MixGrayWorld三种选择。
u32CntThd	最小有效统计值的阀值。当统计值数量小于此值，AWB无法计算。此时使用的WB gain会根据AlgType的选择而有所不同。值域：0 ~ 5000。Keep：维持在前次有足够统计值时得到的WB gain。MixPreferGain：根据PreferCT设定色温算出的WB Gain。MixGrayWorld：使用GrayWorld算法算出的WB gain。
u32SmoothWidth	当算法选择MixPreferGain和MixGrayWorld，或是FDAWB中FwstWbFromSkin有开启且作用时，在统计值数量在CntThd到CntThd + SmoothWidth间会根据选择的AlgoType拿不同的WB gain与AWB算出的target WB gain做混和。注意当FwstWbFromSkin有开启且作用时，拥有最高优先级。值域：0 ~ 5000。
u32PreferCT	eAlgType选择MixPreferGain时会使用，使用者可以决定当统计值不足时要使用哪个色温的WB gain。值域：0~20000。

注意事项

无。
相关结构类型与函式

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

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

MI_ISP_AF_bool结构体¶

列举结构体（Enum Structure）¶

说明

布尔值的列举结构体。
定义

typedef enum

{

E_SS_AF_FALSE = 0,

E_SS_AF_TRUE = !E_SS_AF_FALSE,

E_SS_AF_BOOL_MAX

} MI_ISP_AF_bool_e;
名称

变量名称 描述

E_SS_AF_FALSE 布尔值等于0。

E_SS_AF_TRUE 布尔值等于1。

E_SS_AF_BOOL_MAX 判断布尔值列举列表的最大值。
注意事项

无。
相关结构类型与函式

MI_ISP_AF_QueryInfoType_t

MI_ISP_AF_AccWeightType_t

MI_ISP_AF_OpType结构体¶

列举结构体（Enum Structure）¶

说明

工作模式的列举结构体。
定义

typedef enum

{

E_SS_AF_OP_TYP_AUTO = 0,

E_SS_AF_OP_TYP_MANUAL = ! E_SS_AF_OP_TYP_AUTO,

E_SS_AF_OP_TYP_MODE_MAX

} MI_ISP_AF_OpType_e;
名称

变量名称 描述

E_SS_AF_OP_TYP_AUTO 自动工作模式。

E_SS_AF_OP_TYP_MANUAL 手动工作模式。

E_SS_AF_OP_TYP_MODE_MAX 判断工作模式列举列表的最大值。
注意事项

无。
相关结构类型与函式

MI_ISP_AF_AttrType_t

MI_ISP_AF_SmStateType结构体¶

列举结构体（Enum Structure）¶

说明

状态机（State Machine）的列举结构体。
定义

typedef enum

{

E_SS_AF_STATE_NORMAL = 0,

E_SS_AF_STATE_PAUSE = 1,

E_SS_AF_STATE_MAX

} MI_ISP_AF_SmStateType_e;
名称

变量名称 描述

E_SS_AF_STATE_NORMAL 正常模式。

E_SS_AF_STATE_PAUSE 暂停模式。

E_SS_AF_STATE_MAX 判断状态机列举清单的最大值。
注意事项

无。
相关结构类型与函式

MI_ISP_AF_AttrType_t

MI_ISP_AF_QueryInfo结构体¶

类型结构体（Type Structure）¶

说明

设定当前AF信息。
定义

typedef struct MI_ISP_AF_QueryInfoType_s

{

MI_ISP_AF_bool_e bIsStable;

MI_U16 u16CurMotorPos;

} MI_ISP_AF_QueryInfoType_t;
名称

变量名称 描述

bIsStable 获取目前AF是否在收敛状态。

u16CurMotorPos 获取目前Motor位置。
注意事项

无。
相关结构类型与函式

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

MI_ISP_AF_HwWin结构体¶

类型结构体（Type Structure）¶

说明

设定AF Win。
定义

typedef struct MI_ISP_AF_HwWinType_s

{

MI_ISP_AF_HwRoiModeType_e eMode;

MI_U32 u32VerticalBlockNumber;

MI_ISP_AF_WinType_t stParaAPI[AF_HW_WIN_NUM];

} MI_ISP_AF_HwWinType_t;

名称

变量名称	描述
eMode	ROI模式控制选项，选择0可切为16组ROI，window size与位置可随意分割，选择1可切为16*N组ROI，window size与位置稍有限制，值域0 ~ 1。
u32VerticalBlockNumber	当Mode为Matrix时才有效果，可切为16*N组ROI （N = VerticalBlockNumber），值域1 ~ 16。
stParaAPI[AF_HW_WIN_NUM]	16组ROI坐标，依序为x_start, y_start, x_end, y_end，值域0 ~ 1023。AF_HW_WIN_NUM = 16。

注意事项

无。
相关结构类型与函式

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

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

模式列举结构体（Mode Enum Structure）¶

说明

AF统计值的ROI模式。
定义

typedef enum __attribute__ ((aligned (1)))

{

E_IQ_AF_ROI_MODE_NORMAL,

E_IQ_AF_ROI_MODE_MATRIX

} MI_ISP_AF_HwRoiModeType_e;

名称

变量名称	描述
E_IQ_AF_ROI_MODE_NORMAL	Normal模式。可切为16组ROI，window size与位置可随意分割。
E_IQ_AF_ROI_MODE_MATRIX	Matrix模式。可切为16*N组ROI，window size与位置稍有限制。

注意事项

无。
相关结构类型与函式

MI_ISP_AF_HwWinType_t

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

说明

设定AF Win的位置。
定义

typedef struct MI_ISP_AF_WinType_s

{

MI_U32 u16StartX;

MI_U32 u16StartY;

MI_U32 u16EndX;

MI_U32 u16EndY;

} MI_ISP_AF_WinType_t;

名称

变量名称	描述
u16StartX	起始位置的X坐标值，值域0 ~ 1023。
u16StartY	起始位置的Y坐标值，值域0 ~ 1023。
u16EndX	终点位置的X坐标值，值域0 ~ 1023。
u16EndY	终点位置的Y坐标值，值域0 ~ 1023。

注意事项

无。
相关结构类型与函式

MI_ISP_AF_HwWinType_t

MI_ISP_AF_HwFilterAttr结构体¶

类型结构体（Type Structure）¶

说明

设定AF filter系数。
定义

typedef struct MI_ISP_AF_HwFilterAttrType_s

{

MI_U16 u16IIR1_a0;

MI_U16 u16IIR1_a1;

MI_U16 u16IIR1_a2;

MI_U16 u16IIR1_b1;

MI_U16 u16IIR1_b2;

MI_U16 u16IIR1_1st_low_clip;

MI_U16 u16IIR1_1st_high_clip;

MI_U16 u16IIR1_2nd_low_clip;

MI_U16 u16IIR1_2nd_high_clip;

MI_U16 u16IIR2_a0;

MI_U16 u16IIR2_a1;

MI_U16 u16IIR2_a2;

MI_U16 u16IIR2_b1;

MI_U16 u16IIR2_b2;

MI_U16 u16IIR2_1st_low_clip;

MI_U16 u16IIR2_1st_high_clip;

MI_U16 u16IIR2_2nd_low_clip;

MI_U16 u16IIR2_2nd_high_clip;

MI_U16 u16IIR1_e1_en;

MI_U16 u16IIR1_e1_a0;

MI_U16 u16IIR1_e1_a1;

MI_U16 u16IIR1_e1_a2;

MI_U16 u16IIR1_e1_b1;

MI_U16 u16IIR1_e1_b2;

MI_U16 u16IIR1_e2_en;

MI_U16 u16IIR1_e2_a0;

MI_U16 u16IIR1_e2_a1;

MI_U16 u16IIR1_e2_a2;

MI_U16 u16IIR1_e2_b1;

MI_U16 u16IIR1_e2_b2;

MI_U16 u16IIR2_e1_en;

MI_U16 u16IIR2_e1_a0;

MI_U16 u16IIR2_e1_a1;

MI_U16 u16IIR2_e1_a2;

MI_U16 u16IIR2_e1_b1;

MI_U16 u16IIR2_e1_b2;

MI_U16 u16IIR2_e2_en;

MI_U16 u16IIR2_e2_a0;

MI_U16 u16IIR2_e2_a1;

MI_U16 u16IIR2_e2_a2;

MI_U16 u16IIR2_e2_b1;

MI_U16 u16IIR2_e2_b2;

} MI_ISP_AF_HwFilterAttrType_t;

名称

变量名称	描述
u16IIR1_a0, a1, a2, b1, b2	IIR high滤波器系数，值域0 ~ 1023。
u16IIR1_1st_low_clip, 1st_high_clip, 2nd_low_clip, 2nd_high_clip	IIR high滤波器系数的输入/输出限制，值域0 ~ 1023。
u16IIR2_a0, a1, a2, b1, b2	IIR low滤波器系数，值域0 ~ 1023。
u16IIR2_1st_low_clip, 1st_high_clip, 2nd_low_clip, 2nd_high_clip	IIR low滤波器系数的输入/输出限制，值域0 ~ 1023。
u16IIR1_e1_en	IIR high串接第一级滤波器开关，值域0 ~ 1。
u16IIR1_e1_a0, a1, a2, b1, b2	IIR high串接第一级滤波器系数，值域0 ~ 1023。
u16IIR1_e2_en	IIR high串接第二级滤波器开关，值域0 ~ 1。
u16IIR1_e2_a0, a1, a2, b1, b2	IIR high串接第二级滤波器系数，值域0 ~ 1023。
u16IIR2_e1_en	IIR low串接第一级滤波器开关，值域0 ~ 1。
u16IIR2_e1_a0, a1, a2, b1, b2	IIR low串接第一级滤波器系数，值域0 ~ 1023。
u16IIR2_e2_en	IIR low串接第二级滤波器开关，值域0 ~ 1。
u16IIR2_e2_a0, a1, a2, b1, b2	IIR low串接第二级滤波器系数，值域0 ~ 1023。

注意事项

无。
相关结构类型与函式

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_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_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	设定PFC_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stManual	设定PFC_EX的手动模式属性结构体。

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

变量名称	描述
bEnable	设定DUMMY_EX功能的布尔值。关闭：E_SS_IQ_FALSE = 0。开启：E_SS_IQ_TRUE = 1。
stManual	设定DUMMY_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。

参数名称	描述
MI_ISP_OK	成功。
MI_ISP_FAILURE	失败。

参数名称	描述
MI_ISP_OK	成功。
MI_ISP_FAILURE	失败。

参数名称	描述
MI_ISP_OK	成功。
MI_ISP_FAILURE	失败。

参数名称	描述
MI_ISP_OK	成功。
MI_ISP_FAILURE	失败。

变量名称	描述
stConvThrd	设定自动曝光启动收敛或判断收敛完成的区间。
stConvSpeed	设定自动曝光的收敛速度。

变量名称	描述
u32NumPoints	曝光行程表的节点数。值域范围：1 ~ 16。
stExpoTbl[MI_ISP_AE_LUT_16]	曝光行程表的节点参数数据。 MI_ISP_AE_LUT_16 = 16。

变量名称	描述
E_SS_AE_WEIGHT_AVERAGE	切换至平均测光的权重表
E_SS_AE_WEIGHT_CENTER	切换至中央测光的权重表
E_SS_AE_WEIGHT_SPOT	切换至点状测光的权重表

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

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

变量名称	描述
bEnable	开关ConvSpeed_Ex。
stConvSpeedEx	设定自动曝光的收敛速度。

变量名称	描述
u32SpeedX	设定不同的亮度区间。值域范围：1 ~ 2550。
u32SpeedY	设定不同的亮度区间，给予收敛速度。值域范围：1 ~ 1024。

变量名称	描述
E_SS_AWB_FALSE	布尔值等于0。
E_SS_AWB_TRUE	布尔值等于1。
E_SS_AWB_BOOL_MAX	判断布尔值列举列表的最大值。

变量名称	描述
E_SS_AWB_OP_TYP_AUTO	自动工作模式。
E_SS_AWB_OP_TYP_MANUAL	手动工作模式。
E_SS_AWB_OP_TYP_MODE_MAX	判断工作模式列举列表的最大值。

变量名称	描述
E_SS_AWB_STATE_NORMAL	正常模式。
E_SS_AWB_STATE_PAUSE	暂停模式。
E_SS_AWB_STATE_MAX	判断状态机列举清单的最大值。

变量名称	描述
uAvgR	个别统计值的R平均值。值域0~255。
uAvgG	个别统计值的G平均值。值域0~255。
uAvgB	个别统计值的B平均值。值域0~255。

变量名称	描述
u16StartIdx	亮区开始索引。
u16EndIdx	亮区结束索引。
u16CtParams[MI_ISP_AWB_CT_CALI_CNT]	色温cali参数。MI_ISP_AWB_CT_CALI_CNT = 40。

变量名称	描述
E_SS_AF_FALSE	布尔值等于0。
E_SS_AF_TRUE	布尔值等于1。
E_SS_AF_BOOL_MAX	判断布尔值列举列表的最大值。

变量名称	描述
E_SS_AF_OP_TYP_AUTO	自动工作模式。
E_SS_AF_OP_TYP_MANUAL	手动工作模式。
E_SS_AF_OP_TYP_MODE_MAX	判断工作模式列举列表的最大值。

变量名称	描述
E_SS_AF_STATE_NORMAL	正常模式。
E_SS_AF_STATE_PAUSE	暂停模式。
E_SS_AF_STATE_MAX	判断状态机列举清单的最大值。

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

变量名称	描述
u8R	Bayer to Y的R channel比例（0~255）。
u8G	Bayer to Y的G channel比例（0~255）。
u8B	Bayer to Y的B channel比例（0~255）。

变量名称	描述
eAccSel	统计值种类，值域0 ~ 3。
u16MotorStep	每一帧Motor的移动步伐，值域0 ~ 1023。