41. 查询内部状态消息

41.1. 概述

本章节说明Inner State information的相关接口。 此接口的作用为提供用户查询系统内部状态以及数个与ISO相关的参数目前所设置的真实数值。

使用者可在调试过程中透过此接口获取ISO相关参数目前填入的真实数值以确认参数是否正确配置。 透过此接口只能获得数值，无法改变相关参数。

41.2. API 参考

41.2.1. CVI_ISP_QueryInnerStateInfo

【描述】

获取系统内部信息以及ISO相关参数目前设定的真实数值

【语法】

CVI_S32 CVI_ISP_QueryInnerStateInfo(VI_PIPE ViPipe, ISP_INNER_STATE_INFO_S *pstInnerStateInfo);

【参数】

参数名称

描述

输入/输出

ViPipe

VI_PIPE 号

输入

pstInnerStateInfo

内部信息与目前实际参数设定值

输出

【返回值】

返回值

描述

0

成功。

非 0

失败，其值为 错误码。

【需求】

  • 头文件: cvi_isp.h, cvi_comm_isp.h

  • 库文件: libisp.so

【注意】

无。

【举例】

无。

【相关主题】

无。

41.3. 数据类型

41.3.1. ISP_INNER_STATE_INFO_S

【说明】

定义内部信息与目前实际参数设定值

【定义】

#define MAX_HIST_BINS 256
#define MAX_EXPOSURE_RATIO 256
#define LTM_DARK_CURVE_NODE_NUM 257
#define LTM_BRIGHT_CURVE_NODE_NUM 513
typedef struct _ISP_INNER_STATE_INFO_S {
    CVI_U32 blcOffsetR;
    CVI_U32 blcOffsetGr;
    CVI_U32 blcOffsetGb;
    CVI_U32 blcOffsetB;
    CVI_U32 blcGainR;
    CVI_U32 blcGainGr;
    CVI_U32 blcGainGb;
    CVI_U32 blcGainB;
    CVI_S32 ccm[9];
    CVI_U16 drcGlobalToneBinNum;
    CVI_U16 drcGlobalToneBinSEStep;
    CVI_U32 drcGlobalTone[LTM_GLOBAL_CURVE_NODE_NUM];
    CVI_U32 drcDarkTone[LTM_DARK_CURVE_NODE_NUM];
    CVI_U32 drcBrightTone[LTM_BRIGHT_CURVE_NODE_NUM];
    CVI_BOOL bWDRSwitchFinish;
    // For 2TO1/3TO1/4TO1 use.
    CVI_U32 u32WDRExpRatioActual[ISP_WDR_FRAME_IDX_SIZE];
    ISP_MESH_SHADING_GAIN_LUT_S mlscGainTable;
} ISP_INNER_STATE_INFO_S;

【成员】

成员名称

描述

wdrHistBinNum

目 前画面wdr分布直方图的数组数量

blcOffsetR

目前黑电平在R分量扣除的值

blcOffsetGr

目前黑电平在Gr分量扣除的值

blcOffsetGb

目前黑电平在Gb分量扣除的值

blcOffsetB

目前黑电平在B分量扣除的值

blcGainR

目前ISP在R分量的数字增益

blcGainGr

目前ISP在Gr分量的数字增益

blcGainGb

目前ISP在Gb分量的数字增益

blcGainB

目前ISP在B分量的数字增益

Ccm[9]

目前ISP使用的色彩还原矩阵真实数值

wdrHistogramBefore[MAX_HIST_BINS *MAX_EXPOSURE_RATIO]

目前wdr的分布直方图

wdrHistogramAfter[MAX_HIST_BINS *MAX_EXPOSURE_RATIO]

目前wdr分布直方图所产生的色调映像曲线

drcDarkTone[LTM_DARK_CURVE_NODE_NUM]

目前ISP使用的暗区色调映像曲线

drcBrightTone[LTM_BRIGHT_CURVE_NODE_NUM]

目前ISP使用的亮区色调映像曲线

bWDRSwitchFinish

标示sensor mode切换是否完成

【注意事项】

无。

【相关数据类型及接口】

无。