MI ISP API

ISP 软件开发参考 Version 1.3

1. 概述¶

1.1. 模组说明¶

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

1.2. 流程框图¶

图 1-1：ISP 框图

1.3. 关键字说明¶

ISP

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

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

2D降噪: 对一个图元将其与周围图元平均，平均后杂讯降低，但缺点是会造成画面模糊。

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

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

Static defect correction，固定位置坏点补偿。
STA

Statistics缩写。
HDR

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

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

2. MI ISP API参考¶

2.1. MI_ISP_IQ_GetVersionInfo¶

目的

取得IQ版本号资讯。

语法

MI_S32 MI_ISP_IQ_GetVersionInfo(MI_U32 Channel, MI_ISP_IQ_VERSION_INFO_TYPE_t *data);

描述

调用此函式取得IQ版本号资讯。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

*data IQ版本号资讯的指标。
返回值

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.2. MI_ISP_IQ_SetVersionInfo¶

目的

设定IQ版本号资讯。

语法

MI_S32 MI_ISP_IQ_SetVersionInfo(MI_U32 Channel, MI_ISP_IQ_VERSION_INFO_TYPE_t *data);

描述

调用此函式设定IQ版本号资讯。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.3. MI_ISP_IQ_GetParaInitStatus¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetParaInitStatus(MI_U32 Channel, MI_ISP_IQ_PARAM_INIT_INFO_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。

举例

MI_SYS_INIT();

While(1)

{

    MI_ISP_IQ_GetParaInitStatus (0, &FLAG);

    if（FLAG ==1）

    {

        break;

    }

}

2.4. MI_ISP_IQ_GetIQind¶

目的

取得曝光指数 (ISO index) 参数值。

语法

MI_S32 MI_ISP_IQ_GetIQind(MI_U32 Channel, MI_ISP_IQ_INDEX_e *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

*data 曝光指数 (ISO index) 参数值的指针。
返回值

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.5. MI_ISP_IQ_SetColorToGray¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetColorToGray(MI_U32 Channel, MI_ISP_IQ_COLORTOGRAY_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.6. MI_ISP_IQ_GetColorToGray¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetColorToGray(MI_U32 Channel,MI_ISP_IQ_COLORTOGRAY_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.7. MI_ISP_IQ_SetContrast¶

目的

设定对比度参数值。

语法

MI_S32 MI_ISP_IQ_SetContrast(MI_U32 Channel,    MI_ISP_IQ_CONTRAST_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.8. MI_ISP_IQ_GetContrast¶

目的

取得对比度参数值。

语法

MI_S32 MI_ISP_IQ_GetContrast(MI_U32 Channel,MI_ISP_IQ_CONTRAST_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.9. MI_ISP_IQ_SetBrightness¶

目的

设定亮度参数值。

语法

MI_S32 MI_ISP_IQ_SetBrightness(MI_U32 Channel, MI_ISP_IQ_BRIGHTNESS_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.10. MI_ISP_IQ_GetBrightness¶

目的

取得亮度参数值。

语法

MI_S32 MI_ISP_IQ_GetBrightness(MI_U32 Channel,MI_ISP_IQ_BRIGHTNESS_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.11. MI_ISP_IQ_SetLightness¶

目的

设定灰度参数值。

语法

MI_S32 MI_ISP_IQ_SetLightness(MI_U32 Channel, MI_ISP_IQ_LIGHTNESS_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.12. MI_ISP_IQ_GetLightness¶

目的

取得灰度参数值。

语法

MI_S32 MI_ISP_IQ_GetLightness(MI_U32 Channel, MI_ISP_IQ_LIGHTNESS_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.13. MI_ISP_IQ_SetRGBGamma¶

目的

设定RGB Gamma curve参数值。

语法

MI_S32 MI_ISP_IQ_SetRGBGamma(MI_U32 Channel,MI_ISP_IQ_RGBGAMMA_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.14. MI_ISP_IQ_GetRGBGamma¶

目的

取得RGB Gamma curve参数值。

语法

MI_S32 MI_ISP_IQ_GetRGBGamma(MI_U32 Channel, MI_ISP_IQ_RGBGAMMA_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.15. MI_ISP_IQ_SetYUVGamma¶

目的

设定YUV Gamma curve参数值。

语法

MI_S32 MI_ISP_IQ_SetYUVGamma(MI_U32 Channel,MI_ISP_IQ_YUVGAMMA_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.16. MI_ISP_IQ_GetYUVGamma¶

目的

取得YUV Gamma curve参数值。

语法

MI_S32 MI_ISP_IQ_GetYUVGamma(MI_U32 Channel,MI_ISP_IQ_YUVGAMMA_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.17. MI_ISP_IQ_SetSaturation¶

目的

设定饱和度参数值。

语法

MI_S32 MI_ISP_IQ_SetSaturation(MI_U32 Channel,MI_ISP_IQ_SATURATION_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.18. MI_ISP_IQ_GetSaturation¶

目的

取得饱和度参数值。

语法

MI_S32 MI_ISP_IQ_GetSaturation(MI_U32 Channel, MI_ISP_IQ_SATURATION_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.19. MI_ISP_IQ_SetRGBMatrix¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetRGBMatrix(MI_U32 Channel,MI_ISP_IQ_RGBMATRIX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.20. MI_ISP_IQ_GetRGBMatrix¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetRGBMatrix(MI_U32 Channel,MI_ISP_IQ_RGBMATRIX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.21. MI_ISP_IQ_SetFalseColor¶

目的

设定去伪彩参数值。

语法

MI_S32 MI_ISP_IQ_SetFalseColor(MI_U32 Channel, MI_ISP_IQ_FALSECOLOR_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.22. MI_ISP_IQ_GetFalseColor¶

目的

取得去伪彩参数值。

语法

MI_S32 MI_ISP_IQ_GetFalseColor(MI_U32 Channel, MI_ISP_IQ_FALSECOLOR_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.23. MI_ISP_IQ_SetNR3D¶

目的

设定3D降噪参数值。

语法

MI_S32 MI_ISP_IQ_SetNR3D(MI_U32 Channel, MI_ISP_IQ_NR3D_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.24. MI_ISP_IQ_GetNR3D¶

目的

取得3D降噪参数值。

语法

MI_S32 MI_ISP_IQ_GetNR3D(MI_U32 Channel, MI_ISP_IQ_NR3D_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.25. MI_ISP_IQ_SetNRDeSpike¶

目的

设定DeSpike降噪参数值。

语法

MI_S32 MI_ISP_IQ_SetNRDeSpike(MI_U32 Channel, MI_ISP_IQ_NRDESPIKE_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.26. MI_ISP_IQ_GetNRDeSpike¶

目的

取得DeSpike降噪参数值。

语法

MI_S32 MI_ISP_IQ_GetNRDeSpike(MI_U32 Channel, MI_ISP_IQ_NRDESPIKE_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.27. MI_ISP_IQ_SetNRLuma¶

目的

设定Luma降噪参数值。

语法

MI_S32 MI_ISP_IQ_SetNRLuma(MI_U32 Channel, MI_ISP_IQ_NRLUMA_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.28. MI_ISP_IQ_GetNRLuma¶

目的

取得Luma降噪参数值。

语法

MI_S32 MI_ISP_IQ_GetNRLuma(MI_U32 Channel, MI_ISP_IQ_NRLUMA_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.29. MI_ISP_IQ_SetNRChroma¶

目的

设定颜色降噪参数值。

语法

MI_S32 MI_ISP_IQ_SetNRChroma(MI_U32 Channel, MI_ISP_IQ_NRChroma_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.30. MI_ISP_IQ_GetNRChroma¶

目的

取得颜色降噪参数值。

语法

MI_S32 MI_ISP_IQ_GetNRChroma(MI_U32 Channel, MI_ISP_IQ_NRChroma_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.31. MI_ISP_IQ_SetSharpness¶

目的

设定锐度参数值。

语法

MI_S32 MI_ISP_IQ_SetSharpness(MI_U32 Channel, MI_ISP_IQ_SHARPNESS_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.32. MI_ISP_IQ_GetSharpness¶

目的

取得锐度参数值。

语法

MI_S32 MI_ISP_IQ_GetSharpness(MI_U32 Channel, MI_ISP_IQ_SHARPNESS_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.33. MI_ISP_IQ_SetCrossTalk¶

目的

设定串扰参数值。

语法

MI_S32 MI_ISP_IQ_SetCrossTalk(MI_U32 Channel, MI_ISP_IQ_CROSSTALK_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.34. MI_ISP_IQ_GetCrossTalk¶

目的

取得串扰参数值。

语法

MI_S32 MI_ISP_IQ_GetCrossTalk(MI_U32 Channel, MI_ISP_IQ_CROSSTALK_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.35. MI_ISP_IQ_SetOBC¶

目的

设定黑电平参数值。

语法

MI_S32 MI_ISP_IQ_SetOBC(MI_U32 Channel, MI_ISP_IQ_OBC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.36. MI_ISP_IQ_GetOBC¶

目的

取得黑电平参数值。

语法

MI_S32 MI_ISP_IQ_GetOBC(MI_U32 Channel, MI_ISP_IQ_OBC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.37. MI_ISP_IQ_SetOBC_P1¶

目的

设定pipeline 1黑电平参数值。

语法

MI_S32 MI_ISP_IQ_SetOBC_P1(MI_U32 Channel, MI_ISP_IQ_OBC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.38. MI_ISP_IQ_GetOBC_P1¶

目的

取得pipeline 1黑电平参数值。

语法

MI_S32 MI_ISP_IQ_GetOBC_P1(MI_U32 Channel, MI_ISP_IQ_OBC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.39. MI_ISP_IQ_SetWDR¶

目的

设定宽动态参数值。

语法

MI_S32 MI_ISP_IQ_SetWDR(MI_U32 Channel, MI_ISP_IQ_WDR_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.40. MI_ISP_IQ_GetWDR¶

目的

取得宽动态参数值。

语法

MI_S32 MI_ISP_IQ_GetWDR(MI_U32 Channel, MI_ISP_IQ_WDR_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.41. MI_ISP_IQ_SetDynamicDP¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetDynamicDP(MI_U32 Channel, MI_ISP_IQ_DYNAMIC_DP_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.42. MI_ISP_IQ_GetDynamicDP¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetDynamicDP(MI_U32 Channel, MI_ISP_IQ_DYNAMIC_DP_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.43. MI_ISP_IQ_SetDynamicDP_CLUSTER¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetDynamicDP_CLUSTER(MI_U32 Channel, MI_ISP_IQ_DYNAMIC_DP_CLUSTER_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.44. MI_ISP_IQ_GetDynamicDP_CLUSTER¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetDynamicDP_CLUSTER(MI_U32 Channel, MI_ISP_IQ_DYNAMIC_DP_CLUSTER_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.45. MI_ISP_IQ_SetHSV¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetHSV(MI_U32 Channel, MI_ISP_IQ_HSV_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.46. MI_ISP_IQ_GetHSV¶

目的

取得HSV参数值。

语法

MI_S32 MI_ISP_IQ_GetHSV(MI_U32 Channel, MI_ISP_IQ_HSV_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.47. MI_ISP_IQ_SetRGBIR¶

目的

设定RGBIR参数值。

语法

MI_S32 MI_ISP_IQ_SetRGBIR(MI_U32 Channel, MI_ISP_IQ_RGBIR_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.48. MI_ISP_IQ_GetRGBIR¶

目的

取得RGBIR参数值。

语法

MI_S32 MI_ISP_IQ_GetRGBIR(MI_U32 Channel, MI_ISP_IQ_RGBIR_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.49. MI_ISP_IQ_SetDEMOSAIC¶

目的

设定去马赛克参数值。

语法

MI_S32 MI_ISP_IQ_SetDEMOSAIC(MI_U32 Channel, MI_ISP_IQ_DEMOSAIC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.50. MI_ISP_IQ_GetDEMOSAIC¶

目的

取得去马赛克参数值。

语法

MI_S32 MI_ISP_IQ_GetDEMOSAIC(MI_U32 Channel, MI_ISP_IQ_DEMOSAIC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.51. MI_ISP_IQ_SetR2Y¶

目的

设定色彩转换参数值。

语法

MI_S32 MI_ISP_IQ_SetR2Y(MI_U32 Channel, MI_ISP_IQ_R2Y_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.52. MI_ISP_IQ_GetR2Y¶

目的

设定色彩转换参数值。

语法

MI_S32 MI_ISP_IQ_GetR2Y(MI_U32 Channel, MI_ISP_IQ_R2Y_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.53. MI_ISP_IQ_SetCOLORTRANS¶

目的

设定色彩转换参数值。

语法

MI_S32 MI_ISP_IQ_SetCOLORTRANS(MI_U32 Channel, MI_ISP_IQ_COLORTRANS_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.54. MI_ISP_IQ_GetCOLORTRANS¶

目的

取得色彩转换参数值。

语法

MI_S32 MI_ISP_IQ_GetCOLORTRANS(MI_U32 Channel, MI_ISP_IQ_COLORTRANS_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.55. MI_ISP_IQ_SetHDR¶

目的

设定高动态范围 (High Dynamic Range) 参数值。

语法

MI_S32 MI_ISP_IQ_SetHDR(MI_U32 Channel, MI_ISP_IQ_HDR_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.56. MI_ISP_IQ_GetHDR¶

目的

取得高动态范围 (High Dynamic Range) 参数值。

语法

MI_S32 MI_ISP_IQ_GetHDR(MI_U32 Channel, MI_ISP_IQ_HDR_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.57. MI_ISP_IQ_SetLSC¶

目的

设定LSC参数值。

语法

MI_S32 MI_ISP_IQ_SetLSC(MI_U32 Channel, MI_ISP_IQ_LSC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.58. MI_ISP_IQ_GetLSC¶

目的

取得LSC参数值。

语法

MI_S32 MI_ISP_IQ_GetLSC(MI_U32 Channel, MI_ISP_IQ_LSC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.59. MI_ISP_IQ_SetLSC_CTRL¶

目的

设定LSC CTRL参数值。

语法

MI_S32 MI_ISP_IQ_SetLSC_CTRL(MI_U32 Channel, MI_ISP_IQ_LSC_CTRL_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.60. MI_ISP_IQ_GetLSC_CTRL¶

目的

取得LSC CTRL参数值。

语法

MI_S32 MI_ISP_IQ_GetLSC_CTRL(MI_U32 Channel, MI_ISP_IQ_LSC_CTRL_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.61. MI_ISP_IQ_SetALSC¶

目的

设定ALSC参数值。

语法

MI_S32 MI_ISP_IQ_SetALSC(MI_U32 Channel, MI_ISP_IQ_ALSC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.62. MI_ISP_IQ_GetALSC¶

目的

取得ALSC参数值。

语法

MI_S32 MI_ISP_IQ_GetALSC(MI_U32 Channel, MI_ISP_IQ_ALSC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.63. MI_ISP_IQ_SetALSC_CTRL¶

目的

设定ALSC CTRL参数值。

语法

MI_S32 MI_ISP_IQ_SetALSC_CTRL(MI_U32 Channel, MI_ISP_IQ_ALSC_CTRL_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.64. MI_ISP_IQ_GetALSC_CTRL¶

目的

取得ALSC CTRL参数值。

语法

MI_S32 MI_ISP_IQ_GetALSC_CTRL(MI_U32 Channel, MI_ISP_IQ_ALSC_CTRL_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.65. MI_ISP_IQ_SetIQMode¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetIQMode(MI_U32 Channel, MI_ISP_IQ_PARAM_MODE_e *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.66. MI_ISP_IQ_GetIQMode¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetIQMode(MI_U32 Channel, MI_ISP_IQ_PARAM_MODE_e *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.67. MI_ISP_IQ_SetAPIBypassMode¶

目的

设定ISP对应IP模组的略过模式(ByPass Mode)参数值。

语法

MI_S32 MI_ISP_IQ_SetAPIBypassMode(MI_U32 Channel, MI_ISP_API_BYPASS_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.68. MI_ISP_IQ_GetAPIBypassMode¶

目的

取得ISP对应IP模组的略过模式(ByPass Mode)参数值。

语法

MI_S32 MI_ISP_IQ_GetAPIBypassMode(MI_U32 Channel, MI_ISP_API_BYPASS_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.69. MI_ISP_IQ_QueryCCMInfo¶

目的

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

语法

MI_S32 MI_ISP_IQ_QueryCCMInfo(MI_U32 Channel, MI_ISP_IQ_CCM_INFO_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.70. MI_ISP_IQ_SetNRLuma_Adv¶

目的

设定NRLuma_Adv参数值。

语法

MI_S32 MI_ISP_IQ_SetNRLuma_Adv (MI_U32 Channel, MI_ISP_IQ_NRLuma_Adv_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.71. MI_ISP_IQ_GetNRLuma_Adv¶

目的

取得NRLuma_Adv参数值。

语法

MI_S32 MI_ISP_IQ_GetNRLuma_Adv (MI_U32 Channel, MI_ISP_IQ_NRLuma_Adv_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.72. MI_ISP_IQ_SetNRChroma_Adv¶

目的

设定NRChroma_Adv参数值。

语法

MI_S32 MI_ISP_IQ_SetNRChroma_Adv (MI_U32 Channel, MI_ISP_IQ_NRChroma_Adv_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.73. MI_ISP_IQ_GetNRChroma_Adv¶

目的

取得NRChroma_Adv参数值。

语法

MI_S32 MI_ISP_IQ_GetNRChroma_Adv(MI_U32 Channel, MI_ISP_IQ_NRChroma_Adv_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.74. MI_ISP_IQ_SetPFC¶

目的

设定PFC参数值。

语法

MI_S32 MI_ISP_IQ_SetPFC (MI_U32 Channel, MI_ISP_IQ_PFC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.75. MI_ISP_IQ_GetPFC¶

目的

取得PFC参数值。

语法

MI_S32 MI_ISP_IQ_GetPFC (MI_U32 Channel, MI_ISP_IQ_PFC_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.76. MI_ISP_IQ_SetPFC_EX¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetPFC_EX (MI_U32 Channel, MI_ISP_IQ_PFC_EX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.77. MI_ISP_IQ_GetPFC_EX¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetPFC_EX (MI_U32 Channel, MI_ISP_IQ_PFC_EX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.78. MI_ISP_IQ_SetHDR_EX¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetHDR_EX (MI_U32 Channel, MI_ISP_IQ_HDR_EX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.79. MI_ISP_IQ_GetHDR_EX¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetHDR_EX (MI_U32 Channel, MI_ISP_IQ_HDR_EX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.80. MI_ISP_IQ_SetSHP_EX¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetSHP_EX (MI_U32 Channel, MI_ISP_IQ_SHP_EX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.81. MI_ISP_IQ_GetSHP_EX¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetSHP_EX (MI_U32 Channel, MI_ISP_IQ_SHP_EX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.82. MI_ISP_IQ_SetNR3D_EX¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetNR3D_EX (MI_U32 Channel, MI_ISP_IQ_NR3D_EX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.83. MI_ISP_IQ_GetNR3D_EX¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetNR3D_EX (MI_U32 Channel, MI_ISP_IQ_NR3D_EX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.84. MI_ISP_IQ_SetDUMMY¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetDUMMY (MI_U32 Channel, MI_ISP_IQ_DUMMY_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.85. MI_ISP_IQ_GetDUMMY¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetDUMMY (MI_U32 Channel, MI_ISP_IQ_DUMMY_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.86. MI_ISP_IQ_SetDUMMY_EX¶

目的

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

语法

MI_S32 MI_ISP_IQ_SetDUMMY_EX (MI_U32 Channel, MI_ISP_IQ_DUMMY_EX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.87. MI_ISP_IQ_GetDUMMY_EX¶

目的

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

语法

MI_S32 MI_ISP_IQ_GetDUMMY_EX (MI_U32 Channel, MI_ISP_IQ_DUMMY_EX_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.88. MI_ISP_IQ_SetWDRCurveFull¶

目的

设定WDRCurveFull参数值。

语法

MI_S32 MI_ISP_IQ_SetWDRCurveFull (MI_U32 Channel, MI_ISP_IQ_WDRCurveFull_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.89. MI_ISP_IQ_GetWDRCurveFull¶

目的

取得WDRCurveFull参数值。

语法

MI_S32 MI_ISP_IQ_GetWDRCurveFull (MI_U32 Channel, MI_ISP_IQ_WDRCurveFull_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.90. MI_ISP_AE_QueryExposureInfo¶

目的

取得自动曝光参数值。

语法

MI_S32 MI_ISP_AE_QueryExposureInfo(MI_U32 Channel, MI_ISP_AE_EXPO_INFO_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.91. MI_ISP_AE_GetHistoWghtY¶

目的

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

语法

MI_S32 MI_ISP_AE_GetHistoWghtY(MI_U32 Channel, MI_ISP_AE_HIST_WEIGHT_Y_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

*data 当前画面亮度及长条图统计资料数值的指标。
返回值

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.92. MI_ISP_AE_SetEVComp¶

目的

设定曝光补偿参数值。

语法

MI_S32 MI_ISP_AE_SetEVComp(MI_U32 Channel, MI_ISP_AE_EV_COMP_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.93. MI_ISP_AE_GetEVComp¶

目的

取得曝光补偿参数值。

语法

MI_S32 MI_ISP_AE_GetEVComp(MI_U32 Channel, MI_ISP_AE_EV_COMP_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.94. MI_ISP_AE_SetExpoMode¶

目的

设定曝光模式参数值。

语法

MI_S32 MI_ISP_AE_SetExpoMode(MI_U32 Channel, MI_ISP_AE_MODE_TYPE_e *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.95. MI_ISP_AE_GetExpoMode¶

目的

取得曝光模式参数值。

语法

MI_S32 MI_ISP_AE_GetExpoMode(MI_U32 Channel, MI_ISP_AE_MODE_TYPE_e *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.96. MI_ISP_AE_SetManualExpo¶

目的

设定手动曝光参数值。

语法

MI_S32 MI_ISP_AE_SetManualExpo(MI_U32 Channel, MI_ISP_AE_EXPO_VALUE_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.97. MI_ISP_AE_GetManualExpo¶

目的

取得手动曝光参数值。

语法

MI_S32 MI_ISP_AE_GetManualExpo(MI_U32 Channel, MI_ISP_AE_EXPO_VALUE_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.98. MI_ISP_AE_SetManualShortExpo¶

目的

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

语法

MI_S32 MI_ISP_AE_SetManualShortExpo(MI_U32 Channel, MI_ISP_AE_EXPO_VALUE_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.99. MI_ISP_AE_GetManualShortExpo¶

目的

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

语法

MI_S32 MI_ISP_AE_GetManualShortExpo(MI_U32 Channel, MI_ISP_AE_EXPO_VALUE_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.100. MI_ISP_AE_SetState¶

目的

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

语法

MI_S32 MI_ISP_AE_SetState(MI_U32 Channel, MI_ISP_SM_STATE_TYPE_e *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.101. MI_ISP_AE_GetState¶

目的

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

语法

MI_S32 MI_ISP_AE_GetState(MI_U32 Channel, MI_ISP_SM_STATE_TYPE_e *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.102. MI_ISP_AE_SetTarget¶

目的

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

语法

MI_S32 MI_ISP_AE_SetTarget(MI_U32 Channel, MI_ISP_AE_INTP_LUT_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.103. MI_ISP_AE_GetTarget¶

目的

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

语法

MI_S32 MI_ISP_AE_GetTarget(MI_U32 Channel, MI_ISP_AE_INTP_LUT_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.104. MI_ISP_AE_SetConverge¶

目的

设定曝光收敛参数值。

语法

MI_S32 MI_ISP_AE_SetConverge(MI_U32 Channel, MI_ISP_AE_CONV_CONDITON_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.105. MI_ISP_AE_GetConverge¶

目的

取得曝光收敛参数值。

语法

MI_S32 MI_ISP_AE_GetConverge(MI_U32 Channel, MI_ISP_AE_CONV_CONDITON_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.106. MI_ISP_AE_SetExposureLimit¶

目的

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

语法

MI_S32 MI_ISP_AE_SetExposureLimit(MI_U32 Channel, MI_ISP_AE_EXPO_LIMIT_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.107. MI_ISP_AE_GetExposureLimit¶

目的

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

语法

MI_S32 MI_ISP_AE_GetExposureLimit(MI_U32 Channel, MI_ISP_AE_EXPO_LIMIT_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.108. MI_ISP_AE_SetPlainLongExpoTable¶

目的

设定长曝曝光表参数值。

语法

MI_S32 MI_ISP_AE_SetPlainLongExpoTable(MI_U32 Channel, MI_ISP_AE_EXPO_TABLE_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.109. MI_ISP_AE_GetPlainLongExpoTable¶

目的

取得长曝曝光表参数值。

语法

MI_S32 MI_ISP_AE_GetPlainLongExpoTable(MI_U32 Channel, MI_ISP_AE_EXPO_TABLE_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.110. MI_ISP_AE_SetPlainShortExpoTable¶

目的

设定短曝曝光表参数值。

语法

MI_S32 MI_ISP_AE_SetPlainShortExpoTable(MI_U32 Channel, MI_ISP_AE_EXPO_TABLE_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.111. MI_ISP_AE_GetPlainShortExpoTable¶

目的

取得短曝曝光表参数值。

语法

MI_S32 MI_ISP_AE_GetPlainShortExpoTable(MI_U32 Channel, MI_ISP_AE_EXPO_TABLE_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.112. MI_ISP_AE_SetWinWgtType¶

目的

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

语法

MI_S32 MI_ISP_AE_SetWinWgtType(MI_U32 Channel, MI_ISP_AE_WIN_WEIGHT_MODE_TYPE_e *data);

描述

调用此函式设定曝光权重表种类参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.113. MI_ISP_AE_GetWinWgtType¶

目的

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

语法

MI_S32 MI_ISP_AE_GetWinWgtType(MI_U32 Channel, MI_ISP_AE_WIN_WEIGHT_MODE_TYPE_e *data);

描述

调用此函式取得曝光权重表种类参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.114. MI_ISP_AE_SetWinWgt¶

目的

设定曝光权重表参数值。

语法

MI_S32 MI_ISP_AE_SetWinWgt(MI_U32 Channel, MI_ISP_AE_WIN_WEIGHT_TYPE_t *data);

描述

调用此函式设定曝光权重表参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.115. MI_ISP_AE_GetWinWgt¶

目的

取得曝光权重表参数值。

语法

MI_S32 MI_ISP_AE_GetWinWgt(MI_U32 Channel, MI_ISP_AE_WIN_WEIGHT_TYPE_t *data);

描述

调用此函式取得曝光权重表参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.116. MI_ISP_AE_SetFlicker¶

目的

设定抗闪烁参数值。

语法

MI_S32 MI_ISP_AE_SetFlicker(MI_U32 Channel, MI_ISP_AE_FLICKER_TYPE_e *data);

描述

调用此函式设定抗闪烁参数值，支持50Hz和60Hz抗闪烁。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

支持50Hz和60Hz抗闪烁。

举例

无。

2.117. MI_ISP_AE_GetFlicker¶

目的

取得抗闪烁参数值。

语法

MI_S32 MI_ISP_AE_GetFlicker(MI_U32 Channel, MI_ISP_AE_FLICKER_TYPE_e *data);

描述

调用此函式取得抗闪烁参数值，支持50Hz和60Hz抗闪烁。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.118. MI_ISP_AE_SetFlickerEX¶

目的

设定侦测抗闪烁参数值。

语法

MI_S32 MI_ISP_AE_SetFlickerEX(MI_U32 Channel, MI_ISP_AE_FLICKER_EX_TYPE_t *data);

描述

调用此函式设定侦测抗闪烁参数值，支持50Hz和60Hz抗闪烁。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

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

无。

2.119. MI_ISP_AE_GetFlickerEX¶

目的

取得侦测抗闪烁参数值。

语法

MI_S32 MI_ISP_AE_GetFlickerEX(MI_U32 Channel, MI_ISP_AE_FLICKER_EX_TYPE_t *data);

描述

调用此函式取得侦测抗闪烁参数值，支持50Hz和60Hz抗闪烁。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.120. MI_ISP_AE_QueryFlickerInfo¶

目的

取得抗闪烁参数值之相关资讯。

语法

MI_S32 MI_ISP_AE_QueryFlickerInfo(MI_U32 Channel, MI_ISP_AE_FLICKER_EX_INFO_TYPE_t *data);

描述

调用此函式取得侦测抗闪烁参数值，分别为抗闪烁的有效状态、抗闪烁模式(50/60Hz)、抗闪烁模式的有效分数。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.121. MI_ISP_AE_SetStrategy¶

目的

设定曝光策略参数值。

语法

MI_S32 MI_ISP_AE_SetStrategy(MI_U32 Channel, MI_ISP_AE_STRATEGY_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.122. MI_ISP_AE_GetStrategy¶

目的

取得曝光策略参数值。

语法

MI_S32 MI_ISP_AE_GetStrategy(MI_U32 Channel, MI_ISP_AE_STRATEGY_TYPE_t *data);

描述

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

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.123. MI_ISP_AE_SetRGBIRAE¶

目的

设定RGBIR mode曝光策略参数值。

语法

MI_S32 MI_ISP_AE_SetRGBIRAE(MI_U32 Channel, MI_ISP_AE_RGBIR_AE_TYPE_t *data);

描述

调用此函式设定RGBIR mode曝光策略参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.124. MI_ISP_AE_GetRGBIRAE¶

目的

取得RGBIR mode曝光策略参数值。

语法

MI_S32 MI_ISP_AE_GetRGBIRAE(MI_U32 Channel, MI_ISP_AE_RGBIR_AE_TYPE_t *data);

描述

调用此函式取得RGBIR mode曝光策略参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.125. MI_ISP_AE_SetHDR¶

目的

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

语法

MI_S32 MI_ISP_AE_SetHDR(MI_U32 Channel, MI_ISP_AE_HDR_TYPE_t *data);

描述

调用此函式设定HDR mode曝光策略参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.126. MI_ISP_AE_GetHDR¶

目的

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

语法

MI_S32 MI_ISP_AE_GetHDR(MI_U32 Channel, MI_ISP_AE_HDR_TYPE_t *data);

描述

调用此函式取得HDR mode曝光策略参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.127. MI_ISP_AE_SetStabilizer¶

目的

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

语法

MI_S32 MI_ISP_AE_SetStabilizer(MI_U32 Channel, MI_ISP_AE_STABILIZER_TYPE_t *data);

描述

调用此函式设置Stabilizer策略参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.128. MI_ISP_AE_GetStabilizer¶

目的

取得Stabilizer策略参数值。

语法

MI_S32 MI_ISP_AE_GetStabilizer(MI_U32 Channel, MI_ISP_AE_STABILIZER_TYPE_t *data);

描述

调用此函式取得Stabilizer策略参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.129. MI_ISP_AWB_QueryInfo¶

目的

取得自动白平衡参数值。

语法

MI_S32 MI_ISP_AWB_QueryInfo(MI_U32 Channel, MI_ISP_AWB_QUERY_INFO_TYPE_t *data);

描述

调用此函式取得自动白平衡参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.130. MI_ISP_AWB_GetCTStats¶

目的

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

语法

MI_S32 MI_ISP_AWB_GetCTStats(MI_U32 Channel, MI_ISP_AWB_CT_STATISTICS_TYPE_t *data);

描述

调用此函式取得自动白平衡校正统计值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.131. MI_ISP_AWB_GetHWStats¶

目的

取得自动白平衡硬体统计值。

语法

MI_S32 MI_ISP_AWB_GetHWStats(MI_U32 Channel, MI_ISP_AWB_HW_STATISTICS_TYPE_t *data);

描述

调用此函式取得自动白平衡硬体统计值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

*data 自动白平衡硬体统计值的指标。
返回值

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.132. MI_ISP_AWB_SetAttr¶

目的

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

语法

MI_S32 MI_ISP_AWB_SetAttr(MI_U32 Channel, MI_ISP_AWB_ATTR_TYPE_t *data);

描述

调用此函式设定自动白平衡属性参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.133. MI_ISP_AWB_GetAttr¶

目的

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

语法

MI_S32 MI_ISP_AWB_GetAttr(MI_U32 Channel, MI_ISP_AWB_ATTR_TYPE_t *data);

描述

调用此函式取得自动白平衡属性参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.134. MI_ISP_AWB_SetAttrEx¶

目的

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

语法

MI_S32 MI_ISP_AWB_SetAttrEx(MI_U32 Channel, MI_ISP_AWB_ATTR_EX_TYPE_t *data);

描述

调用此函式设定自动白平衡增强属性参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

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

无。

2.135. MI_ISP_AWB_GetAttrEx¶

目的

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

语法

MI_S32 MI_ISP_AWB_GetAttrEx(MI_U32 Channel, MI_ISP_AWB_ATTR_EX_TYPE_t *data);

描述

调用此函式取得自动白平衡增强属性参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.136. MI_ISP_AWB_SetMultiLSAttr¶

目的

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

语法

MI_S32 MI_ISP_AWB_SetMultiLSAttr(MI_U32 Channel, MI_ISP_AWB_MULTILS_LS_TYPE_t *data);

描述

调用此函式设定自动白平衡混光偏校正参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

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

无。

2.137. MI_ISP_AWB_GetMultiLSAttr¶

目的

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

语法

MI_S32 MI_ISP_AWB_GetMultiLSAttr(MI_U32 Channel, MI_ISP_AWB_MULTILS_LS_TYPE_t *data);

描述

调用此函式取得自动白平衡混光偏校正参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.138. MI_ISP_AWB_SetCTCaliAttr¶

目的

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

语法

MI_S32 MI_ISP_AWB_SetCTCaliAttr(MI_U32 Channel, MI_ISP_AWB_CT_CALI_TYPE_t *data);

描述

调用此函式设定自动白平衡校正参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.139. MI_ISP_AWB_GetCTCaliAttr¶

目的

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

语法

MI_S32 MI_ISP_AWB_GetCTCaliAttr(MI_U32 Channel, MI_ISP_AWB_CT_CALI_TYPE_t *data);

描述

调用此函式取得自动白平衡校正参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.140. MI_ISP_AWB_GetCurCTCaliAttr¶

目的

取得自动白平衡套用校正资料后的色温框资料。

语法

MI_S32 MI_ISP_AWB_GetCurCTCaliAttr(MI_U32 Channel, MI_ISP_AWB_CUR_CT_CALI_TYPE_t *data);

描述

调用此函式取得自动白平衡校正参数值。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

2.141. MI_ISP_API_CmdLoadBinFile¶

目的

载入cmd load bin file，于使用者在IQ Tool调校好的IQ参数后tunnel到用户应用程式中。

语法

MI_S32 MI_ISP_API_CmdLoadBinFile(MI_U32 Channel, char* filepath, MI_U32 user_key);

描述

调用此函式载入IQ Tool调校好之后的api cmd bin档案，那么用户在app中直接load 此bin file，就与IQ Tool调校效果一样。

参数

参数名称	描述
Channel	影像输入的通道号(一般为0)。
filepath	ISP api bin档案的路径位置。
user_key	user key与magic key必须一致。magic key可由IQ Tool内的Setting栏位来修改值。

返回值

参数名称描述

MI_ISP_OK 成功。

MI_ISP_FAILURE 失败。
需求
头文件：mi_isp.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里面设定，如下图。

图 2-1：IQTool介面设定Magic key示意图

2.142. MI_ISP_API_CmdLoadCaliData¶

目的

载入offline calibration data file，于使用者在离线版校正程式的参数档案(*.data)后tunnel到用户应用程式中呼叫此API function。

语法

MI_S32 MI_ISP_API_CmdLoadCaliData(MI_U32 Channel, MI_ISP_CALI_ITEM_e  eCaliItem, char* filepath);

描述

调用此函式载入离线版校正程式的参数档案(*.data)，那么用户在应用程式中直接load此data file。
参数

参数名称描述

Channel 影像输入的通道号(一般为0)。

eCaliItem 校正专案的列举结构体。

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

参数名称描述

MI_ISP_OK 成功。

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

无。
举例

无。

3. MI ISP API 资料类型¶

3.1. MI_ISP_BOOL结构体¶

3.1.1. 列举结构体 (Enum Structure)¶

说明

布林值的列举结构体。

定义

typedef enum

{

    SS_FALSE = 0,

    SS_TRUE = !SS_FALSE,

    SS_BOOL_MAX

} MI_ISP_BOOL_e;

名称

变数名称描述

SS_FALSE 布林值等于0。

SS_TRUE 布林值等于1。

SS_BOOL_MAX 判断布林值列举列表的最大值。

3.2. MI_ISP_OP_TYPE结构体¶

3.2.1. 列举结构体 (Enum Structure)¶

说明

工作模式的列举结构体。

定义

typedef enum

{

    SS_OP_TYP_AUTO = 0,

    SS_OP_TYP_MANUAL = !SS_OP_TYP_AUTO,

    SS_OP_TYP_MODE_MAX

} MI_ISP_OP_TYPE_e;

名称

变数名称描述

SS_OP_TYP_AUTO 自动工作模式。

SS_OP_TYP_MANUAL 手动工作模式。

SS_OP_TYP_MODE_MAX 判断工作模式列举清单的最大值。

3.3. MI_ISP_SM_STATE_TYPE结构体¶

3.3.1. 列举结构体 (Enum Structure)¶

说明

状态机 (State Machine) 的列举结构体。

定义

typedef enum

{

    SS_ISP_STATE_NORMAL = 0,

    SS_ISP_STATE_PAUSE = 1,

    SS_ISP_STATE_MAX

} MI_ISP_SM_STATE_TYPE_e;

名称

变数名称描述

SS_OP_TYP_AUTO 正常模式。

SS_OP_TYP_MANUAL 暂停模式。

SS_OP_TYP_MODE_MAX 判断状态机列举清单的最大值。

3.4. MI_ISP_IQ_PARAM_MODE结构体¶

3.4.1. 列举结构体 (Enum Structure)¶

说明

IQ特殊模式的列举结构体。

定义

typedef enum

{

    SS_IQ_PARAM_MODE_NORMAL = 0,

    SS_IQ_PARAM_MODE_NIGHT = 1,

    SS_IQ_PARAM_MODE_MAX

} MI_ISP_IQ_PARAM_MODE_e;

名称

变数名称描述

SS_IQ_PARAM_MODE_NORMAL IQ白天工作模式。

SS_IQ_PARAM_MODE_NIGHT IQ夜间工作模式。

SS_IQ_PARAM_MODE_MAX 判断IQ工作模式列举清单的最大值。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetIQMode(MI_U32 Channel, MI_ISP_IQ_PARAM_MODE_e *data);

MI_S32 MI_ISP_IQ_GetIQMode(MI_U32 Channel, MI_ISP_IQ_PARAM_MODE_e *data);。

3.5. MI_ISP_BYPASS_MODE结构体¶

3.5.1. 列举结构体 (Enum Structure)¶

说明

ByPass工作模式的列举结构体。

定义

typedef enum

{

    SS_BYPASS_OFF = 0,

    SS_BYPASS_ON,

    SS_BYPASS_MAX

} MI_ISP_BYPASS_MODE_e;

名称

变数名称描述

SS_BYPASS_OFF ByPass工作模式等于Disable。

SS_BYPASS_ON ByPass工作模式等于Enable。

SS_ BYPASS_MAX 判断ByPass工作模式列举清单的最大值。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetAPIBypassMode(MI_U32 Channel, MI_ISP_API_BYPASS_TYPE_t *data);。

MI_S32 MI_ISP_IQ_GetAPIBypassMode(MI_U32 Channel, MI_ISP_API_BYPASS_TYPE_t *data);。

3.6. MI_ISP_IQ_INDEX结构体¶

3.6.1. 列举结构体 (Enum Structure)¶

说明

IQ曝光指数 (ISO index) 的列举结构体。

定义

typedef enum

{

    SS_IQ_INDEX_0 = 0,

    SS_IQ_INDEX_1,

    SS_IQ_INDEX_2,

    SS_IQ_INDEX_3,

    SS_IQ_INDEX_4,

    SS_IQ_INDEX_5,

    SS_IQ_INDEX_6,

    SS_IQ_INDEX_7,

    SS_IQ_INDEX_8,

    SS_IQ_INDEX_9,

    SS_IQ_INDEX_10,

    SS_IQ_INDEX_11,

    SS_IQ_INDEX_12,

    SS_IQ_INDEX_13,

    SS_IQ_INDEX_14,

    SS_IQ_INDEX_15,

    SS_IQ_INDEX_MAX

} MI_ISP_IQ_INDEX_e;

名称

变数名称	描述
SS_IQ_INDEX_0	SS_IQ_INDEX_0曝光指数等于0、增益数值等于1倍。
SS_IQ_INDEX_1	SS_IQ_INDEX_1曝光指数等于1、增益数值等于2倍。
SS_IQ_INDEX_2	SS_IQ_INDEX_2曝光指数等于2、增益数值等于4倍。
SS_IQ_INDEX_3	SS_IQ_INDEX_3曝光指数等于3、增益数值等于8倍。
SS_IQ_INDEX_4	SS_IQ_INDEX_4曝光指数等于4、增益数值等于16倍。
SS_IQ_INDEX_5	SS_IQ_INDEX_5曝光指数等于5、增益数值等于32倍。
SS_IQ_INDEX_6	SS_IQ_INDEX_6曝光指数等于6、增益数值等于64倍。
SS_IQ_INDEX_7	SS_IQ_INDEX_7曝光指数等于7、增益数值等于128倍。
SS_IQ_INDEX_8	SS_IQ_INDEX_8曝光指数等于8、增益数值等于256倍。
SS_IQ_INDEX_9	SS_IQ_INDEX_9曝光指数等于9、增益数值等于512倍。
SS_IQ_INDEX_10	SS_IQ_INDEX_10曝光指数等于10、增益数值等于1024倍。
SS_IQ_INDEX_11	SS_IQ_INDEX_11曝光指数等于11、增益数值等于2048倍。
SS_IQ_INDEX_12	SS_IQ_INDEX_12曝光指数等于12、增益数值等于4096倍。
SS_IQ_INDEX_13	SS_IQ_INDEX_13曝光指数等于13、增益数值等于8192倍。
SS_IQ_INDEX_14	SS_IQ_INDEX_14曝光指数等于14、增益数值等于16384倍。
SS_IQ_INDEX_15	SS_IQ_INDEX_15曝光指数等于15、增益数值等于32768倍。

相关结构类型与函式

MI_S32 MI_ISP_IQ_GetIQind(MI_U32 Channel, MI_ISP_IQ_INDEX_e *data);

3.7. MI_ISP_API_ID结构体¶

3.7.1. 列举结构体 (Enum Structure)¶

说明

每个API ID的列举结构体。

定义

typedef enum

{

    API20_AUTO = 0,

    API20_FPN = 1,

    API20_CCM = 2,

    API20_SAT = 3,

    API20_OBC = 4,

    API20_OBC_P1 = 5,

    API20_FCOLOR = 6,

    API20_CR = 7,

    API20_NR_DeSpike = 8,

    API20_SHP2 = 9,

    API20_NR_3D = 10,

    API20_BRI = 11,

    API20_LIG = 12,

    API20_CST = 13,

    API20_GMA = 14,

    API20_CTG = 15,

    API20_NR_NLM = 16,

    API20_DEFOG = 17,

    API20_DRC = 18,

    API20_DPC = 19,

    API20_HSV = 20,

    API20_WDR_LOC = 21,

    API20_RGBIR = 22,

    API20_YUVGMA = 23,

    API20_HDR16to12 = 24,

    API20_COLORTRANS = 25,

    API20_HDR = 26,

    API20_EFFECT = 27,

    API20_PFC = 28,

    API20_NRChroma = 29,

    API20_DM = 30,

    API20_NR_3D_P1 = 31,

    API20_WDRCurveAdv = 32,

    API20_MXNR = 33,

    API20_R2Y = 34,

    API20_LSC = 35,

    API20_LSC_CTRL = 36,

    API20_ALSC = 37,

    API20_ALSC_CTRL = 38,

    API20_DPC_CLUSTER = 39,

    API20_PFC_EX = 40,

    API20_HDR_EX = 41,

    API20_SHP_EX = 42,

    API20_NR_3D_EX = 43,

    API20_GNR = 44,

    API20_DUMMY = 45,

    API20_DUMMY_EX = 46,

    API20_WDRCurveFull = 47,

    API20_MAX = 48,

} MI_ISP_API_ID_e;

名称

无。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetAPIBypassMode(MI_U32 Channel, MI_ISP_API_BYPASS_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetAPIBypassMode(MI_U32 Channel, MI_ISP_API_BYPASS_TYPE_t *data);

3.8. MI_ISP_AWB_ALG_TYPE结构体¶

3.8.1. 列举结构体 (Enum Structure)¶

说明

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

定义

typedef enum

{

    SS_AWB_ALG_GRAYWORLD = 0,

    SS_AWB_ALG_NORMAL = 1,

    SS_AWB_ALG_BALANCE =2,

    SS_AWB_ALG_FOCUS =3,

    SS_AWB_ALG_MAX

} MI_ISP_AWB_ALG_TYPE_e;

名称

变数名称	描述
SS_AWB_ALG_ GRAYWORLD	以所有统计值来计算WB gain。
SS_AWB_ALG_NORMAL	以落点数最高的2~3个色温框内的统计值来计算WB gain。
SS_AWB_ALG_BALANCE	以所有落入有效色温框的统计值来计算WB gain。
SS_AWB_ALG_FOCUS	WB gain计算会偏向单一色温为主。
SS_AWB_ALG_MAX	判断自动白平衡演算法列举清单的最大值。

3.9. MI_ISP_AWB_ADV_TYPE结构体¶

3.9.1. 列举结构体 (Enum Structure)¶

说明

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

定义

typedef enum

{

    SS_AWB_ADV_DEFAULT = 0,

    SS_AWB_ADV_ADVANCE = 1,

    SS_AWB_ADV_MAX

} MI_ISP_AWB_ADV_TYPE_e;

名称

变数名称	描述
SS_AWB_ADV_DEFAULT	预设的自动白平衡演算法。
SS_AWB_ADV_ADVANCE	增强的自动白平衡演算法，可以开启MI_ISP_AWB_SetAttrEx的设定功能。
SS_AWB_ADV_MAX	判断自动白平衡进阶演算法列举清单的最大值。

3.10. MI_ISP_CALI_ITEM结构体¶

3.10.1. 列举结构体 (Enum Structure)¶

说明

校正选项的列举结构体。

定义

typedef enum

{

    SS_CALI_ITEM_AWB = 0,

    SS_CALI_ITEM_OBC,

    SS_CALI_ITEM_SDC,

    SS_CALI_ITEM_ALSC,

    SS_CALI_ITEM_LSC,

    SS_CALI_ITEM_MAX,

} MI_ISP_CALI_ITEM_e;

名称

变数名称	描述
SS_CALI_ITEM_AWB	白平衡补偿校正。
SS_CALI_ITEM_OBC	黑电平补偿校正。
SS_CALI_ITEM_SDC	静态坏点补偿校正。
SS_CALI_ITEM_ALSC	镜头补偿校正。
SS_CALI_ITEM_LSC	镜头补偿校正。
SS_CALI_ITEM_MAX	判断校正选项列举清单的最大值。

相关结构类型与函式

MI_S32 MI_ISP_API_CmdLoadCaliData(MI_U32 Channel, MI_ISP_CALI_ITEM_e eCaliItem, char* filepath);

3.11. MI_ISP_IQ_VERSION_INFO结构体¶

3.11.1. 类型结构体 (Type Structure)¶

说明

取得ISP IQ版本号的类型结构体。

定义

typedef struct MI_ISP_IQ_VERSION_INFO_TYPE_s

{

    IQ_VERSION_INFO_PARAM_t stParaAPI;

} MI_ISP_IQ_VERSION_INFO_TYPE_t;

名称

变数名称描述

stParaAPI 取得ISP IQ版本号的类型结构体。
相关结构类型与函式

MI_S32 MI_ISP_IQ_GetVersionInfo(MI_U32 Channel, MI_ISP_IQ_VERSION_INFO_TYPE_t *data);

3.11.2. 参数结构体 (Parameter Structure)¶

说明

取得IQ版本号的参数结构体。

定义

typedef struct IQ_VERSION_INFO_PARAM_s

{

    MI_U32 u32Vendor;

    MI_U32 u32Major;

    MI_U32 u32Minor;

} IQ_VERSION_INFO_PARAM_t;

名称

变数名称	描述
u32Vendor	ISP IQ Vendor版本号，提供Get / Set功能。
u32Major	ISP IQ Major版本号，只提供Get功能。
u32Minor	ISP IQ Minor版本号，只提供Get功能。

3.12. MI_ISP_IQ_PARAM_INIT_INFO结构体¶

3.12.1. 类型结构体 (Type Structure)¶

说明

取得ISP初始化ready状态的类型结构体。

定义

typedef struct MI_ISP_IQ_PARAM_INIT_INFO_TYPE_s

{

    IQ_PARAM_INIT_INFO_PARAM_t stParaAPI;

} MI_ISP_IQ_PARAM_INIT_INFO_TYPE_t;

名称

变数名称描述

stParaAPI 取得ISP初始化ready状态的类型结构体。
相关结构类型与函式

MI_S32 MI_ISP_IQ_GetParaInitStatus(MI_U32 Channel, MI_ISP_IQ_PARAM_INIT_INFO_TYPE_t *data);

3.12.2. 参数结构体 (Parameter Structure)¶

说明

取得ISP初始化ready状态的参数结构体。
定义

typedef struct IQ_PARAM_INIT_INFO_PARAM_s

{
```
MI_ISP_BOOL_e bFlag;
```
} IQ_PARAM_INIT_INFO_PARAM_t;
名称

变数名称描述

bFlag 取得ISP初始化完毕状态的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

3.13. MI_ISP_IQ_COLORTOGRAY结构体¶

3.13.1. 类型结构体 (Type Structure)¶

说明

设定彩色转灰阶影像的类型结构体。

定义

typedef struct MI_ISP_IQ_COLORTOGRAY_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

} MI_ISP_IQ_COLORTOGRAY_TYPE_t;

名称

变数名称描述

bEnable 设定彩色转灰阶影像功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetColorToGray(MI_U32 Channel, MI_ISP_IQ_COLORTOGRAY_TYPE_t](#类型结构体-type-structure-2) *data);

MI_S32 MI_ISP_IQ_GetColorToGray(MI_U32 Channel, MI_ISP_IQ_COLORTOGRAY_TYPE_t](#类型结构体-type-structure-2) *data);

3.14. MI_ISP_IQ_CONTRAST结构体¶

3.14.1. 类型结构体 (Type Structure)¶

说明

设定对比度的类型结构体。

定义

typedef struct MI_ISP_IQ_CONTRAST_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    CONTRAST_AUTO_ATTR_t stAuto;

    CONTRAST_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_CONTRAST_TYPE_t;

名称

变数名称	描述
bEnable	设定对比度功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定对比度的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定对比度的自动模式属性结构体。
stManual	设定对比度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetContrast(MI_U32 Channel, MI_ISP_IQ_CONTRAST_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetContrast(MI_U32 Channel, MI_ISP_IQ_CONTRAST_TYPE_t *data);

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

说明

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

定义

typedef struct CONTRAST_AUTO_ATTR_s

{

    LEVEL_BASE_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} CONTRAST_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

定义

typedef struct CONTRAST_MANUAL_ATTR_s

{

    LEVEL_BASE_PARAM_t  stParaAPI;

} CONTRAST_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

参数结构体 (Parameter Structure)¶

说明

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

定义

typedef struct LEVEL_BASE_PARAM_s

{

    MI_U32 u32Lev;

} LEVEL_BASE_PARAM_t;

名称

变数名称描述

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

3.15. MI_ISP_IQ_BRIGHTNESS结构体¶

3.15.1. 类型结构体 (Type Structure)¶

说明

设定亮度的类型结构体。

定义

typedef struct MI_ISP_IQ_BRIGHTNESS_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    BRIGHTNESS_AUTO_ATTR_t stAuto;

    BRIGHTNESS_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_BRIGHTNESS_TYPE_t;

名称

变数名称	描述
bEnable	设定亮度功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定亮度的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定亮度的自动模式属性结构体。
stManual	设定亮度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetBrightness(MI_U32 Channel, MI_ISP_IQ_BRIGHTNESS_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetBrightness(MI_U32 Channel, MI_ISP_IQ_BRIGHTNESS_TYPE_t *data);

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

说明

设定亮度的自动模式属性结构体。

定义

typedef struct BRIGHTNESS_AUTO_ATTR_s

{

    LEVEL_BASE_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} BRIGHTNESS_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定亮度的手动模式属性结构体。

定义

typedef struct BRIGHTNESS_MANUAL_ATTR_s

{

    LEVEL_BASE_PARAM_t  stParaAPI;

} BRIGHTNESS_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.16. MI_ISP_IQ_LIGHTNESS结构体¶

3.16.1. 类型结构体 (Type Structure)¶

说明

设定灰度的类型结构体。

定义

typedef struct MI_ISP_IQ_LIGHTNESS_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    LIGHTNESS_AUTO_ATTR_t   stAuto;

    LIGHTNESS_MANUAL_ATTR_t   stManual;

} MI_ISP_IQ_LIGHTNESS_TYPE_t;

名称

变数名称	描述
bEnable	设定灰度功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定灰度的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定灰度的自动模式属性结构体。
stManual	设定灰度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetLightness(MI_U32 Channel, MI_ISP_IQ_LIGHTNESS_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetLightness(MI_U32 Channel, MI_ISP_IQ_LIGHTNESS_TYPE_t *data);

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

说明

设定灰度的自动模式属性结构体。

定义

typedef struct LIGHTNESS_AUTO_ATTR_s

{

    LEVEL_BASE_PARAM_t  stParaAPI[MI_ISP_AUTO_NUM];

} LIGHTNESS_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定灰度的手动模式属性结构体。

定义

typedef struct LIGHTNESS_MANUAL_ATTR_s

{

    LEVEL_BASE_PARAM_t  stParaAPI;

} LIGHTNESS_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.17. MI_ISP_IQ_RGBGAMMA结构体¶

3.17.1. 类型结构体 (Type Structure)¶

说明

设定RGB Gamma curve的类型结构体。

定义

typedef struct MI_ISP_IQ_RGBGAMMA_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    RGBGAMMA_AUTO_ATTR_t  stAuto;

    RGBGAMMA_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_RGBGAMMA_TYPE_t;

名称

变数名称	描述
bEnable	设定RGB Gamma curve功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定RGB Gamma curve的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定RGB Gamma curve的自动模式属性结构体。
stManual	设定RGB Gamma curve的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetRGBGamma(MI_U32 Channel, MI_ISP_IQ_RGBGAMMA_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetRGBGamma(MI_U32 Channel, MI_ISP_IQ_RGBGAMMA_TYPE_t *data);

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

说明

设定RGB Gamma curve的自动模式属性结构体。

定义

typedef struct RGBGAMMA_AUTO_ATTR_s

{

    RGBGAMMA_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} RGBGAMMA_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定RGB Gamma curve的手动模式属性结构体。

定义

typedef struct RGBGAMMA_MANUAL_ATTR_s

{

    RGBGAMMA_PARAM_t stParaAPI;

} RGBGAMMA_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

参数结构体 (Parameter Structure)¶

说明

设定RGB Gamma curve的参数结构体。

定义

typedef struct RGBGAMMA_PARAM_s

{

    MI_U16 u16LutR[256];

    MI_U16 u16LutG[256];

    MI_U16 u16LutB[256];

} RGBGAMMA_PARAM_t;

名称

变数名称	描述
u16LutR[256]	R通道分量。值域范围：0 ~ 1023。
u16LutG[256]	G通道分量。值域范围：0 ~ 1023。
u16LutB[256]	B通道分量。值域范围：0 ~ 1023。

注意事项

支持三个通道的Gamma设定，SigmaStar建议三个通道设定一样，如下图。

图 3-1：RGB Gamma 曲线
相关结构类型与函式

无。

3.18. MI_ISP_IQ_YUVGAMMA结构体¶

3.18.1. 类型结构体 (Type Structure)¶

说明

设定YUV Gamma curve的类型结构体。

定义

typedef struct MI_ISP_IQ_YUVGAMMA_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    YUVGAMMA_AUTO_ATTR_t  stAuto;

    YUVGAMMA_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_YUVGAMMA_TYPE_t;

名称

变数名称	描述
bEnable	设定YUV Gamma curve功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定YUV Gamma curve的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定YUV Gamma curve的自动模式属性结构体。
stManual	设定YUV Gamma curve的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetYUVGamma(MI_U32 Channel, MI_ISP_IQ_YUVGAMMA_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetYUVGamma(MI_U32 Channel, MI_ISP_IQ_YUVGAMMA_TYPE_t *data);

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

说明

设定YUV Gamma curve的自动模式属性结构体。

定义

typedef struct YUVGAMMA_AUTO_ATTR_s

{

    YUVGAMMA_PAMAR_t stParaAPI[MI_ISP_AUTO_NUM];

} YUVGAMMA_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定YUV Gamma curve的手动模式属性结构体。

定义

typedef struct YUVGAMMA_MANUAL_ATTR_s

{

    YUVGAMMA_PAMAR_t  stParaAPI;

} YUVGAMMA_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

参数结构体 (Parameter Structure)¶

说明

设定YUV Gamma curve的参数结构体。

定义

typedef struct YUVGAMMA_PAMAR_s

{

    MI_U16 u16LutY[256];

    MI_U16 u16LutU[128];

    MI_U16 u16LutV[128];

} YUVGAMMA_PAMAR_t;

名称

变数名称描述

u16LutY[256] Y通道分量。值域范围：0 ~ 1023。

u16LutU[128] U通道分量。值域范围：0 ~ 511。

u16LutV[128] V通道分量。值域范围：0 ~ 511。

3.19. MI_ISP_IQ_SATURATION结构体¶

3.19.1. 类型结构体 (Type Structure)¶

说明

设定饱和度的类型结构体。

定义

typedef struct MI_ISP_IQ_SATURATION_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    SATURATION_AUTO_ATTR_t  stAuto;

    SATURATION_MANUAL_ATTR_t  stManual;

} MI_ISP_IQ_SATURATION_TYPE_t;

名称

变数名称	描述
bEnable	设定饱和度功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定饱和度的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定饱和度的自动模式属性结构体。
stManual	设定饱和度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetSaturation(MI_U32 Channel, MI_ISP_IQ_SATURATION_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetSaturation(MI_U32 Channel, MI_ISP_IQ_SATURATION_TYPE_t *data);

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

说明

设定饱和度的自动模式属性结构体。
定义

typedef struct SATURATION_AUTO_ATTR_s

{
```
SATURATION_PARAM_t  stParaAPI[MI_ISP_AUTO_NUM];
```
} SATURATION_AUTO_ATTR_t;
名称

变数名称描述

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

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

说明

设定饱和度的手动模式属性结构体。

定义

typedef struct SATURATION_MANUAL_ATTR_s

{

    SATURATION_PARAM_t  stParaAPI;

} SATURATION_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.19.4. 参数结构体 (Parameter Structure)¶

说明

设定饱和度的参数结构体。

定义

typedef struct SATURATION_PARAM_s

{

    MI_U8 u8SatAllStr;

    MI_U8 u8SatByYSFTAdv[5];

    MI_U8 u8SatByYLUTAdv[6];

    MI_U8 u8SatBySSFTAdv[5];

    MI_U8 u8SatBySLUTAdv[6];

    MI_U8 u8SatCoring;

} SATURATION_PARAM_t;

名称

变数名称	描述
u8SatAllStr	整体饱和度的强度数值。值域范围：0 ~ 127 (32等于1倍)。
u8SatByYSFTAdv[5]	调整亮度区间的强度数值。值域范围：0 ~ 8。
u8SatByYLUTAdv[6]	基于亮度区间调整饱和度的数值。值域范围：0 ~ 128。
u8SatBySSFTAdv[5]	调整彩度区间的强度数值。值域范围：0 ~ 8。
u8SatBySLUTAdv[6]	基于彩度区间调整饱和度的数值。值域范围：0 ~ 128。
u8SatCoring	彩度全部减一个值降低彩度。值域范围：0 ~ 255。

3.20. MI_ISP_IQ_RGBMATRIX结构体¶

3.20.1. 类型结构体 (Type Structure)¶

说明

设定色彩校正矩阵的类型结构体。

定义

typedef struct MI_ISP_IQ_RGBMATRIX_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    RGBMATRIX_AUTO_ATTR_t stAuto;

    RGBMATRIX_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_RGBMATRIX_TYPE_t;

名称

变数名称	描述
bEnable	设定色彩校正矩阵功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定色彩校正矩阵的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定色彩校正矩阵的自动模式属性结构体。
stManual	设定色彩校正矩阵的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetRGBMatrix(MI_U32 Channel, MI_ISP_IQ_RGBMATRIX_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetRGBMatrix(MI_U32 Channel, MI_ISP_IQ_RGBMATRIX_TYPE_t *data);

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

说明

设定色彩校正矩阵的自动模式属性结构体。

定义

typedef struct RGBMATRIX_AUTO_ATTR_s

{

    MI_ISP_BOOL_e bISOActEn;

    RGBMATRIX_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} RGBMATRIX_AUTO_ATTR_t;

名称

变数名称	描述
bISOActEn	设定ISO功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
stParaAPI[MI_ISP_AUTO_NUM]	自动模式属性结构体，MI_ISP_AUTO_NUM = 16。该数列组的16个值分别对应在不同增益情况下的设定值。

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

说明

设定色彩校正矩阵的手动模式属性结构体。

定义

typedef struct RGBMATRIX_MANUAL_ATTR_s

{

    MI_U16 u16CCM[12];

    MI_U8 u8CCMSat;

} RGBMATRIX_MANUAL_ATTR_t;

名称

变数名称	描述
u16CCM[12]	色彩校正矩阵参数值。值域范围：0 ~ 8191。 u16CCM[3] = mod(u16CCM[0]+u16CCM[1]+u16CCM[2], 1024)。 u16CCM[7] = mod(u16CCM[4]+u16CCM[5]+u16CCM[6], 1024)。 u16CCM[11] = mod(u16CCM[8]+u16CCM[9]+u16CCM[10], 1024)。
u8CCMSat	透过色彩校正矩阵调整饱和度的数值强度。值域范围：0 ~ 100。

注意事项

u8CCMSat = 0表示为色彩校正的单位矩阵数值。

u8CCMSat = 100表示为色彩校正的矩阵数值。
相关结构类型与函式

无。

3.20.4. 参数结构体 (Parameter Structure)¶

说明

设定色彩校正矩阵的参数结构体。

定义

typedef struct RGBMATRIX_PARAM_s

{

    MI_U16 u16CCTthr;

    MI_U16 u16CCM[12];

    MI_U8 u8CCMSat;

} RGBMATRIX_PARAM_t;

名称

变数名称	描述
u16CCTthr	该组CCM的代表色温。值域范围：0 ~ 10000。
u16CCM[12]	色彩校正矩阵参数值。值域范围：0 ~ 8191。 u16CCM[3] = mod(u16CCM[0]+u16CCM[1]+u16CCM[2], 1024)。 u16CCM[7] = mod(u16CCM[4]+u16CCM[5]+u16CCM[6], 1024)。 u16CCM[11] = mod(u16CCM[8]+u16CCM[9]+u16CCM[10], 1024)。
u8CCMSat	透过色彩校正矩阵调整饱和度的数值强度。值域范围：0 ~ 100。

注意事项

u8CCMSat = 0表示为色彩校正的单位矩阵数值。

u8CCMSat = 100表示为色彩校正的矩阵数值。
相关结构类型与函式

无。

3.21. MI_ISP_IQ_CCM_INFO结构体¶

3.21.1. 类型结构体 (Type Structure)¶

说明

取得当前色温的色彩校正矩阵的类型结构体。

定义

typedef struct MI_ISP_IQ_ CCM_INFO_TYPE_s

{

    MI_U16 u16CCM[12]; //0 ~ 8191(1024 = 1X)

    MI_U16 u16CCT;

} MI_ISP_IQ_CCM_INFO_TYPE_t;

名称

变数名称	描述
u16CCM[12]	色彩校正矩阵包含CCM coefficient总和资讯的参数值。值域范围：0 ~ 8191。 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 Channel, MI_ISP_IQ_CCM_INFO_TYPE_t *data);

3.22. MI_ISP_IQ_FALSECOLOR结构体¶

3.22.1. 类型结构体 (Type Structure)¶

说明

设定去伪彩的类型结构体。

定义

typedef struct MI_ISP_IQ_FALSECOLOR_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    FALSECOLOR_AUTO_ATTR_t  stAuto;

    FALSECOLOR_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_FALSECOLOR_TYPE_t;

名称

变数名称	描述
bEnable	设定去伪彩功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定去伪彩的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定去伪彩的自动模式属性结构体。
stManual	设定去伪彩的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetFalseColor(MI_U32 Channel, MI_ISP_IQ_FALSECOLOR_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetFalseColor(MI_U32 Channel, MI_ISP_IQ_FALSECOLOR_TYPE_t *data);

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

说明

设定去伪彩的自动模式属性结构体。

定义

typedef struct FALSECOLOR_AUTO_ATTR_s

{

    FALSECOLOR_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} FALSECOLOR_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定去伪彩的手动模式属性结构体。

定义

typedef struct FALSECOLOR_MANUAL_ATTR_s

{

    FALSECOLOR_PARAM_t  stParaAPI;

} FALSECOLOR_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

参数结构体 (Parameter Structure)¶

说明

设定去伪彩的参数结构体。

定义

typedef struct FALSECOLOR_PARAM_s

{

    MI_U8 u8FreqThrd;

    MI_U8 u8EdgeScoreThrd;

    MI_U8 u8ChromaThrdOfStrengthMax;

    MI_U8 u8ChromaThrdOfStrengthMid;

    MI_U8 u8ChromaThrdOfStrengthMin;

    MI_U8 u8StrengthMid;

    MI_U8 u8StrengthMin;

} FALSECOLOR_PARAM_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。

图 3-2：Chroma强度的阀值限制条件示意图

相关结构类型与函式

无。

3.23. MI_ISP_IQ_NR3D结构体¶

3.23.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_IQ_NR3D_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    NR3D_AUTO_ATTR_t stAuto;

    NR3D_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_NR3D_TYPE_t;

名称

变数名称	描述
bEnable	设定3D降噪功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定3D降噪的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定3D降噪的自动模式属性结构体。
stManual	设定3D降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNR3D(MI_U32 Channel, MI_ISP_IQ_NR3D_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetNR3D(MI_U32 Channel, MI_ISP_IQ_NR3D_TYPE_t *data);

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

说明

设定3D降噪的自动模式属性结构体。

定义

typedef struct NR3D_AUTO_ATTR_s

{

    NR3D_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} NR3D_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定3D降噪的手动模式属性结构体。

定义

typedef struct NR3D_MANUAL_ATTR_s

{

    NR3D_PARAM_t stParaAPI;

} NR3D_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.23.4. 参数结构体 (Parameter Structure)¶

说明

设定3D降噪的参数结构体。

定义

typedef struct NR3D_PARAM_s

{

    MI_U8 u8MdThd;

    MI_U16 u16MdGain;

    MI_U8 u8TfStr;

    MI_U8 u8TfStrEx;

    MI_U8 u8MdThdByY[16];

    MI_U8 u8MdGainByY[16];

    MI_U8 u8M2SLut[16];

    MI_U16 u16TfLut[16];

    MI_U8 u8YSfBlendLut[16];

    MI_U8 u8YSfBlendOffset;

} NR3D_PARAM_t;

名称

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

3.24. MI_ISP_IQ_NRDESPIKE结构体¶

3.24.1. 类型结构体 (Type Structure)¶

说明

设定DeSpike降噪的类型结构体。

定义

typedef struct MI_ISP_IQ_NRDESPIKE_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    NRDESPIKE_AUTO_ATTR_t stAuto;

    NRDESPIKE_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_NRDESPIKE_TYPE_t;

名称

变数名称	描述
bEnable	设定DeSpike降噪功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定DeSpike降噪的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定DeSpike降噪的自动模式属性结构体。
stManual	设定DeSpike降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNRDeSpike(MI_U32 Channel, MI_ISP_IQ_NRDESPIKE_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetNRDeSpike(MI_U32 Channel, MI_ISP_IQ_NRDESPIKE_TYPE_t *data);

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

说明

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

定义

typedef struct NRDESPIKE_AUTO_ATTR_s

{

    NRDESPIKE_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} NRDESPIKE_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

定义

typedef struct NRDESPIKE_MANUAL_ATTR_s

{

    NRDESPIKE_PARAM_t stParaAPI;

} NRDESPIKE_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.24.4. 参数结构体 (Parameter Structure)¶

说明

设定DeSpike降噪的参数结构体。

定义

typedef struct NRDESPIKE_PARAM_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[5];

    MI_U8 u8StrengthByY[16];

} NRDESPIKE_PARAM_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[5]	根据亮度选用median/mean的混合比例，值越大越偏向median设定，值越小越偏向mean设定。值域范围：0 ~ 2047。
u8StrengthByY[16]	根据亮度给予不同强度，64为不调整，越大越强。值域范围：0 ~ 127。

注意事项

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

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

无。

3.25. MI_ISP_IQ_NRLUMA结构体¶

3.25.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_IQ_NRLUMA \_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    NRLUMA_AUTO_ATTR_t stAuto;

    NRLUMA_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_NRLUMA_TYPE_t;

名称

变数名称	描述
bEnable	设定Luma降噪功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定Luma降噪的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定Luma降噪的自动模式属性结构体。
stManual	设定Luma降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNRLuma(MI_U32 Channel, MI_ISP_IQ_NRLUMA_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetNRLuma(MI_U32 Channel, MI_ISP_IQ_NRLUMA_TYPE_t *data);

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

说明

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

定义

typedef struct NRLUMA_AUTO_ATTR_s

{

    NRLUMA_PARAM_t  stParaAPI[MI_ISP_AUTO_NUM];

} NRLUMA_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

typedef struct NRLUMA_MANUAL_ATTR_s

{
```
NRLUMA_PARAM_t stParaAPI;
```
} NRLUMA_MANUAL_ATTR_t;
名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.25.4. 参数结构体 (Parameter Structure)¶

说明

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

定义

typedef struct NRLUMA_PARAM_s

{

MI_U8 u8Strength;

MI_U8 u8GMaskSel;

MI_U16 u16SpfBlendLut[2];

} NRLUMA_PARAM_t;

名称

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

3.26. MI_ISP_IQ_NRChroma结构体¶

3.26.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_IQ_NRChroma_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    NRChroma_AUTO_ATTR_t stAuto;

    NRChroma_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_NRChroma_TYPE_t;

名称

变数名称	描述
bEnable	设定颜色降噪功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定颜色降噪的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定颜色降噪的自动模式属性结构体。
stManual	设定颜色降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNRChroma(MI_U32 Channel, MI_ISP_IQ_NRChroma_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetNRChroma(MI_U32 Channel, MI_ISP_IQ_NRChroma_TYPE_t *data);

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

说明

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

定义

typedef struct NRChroma_AUTO_ATTR_s

{

    NRChroma_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} NRChroma_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

定义

typedef struct NRChroma_MANUAL_ATTR_s

{

    NRChroma_PARAM_t  stParaAPI;

} NRChroma_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.26.4. 参数结构体 (Parameter Structure)¶

说明

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

定义

typedef struct NRChroma_PARAM_s

{

    MI_U8 u8MatchRatio;

    MI_U16 u16UvTh;

    MI_U16 u16StrengthByCEdge[6];

} NRChroma_PARAM_t;

名称

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

3.27. MI_ISP_IQ_SHARPNESS结构体¶

3.27.1. 类型结构体 (Type Structure)¶

说明

设定锐度的类型结构体。

定义

typedef struct MI_ISP_IQ_SHARPNESS_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    SHARPNESS_AUTO_ATTR_t  stAuto;

    SHARPNESS_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_SHARPNESS_TYPE_t;

名称

变数名称	描述
bEnable	设定锐度功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定锐度的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定锐度的自动模式属性结构体。
stManual	设定锐度的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetSharpness(MI_U32 Channel, MI_ISP_IQ_SHARPNESS_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetSharpness(MI_U32 Channel, MI_ISP_IQ_SHARPNESS_TYPE_t *data);

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

说明

设定锐度的自动模式属性结构体。

定义

typedef struct SHARPNESS_AUTO_ATTR_s

{

    SHARPNESS_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} SHARPNESS_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定锐度的手动模式属性结构体。

定义

typedef struct SHARPNESS_MANUAL_ATTR_s

{

    SHARPNESS_PARAM_t stParaAPI;

} SHARPNESS_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.27.4. 参数结构体 (Parameter Structure)¶

说明

设定锐度的参数结构体。

定义

typedef struct SHARPNESS_PARAM_s

{

    MI_U8 u8OverShootGain;

    MI_U8 u8UnderShootGain;

    MI_U8 u8CorLUT[6];

    MI_U8 u8SclLUT[6];

    MI_U16 u16EdgeKillLUT[6];

    MI_U8 u8CornerReduce;

    MI_U8 u8DirTh;

    MI_U16 u16SharpnessUD[2];

    MI_U16 u16SharpnessD[2];

    MI_U8 u8PreCorUD[2];

    MI_U8 u8PreCorD[2];

    MI_U8 u8PreCorMotGain;

    MI_U8 u8LpfEdgeGainUD;

    MI_U8 u8LpfEdgeGainD;

    MI_U8 u8WeakDetailEnhance;

    MI_U16 u16DetailTh;

    MI_U8 u8DetailMotOffset;

    MI_U8 u8DetailByY[6];

    MI_U16 u16OverShootLimit;

    MI_U16 u16UnderShootLimit;

    MI_U8 u8MotGain[16];

} SHARPNESS_PARAM_t;

名称

变数名称	描述
u8OverShootGain	调整edge overshoot的强度程度，值越大锐化越强。值域范围：0 ~ 255。
u8UnderShootGain	调整edge undershoot的强度程度，值越大锐化越强。值域范围：0 ~ 255。
u8CorLUT[6]	抑制高亮度平坦区。值域范围：0 ~ 255。
u8SclLUT[6]	根据亮度调整edge输出。值域范围：0 ~ 255。
u16EdgeKillLUT[6]	设定edge的强度输出。值域范围：0 ~ 1023。
u8CornerReduce	调整周围edge的锐化程度。值域范围：0 ~ 32。
u8DirTh	方向性判断的阀值，大于此阀值，使用有方向性滤波器强化边缘，好处是edge较连续，坏处是小细节的edge被强化，图像不自然。值域范围：0 ~ 255。
u16SharpnessUD[2]	增强无方向性的细节纹理，可用于提高发丝、草地…等细小纹理清晰度，SharpnessUD[0]可针对高频做处理，SharpnessUD[1]可针对低频做处理，值越大，Edge越强。值域范围：0 ~ 1023。
u16SharpnessD[2]	根据边缘方向强化锐化度，整体增强图像边缘，但调的太强会导致锯齿状，SharpnessD[0]可针对高频做处理，SharpnessD[1]可针对低频做处理，值越大，Edge越强。值域范围：0 ~ 1023。
u8PreCorUD[2]	针对无方向性，做coring处理，SharpnessUD[0]针对高频，SharpnessUD[1]针对低频，值越大，Edge越弱。值域范围：0 ~ 63。
u8PreCorD[2]	针对方向性，做coring处理，SharpnessUD[0]针对高频，SharpnessUD[1]针对低频，值越大，Edge越弱。值域范围：0 ~ 63。
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	根据亮度调整SharpnessUD。值域范围：0 ~ 255。
u16OverShootLimit	参考周围最亮点做调整，设0则edge上限为周围最亮点的Y值。值域范围：0 ~ 1023。
u16UndreShootLimit	参考周围最暗点做调整，设0则edge下限为周围最暗点的Y值，也就是不会undershoot。值域范围：0 ~ 1023。
u8MotGain[16]	根据移动程度，调整最终Edge，横轴代表移动程度，越左边代表越移动，值为128，代表不做调整，值越大，Edge越强。值域范围：0 ~ 255。

3.28. MI_ISP_IQ_CROSSTALK结构体¶

3.28.1. 类型结构体 (Type Structure)¶

说明

设定串扰的类型结构体。

定义

typedef struct MI_ISP_IQ_CROSSTALK_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    CROSSTALK_AUTO_ATTR_t stAuto;

    CROSSTALK_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_CROSSTALK_TYPE_t;

名称

变数名称	描述
bEnable	设定串扰功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定串扰的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定串扰的自动模式属性结构体。
stManual	设定串扰的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetCrossTalk(MI_U32 Channel, MI_ISP_IQ_CROSSTALK_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetCrossTalk(MI_U32 Channel, MI_ISP_IQ_CROSSTALK_TYPE_t *data);

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

说明

设定串扰的自动模式属性结构体。

定义

typedef struct CROSSTALK_AUTO_ATTR_s

{

    CROSSTALK_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} CROSSTALK_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定串扰的手动模式属性结构体。

定义

typedef struct CROSSTALK_MANUAL_ATTR_s

{

    CROSSTALK_PARAM_t  stParaAPI;

} CROSSTALK_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.28.4. 参数结构体 (Parameter Structure)¶

说明

设定串扰的参数结构体。

定义

typedef struct CROSSTALK_PARAM_s

{

    MI_U8 u8Strength;

    MI_U8 u8StrengthByY[15];

    MI_U8 u8Threshold;

    MI_U16 u16ThresholdOffset;

} CROSSTALK_PARAM_t;

名称

变数名称	描述
u8Strength	串扰的可变强度数值。值域范围：0 ~ 31。
u8StrengthByY[15]	依据亮度调整串扰强度数值。值域范围：0 ~ 127。
u8Threshold	串扰的阀值比例数值。值域范围：0 ~ 255。
u16ThresholdOffset	串扰的阀值平移数值。值域范围：0 ~ 4095。

注意事项

此功能开强会造成细节损失，因此如果没有串扰问题则不需要开启。
相关结构类型与函式

无。

3.29. MI_ISP_IQ_OBC结构体¶

3.29.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_IQ_OBC_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    OBC_AUTO_ATTR_t stAuto;

    OBC_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_OBC_TYPE_t;

名称

变数名称	描述
bEnable	设定黑电平功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定黑电平的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定黑电平的自动模式属性结构体。
stManual	设定黑电平的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetOBC(MI_U32 Channel, MI_ISP_IQ_OBC_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetOBC(MI_U32 Channel, MI_ISP_IQ_OBC_TYPE_t *data);

MI_S32 MI_ISP_IQ_SetOBC_P1(MI_U32 Channel, MI_ISP_IQ_OBC_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetOBC_P1(MI_U32 Channel, MI_ISP_IQ_OBC_TYPE_t *data);

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

说明

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

定义

typedef struct OBC_AUTO_ATTR_s

{

    OBC_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} OBC_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

定义

typedef struct OBC_MANUAL_ATTR_s

{

    OBC_PARAM_t stParaAPI;

} OBC_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.29.4. 参数结构体 (Parameter Structure)¶

说明

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

定义

typedef struct OBC_PARAM_s

{

    MI_U16 u16ValR;

    MI_U16 u16ValGr;

    MI_U16 u16ValGb;

    MI_U16 u16ValB;

} OBC_PARAM_t;

名称

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

3.30. MI_ISP_IQ_WDR结构体¶

3.30.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_IQ_WDR_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    WDR_AUTO_ATTR_t stAuto;

    WDR_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_WDR_TYPE_t;

名称

变数名称	描述
bEnable	设定宽动态功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定宽动态的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定宽动态的自动模式属性结构体。
stManual	设定宽动态的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetWDR(MI_U32 Channel, MI_ISP_IQ_WDR_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetWDR(MI_U32 Channel, MI_ISP_IQ_WDR_TYPE_t *data);

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

说明

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

定义

typedef struct WDR_AUTO_ATTR_s

{

    WDR_PARAM_t  stParaAPI[MI_ISP_AUTO_NUM];

} WDR_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

定义

typedef struct WDR_MANUAL_ATTR_s

{

    WDR_PARAM_t  stParaAPI;

} WDR_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.30.4. 参数结构体 (Parameter Structure)¶

说明

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

定义

typedef struct WDR_PARAM_s

{

    MI_U8 u8BoxNum;

    MI_ISP_BOOL_e bAutoDetailEnhance;

    MI_U8 u8ManualDetailEnhance;

    MI_U8 u8GlobalDarkToneEnhance;

    MI_U8 u8WDRStrByY[33];

    MI_U8 u8Strength;

    MI_U8 u8DarkLimit;

    MI_U8 u8BrightLimit;

    MI_ISP_BOOL_e bGammaSyncEn;

} WDR_PARAM_t;

名称

变数名称	描述
u8BoxNum	区域宽动态作用范围的大小。值域范围：0 ~ 4。
bAutoDetailEnhance	额外的细节加强。值域范围：0 ~ 1。
u8ManualDetailEnhance	bAutoDetailEnhance = 1时，可控制亮暗处细节的强度，值域范围：0 ~ 255。
u8GlobalDarkToneEnhance	全域宽动态的强度。值域范围：0 ~ 15。
u8WDRStrByY[33]	根据亮度控制宽动态强度。值域范围：0 ~ 255。
u8Strength	区域宽动态的强度。值域范围：0 ~ 255。
u8DarkLimit	限制暗区的强度。值域范围：0 ~ 255。
u8BrightLimit	限制亮区的强度。值域范围：0 ~ 255。
bGammaSyncEn	WDR和Gamma连动开关。值域范围：0 ~ 1。

3.31. MI_ISP_IQ_DYNAMIC_DP结构体¶

3.31.1. 类型结构体 (Type Structure)¶

说明

设定动态补偿坏点的类型结构体。

定义

typedef struct MI_ISP_IQ_DYNAMIC_DP_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    DYNAMIC_DP_AUTO_ATTR_t stAuto;

    DYNAMIC_DP_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_DYNAMIC_DP_TYPE_t;

名称

变数名称	描述
bEnable	设定动态补偿坏点功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定动态补偿坏点的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定动态补偿坏点的自动模式属性结构体。
stManual	设定动态补偿坏点的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDynamicDP(MI_U32 Channel, MI_ISP_IQ_DYNAMIC_DP_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetDynamicDP(MI_U32 Channel, MI_ISP_IQ_DYNAMIC_DP_TYPE_t *data);

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

说明

设定动态补偿坏点的自动模式属性结构体。

定义

typedef struct DYNAMIC_DP_AUTO_ATTR_s

{

    DYNAMIC_DP_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} DYNAMIC_DP_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定动态补偿坏点的手动模式属性结构体。

定义

typedef struct DYNAMIC_DP_MANUAL_ATTR_s

{

    DYNAMIC_DP_PARAM_t stParaAPI;

} DYNAMIC_DP_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.31.4. 参数结构体 (Parameter Structure)¶

说明

设定动态补偿坏点的参数结构体。

定义

typedef struct DYNAMIC_DP_PARAM_s

{

    MI_ISP_BOOL_e bHotPixEn;

    MI_U16 u16HotPixCompSlpoe;

    MI_ISP_BOOL_e bDarkPixEn;

    MI_U16 u16DarkPixCompSlpoe;

    MI_U16 u16DPCTH;

    MI_ISP_BOOL_e bBlendEn;

    MI_U16 u16DiffLut[6];

    MI_U16 u16YLut[6];

} DYNAMIC_DP_PARAM_t;

名称

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

3.32. MI_ISP_IQ_DYNAMIC_DP_CLUSTER结构体¶

3.32.1. 类型结构体 (Type Structure)¶

说明

设定动态补偿坏点的类型结构体。

定义

typedef struct MI_ISP_IQ_DYNAMIC_DP_CLUSTER_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    DYNAMIC_DP_CLUSTER_AUTO_ATTR_t stAuto;

    DYNAMIC_DP_CLUSTER_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_DYNAMIC_DP_CLUSTER _TYPE_t;

名称

变数名称	描述
bEnable	设定动态补偿坏点功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定动态补偿坏点的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定动态补偿坏点的自动模式属性结构体。
stManual	设定动态补偿坏点的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDynamicDP_CLUSTER(MI_U32 Channel, MI_ISP_IQ_DYNAMIC_DP_CLUSTER TYPE_t *data);

MI_S32 MI_ISP_IQ_GetDynamicDP_CLUSTER (MI_U32 Channel, MI_ISP_IQ_DYNAMIC_DP_CLUSTER_TYPE_t *data);

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

说明

设定动态补偿坏点的自动模式属性结构体。

定义

typedef struct DYNAMIC_DP_CLUSTER_AUTO_ATTR_s

{

    DYNAMIC_DP_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} DYNAMIC_DP_CLUSTER_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定动态补偿坏点的手动模式属性结构体。

定义

typedef struct DYNAMIC_DP_CLUSTER_MANUAL_ATTR_s

{

    DYNAMIC_DP_PARAM_t  stParaAPI;

} DYNAMIC_DP_CLUSTER_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

参数结构体 (Parameter Structure)¶

说明

设定动态补偿坏点的参数结构体。

定义

typedef struct DYNAMIC_DP_CLUSTER_PARAM_s

{

    MI_ISP_BOOL_e bEdgeMode;

    MI_U16 u16NeiDeltaTh;

    MI_U8 u8NeiSmooth;

    MI_ISP_BOOL_e bSortEn;

    MI_ISP_BOOL_e bSortRGGBEn[4];

    MI_ISP_BOOL_e bSort1x3ModeEn;

    MI_U16 u16SortLumTblL[6];

    MI_U16 u16SortLumTblD[6];

    MI_U16 u16SortLumTblS[6];

} DYNAMIC_DP_CLUSTER_PARAM_t;

名称

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

3.33. MI_ISP_IQ_HSV结构体¶

3.33.1. 类型结构体 (Type Structure)¶

说明

设定HSV的类型结构体。

定义

typedef struct MI_ISP_IQ_HSV_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    HSV_AUTO_ATTR_t stAuto;

    HSV_MANUAL_ATTR_t  stManual;

} MI_ISP_IQ_HSV_TYPE_t;

名称

变数名称	描述
bEnable	设定HSV功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定HSV的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定HSV的自动模式属性结构体。
stManual	设定HSV的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetHSV(MI_U32 Channel, MI_ISP_IQ_HSV_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetHSV(MI_U32 Channel, MI_ISP_IQ_HSV_TYPE_t *data);

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

说明

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

定义

typedef struct HSV_AUTO_ATTR_s

{

    HSV_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} HSV_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

定义

typedef struct HSV_MANUAL_ATTR_s

{

    HSV_PARAM_t stParaAPI;

} HSV_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.33.4. 参数结构体 (Parameter Structure)¶

说明

设定HSV的参数结构体。

定义

typedef struct HSV_PARAM_s

{

    MI_S16 s16HueLut[24];

    MI_U16 u16SatLut[24];

    MI_S16 s16HueLut_ForUnitCCM[24];

    MI_U16 u16SatLut_ForUnitCCM[24];

    MI_U8 u8GlobalSat;

} HSV_PARAM_t;

名称

变数名称	描述
s16HueLut[24]	将360度色相等分为24份，分别控制每个等分的色相旋转角度，自动模式下根据色温作切换。值域范围：-15 ~ 15
u16SatLut[24]	将360度色相等分为24份，分别控制每个等分的饱和度，自动模式下根据色温作切换。值域范围：0 ~ 255 (64 = 1x)
s16HueLut_ForUnitCCM[24]	将360度色相等分为24份，分别控制每个等分的色相旋转角度与Unit CCM搭配参数，自动模式下根据色温作切换。值域范围：-15~15
u16SatLut_ForUnitCCM[24]	将360度色相等分为24份，分别控制每个等分的饱和度与Unit CCM搭配参数，自动模式下根据色温作切换。值域范围：0~255 (64 = 1x)
u8GlobalSat	整体饱和度控制，自动模式下根据增益作切换。值域范围：0 ~ 255 (64 = 1x)

3.34. MI_ISP_IQ_RGBIR结构体¶

3.34.1. 类型结构体 (Type Structure)¶

说明

设定RGBIR的类型结构体。

定义

typedef struct MI_ISP_IQ_RGBIR_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    RGBIR_AUTO_ATTR_t stAuto;

    RGBIR_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_RGBIR_TYPE_t;

名称

变数名称	描述
bEnable	设定RGBIR功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定RGBIR的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定RGBIR的自动模式属性结构体。
stManual	设定RGBIR的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetRGBIR(MI_U32 Channel, MI_ISP_IQ_RGBIR_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetRGBIR(MI_U32 Channel, MI_ISP_IQ_RGBIR_TYPE_t *data);

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

说明

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

定义

typedef struct RGBIR_AUTO_ATTR_s

{

    RGBIR_PARAM_t  stParaAPI[MI_ISP_AUTO_NUM];

} RGBIR_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

定义

typedef struct RGBIR_MANUAL_ATTR_s

{

    RGBIR_PARAM_t  stParaAPI;

} RGBIR_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.34.4. 参数结构体 (Parameter Structure)¶

说明

设定RGBIR的参数结构体。

定义

typedef struct RGBIR_PARAM_s

{

    MI_U8 u8IrPosType;

    MI_ISP_BOOL_e bRemovelEn;

    MI_U16 u16Ratio_R[6];

    MI_U16 u16Ratio_G[6];

    MI_U16 u16Ratio_B[6];

} RGBIR_PARAM_t;

名称

变数名称	描述
u8IrPosType	RGBIR分布型态。值域范围：0 ~ 7，预设值：0。
bRemovelEn	设定减IR功能的布林值，预设值：1。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
u16Ratio_R[6]	红色减IR比例，由暗至亮区\@12bits
u16Ratio_G[6]	绿色减IR比例，由暗至亮区\@12bits
u16Ratio_B[6]	蓝色减IR比例，由暗至亮区\@12bits

3.35. MI_ISP_IQ_DEMOSAIC结构体¶

3.35.1. 类型结构体 (Type Structure)¶

说明

设定去马赛克的类型结构体。

定义

typedef struct MI_ISP_IQ_DEMOSAIC_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    DEMOSAIC_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_DEMOSAIC_TYPE_t;

名称

变数名称描述

bEnable 设定去马赛克功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

stManual 设定去马赛克的手动模式属性结构体。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDEMOSAIC(MI_U32 Channel, MI_ISP_IQ_DEMOSAIC_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetDEMOSAIC(MI_U32 Channel, MI_ISP_IQ_DEMOSAIC_TYPE_t *data);

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

说明

设定去马赛克的手动模式属性结构体。

定义

typedef struct DEMOSAIC_MANUAL_ATTR_s

{

    DEMOSAIC_PARAM_t  paraAPI;

} DEMOSAIC_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.35.3. 参数结构体 (Parameter Structure)¶

说明

设定去马赛克的参数结构体。

定义

typedef struct DEMOSAIC_PARAM_s

{

    MI_U8 u8DirThrd;

    MI_U8 u8EdgeSmoothThrdY;

    MI_U8 u8EdgeSmoothThrdC;

} DEMOSAIC_PARAM_t;

名称

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

3.36. MI_ISP_IQ_R2Y结构体¶

3.36.1. 类型结构体 (Type Structure)¶

说明

设定色彩转换的类型结构体。

定义

typedef struct MI_ISP_IQ_R2Y_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    R2Y_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_R2Y_TYPE_t;

名称

变数名称描述

bEnable 设定色彩转换功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

stManual 设定色彩转换的手动模式属性结构体。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetR2Y(MI_U32 Channel, MI_ISP_IQ_R2Y_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetR2Y(MI_U32 Channel, MI_ISP_IQ_R2Y_TYPE_t *data);

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

说明

设定色彩转换的手动模式属性结构体。

定义

typedef struct R2Y_MANUAL_ATTR_s

{

    R2Y_PARAM_t  stParaAPI;

} R2Y_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.36.3. 参数结构体 (Parameter Structure)¶

说明

设定色彩转换的参数结构体。

定义

typedef struct R2Y_PARAM_s

{

    MI_U16 u16Matrix[9];

    MI_U8 u8AddY16;

} R2Y_PARAM_t;

名称

变数名称	描述
u16Matrix[9]	调整RGB to YUV矩阵，值域范围：0 ~ 8191，1倍为1024，负数以2的补数表示，等同于±3.996。
u8AddY16	调整Y Offset，经过矩阵转换后，用来控制是否要对Y加16。

3.37. MI_ISP_IQ_COLORTRANS结构体¶

3.37.1. 类型结构体 (Type Structure)¶

说明

设定色彩转换的类型结构体。

定义

typedef struct MI_ISP_IQ_COLORTRANS_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    COLORTRANS_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_COLORTRANS_TYPE_t;

名称

变数名称描述

bEnable 设定色彩转换功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

stManual 设定色彩转换的手动模式属性结构体。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetCOLORTRANS(MI_U32 Channel, MI_ISP_IQ_COLORTRANS_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetCOLORTRANS(MI_U32 Channel, MI_ISP_IQ_COLORTRANS_TYPE_t *data);

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

说明

设定色彩转换的手动模式属性结构体。

定义

typedef struct COLORTRANS_MANUAL_ATTR_s

{

    COLORTRANS_PARAM_t stParaAPI;

} COLORTRANS_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.37.3. 参数结构体 (Parameter Structure)¶

说明

设定色彩转换的参数结构体。

定义

typedef struct COLORTRANS_PARAM_s

{

    MI_U16 u16Y_OFST;

    MI_U16 u16U_OFST;

    MI_U16 u16V_OFST;

    MI_U16 u16Matrix[9];

} COLORTRANS_PARAM_t;

名称

变数名称	描述
u16Y_OFST	调整Y偏差值。10bit domain，值域范围：0 ~ 2047，负数以2的补数表示，等同于±1023。
u16U_OFST	调整U偏差值。10bit domain，值域范围：0 ~ 2047，负数以2的补数表示，等同于±1023。
u16V_OFST	调整V偏差值。10bit domain，值域范围：0 ~ 2047，负数以2的补数表示，等同于±1023。
u16Matrix[9]	调整RGBYUV矩阵，值域范围：0 ~ 1023，1倍为256，负数以2的补数表示，等同于±1.996。

注意事项

对于YUV_OFST，Matrix[9]，负数以2的补数表示。

UV偏差值，在矩阵相乘后，已经预设加上128。

下面例子为，将YUV转为16~235的值域范围

$Y = \left( 0.257*R \right) + \left( 0.504*G \right) + \left( 0.098*B \right) + 16$

$Cb = - \left( 0.148*R \right) - \left( 0.291*G \right) + \left( 0.439*B \right) + 128$

$\text{Cr} = \left( 0.439*R \right) - \left( 0.368*G \right) - \left( 0.071*B \right) + 128$

Matrix[9] = {66, 129, 25, 986, 950, 112, 112, 930, 1006}

Y_OFST = 64

U_OFST = 0 (预设以加上128*4，所以填0)

V_OFST = 0 (预设以加上128*4，所以填0)
相关结构类型与函式

无。

3.38. MI_ISP_IQ_HDR结构体¶

3.38.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_IQ_HDR_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    HDR_AUTO_ATTR_t  stAuto;

    HDR_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_HDR_TYPE_t;

名称

变数名称	描述
bEnable	设定高动态范围功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定高动态范围的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定高动态范围的自动模式属性结构体。
stManual	设定高动态范围的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetHDR(MI_U32 Channel, MI_ISP_IQ_HDR_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetHDR(MI_U32 Channel, MI_ISP_IQ_HDR_TYPE_t *data);

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

说明

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

typedef struct HDR_AUTO_ATTR_s

{

HDR_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} HDR_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

typedef struct HDR_MANUAL_ATTR_s

{

HDR_PARAM_t stParaAPI;

} HDR_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

参数结构体 (Parameter Structure)¶

说明

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

typedef struct HDR_PARAM_s

{

[MI_ISP_BOOL_e bNrEn;

MI_U16 u16YwtTh1;

MI_U16 u16YwtTh2;

MI_U16 u16NoiseLevel[16];

MI_U16 u16MotionTh;

MI_U16 u16MotionAdjLut[7];

} HDR_PARAM_t;

名称

变数名称	描述
bNrEn	控制短曝NR开关。值域范围：0 ~ 1。
u16YwtTh1	长曝曝光的最低亮度门阀。值域范围：0 ~ 1023。
u16YwtTh2	长曝曝光的最高亮度门阀。值域范围：0 ~ 1023。
u16NoiseLevel[16]	杂讯程度，横轴为亮度。值域范围：0 ~ 1023。
u16MotionTh	运动门阀，超过此值会被判断成运动，依据运动程度融合，低于此值会被判断为静止，依据亮度融合。值域范围：0 ~ 256。
u16MotionAdjLut[7]	动运区采用长曝的比例，横轴为运动程度，越右边越动。值域范围：0 ~ 256。

3.39. MI_ISP_IQ_LSC结构体¶

3.39.1. 类型结构体 (Type Structure)¶

说明

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

typedef struct MI_ISP_IQ_LSC_TYPE_s

{

[MI_ISP_BOOL_e bEnable;

MI_U16 u16CenterX;

MI_U16 u16CenterY;

MI_U8 u8Shift;

MI_U16 u16RGainTable[32*3];

MI_U16 u16GGainTable[32*3];

MI_U16 u16BGainTable[32*3];

} MI_ISP_IQ_LSC_TYPE_t;

名称

变数名称	描述
bEnable	设定LSC功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
u16CenterX	设定X方向补偿中心点。值域范围：0 ~ 4095。
u16CenterY	设定Y方向补偿中心点。值域范围：0 ~ 4095。
u8Shift	根据解析度设定，不建议修改。值域范围：0 ~ 31。
u16RGainTable[32*3]	红色通道的LSC补正table。值域范围：0 ~ 1023。
u16GGainTable[32*3]	绿色通道的LSC补正table。值域范围：0 ~ 1023。
u16BGainTable[32*3]	蓝色通道的LSC补正table。值域范围：0 ~ 1023。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetLSC(MI_U32 Channel, MI_ISP_IQ_LSC_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetLSC(MI_U32 Channel, MI_ISP_IQ_LSC_TYPE_t *data);

3.40. MI_ISP_IQ_LSC_CTRL结构体¶

3.40.1. 类型结构体 (Type Structure)¶

说明

设定LSC CTRL的类型结构体。
定义

typedef struct MI_ISP_IQ_LSC_CTRL_TYPE_s

{

[MI_ISP_BOOL_e bEnable;

MI_U8 u8RRatioByCct[3];

MI_U8 u8GRatioByCct[3];

MI_U8 u8BRatioByCct[3];

INTP_LUT_IQ RatioByBv;

} MI_ISP_IQ_LSC_TYPE_t;

typedef struct

{

MI_U16 u16NumOfPoints;

MI_S32 s32Y[16];

MI_S32 s32X[16];

} INTP_LUT_IQ;

名称

变数名称	描述
bEnable	设定LSC CTRL功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
u8RRatioByCct [3]	红色通道的LSC额外ratio。值域范围：0 ~ 128 (128 = 1x)。
u8GRatioByCct [3]	绿色通道的LSC额外ratio。值域范围：0 ~ 128 (128 = 1x)。
u8BRatioByCct [3]	蓝色通道的LSC额外ratio。值域范围：0 ~ 128 (128 = 1x)。
RatioByBv.u16NumOfPoints	RatioByBv节点个数。值域范围：0 ~ 16。
RatioByBv.s32Y	各节点Ratio。值域范围：0 ~ 128 (128 = 1x)。
RatioByBv.s32X	各节点BV。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetLSC_CTRL(MI_U32 Channel, MI_ISP_IQ_LSC_CTRL TYPE_t *data);

MI_S32 MI_ISP_IQ_GetLSC_CTRL (MI_U32 Channel, MI_ISP_IQ_LSC_CTRL_TYPE_t *data);

3.41. MI_ISP_IQ_ALSC结构体¶

3.41.1. 类型结构体 (Type Structure)¶

说明

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

typedef struct MI_ISP_IQ_ALSC_TYPE_s

{

[MI_ISP_BOOL_e bEnable;

MI_U8 u8GridX;

MI_U8 u8GridY;

MI_U16 u16CCTthr[3];

MI_U8 u8DeltaMode;

[MI_ISP_BOOL_e bDeltaModeAdvEn;

MI_U8 u8DeltaLutX[26];

MI_U8 u8DeltaLutY[26];

MI_U16 u16TableR[459*3];

MI_U16 u16TableG[459*3];

MI_U16 u16TableB[459*3];

} MI_ISP_IQ_ALSC_TYPE_t;

名称

变数名称	描述
bEnable	设定ALSC功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
u8GridX	X方向shading table方格总点数。值域范围：0 ~ 27。
u8GridY	Y方向shading table方格总点数。值域范围：0 ~ 17。
u16CCTthr[3]	色温节点。值域范围：0 ~ 20000。
u8DeltaMode	16组预设的shading table间距形式，0代表等距，值愈大，中心间距越大，周围越小。值域范围：0 ~ 15。
bDeltaModeAdvEn	手动控制每格间距开关，开了则u8DeltaMode失效。值域范围：0 ~ 1。
u8DeltaLutX[26]	X方向每格间距，只限填1,2,4,8,16。值域范围：0 ~ 16。
u8DeltaLutY[26]	Y方向每格间距，只限填1,2,4,8,16。值域范围：0 ~ 16。
u16TableR[459*3]	红色通道的ALSC补正table。值域范围：0 ~ 8191 (1024 = 1x)。
u16TableG[459*3]	绿色通道的ALSC补正table。值域范围：0 ~ 8191 (1024 = 1x)。
u16TableB[459*3]	蓝色通道的ALSC补正table。值域范围：0 ~ 8191 (1024 = 1x)。

注意事项
R、G、B Table数值不建议设低于1024，否则高亮部分会因为无法饱和而造成色偏问题。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetALSC(MI_U32 Channel, MI_ISP_IQ_ALSC_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetALSC(MI_U32 Channel, MI_ISP_IQ_ALSC_TYPE_t *data);

3.42. MI_ISP_IQ_ALSC_CTRL结构体¶

3.42.1. 类型结构体 (Type Structure)¶

说明

设定ALSC CTRL的类型结构体。
定义

typedef struct MI_ISP_IQ_ALSC_CTRL_TYPE_s

{

[MI_ISP_BOOL_e bEnable;

MI_U8 u8RRatioByCct[3];

MI_U8 u8GRatioByCct[3];

MI_U8 u8BRatioByCct[3];

INTP_LUT_IQ RatioByBv;

} MI_ISP_IQ_ALSC_TYPE_t;

typedef struct

{

MI_U16 u16NumOfPoints;

MI_S32 s32Y[16];

MI_S32 s32X[16];

} INTP_LUT_IQ;

名称

变数名称	描述
bEnable	设定LSC CTRL功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
u8RRatioByCct [3]	红色通道的ALSC额外ratio。值域范围：0 ~ 128 (128 = 1x)。
u8GRatioByCct [3]	绿色通道的ALSC额外ratio。值域范围：0 ~ 128 (128 = 1x)。
u8BRatioByCct [3]	蓝色通道的ALSC额外ratio。值域范围：0 ~ 128 (128 = 1x)。
RatioByBv.u16NumOfPoints	RatioByBv节点个数。值域范围：0 ~ 16。
RatioByBv.s32Y	各节点Ratio。值域范围：0 ~ 128 (128 = 1x)。
RatioByBv.s32X	各节点BV。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetALSC_CTRL(MI_U32 Channel, MI_ISP_IQ_ALSC_CTRL _TYPE_t *data);

MI_S32 MI_ISP_IQ_GetALSC_CTRL (MI_U32 Channel, MI_ISP_IQ_ALSC_CTRL _TYPE_t *data);

3.43. MI_ISP_IQ_NRLUMA_ADV结构体¶

3.43.1. 类型结构体 (Type Structure)¶

说明

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

typedef struct MI_ISP_IQ_NRLUMA_ADV_TYPE_s

{

[MI_ISP_BOOL_e bEnable;

[MI_ISP_OP_TYPE_e enOpType;

NRLUMA_ADV_AUTO_ATTR_t stAuto;

NRLUMA_ADV_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_NRLUMA_ADV_TYPE_t;

名称

变数名称	描述
bEnable	设定Luma_Adv降噪功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定Luma_Adv降噪的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定Luma_Adv降噪的自动模式属性结构体。
stManual	设定Luma_Adv降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNRLuma_Adv(MI_U32 Channel, MI_ISP_IQ_NRLUMA_ADV_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetNRLuma_Adv(MI_U32 Channel, MI_ISP_IQ_NRLUMA_ADV_TYPE_t *data);

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

说明

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

typedef struct NRLUMA_ADV_AUTO_ATTR_s

{

[NRLUMA_ADV_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} NRLUMA_ADV_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

typedef struct NRLUMA_ADV_MANUAL_ATTR_s

{

[NRLUMA_ADV_PARAM_t stParaAPI;

} NRLUMA_ADV_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

参数结构体 (Parameter Structure)¶

说明

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

typedef struct NRLUMA_ADV_PARAM_s

{

[MI_ISP_BOOL_e bDbgEn;

MI_U8 u8Strength;

MI_U8 u8StrengthByY[10];

MI_U8 u8StrengthByMot[16];

MI_U16 u16EdgeTh[8];

MI_U32 u32EdgeGain[8];

MI_U8 u8StrengthByType[2];

} NRLUMA_ADV_PARAM_t;

名称

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

3.44. MI_ISP_IQ_NRCHROMA_ADV结构体¶

3.44.1. 类型结构体 (Type Structure)¶

说明

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

typedef struct MI_ISP_IQ_NRCHROMA_ADV_TYPE_s

{

[MI_ISP_BOOL_e bEnable;

[MI_ISP_OP_TYPE_e enOpType;

NRCHROMA_ADV_AUTO_ATTR_t stAuto;

NRCHROMA_ADV MANUAL_ATTR_t stManual;

} MI_ISP_IQ_NRCHROMA_ADV_TYPE_t;

名称

变数名称	描述
bEnable	设定Chroma_Adv降噪功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定Chroma_Adv降噪的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定Chroma_Adv降噪的自动模式属性结构体。
stManual	设定Chroma_Adv降噪的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetNRChroma_Adv (MI_U32 Channel, MI_ISP_IQ_NRCHROMA_ADV_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetNRChroma_Adv (MI_U32 Channel, MI_ISP_IQ_NRCHROMA_ADV TYPE_t *data);

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

说明

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

定义

typedef struct NRCHROMA_ADV_AUTO_ATTR_s

{

    NRCHROMA_ADV_PARAM_t  stParaAPI[MI_ISP_AUTO_NUM];

} NRCHROMA_ADV_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

定义

typedef struct NRCHROMA_ADV_MANUAL_ATTR_s

{

    NRCHROMA_ADV_PARAM_t stParaAPI;

} NRCHROMA_ADV_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.44.4. 参数结构体 (Parameter Structure)¶

说明

设定Chroma_Adv降噪的参数结构体。

定义

typedef struct NRCHROMA_ADV_PARAM_s

{

    MI_U8 u8StrengthByY[8];

    MI_U8 u8StrengthByYEdge[8];

    MI_U8 u8StrengthByCEdge[8];

    MI_U8 u8MaxStrength;

    MI_U8 u8StaticLimitRatio;

    MI_U8 u8MotionClip;

    MI_U8 u8MotionColorReduce;

    MI_U8 u8MotionColorRecover;

    MI_U8 u8PreStrength;

} NRCHROMA_ADV_PARAM_t;

名称

变数名称	描述
u8StrengthByY[8]	针对不同亮度，给予不同NR强度的控制，横轴越右边代表亮度越大。值域0~255，值越大越强，值域范围：0~255。
u8StrengthByYEdge[8]	使用Luma来侦测Edge程度，针对不同Edge，给予不同NR强度的控制，横轴越右边代表Edge越大。值越大越强，值域范围：0~63。
u8StrengthByCEdge[8]	使用Chroma来侦测Edge程度，针对不同Edge，给予不同NR强度的控制，横轴越右边代表Edge越大。值越大越强，值域范围：0~255。
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。

3.45. MI_ISP_IQ_PFC结构体¶

3.45.1. 类型结构体 (Type Structure)¶

说明

设定PFC的类型结构体。

定义

typedef struct MI_ISP_IQ_PFC_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    PFC_AUTO_ATTR_t stAuto;

    PFC_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_PFC_TYPE_t;

名称

变数名称	描述
bEnable	设定PFC功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定PFC的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定PFC的自动模式属性结构体。
stManual	设定PFC的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetPFC (MI_U32 Channel, MI_ISP_IQ_PFC_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetPFC (MI_U32 Channel, MI_ISP_IQ_PFC_TYPE_t *data);

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

说明

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

定义

typedef struct PFC_AUTO_ATTR_s

{

    PFC_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} PFC_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

定义

typedef struct PFC_MANUAL_ATTR_s

{

    PFC_PARAM_t stParaAPI;

} PFC_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.45.4. 参数结构体 (Parameter Structure)¶

说明

设定PFC的参数结构体。

定义

typedef struct PFC_PARAM_s

{

    MI_U8 u8Strength;

    MI_U8 u8UStrength;

    MI_U8 u8VStrength;

    MI_U8 u8StrengthByY[8];

    MI_U8 u8FlatProtect;

    MI_U8 u8SatByY[2];

    MI_U8 u8SatSrcSel;

    MI_U8 u8StrengthByContrast[8];

} PFC_PARAM_t;

名称

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

3.46. MI_ISP_IQ_PFC_EX结构体¶

3.46.1. 类型结构体 (Type Structure)¶

说明

设定PFC_EX的类型结构体。

定义

typedef struct MI_ISP_IQ_PFC_EX_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    PFC_EX_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_PFC_EX_TYPE_t;

名称

变数名称描述

bEnable 设定PFC_EX功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

stManual 设定PFC_EX的手动模式属性结构体。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetPFC_EX (MI_U32 Channel, MI_ISP_IQ_PFC_EX_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetPFC_EX (MI_U32 Channel, MI_ISP_IQ_PFC_EX_TYPE_t *data);

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

说明

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

定义

typedef struct PFC_EX_MANUAL_ATTR_s

{

    PFC_EX_PARAM_t  stParaAPI;

} PFC_EX_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.46.3. 参数结构体 (Parameter Structure)¶

说明

设定PFC_EX的参数结构体。

定义

typedef struct PFC_EX_PARAM_s

{

    MI_ISP_BOOL_e bDbgEn;

    MI_ISP_BOOL_e bGSkipEn;

    MI_U8 u8SatMaskSel;

    MI_ISP_BOOL_e bSatAmpEn;

    MI_U8 u8StrengthByHue[12];

} PFC_EX_PARAM_t;

名称

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

3.47. MI_ISP_IQ_HDR_EX结构体¶

3.47.1. 类型结构体 (Type Structure)¶

说明

设定HDR_EX的类型结构体。

定义

typedef struct MI_ISP_IQ_HDR_EX_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    HDR_EX_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_HDR_EX_TYPE_t;

名称

变数名称描述

bEnable 设定HDR_EX功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

stManual 设定HDR_EX的手动模式属性结构体。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetHDR_EX(MI_U32 Channel, MI_ISP_IQ_HDR_EX_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetHDR_EX(MI_U32 Channel, MI_ISP_IQ_HDR_EX_TYPE_t *data);

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

说明

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

定义

typedef struct HDR_EX_MANUAL_ATTR_s

{

    HDR_EX_PARAM_t  stParaAPI;

} HDR_EX_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.47.3. 参数结构体 (Parameter Structure)¶

说明

设定HDR_EX的参数结构体。

定义

typedef struct HDR_EX_PARAM_s

{

    MI_U16 u16SensorExpRatio;

    MI_ISP_BOOL_e bDynRatioEn;

    MI_U8 u8DynRatioSrcSel;

    MI_U8 u8YSrcSel;

    MI_U8 u8NoiseLevelSrcSel;

    MI_U8 u8MotionMaxVal;

    MI_U16 u16MotionLumaTh;

    MI_U8 u8MotionAdjSft[6];

} HDR_EX_PARAM_t;

名称

变数名称	描述
u16SensorExpRatio	HDR曝光比，建议和AE设定一致。值域范围：0~65535。
bDynRatioEn	动态曝光补偿开关。值域范围：0~1。
u8DynRatioSrcSel	动态曝光补偿亮度来源，0代表长曝，1代表短曝。值域范围：0~1。
u8YSrcSel	依据亮度融合的亮度来源，0代表该点长曝值，1代表长曝周围最大值，2代表该点短曝值，3代表短曝周围最大值。值域范围：0~3。
u8NoiseLevelSrcSel	杂讯亮度来源。0代表长曝，1代表短曝，2代表两者最小值，3代表两者最大值。值域范围：0~3。
u8MotionMaxVal	运动程度上限值，值越大越不容易把杂讯误判成运动，不建议调整。值域范围：0~3。
u16MotionLumaTh	依据运动融合的亮度阀值，超过此值采用短曝，不建议调整。值域范围：0~1023。
u8MotionAdjSft	运动区采用长曝比例的横轴，不建议调整。值域范围：0~7。

3.48. MI_ISP_IQ_SHP_EX结构体¶

3.48.1. 类型结构体 (Type Structure)¶

说明

设定SHP_EX的类型结构体。

定义

typedef struct MI_ISP_IQ_SHP_EX_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    SHP_EX_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_SHP_EX_TYPE_t;

名称

变数名称描述

bEnable 设定SHP_EX功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

stManual 设定SHP_EX的手动模式属性结构体。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetSHP_EX(MI_U32 Channel, MI_ISP_IQ_SHP_EX_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetSHP_EX(MI_U32 Channel, MI_ISP_IQ_SHP_EX_TYPE_t *data);

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

说明

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

定义

typedef struct SHP_EX_MANUAL_ATTR_s

{

    SHP_EX_PARAM_t  stParaAPI;

} SHP_EX_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.48.3. 参数结构体 (Parameter Structure)¶

说明

设定SHP_EX的参数结构体。

定义

typedef struct SHP_EX_PARAM_s

{

    MI_ISP_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];

} SHP_EX_PARAM_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[6]	SharpnessD的低频部分，会先经过Sobel滤波来判断强度，而此参数可根据不同亮度，调整不同的强度，横轴代表亮度，越右边代表越亮。值域0~255，值越高，判断到的强度越强。
u8Sbl2LutY[6]	SharpnessD的高频部分，会先经过Sobel滤波来判断强度，而此参数可根据不同亮度，调整不同的强度，横轴代表亮度，越右边代表越亮。值域0~255，值越高，判断到的强度越强。
u8StrengthByHue[24]	根据Hue调整Sharpness，可针对特定颜色，加强或减弱edge程度，横轴为Hue，从0度~360度分为24等分，值越大，edge越强，值为64，代表不做调整。

3.49. MI_ISP_IQ_NR3D_EX结构体¶

3.49.1. 类型结构体 (Type Structure)¶

说明

设定NR3D_EX的类型结构体。

定义

typedef struct MI_ISP_IQ_NR3D_EX_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    NR3D_EX_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_NR3D_EX_TYPE_t;

名称

变数名称描述

bEnable 设定NR3D_EX功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

stManual 设定NR3D_EX的手动模式属性结构体。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetN R3D_EX(MI_U32 Channel, MI_ISP_IQ_NR3D_EX_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetNR3D_EX (MI_U32 Channel, MI_ISP_IQ_NR3D_EX_TYPE_t *data);

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

说明

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

定义

typedef struct NR3D_EX_MANUAL_ATTR_s

{

    NR3D_EX_PARAM_t  stParaAPI;

} NR3D_EX_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.49.3. 参数结构体 (Parameter Structure)¶

说明

设定NR3D_EX的参数结构体。

定义

typedef struct NR3D_EX_PARAM_s

{

    MI_ISP_BOOL_e bAREn;

    MI_U8 u8ARLumaTh[2];

    MI_U8 u8ARMotTh[2];

    MI_ISP_BOOL_e bPREn;

    MI_U16 u16PRDiffTh;

    MI_U8 u8PRRatioConf[4];

    MI_U8 u8PRContrastTh[2];

    MI_U8 u8PRMotTh[2];

} NR3D_EX_PARAM_t;

名称

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

3.50. MI_ISP_IQ_DUMMY结构体¶

3.50.1. 类型结构体 (Type Structure)¶

说明

设定DUMMY的类型结构体。

定义

typedef struct MI_ISP_IQ_DUMMY_TYPE_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_DUMMY_TYPE_t;

名称

变数名称	描述
bEnable	设定DUMMY功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定DUMMY的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定DUMMY的自动模式属性结构体。
stManual	设定DUMMY的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDUMMY(MI_U32 Channel, MI_ISP_IQ_DUMMY_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetDUMMY(MI_U32 Channel, MI_ISP_IQ_DUMMY_TYPE_t *data);

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

说明

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

定义

typedef struct DUMMY_AUTO_ATTR_s

{

    DUMMY_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} DUMMY_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

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

定义

typedef struct DUMMY_MANUAL_ATTR_s

{

    DUMMY_PARAM_t stParaAPI;

} DUMMY_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.50.4. 参数结构体 (Parameter Structure)¶

说明

设定DUMMY的参数结构体。

定义

typedef struct DUMMY_PARAM_s

{

    MI_S16 s16Dummy0[256];

    MI_S16 s16Dummy1[256];

    MI_S16 s16Dummy2[256];

    MI_S16 s16Dummy3;

    MI_S16 s16Dummy4;

} DUMMY_PARAM_t;

名称

变数名称	描述
s16Dummy0[16]	值域范围: -1 ~ 255。
s16Dummy1[16]	值域范围: -1 ~ 255。
s16Dummy2[16]	值域范围: -1 ~ 255。
s16Dummy3	值域范围: -1 ~ 255。
s16Dummy4	值域范围: -1 ~ 255。

3.51. MI_ISP_IQ_DUMMY_EX结构体¶

3.51.1. 类型结构体 (Type Structure)¶

说明

设定DUMMY_EX的类型结构体。

定义

typedef struct MI_ISP_IQ_DUMMY_EX_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    DUMMY_EX_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_DUMMY_EX_TYPE_t;

名称

变数名称描述

bEnable 设定DUMMY_EX功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

stManual 设定DUMMY_EX的手动模式属性结构体。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetDUMMY_EX(MI_U32 Channel, MI_ISP_IQ_DUMMY_EX_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetDUMMY _EX(MI_U32 Channel, MI_ISP_IQ_DUMMY_EX_TYPE_t *data);

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

说明

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

定义

typedef struct DUMMY_EX_MANUAL_ATTR_s

{

    DUMMY_EX_PARAM_t stParaAPI;

} DUMMY_EX_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.51.3. 参数结构体 (Parameter Structure)¶

说明

设定DUMMY_EX的参数结构体。

定义

typedef struct DUMMY_EX_PARAM_s

{

    MI_S16 s16DummyEx0[256];

    MI_S16 s16DummyEx1[256];

    MI_S16 s16DummyEx2[256];

    MI_S16 s16DummyEx3;

    MI_S16 s16DummyEx4;

} DUMMY_EX_PARAM_t;

名称

变数名称	描述
s16Dummy0[16]	值域范围: -1 ~ 255。
s16Dummy1[16]	值域范围: -1 ~ 255。
s16Dummy2[16]	值域范围: -1 ~ 255。
s16Dummy3	值域范围: -1 ~ 255。
s16Dummy4	值域范围: -1 ~ 255。

3.52. MI_ISP_IQ_WDRCurveFull结构体¶

3.52.1. 类型结构体 (Type Structure)¶

说明

设定WDR curve的类型结构体。

定义

typedef struct MI_ISP_IQ_WDRCurveFull_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    WDRCurveFull_AUTO_ATTR_t stAuto;

    WDRCurveFull_MANUAL_ATTR_t stManual;

} MI_ISP_IQ_ WDRCurveFull_TYPE_t;

名称

变数名称	描述
bEnable	设定WDR curve功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定WDR curve的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定WDR curve的自动模式属性结构体。
stManual	设定WDR curve的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_IQ_SetWDRCurveFull(MI_U32 Channel, MI_ISP_IQ_WDRCurveFull_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetWDRCurveFull(MI_U32 Channel, MI_ISP_IQ_WDRCurveFull_TYPE_t *data);

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

说明

设定WDR curve的自动模式属性结构体。

定义

typedef struct WDRCurveFull_AUTO_ATTR_s

{

    WDRCurveFull_PARAM_t stParaAPI[MI_ISP_AUTO_NUM];

} WDRCurveFull_AUTO_ATTR_t;

名称

变数名称描述

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

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

说明

设定WDR curve的手动模式属性结构体。

定义

typedef struct WDRCurveFull_MANUAL_ATTR_s

{

    WDRCurveFull_PARAM_t stParaAPI;

} WDRCurveFull_MANUAL_ATTR_t;

名称

变数名称描述

stParaAPI 手动模式属性结构体。

3.52.4. 参数结构体 (Parameter Structure)¶

说明

设定WDR curve的参数结构体。

定义

typedef struct WDRCurveFull_PARAM_s

{

    MI_U16 u16FCurve[256];

} WDRCurveFull_PARAM_t;

名称

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

3.53. MI_ISP_API_BYPASS结构体¶

3.53.1. 类型结构体 (Type Structure)¶

说明

设定ISP对应IP模组的略过模式的类型结构体。

定义

typedef struct MI_ISP_API_BYPASS_TYPE_s

{

    MI_ISP_BYPASS_MODE_e  bEnable;

    MI_ISP_API_ID_e  eAPIIndex;

} MI_ISP_API_BYPASS_TYPE_t;

名称

变数名称描述

bEnable 设定ISP对应IP模组的略过模式功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。

eAPIIndex 设定ISP API ID列举数值。
相关结构类型与函式

MI_S32 MI_ISP_IQ_SetAPIBypassMode(MI_U32 Channel, MI_ISP_API_BYPASS_TYPE_t *data);

MI_S32 MI_ISP_IQ_GetAPIBypassMode(MI_U32 Channel, MI_ISP_API_BYPASS_TYPE_t *data);

3.54. MI_ISP_AE_EXPO_VALUE结构体¶

3.54.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_AE_EXPO_VALUE_TYPE_s

{

    MI_U32 u32FNx10;

    MI_U32 u32SensorGain;

    MI_U32 u32ISPGain;

    MI_U32 u32US;

} MI_ISP_AE_EXPO_VALUE_TYPE_t;

名称

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

相关结构类型与函式

MI_ISP_AE_EXPO_INFO_TYPE_t

MI_S32 MI_ISP_AE_SetManualExpo(MI_U32 Channel, MI_ISP_AE_EXPO_VALUE_TYPE_t *data);

MI_S32 MI_ISP_AE_GetManualExpo(MI_U32 Channel, MI_ISP_AE_EXPO_VALUE_TYPE_t *data);

MI_S32 MI_ISP_AE_SetManualShortExpo(MI_U32 Channel, [MI_ISP_AE_EXPO_VALUE_TYPE_t *data);

MI_S32 MI_ISP_AE_GetManualShortExpo(MI_U32 Channel, [MI_ISP_AE_EXPO_VALUE_TYPE_t *data);

3.55. MI_ISP_AE_HIST_WEIGHT_Y结构体¶

3.55.1. 类型结构体 (Type Structure)¶

说明

纪录当前画面亮度及直方统计资料之结构体。

定义

typedef struct MI_ISP_AE_HIST_WEIGHT_Y_TYPE_s

{

    MI_U32 u32LumY;

    MI_U32 u32AvgY;

    MI_U32 u32Hits[128];

} MI_ISP_AE_HIST_WEIGHT_Y_TYPE_t;

名称

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

相关结构类型与函式

MI_S32 MI_ISP_AE_GetHistoWghtY(MI_U32 Channel, MI_ISP_AE_HIST_WEIGHT_Y_TYPE_t *data);

3.56. MI_ISP_AE_EXPO_INFO结构体¶

3.56.1. 类型结构体 (Type Structure)¶

说明

获取当前整体曝光资讯的结构体。

定义

typedef struct MI_ISP_AE_EXPO_INFO_TYPE_s

{

    MI_ISP_BOOL_e bIsStable;

    MI_ISP_BOOL_e bIsReachBoundary;

    MI_ISP_AE_EXPO_VALUE_TYPE_t stExpoValueLong;

    MI_ISP_AE_EXPO_VALUE_TYPE_t stExpoValueShort;

    MI_ISP_AE_HIST_WEIGHT_Y_TYPE_t stHistWeightY;

    MI_U32 u32LVx10;

    MI_S32 s32BV;

    MI_U32 u32SceneTarget;

} MI_ISP_AE_EXPO_INFO_TYPE_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 Channel, [MI_ISP_AE_EXPO_INFO_TYPE_t *data);

3.57. MI_ISP_AE_EV_COMP结构体¶

3.57.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_AE_EV_COMP_TYPE_s

{

    MI_S32 s32EV;

    MI_U32 u32Grad;

} MI_ISP_AE_EV_COMP_TYPE_t;

名称

变数名称描述

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

u32Grad 额外的增减曝光能亮之分母。值域范围：-10 ~ 10。
注意事项
Ex：s32EV = 1、u32Grad = 2，则曝光能亮会较原订自动模式再额外增加½ EV。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetEVComp(MI_U32 Channel, MI_ISP_AE_EV_COMP_TYPE_t *data);

MI_S32 MI_ISP_AE_GetEVComp(MI_U32 Channel, MI_ISP_AE_EV_COMP_TYPE_t *data);

3.58. MI_ISP_AE_MODE结构体¶

3.58.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef enum

{

    SS_AE_MODE_A,

    SS_AE_MODE_AV,

    SS_AE_MODE_SV,

    SS_AE_MODE_TV,

    SS_AE_MODE_M,

    SS_AE_MODE_MAX

} MI_ISP_AE_MODE_TYPE_e;

名称

变数名称	描述
SS_AE_MODE_A	全自动曝光模式。
SS_AE_MODE_AV	光圈先决模式。
SS_AE_MODE_SV	增益先决模式。
SS_AE_MODE_TV	快门先决模式。
SS_AE_MODE_M	手动模式。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetExpoMode(MI_U32 Channel, MI_ISP_AE_MODE_TYPE_e *data);

MI_S32 MI_ISP_AE_GetExpoMode(MI_U32 Channel, MI_ISP_AE_MODE_TYPE_e *data);

3.59. MI_ISP_AE_INTP_LUT结构体¶

3.59.1. 类型结构体 (Type Structure)¶

说明

具结点内插功能之参数资料设定表。

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

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

定义

typedef struct MI_ISP_AE_INTP_LUT_TYPE_s

{

    MI_U16 u16NumOfPoints;

    MI_U32 u32Y[16];

    MI_U32 u32X[16];

} MI_ISP_AE_INTP_LUT_TYPE_t;

名称

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

相关结构类型与函式

MI_ISP_AE_STRATEGY_TYPE_t

MI_S32 MI_ISP_AE_SetTarget(MI_U32 Channel, MI_ISP_AE_INTP_LUT_TYPE_t](#类型结构体-type-structure-48) *data);

MI_S32 MI_ISP_AE_GetTarget(MI_U32 Channel, MI_ISP_AE_INTP_LUT_TYPE_t](#类型结构体-type-structure-48) *data);

3.60. MI_ISP_AE_CONV_CONDITON结构体¶

3.60.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_AE_CONV_CONDITON_TYPE_s

{

    CONV_THD_PARAM_t  stConvThrd;

    CONV_SPEED_PARAM_t  stConvSpeed;

} MI_ISP_AE_CONV_CONDITON_TYPE_t;

名称

变数名称描述

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

stConvSpeed 设定自动曝光之收敛速度。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetConverge(MI_U32 Channel, MI_ISP_AE_CONV_CONDITON_TYPE_t](#类型结构体-type-structure-49) *data);

MI_S32 MI_ISP_AE_GetConverge(MI_U32 Channel, MI_ISP_AE_CONV_CONDITON_TYPE_t](#类型结构体-type-structure-49) *data);

3.60.2. 收敛区间结构体 (CONV_THD_PARAM_t)¶

说明

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

定义

typedef struct CONV_THD_PARAM_s

{

    MI_U32 u32InThd;

    MI_U32 u32OutThd;

} CONV_THD_PARAM_t;

名称

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

相关结构类型与函式

MI_ISP_AE_CONV_CONDITON_TYPE_t

3.60.3. 收敛速度结构体 (CONV_SPEED_PARAM_t)¶

说明

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

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

定义

typedef struct CONV_SPEED_PARAM_s

{

    MI_U32 u32SpeedX[4];

    MI_U32 u32SpeedY[4];

} CONV_SPEED_PARAM_t;

名称

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

注意事项

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

无。

3.61. MI_ISP_AE_EXPO_LIMIT结构体¶

3.61.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_AE_EXPO_LIMIT_TYPE_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_EXPO_LIMIT_TYPE_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 Channel, MI_ISP_AE_EXPO_LIMIT_TYPE_t](#类型结构体-type-structure-50) *data);

MI_S32 MI_ISP_AE_GetExposureLimit(MI_U32 Channel, MI_ISP_AE_EXPO_LIMIT_TYPE_t](#类型结构体-type-structure-50) *data);

3.62. MI_ISP_AE_EXPO_TABLE结构体¶

3.62.1. 类型结构体 (Type Structure)¶

说明

曝光行程表。

定义

typedef struct MI_ISP_AE_EXPO_TABLE_TYPE_s

{

    MI_U32 u32NumPoints;

    EXPO_POINT_PARAM_t  stExpoTbl[16];

} MI_ISP_AE_EXPO_TABLE_TYPE_t;

名称

变数名称描述

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

stExpoTbl[16] 曝光行程表的节点参数资料。
相关结构类型与函式

MI_S32 MI_ISP_AE_SetPlainLongExpoTable (MI_U32 Channel, [MI_ISP_AE_EXPO_TABLE_TYPE_t *data);

MI_S32 MI_ISP_AE_GetPlainLongExpoTable (MI_U32 Channel, [MI_ISP_AE_EXPO_TABLE_TYPE_t *data);

MI_S32 MI_ISP_AE_SetPlainShortExpoTable (MI_U32 Channel, [MI_ISP_AE_EXPO_TABLE_TYPE_t *data);

MI_S32 MI_ISP_AE_GetPlainShortExpoTable (MI_U32 Channel, [MI_ISP_AE_EXPO_TABLE_TYPE_t *data);

3.62.2. 曝光行程节点参数结构体 (EXPO_POINT_PARAM_t)¶

说明

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

定义

typedef struct EXPO_POINT_PARAM_s

{

    MI_U32 u32FNumx10;

    MI_U32 u32Shutter;

    MI_U32 u32TotalGain;

    MI_U32 u32SensorGain;

} EXPO_POINT_PARAM_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。

3.63. MI_ISP_AE_WIN_WEIGHT_MODE结构体¶

3.63.1. 类型结构体 (Type Structure)¶

说明

单独设定或切换画面亮度计算的权重表种类。

定义

typedef enum

{

    SS_AE_WEIGHT_AVERAGE = 0,

    SS_AE_WEIGHT_CENTER,

    SS_AE_WEIGHT_SPOT,

    SS_AE_WEIGHT_MAX

} MI_ISP_AE_WIN_WEIGHT_MODE_TYPE_e;

名称

变数名称描述

SS_AE_WEIGHT_AVERAGE 切换至平均测光的权重表

SS_AE_WEIGHT_CENTER 切换至中央测光的权重表

SS_AE_WEIGHT_SPOT 切换至点状测光的权重表
相关结构类型与函式

MI_S32 MI_ISP_AE_SetWinWgtType(MI_U32 Channel, MI_ISP_AE_WIN_WEIGHT_MODE_TYPE_e *data);

MI_S32 MI_ISP_AE_GetWinWgtType(MI_U32 Channel, MI_ISP_AE_WIN_WEIGHT_MODE_TYPE_e](#类型结构体-type-structure-52) *data);

3.64. MI_ISP_AE_WIN_WEIGHT结构体¶

3.64.1. 类型结构体 (Type Structure)¶

说明

设定或切换画面亮度计算的权重表种类并设定权重表。

定义

typedef struct MI_ISP_AE_WIN_WEIGHT_TYPE_s

{

    MI_ISP_AE_WIN_WEIGHT_MODE_TYPE_e eTypeID;

    WIN_WEIGHT_PARAM_t  stParaAPI;

} MI_ISP_AE_WIN_WEIGHT_TYPE_t;

名称

变数名称	描述
eTypeID	选择要切换过去的测光权重表种类。平均测光：SS_AE_WEIGHT_AVERAGE 中央测光：SS_AE_WEIGHT_CENTER 点状测光：SS_AE_WEIGHT_SPOT
PARAM_t	设定曝光权重表。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetWinWgt(MI_U32 Channel, MI_ISP_AE_WIN_WEIGHT_TYPE_t](#类型结构体-type-structure-53) *data);

MI_S32 MI_ISP_AE_GetWinWgt(MI_U32 Channel, MI_ISP_AE_WIN_WEIGHT_TYPE_t](#类型结构体-type-structure-53) *data);

3.64.2. 测光权重表参数结构体 (WIN_WEIGHT_PARAM_t)¶

说明

设定32×32的测光权重表。

定义

typedef struct WIN_WEIGHT_PARAM_s

{

    MI_U8 u8AverageTbl[32×32];

    MI_U8 u8CenterTbl[32×32];

    MI_U8 u8SpotTbl[32×32];

} WIN_WEIGHT_PARAM_t;

名称

变数名称	描述
u8AverageTbl[32×32]	平均测光分块权重表。值域范围：0 ~ 255。
u8CenterTbl[32×32]	中央测光分块权重表。值域范围：0 ~ 255。
u8SpotTbl[32×32]	点状测光分块权重表。值域范围：0 ~ 255。

注意事项

最大支持尺寸为32×32，目前默认尺寸为16×16。
相关结构类型与函式

无。

3.65. MI_ISP_AE_FLICKER结构体¶

3.65.1. 类型结构体 (Type Structure)¶

说明

设定抗频闪频率。

定义

typedef enum

{

    SS_AE_FLICKER_TYPE_DISABLE = 0,

    SS_AE_FLICKER_TYPE_60HZ = 1,

    SS_AE_FLICKER_TYPE_50HZ = 2,

    SS_AE_FLICKER_TYPE_AUTO = 3,

    SS_AE_FLICKER_TYPE_MAX

} MI_ISP_AE_FLICKER_TYPE_e;

名称

变数名称	描述
SS_AE_FLICKER_TYPE_DISABLE	关闭抗频闪功能。
SS_AE_FLICKER_TYPE_60HZ	设定频闪环境为60Hz。
SS_AE_FLICKER_TYPE_50HZ	设定频闪环境为50Hz。
SS_AE_FLICKER_TYPE_AUTO	自动设定频闪环境。

相关结构类型与函式

MI_S32 MI_ISP_AE_SetFlicker(MI_U32 Channel, MI_ISP_AE_FLICKER_TYPE_e](#类型结构体-type-structure-54) *data);

MI_S32 MI_ISP_AE_GetFlicker(MI_U32 Channel, MI_ISP_AE_FLICKER_TYPE_e](#类型结构体-type-structure-54) *data);

3.66. MI_ISP_AE_FLICKER_EX结构体¶

3.66.1. 类型结构体 (Type Structure)¶

说明

设定侦测抗闪烁频率。

定义

typedef struct MI_ISP_AE_FLICKER_EX_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_ISP_OP_TYPE_e  enOpType;

    MI_U8 u8AmpSensitivity;

    MI_U8 u8ScoreThd;

    MI_U8 u8RefreshCycles;

    MI_U8 u8ValidTimesThd;

    MI_ISP_AE_FLICKER_DETECT_TYPE_e         eFlickerType;

} MI_ISP_AE_FLICKER_EX_TYPE_t;

名称

变数名称	描述
bEnable	设定侦测抗闪烁功能的布林值。当bEnable为1时, 旧版Flicker API则失效。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
enOpType	设定侦测抗闪烁的工作模式。若设为auto, 当侦测到flicker时会自动切换eFlickerType. 自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_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 Channel, MI_ISP_AE_FLICKER_EX_TYPE_t *data);

MI_S32 MI_ISP_AE_GetFlickerEX(MI_U32 Channel, MI_ISP_AE_FLICKER_EX_TYPE_t *data);

3.66.2. 侦测抗闪烁模式结构体 (MI_ISP_AE_FLICKER_DETECT_TYPE_e)¶

说明

选择侦测抗闪烁之模式。

定义

typedef enum

{

    SS_AE_FLICKER_TYPE_DETECT_60HZ = 0,

    SS_AE_FLICKER_TYPE_DETECT_50HZ = 1,

    SS_AE_FLICKER_TYPE_DETECT_MAX

} MI_ISP_AE_FLICKER_DETECT_TYPE_e;

名称

变数名称描述

SS_AE_FLICKER_TYPE_DETECT_60HZ 设定侦测抗闪烁环境为60Hz。

SS_AE_FLICKER_TYPE_DETECT_50HZ 设定侦测抗闪烁环境为50Hz。

3.67. MI_ISP_AE_QueryFlickerInfo结构体¶

3.67.1. 类型结构体 (Type Structure)¶

说明

获取当前侦测抗闪烁资讯的结构体。

定义

typedef struct MI_ISP_AE_FLICKER_EX_INFO_TYPE_s

{

    MI_ISP_BOOL_e bIsEffective;

    MI_ISP_AE_FLICKER_DETECT_TYPE_e     eFlickerType;

    MI_U16 u16Score;

} MI_ISP_AE_FLICKER_EX_INFO_TYPE_t;

名称

变数名称	描述
bIsEffective	取得当前侦测抗闪烁是否有效(1：有效值，0：无效值)。
eFlickerType	取得当前侦测抗闪烁模式，模式分别为0 = 60Hz、1 = 50Hz。
u16Score	取得当前侦测抗闪烁有效模式的程度分数。如果分数较高，则判断为当前的抗闪烁频率模式。如果分数较低，则判断为另一种抗闪烁频率模式。

相关结构类型与函式

MI_S32 MI_ISP_AE_QueryFlickerInfo(MI_U32 Channel, MI_ISP_AE_FLICKER_EX_INFO_TYPE_t *data);

3.68. MI_ISP_AE_STRATEGY结构体¶

3.68.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_AE_STRATEGY_TYPE_s

{

    MI_ISP_AE_STRATEGY_TYPE_e eAEStrategyMode;

    MI_U32 u32Weighting;

    MI_ISP_AE_INTP_LUT_TYPE_t stUpperOffset;

    MI_ISP_AE_INTP_LUT_TYPE_t stLowerOffset;

    MI_U32 u32BrightToneStrength;

    MI_U32 u32BrightToneSensitivity;

    MI_U32 u32DarkToneStrength;

    MI_U32 u32DarkToneSensitivity;

    MI_U32 u32AutoStrength;

    MI_U32 u32AutoSensitivity;

} MI_ISP_AE_STRATEGY_TYPE_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设定为SS_AE_STRATEGY_BRIGHTTONE时，可用来调整亮阶区域的目标亮度(数值愈大画面将愈暗)。值域范围：0 ~ 1024。
BrightToneSensitivity	eAEStrategyMode设定为SS_AE_STRATEGY_BRIGHTTONE时，可用来调整对亮阶区域的敏感度(数值愈大愈敏感，即使影像中仅少部分区域过曝也会选择将画面压暗)。值域范围：0 ~ 1024。
DarkToneStrength	eAEStrategyMode 设定为SS_AE_STRATEGY_DARKTONE时，可用来调整暗阶区域的目标亮度(数值愈大画面将愈亮)。值域范围：0 ~ 1024。
DarkToneSensitivity	eAEStrategyMode设定为SS_AE_STRATEGY_DARKTONE时，可用来调整对暗阶区域的敏感度(数值愈大愈敏感，即使影像中仅少部分区域很暗也会选择将画面拉亮)。值域范围：0 ~ 1024。
AutoStrength	eAEStrategyMode设定为SS_AE_STRATEGY_AUTO时，可用来调整亮阶区域的目标亮度(数值愈大画面将愈暗)。值域范围：0 ~ 1024。
AutoSensitivity	eAEStrategyMode设定为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 Channel, MI_ISP_AE_STRATEGY_TYPE_t](#类型结构体-type-structure-57) *data);

MI_S32 MI_ISP_AE_GetStrategy(MI_U32 Channel, MI_ISP_AE_STRATEGY_TYPE_t](#类型结构体-type-structure-57) *data);

3.68.2. 曝光策略模式结构体 (MI_ISP_AE_STRATEGY_TYPE_e)¶

说明

选择曝光策略之模式。

定义

typedef enum

{

    SS_AE_STRATEGY_BRIGHTTONE,

    SS_AE_STRATEGY_DARKTONE,

    SS_AE_STRATEGY_AUTO,

    SS_AE_STRATEGY_MAX

} MI_ISP_AE_STRATEGY_TYPE_e;

名称

变数名称描述

SS_AE_STRATEGY_BRIGHTTONE 强光抑制模式(亮阶优先)。

SS_AE_STRATEGY_DARKTONE 背光补偿模式(暗阶优先)。

SS_AE_STRATEGY_AUTO 自动补偿模式。

3.69. MI_ISP_AE_RGBIR_AE结构体¶

3.69.1. 类型结构体 (Type Structure)¶

说明

RGBIR mode 的相关AE控制参数

定义

typedef struct MI_ISP_AE_RGBIR_AE_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_U16 u16MaxYWithIR;

    MI_U16 u16MinISPGainCompRatio;

} MI_ISP_AE_RGBIR_AE_TYPE_t;

名称

变数名称	描述
bEnable	Enable / disable RGBIR 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 Channel, MI_ISP_AE_RGBIR_AE_TYPE_t *data);

MI_S32 MI_ISP_AE_GetRGBIRAE(MI_U32 Channel, MI_ISP_AE_RGBIR_AE_TYPE_t *data);

3.70. MI_ISP_AE_HDR结构体¶

3.70.1. 类型结构体 (Type Structure)¶

说明

具结点内插功能之参数资料设定表。

可用于设定随总增益变化的HDR的长短曝曝光比例(ex：X轴：total gain、Y轴：HDR 长短曝光比例)。

定义

typedef struct MI_ISP_AE_HDR_TYPE_s

{

    MI_ISP_AE_INTP_LUT_TYPE_t stAeHdrRatio;

} MI_ISP_AE_HDR_TYPE_t;

名称

变数名称描述

stAeHdrRatio 可设定不同总增益下的HDR 长短曝曝光倍率，使用方法同[MI_ISP_AE_INTP_LUT_TYPE_t
相关结构类型与函式

MI_S32 MI_ISP_AE_SetHDR(MI_U32 Channel, MI_ISP_AE_HDR_TYPE_t *data);

MI_S32 MI_ISP_AE_GetHDR(MI_U32 Channel, MI_ISP_AE_HDR_TYPE_t *data);

3.71. MI_ISP_AE_STABILIZER结构体¶

3.71.1. 类型结构体 (Type Structure)¶

说明

Stabilizer结构体。

定义

typedef struct MI_ISP_AE_STABILIZER_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_U16 u16DiffThd;

    MI_[U16 u16Percent;

} MI_ISP_AE_ STABILIZER _TYPE_t;

名称

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

相关结构类型与函式

MI_S32 MI_ISP_AE_SetStabilizer(MI_U32 Channel, MI_ISP_AE_STABILIZER_TYPE_t *data);

MI_S32 MI_ISP_AE_GetStabilizer(MI_U32 Channel, MI_ISP_AE_STABILIZER_TYPE_t *data);

3.72. MI_ISP_AWB_QUERY_INFO结构体¶

3.72.1. 类型结构体 (Type Structure)¶

说明

设定当前整体白平衡资讯的类型结构体。

定义

typedef struct MI_ISP_AWB_QUERY_INFO_TYPE_s

{

    MI_ISP_BOOL_e bIsStable;

    MI_U16 u16Rgain;

    MI_U16 u16Grgain;

    MI_U16 u16Gbgain;

    MI_U16 u16Bgain;

    MI_U16 u16ColorTemp;

    MI_U8 u8WPInd;

    MI_ISP_BOOL_e bMultiLSDetected;

    MI_U8 u8FirstLSInd;

    MI_U8 u8SecondLSInd;

} MI_ISP_AWB_QUERY_INFO_TYPE_t;

名称

变数名称	描述
bIsStable	获取目前AWB是否在收敛状态。
u16Rgain	获取目前设定的白平衡R通道增益。
u16Grgain	获取目前设定的白平衡Gr通道增益。
u16Gbgain	获取目前设定的白平衡Gb通道增益。
u16Bgain	获取目前设定的白平衡B通道增益。
u16ColorTemp	获取目前计算的色温值。
u8WPInd	当开启WpWeight功能，获取目前参考白点色温框index。
bMultiLSDetected	当开启混光色偏校正功能，获取目前是否侦测出混光。关闭：SS_FALSE = 0。开启：SS_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 Channel, MI_ISP_AWB_QUERY_INFO_TYPE_t *data);

3.73. MI_ISP_AWB_CT_STATISTICS结构体¶

3.73.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_AWB_CT_STATISTICS_TYPE_s

{

    MI_U16 u16Width;

    MI_U16 u16Height;

    MI_U16 u16StatisX[5760];

    MI_U16 u16StatisY[5760];

} MI_ISP_AWB_CT_STATISTICS_TYPE_t;

名称

变数名称描述

u16Width 有效区宽度。

u16Height 有效区高度。

u16StatisX[5760] 色温域的统计X。

u16StatisY[5760] 色温域的统计Y。
相关结构类型与函式

MI_S32 MI_ISP_AWB_GetCTStats(MI_U32 Channel, MI_ISP_AWB_CT_STATISTICS_TYPE_t *data);

3.74. MI_ISP_AWB_HW_STATISTICS结构体¶

3.74.1. 类型结构体 (Type Structure)¶

说明

设定AWB硬体统计值的类型结构体。

定义

typedef struct MI_ISP_AWB_HW_STATISTICS_TYPE_s

{

    MI_U8 u8AwbBuffer[34560];

} MI_ISP_AWB_HW_STATISTICS_TYPE_t;

名称

变数名称描述

u8AwbBuffer AWB统计值资料，n = 34560。其资料排列依序为{R0,G0,B0,R1,G1,B1,…,Rn-1,Gn-1,Bn-1}。
相关结构类型与函式

MI_S32 MI_ISP_AWB_GetHWStats(MI_U32 Channel, MI_ISP_AWB_HW_STATISTICS_TYPE_t *data);

3.75. MI_ISP_AWB_ATTR结构体¶

3.75.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_AWB_ATTR_TYPE_s

{

    MI_ISP_SM_STATE_TYPE_e  eState;

    MI_ISP_OP_TYPE_e  eOpType;

    MWB_ATTR_PARAM_t stManualParaAPI;

    AWB_ATTR_PARAM_t stAutoParaAPI;

} MI_ISP_AWB_ATTR_TYPE_t;

名称

变数名称	描述
bEnable	设定AWB属性功能的工作模式。正常：SS_ISP_STATE_NORMAL = 0。暂停：SS_ISP_STATE_PAUSE = 1。
enOpType	设定AWB属性的工作模式。自动模式：SS_OP_TYP_AUTO = 0。手动模式：SS_OP_TYP_MANUAL = 1。
stAuto	设定AWB属性的自动模式属性结构体。
stManual	设定AWB属性的手动模式属性结构体。

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetAttr(MI_U32 Channel, MI_ISP_AWB_ATTR_TYPE_t *data);

MI_S32 MI_ISP_AWB_GetAttr(MI_U32 Channel, MI_ISP_AWB_ATTR_TYPE_t *data);

3.75.2. 手动模式参数结构体 (Manual Parameter Structure)¶

说明

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

定义

typedef struct MWB_ATTR_PARAM_s

{

    MI_U16 u16Rgain;

    MI_U16 u16Grgain;

    MI_U16 u16Gbgain;

    MI_U16 u16Bgain;

} MWB_ATTR_PARAM_t;

名称

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

3.75.3. 自动模式参数结构体 (Automatic Parameter Structure)¶

说明

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

定义

typedef struct AWB_ATTR_PARAM_s

{

    MI_U8 u8Speed;

    MI_U8 u8ConvInThd;

    MI_U8 u8ConvOutThd;

    MI_ISP_AWB_ALG_TYPE_e eAlgType;

    MI_ISP_AWB_ADV_TYPE_e eAdvType;

    MI_U8 u8RGStrength;

    MI_U8 u8BGStrength;

    CT_LIMIT_PARAM_t stCTLimit;

    CT_WEIGHT_PARAM_t stLvWeight[MI_ISP_AWB_LV_CT_TBL_NUM];

    CT_RATIO_PARAM_t stPreferRRatio[MI_ISP_AWB_LV_CT_TBL_NUM];

    CT_RATIO_PARAM_t 
    stPreferBRatio[MI_ISP_AWB_LV_CT_TBL_NUM];

    MI_U16 u16WpWeight[MI_ISP_AWB_CT_TBL_NUM];

    MS_U32 u4WeightWin[MI_ISP_AWB_WEIGHT_WIN_NUM];

} AWB_ATTR_PARAM_t;

名称

变数名称	描述
u8Speed	自动白平衡演算法收敛速度，值越大收敛速度越快。值域范围：0 ~ 100。
u8ConvInThd	设定白平衡的收敛区间，值越小则AWB收敛的与目标值越接近。值域范围：0 ~ 255，不建议将值设太小，容易导致AWB一直处在不稳定状态，建议值32。
u8ConvOutThd	设定要让白平衡离开收敛状态重新计算白平衡的阀值，值越大则AWB收敛稳定后，越不容易重新计算。值域范围：0 ~ 255，不建议将值设太大，建议值64。
eAlgType	自动白平衡演算法类型设定，共有以下四种选择： 1. GrayWorld 2. Normal 3. Balance 4. Focus
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。
u4WeightWin[MI_ISP_AWB_WEIGHT_WIN_NUM]	将画面区分成9x9个区域，可以分别给定各区域的权重，让白平衡计算更偏向将该区域做灰。值域范围：0 ~ 16。

详细说明请参考MI_ISP_AWB_ALG_TYPE_e。

注意事项

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

无。

3.75.4. 参数结构体 (Parameter Structure)¶

说明

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

定义

typedef struct CT_LIMIT_PARAM_s

{

    MI_U16 u16MaxRgain;

    MI_U16 u16MinRgain;

    MI_U16 u16MaxBgain;

    MI_U16 u16MinBgain;

} CT_LIMIT_PARAM_t;

名称

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

3.75.5. 参数结构体 (Parameter Structure)¶

说明

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

定义

typedef struct CT_WEIGHT_PARAM_s

{

    MI_U16 u16Weight[MI_ISP_AWB_CT_TBL_NUM];

} CT_WEIGHT_PARAM_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。

3.75.6. 参数结构体 (Parameter Structure)¶

说明

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

定义

typedef struct CT_RATIO_PARAM_s

{

    MI_U16 u16Ratio[MI_ISP_AWB_CT_TBL_NUM];

} CT_RATIO_PARAM_t;

名称

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

3.76. MI_ISP_AWB_ATTR_EX结构体¶

3.76.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_AWB_ATTR_EX_TYPE_s

{

    MI_ISP_BOOL_e bExtraLightEn;

    AWB_ATTR_EXTRA_LIGHTSOURCE_PARAM_t stLightInfo[4];

} MI_ISP_AWB_ATTR_EX_TYPE_t;

名称

变数名称	描述
bExtraLightEn	设定自动白平衡计算时是否考虑使用者设的独立色温范围功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
stLightInfo[4]	使用者设定的独立光源点资讯。

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetAttrEx(MI_U32 Channel, MI_ISP_AWB_ATTR_EX_TYPE_t *data);

MI_S32 MI_ISP_AWB_GetAttrEx(MI_U32 Channel, MI_ISP_AWB_ATTR_EX_TYPE_t *data);

3.76.2. 白平衡独立光源点参数结构体(AWB Extar LightSource Parameter Structure)¶

说明

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

定义

typedef struct AWB_ATTR_EXTRA_LIGHTSOURCE_PARAM_s

{

    MI_U16 u16WhiteRgain;

    MI_U16 u16WhiteBgain;

    MI_U8 u8AreaSize;

    MI_ISP_BOOL_e bExclude;

} AWB_ATTR_EXTRA_LIGHTSOURCE_PARAM_t;

名称

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

3.77. MI_ISP_AWB_MULTILS_LS结构体¶

3.77.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_AWB_MULTILS_LS_TYPE_s

{

    MI_ISP_BOOL_e bEnable;

    MI_U8 u8Sensitive;

    MI_U8 u8CaliStrength;

    MI_U16 u16CcmForLow[9];

    MI_U16 u16CcmForHigh[9];

} MI_ISP_AWB_MULTILS_LS_TYPE_t;

名称

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

相关结构类型与函式

MI_S32 MI_ISP_AWB_SetMultiLSAttr(MI_U32 Channel, MI_ISP_AWB_MULTILS_LS_TYPE_t *data);

MI_S32 MI_ISP_AWB_GetMultiLSAttr(MI_U32 Channel, MI_ISP_AWB_MULTILS_LS_TYPE_t *data);

3.78. MI_ISP_AWB_CT_CALI结构体¶

3.78.1. 类型结构体 (Type Structure)¶

说明

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

定义

typedef struct MI_ISP_AWB_CT_CALI_TYPE_s

{

    MI_U16 u16StartIdx;

    MI_U16 u16EndIdx;

    MI_U16 u16CtParams[40];

} MI_ISP_AWB_CT_CALI_TYPE_t;

名称

变数名称描述

u16StartIdx 亮区开始索引。

u16EndIdx 亮区结束索引。

u16CtParams[40] 色温cali参数。
相关结构类型与函式

MI_S32 MI_ISP_AWB_SetCTCaliAttr(MI_U32 Channel, MI_ISP_AWB_CT_CALI_TYPE_t *data);

MI_S32 MI_ISP_AWB_GetCTCaliAttr(MI_U32 Channel, MI_ISP_AWB_CT_CALI_TYPE_t *data);

3.79. MI_ISP_AWB_CUR_CT_CALI结构体¶

3.79.1. 类型结构体 (Type Structure)¶

说明

自动白平衡色温框资料的类型结构体。

定义

typedef struct MI_ISP_AWB_CUR_CT_CALI_TYPE_s

{

    MI_U16 u16CtParams[40];

} MI_ISP_AWB_CUR_CT_CALI_TYPE_t;

名称

变数名称描述

u16CtParams[40] 色温框资料。
相关结构类型与函式

MI_S32 MI_ISP_AWB_GetCurCTCaliAttr(MI_U32 Channel, [MI_ISP_AWB_CUR_CT_CALI_TYPE_t *data);

4. 错误码¶

参数名称	数值	描述
MI_ISP_OK	0	成功。
MI_ISP_FAILURE	-1	失败。

参数名称	描述
Channel	影像输入的通道号(一般为0)。
*data	IQ版本号资讯的指标。

参数名称	描述
Channel	影像输入的通道号(一般为0)。
eCaliItem	校正专案的列举结构体。
filepath	校正参数档案的路径位置。

变数名称	描述
SS_FALSE	布林值等于0。
SS_TRUE	布林值等于1。
SS_BOOL_MAX	判断布林值列举列表的最大值。

变数名称	描述
SS_OP_TYP_AUTO	自动工作模式。
SS_OP_TYP_MANUAL	手动工作模式。
SS_OP_TYP_MODE_MAX	判断工作模式列举清单的最大值。

变数名称	描述
SS_OP_TYP_AUTO	正常模式。
SS_OP_TYP_MANUAL	暂停模式。
SS_OP_TYP_MODE_MAX	判断状态机列举清单的最大值。

变数名称	描述
SS_IQ_PARAM_MODE_NORMAL	IQ白天工作模式。
SS_IQ_PARAM_MODE_NIGHT	IQ夜间工作模式。
SS_IQ_PARAM_MODE_MAX	判断IQ工作模式列举清单的最大值。

变数名称	描述
SS_BYPASS_OFF	ByPass工作模式等于Disable。
SS_BYPASS_ON	ByPass工作模式等于Enable。
SS_ BYPASS_MAX	判断ByPass工作模式列举清单的最大值。

变数名称	描述
u16LutY[256]	Y通道分量。值域范围：0 ~ 1023。
u16LutU[128]	U通道分量。值域范围：0 ~ 511。
u16LutV[128]	V通道分量。值域范围：0 ~ 511。

变数名称	描述
bEnable	设定去马赛克功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
stManual	设定去马赛克的手动模式属性结构体。

变数名称	描述
bEnable	设定色彩转换功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
stManual	设定色彩转换的手动模式属性结构体。

变数名称	描述
bEnable	设定PFC_EX功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
stManual	设定PFC_EX的手动模式属性结构体。

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

变数名称	描述
bEnable	设定SHP_EX功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
stManual	设定SHP_EX的手动模式属性结构体。

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

变数名称	描述
bEnable	设定DUMMY_EX功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
stManual	设定DUMMY_EX的手动模式属性结构体。

变数名称	描述
bEnable	设定ISP对应IP模组的略过模式功能的布林值。关闭：SS_FALSE = 0。开启：SS_TRUE = 1。
eAPIIndex	设定ISP API ID列举数值。

变数名称	描述
s32EV	额外的增减曝光能亮之分子。值域范围：-10 ~ 10。
u32Grad	额外的增减曝光能亮之分母。值域范围：-10 ~ 10。

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

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

变数名称	描述
SS_AE_WEIGHT_AVERAGE	切换至平均测光的权重表
SS_AE_WEIGHT_CENTER	切换至中央测光的权重表
SS_AE_WEIGHT_SPOT	切换至点状测光的权重表

变数名称	描述
SS_AE_FLICKER_TYPE_DETECT_60HZ	设定侦测抗闪烁环境为60Hz。
SS_AE_FLICKER_TYPE_DETECT_50HZ	设定侦测抗闪烁环境为50Hz。

变数名称	描述
SS_AE_STRATEGY_BRIGHTTONE	强光抑制模式(亮阶优先)。
SS_AE_STRATEGY_DARKTONE	背光补偿模式(暗阶优先)。
SS_AE_STRATEGY_AUTO	自动补偿模式。

变数名称	描述
u16Width	有效区宽度。
u16Height	有效区高度。
u16StatisX[5760]	色温域的统计X。
u16StatisY[5760]	色温域的统计Y。

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