PhysicalDevice/Detector/Sensview/SensviewDF/SDK/Include/nvDentalDet.h

#ifndef NVDENTALDET_H
#define NVDENTALDET_H

#ifdef NVDENTALDET_EXPORTS
#define NVDENTALDET_API __declspec(dllexport)
#else
#define NVDENTALDET_API __declspec(dllimport)
#endif

#include "nvTypes.h"

#ifdef __cplusplus
extern "C" {
#endif


/* DeviceProperty */

/////////////////////////////////////////////////////////////////////////
/// @brief						枚举网络上发现的探测器设备
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @param [in out] pDetBuffer			探测器缓冲区指针
/// @param [in] iCount			探测器个数
/// @note						不允许对获取到的缓冲区进行修改或删除，否则会导致程序崩溃
NVDENTALDET_API NV_StatusType	NV_EnumDets(NV_DET * pDets, int iBufferSize, int * iCount);

/////////////////////////////////////////////////////////////////////////
/// @brief						使用探测器ID打开探测器，读取配置文件初始化到硬件，并启动温度和状态监控线程
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @param [in] uDetID			探测器ID,如果使用DEFAULT_DETID，则默认打开网络上搜索到的第一个设备
/// @note						该函数用户打开探测器，当探测器不再使用时必须调用 @c NV_CloseDet()
/// 推荐在打开探测器设备前使用NV_EnumDets 获取探测器的数量，然后使用此函数打开设备
/// @sa @c NV_CloseDet()
NVDENTALDET_API NV_StatusType	NV_OpenDet(NV_DETID uDetID);

/////////////////////////////////////////////////////////////////////////
/// @brief						是否已经打开了探测器
/// @retval	bool					返回是否打开的状态值，未打开为false,已打开为true
NVDENTALDET_API bool			NV_IsDetOpen();

/////////////////////////////////////////////////////////////////////////
/// @brief						探测器是否处于连接状态
/// @retval	bool					返回是否连接的状态值，已断开为false,已连接为true
NVDENTALDET_API bool			NV_IsDetConn();

/////////////////////////////////////////////////////////////////////////
/// @brief						关闭探测器，并停止温度和状态监控线程
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						当探测器关闭时，清理所用资源
/// @sa @c NV_OpenDet()
NVDENTALDET_API NV_StatusType	NV_CloseDet();

/////////////////////////////////////////////////////////////////////////
/// @brief						设置时间回调函数，内部温度改变事件、状态改变事件、图像接收到事件等
/// @param [out] pCallback		回调函数指针
/// @param [out] pCallbackData	回调函数附带指针，在回调函数中直接返回
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						一般调用NV_OpenDet后，直接调用次函数
NVDENTALDET_API NV_StatusType	NV_SetEventCallback(NV_EVENT_CALLBACK pCallback, void *pCallbackData);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取时间回调函数，内部温度改变事件、状态改变事件、图像接收到事件等
/// @param [out] pCallback		回调函数指针
/// @param [out] pCallbackData	回调函数附带指针，在回调函数中直接返回
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						一般调用NV_OpenDet后，直接调用次函数
NVDENTALDET_API NV_StatusType	NV_GetEventCallback(NV_EVENT_CALLBACK * pCallback, void **pCallbackData);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取传感器尺寸
/// @param [out] sensorWidth	传感器宽
/// @param [out] sensorHeight	传感器高
/// @param [out] bits			传感器位数
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetSensorSize(int *sensorWidth, int *sensorHeight, int *bits);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取版本信息
/// @param [out] version		探测器版本信息
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetVersion(NV_Version *version);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取探测器序列号
/// @param [out] pBuffer		探测器序列号
/// @param [out] pSize			序列号缓存长度
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetSerialNum(char* pBuffer, unsigned long* pSize);

/* AcquisitionControl */
/////////////////////////////////////////////////////////////////////////
/// @brief						获取探测器支持的采集模式
/// @param [in out] pMode			模式缓冲区指针
/// @param [in] iBufLen			缓冲区长度
/// @param [out] iCnt			支持的模式总数 
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_EnumAcquisitionMode(NV_AcquisitionMode * pMode, int iBufLen, int * iCnt);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取探测器支持的快门模式
/// @param [in out] pMode			模式缓冲区指针
/// @param [in] iBufLen			缓冲区长度
/// @param [out] iCnt			支持的模式总数 
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_EnumShutterMode(NV_ShutterMode * pMode, int iBufLen, int * iCnt);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取探测器支持的binning模式
/// @param [in out] pMode			模式缓冲区指针
/// @param [in] iBufLen			缓冲区长度
/// @param [out] iCnt			支持的模式总数 
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_EnumBinningMode(NV_BinningMode * pMode, int iBufLen, int * iCnt);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取探测器支持的GAIN档位
/// @param [out] iCnt			支持的增益档位总数 
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_EnumGains(int * iCnt);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取探测器支持的数字增益档位
/// @param [out] iCnt			支持的数字增益档位总数 
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_EnumDigitalGains(int * iCnt);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取探测器档位描述信息
/// @param [in] iGainIndex			增益档序号
/// @param [in out] pBuffer			描述信息缓冲区指针
/// @param [in] iBufLen			缓冲区长度
/// @note						增益档位序号从0 开始，最大为支持的总数-1
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetGainDescription(int iGainIndex, char* pBuffer,  int iBufLen);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取探测器数字增益档位描述信息
/// @param [in] iGainIndex		数字增益档序号
/// @param [in out] pBuffer		描述信息缓冲区指针
/// @param [in] iBufLen			缓冲区长度
/// @note						增益档位序号从0 开始，最大为支持的总数-1
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetDigitalGainDescription(int iGainIndex, char* pBuffer,  int iBufLen);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置采集模式
/// @param [in] aMode			采集模式 
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetAcquisitionMode(NV_AcquisitionMode aMode);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置快门模式	
/// @param [in] sMode			快门模式
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetShutterMode(NV_ShutterMode sMode);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置Binning模式
/// @param [in] bMode			Binning模式
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetBinningMode(NV_BinningMode bMode);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取采集模式
/// @param [out] aMode			采集模式
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetAcquisitionMode(NV_AcquisitionMode *aMode);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取快门模式
/// @param [out] sMode			快门模式
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetShutterMode(NV_ShutterMode *sMode);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取Binning模式
/// @param [out] bMode			Binning模式
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetBinningMode(NV_BinningMode *bMode);

/* WorkControl */

/////////////////////////////////////////////////////////////////////////
/// @brief						设置触发输入是否反向
/// @param [out] bReverse			是否反向
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetTriggerInReversionStatus(bool bReverse);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取触发输入是否反向
/// @param [out] bReverse			是否反向
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetTriggerInReversionStatus(bool * bReverse);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置触发输出是否反向
/// @param [out] bReverse			是否反向
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetTriggerOutReversionStatus(bool bReverse);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取触发输出的反向状态
/// @param [out] bReverse			是否反向
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetTriggerOutReversionStatus(bool * bReverse);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置增益档灵敏度
/// @param [in] iGainIndex			增益档序号
/// @note						增益档位序号从0 开始，最大为支持的总数-1
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetGainEx(int iGainIndex);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置数字增益档
/// @param [in] iGainIndex		增益档序号
/// @note						增益档位序号从0 开始，最大为支持的总数-1
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetDigitalGainEx(int iGainIndex);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置ROI模式图像范围
/// @param [in] offsetX			图像起始列
/// @param [in] offsetY			图像起始行
/// @param [in] width				图像宽
/// @param [in] height				图像高
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetImageRange(int offsetX, int offsetY, int width, int height);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置探测器的积分时间(即X射线出线时间)，单位0.1ms。当AcquisitionMode是CONTINUE、FALLING_EDGE_TRRIGER及RISING_EDGE_TRIGGER时，以该设定值作为Sensor的积分窗口时间
/// @param [in] expTime			探测器的积分时间(即X射线出线时间)
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					v1.3.0.0版之后的SDK不推荐使用该函数，该函数等效于以下两步操作，
///                            使用NV_SetAcqSpeedCtrlMode将控制模式切换为通过曝光时间控制速度
///						    使用NV_SetAcqSpeedCtrlParam配置了参数
NVDENTALDET_API NV_StatusType	NV_SetExpTime(int expTime);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置探测器的采集帧率
/// @param [in] iFPS			采集帧率（会自动根据探测器类型计算探测器的积分时间）
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					v1.3.0.0版之后的SDK不推荐使用该函数，该函数等效于以下两步操作，
///                            使用NV_SetAcqSpeedCtrlMode将控制模式切换为FPS
///						    使用NV_SetAcqSpeedCtrlParam配置了参数
NVDENTALDET_API NV_StatusType	NV_SetFramePerSecond(int iFPS);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置探测器的采集速度控制模式
/// @param [in] eAcqSpeedCtrlMode	控制模式（积分时间和FPS控制）
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetAcqSpeedCtrlMode(NV_AcqSpeedCtrlType eAcqSpeedCtrlMode);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置探测器的采集速度控制参数
/// @param [in] eAcqSpeedCtrlMode	控制参数
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						当控制模式为NV_ACQSPEED_CTRL_EXPTIME时，设置的参数为积分时间，单位为0.1ms
///								当控制模式为NV_ACQSPEED_CTRL_FPS时，设置的参数为帧率，单位为每秒多少张图
NVDENTALDET_API NV_StatusType	NV_SetAcqSpeedCtrlParam(int iParam);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置该序列的最大图像帧数。
/// @param [in] maxFrames		该序列的最大图像帧数。当为0时，不限制图像帧数
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						当maxFrames不为0时，达到最大帧数会自动停止采集。
NVDENTALDET_API NV_StatusType	NV_SetMaxFrames(int maxFrames);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取增益档
/// @param [out] iGainIndex			增益档序号
/// @note						增益档位序号从0 开始，最大为支持的总数-1
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetGainEx(int *iGainIndex);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取数字增益档
/// @param [out] iGainIndex		增益档序号
/// @note						增益档位序号从0 开始，最大为支持的总数-1
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetDigitalGainEx(int *iGainIndex);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取ROI模式图像范围
/// @param [out] offsetX		图像起始列
/// @param [out] offsetY		图像起始行
/// @param [out] width			图像宽
/// @param [out] height			图像高
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetImageRange(int *offsetX, int *offsetY, int *width, int *height);

/////////////////////////////////////////////////////////////////////////
/// @brief					获取探测器的积分时间(即X射线出线时间)，单位0.1ms。当AcquisitionMode是CONTINUE、FALLING_EDGE_TRRIGER及RISING_EDGE_TRIGGER时，以该设定值作为Sensor的积分窗口时间
/// @param [out] expTime		探测器的积分时间(即X射线出线时间)
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					v1.3.0.0版之后，如果当前的采集速度控制模式不是曝光时间控制模式，则会返回失败
NVDENTALDET_API NV_StatusType	NV_GetExpTime(int *expTime);

/////////////////////////////////////////////////////////////////////////
/// @brief					获取探测器的采集帧率
/// @param [out] iFPS			探测器的采集帧率
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					v1.3.0.0版之后，如果当前的采集速度控制模式不是FPS模式，则会返回失败
NVDENTALDET_API NV_StatusType	NV_GetFramePerSecond(int * iFPS);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取探测器的采集速度控制模式
/// @param [out] eAcqSpeedCtrlMode	控制模式（积分时间和FPS控制）
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetAcqSpeedCtrlMode(NV_AcqSpeedCtrlType * eAcqSpeedCtrlMode);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取探测器的采集速度控制参数
/// @param [out] eAcqSpeedCtrlMode	控制参数
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						当控制模式为NV_ACQSPEED_CTRL_EXPTIME时，返回的参数为积分时间，单位为0.1ms
///								当控制模式为NV_ACQSPEED_CTRL_FPS时，返回的参数为帧率，单位为每秒多少张图
NVDENTALDET_API NV_StatusType	NV_GetAcqSpeedCtrlParam(int * iParam);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取该序列的最大图像帧数。
/// @param [out] maxFrames		该序列的最大图像帧数。当为0时，不限制图像帧数
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetMaxFrames(int *maxFrames);

/* Acq */
/////////////////////////////////////////////////////////////////////////
/// @brief						创建采图缓冲区
/// @param [in] imgCount		要缓存的图像总张数
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						调用该函数之前必须确保探测器已经打开，否则会返回失败。
///								如果缓冲区满则覆盖最早的数据，读索引向后移动。
///								不再使用缓冲区时必须调用 @c NV_AcqBufferDestroy()释放。如果之前的缓冲区没有释放，则函数返回失败。
///								如果图像大小改变(改变Binning模式或设置图像宽高)，SDK自动调整到适合图像宽高的缓冲区，缓存的图像总张数不变。
/// @sa @c NV_AcqBufferDestroy()
NVDENTALDET_API NV_StatusType	NV_AcqBufferCreate(unsigned int imgCount);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取采图缓冲区可读图像张数
/// @param [out] readableNum	采图缓冲区可读图像张数
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_AcqBufferReadableNum(unsigned int *readableNum);

/////////////////////////////////////////////////////////////////////////
/// @brief						读取采图缓冲区一张最新图像
/// @param [out] imgInfo			读出的图像内容
/// @param [in] milliseconds		等待读取的时间
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						先进先出，顺序读取，即：最早采集到的图像最先读出。
///								如果有数据被覆盖，读索引会自动向后移动。读到的数据始终是最先进入队列的数据。
///								若设置milliseconds为0，则没有可读数据会立即返回；若设置milliseconds>0，则阻塞milliseconds毫秒直到超时或有数据可读
NVDENTALDET_API NV_StatusType	NV_AcqBufferReadImage(NV_ImageInfo *imgInfo, unsigned long milliseconds = 0);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取已缓存的图像张数总数
/// @retval	NV_StatusCodes		返回状态码图像张数
NVDENTALDET_API int	NV_AcqBufferGetNumFrames();

/////////////////////////////////////////////////////////////////////////
/// @brief						从缓存中获取一张指定的图像 
/// @param [in] index				图像索引
/// @param [in out] frame			图像数据缓冲区指针
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_AcqBufferGetImage(int index, unsigned short *frame);

/////////////////////////////////////////////////////////////////////////
/// @brief						清空采图缓冲区，即全置0
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_AcqBufferClear();

/////////////////////////////////////////////////////////////////////////
/// @brief						释放采图缓冲区
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						该函数负责回收资源。
///								不再使用采图缓冲区时，必须调用该函数，否则会造成内存泄漏。
/// @sa @c NV_AcqBufferCreate()
NVDENTALDET_API NV_StatusType	NV_AcqBufferDestroy();

/////////////////////////////////////////////////////////////////////////
/// @brief						开始采集
/// @param [in] pCallback			采集到达最大帧回调函数
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						该函数创建新线程接收数据，并发送"AcquisitionStart"命令启动采集，然后立即返回。
///								如果MaxFrame不为0，采集到最大帧数时，自动发送"AcquisitionStop"命令停止采集，并回调用户提供的回调函数。
///								采集过程中用户可以自己调用 @c NV_StopAcq()结束采集。
///								SDK提供两种方式获取图像数据：1.设置回调函数 @c NV_SetAcqCallback(); 2.创建缓冲区 @c NV_AcqBufferCreate() @c NV_AcqBufferReadImage()
/// @sa @c NV_StopAcq() @c NV_SetAcqCallback() @c NV_AcqBufferCreate() @c NV_AcqBufferReadImage() ..
NVDENTALDET_API NV_StatusType	NV_StartAcq();			

/////////////////////////////////////////////////////////////////////////
/// @brief						是否正在采集
/// @retval	bool					返回是否正在采集的状态，未采集为false,已采集为true
///								采集过程中用户调用该函数以结束采集。
NVDENTALDET_API bool			NV_IsAcqing();

/////////////////////////////////////////////////////////////////////////
/// @brief						结束采集
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						该函数发送"AcquisitionStop"命令停止采集，并结束 @c NV_StartAcq()创建的接收数据线程。
///								采集过程中用户调用该函数以结束采集。
/// @sa @c NV_StartAcq()
NVDENTALDET_API NV_StatusType	NV_StopAcq();

/* Calibration */

/////////////////////////////////////////////////////////////////////////
/// @brief						启动本底校正线程，读取配置文件进行校正，校正完成后保存并加载本底模板文件，同时外部调用者可使用提供的模板数据，自行保存模板
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						启动新线程后台工作，该函数立刻返回。线程结束时回调通知本底校正是否成功
///								调用该函数之前需要调用 @c NV_ResetCorrection()重置校正使能
/// @sa @c NV_CancelOffsetCal() @c NV_ResetCorrection()
NVDENTALDET_API NV_StatusType	NV_RunOffsetCalThread();

/////////////////////////////////////////////////////////////////////////
/// @brief						取消本底校正
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						本底校正线程会被终止
/// @sa @c NV_RunOffsetCalThread()
NVDENTALDET_API NV_StatusType	NV_CancelOffsetCal();

/// @brief						加载用户保存的本底模板文件
/// @param [in] pTemplateData		增益模板数据
/// @param [in] iTempSize			增益模板大小
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						加载模板之后，将会以加载的模板数据进行校正，之前加载的模板或者加载的本地保存的模板将会失效
/// @note						加载模板之后，依然需要调用NV_SetOffsetCal启用校正功能
/// @note						加载的模板数据必须是对应BINNING模式和增益档位，否则会加载失败
NVDENTALDET_API NV_StatusType	NV_LoadOffsetTemplateData(const char * pTemplateData, int iTempSize);

/// @brief						加载本地保存的本底模板文件
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						加载模板之后，将会以加载的模板数据进行校正，之前加载的模板将会失效
/// @note						加载模板之后，依然需要调用NV_SetOffsetCal启用校正功能
NVDENTALDET_API NV_StatusType	NV_LoadLocalOffsetTemplate();

/////////////////////////////////////////////////////////////////////////
/// @brief						启动增益校正线程，读取配置文件进行校正，校正完成后在本地保存并加载增益模板文件，同时外部调用者可使用提供的模板数据，自行保存模板
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						启动新线程后台工作，该函数立刻返回。线程结束时回调通知增益校正是否成功
///								调用该函数之前需要调用 @c NV_ResetCorrection()重置校正使能
/// @sa @c NV_CancelGainCal() @c NV_ResetCorrection()
NVDENTALDET_API NV_StatusType	NV_RunGainCalThread();

/////////////////////////////////////////////////////////////////////////
/// @brief						取消增益校正
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						增益校正线程会被终止
/// @sa @c NV_RunGainCalThread()
NVDENTALDET_API NV_StatusType	NV_CancelGainCal();

/////////////////////////////////////////////////////////////////////////
/// @brief						启动本底校正线程，读取配置文件进行校正，校正完成后保存本底模板文件
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						启动新线程后台工作，该函数立刻返回。线程结束时回调通知本底校正是否成功
/// @note 当有温度值发生改变时，通过EVENT_CALLBACK通知用户 
///                    EVENT类型:NV_EVENTTYPE_AUTOOFFSETCAL
///                    数据：无
NVDENTALDET_API NV_StatusType	NV_PerformOffsetCal();

/// @brief						加载用户保存的增益模板文件
/// @param [in] pTemplateData		增益模板数据
/// @param [in] iTempSize			增益模板大小
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						加载模板之后，将会以加载的模板数据进行校正，之前加载的模板或者加载的本地保存的模板将会失效
/// @note						加载模板之后，依然需要调用NV_SetGainCal启用校正功能
/// @note						加载的模板数据必须是对应BINNING模式和增益档位，否则会加载失败
NVDENTALDET_API NV_StatusType	NV_LoadGainTemplateData(const char * pTemplateData, int iTempSize);

/// @brief						加载本地保存的增益模板文件
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						加载模板之后，将会以加载的模板数据进行校正，之前加载的模板将会失效
/// @note						加载模板之后，依然需要调用NV_SetGainCal启用校正功能
NVDENTALDET_API NV_StatusType	NV_LoadLocalGainTemplate();

/////////////////////////////////////////////////////////////////////////
/// @brief						启动自动坏点校正线程，读取配置文件进行校正，校正完成后保存自动坏点模板文件
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						启动新线程后台工作，该函数立刻返回。线程结束时回调通知自动坏点校正是否成功
///								调用该函数之前需要调用 @c NV_ResetCorrection()重置校正使能
/// @sa @c NV_ResetCorrection()
NVDENTALDET_API NV_StatusType	NV_RunAutoDefectCalThread();

/////////////////////////////////////////////////////////////////////////
/// @brief					保存手动坏点模板(坏点用非0数表示)
/// @param [in] pixel			手动坏点模板的数据区域
/// @param [in] width			图像宽
/// @param [in] height			图像高
/// @param [in] mode			Binning模式
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SaveManDefectData(const unsigned short* pixel, int width, int height, NV_BinningMode mode);

/////////////////////////////////////////////////////////////////////////
/// @brief					手动添加坏点（在当前的增益和binning模式下添加）
/// @param [in] pixel			手动坏点模板的数据区域
/// @param [in] width			图像宽
/// @param [in] height			图像高
/// @param [in] mode			Binning模式
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SaveManDefectData(const unsigned short* pixel, int width, int height, NV_BinningMode mode);

/* ImageProcessing */

/////////////////////////////////////////////////////////////////////////
/// @brief						设置本底校正使能
/// @param [in] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_SetOffsetCal(NV_CorrType type);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置增益校正使能
/// @param [in] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_SetGainCal(NV_CorrType type);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置坏点校正使能
/// @param [in] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_SetDefectCal(NV_CorrType type);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置水平镜像使能
/// @param [in] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_SetMirrorX(NV_CorrType type);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置垂直镜像使能
/// @param [in] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_SetMirrorY(NV_CorrType type);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置图像反白使能
/// @param [in] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_SetInversion(NV_CorrType type);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置Gamma校正使能
/// @param [in] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_SetDigitalGamma(NV_CorrType type);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置LUT校正使能
/// @param [in] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_SetDigitalLUT(NV_CorrType type);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置图像校正完成后整体的像素灰度偏移量
/// @param [in] imageOffset		整体的像素灰度偏移量，默认为0
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_SetImageOffset(int imageOffset);

/////////////////////////////////////////////////////////////////////////
/// @brief						重置校正使能
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						校正使能全部设为不使能，偏移量设为0，采图范围设为默认值
NVDENTALDET_API NV_StatusType NV_ResetCorrection();

/////////////////////////////////////////////////////////////////////////
/// @brief						获取本底校正使能状态
/// @param [out] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_GetOffsetCal(NV_CorrType *type);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取增益校正使能状态
/// @param [out] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_GetGainCal(NV_CorrType *type);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取坏点校正使能状态
/// @param [out] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_GetDefectCal(NV_CorrType *type);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取水平镜像使能状态
/// @param [out] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_GetMirrorX(NV_CorrType *type);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取垂直镜像使能状态
/// @param [out] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_GetMirrorY(NV_CorrType *type);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取图像反白使能状态
/// @param [out] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_GetInversion(NV_CorrType *type);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取Gamma校正使能状态
/// @param [out] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_GetDigitalGamma(NV_CorrType *type);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取LUT校正使能状态
/// @param [out] type			校正类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_GetDigitalLUT(NV_CorrType *type);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取图像校正完成后整体的像素灰度偏移量
/// @param [out] imageOffset	整体的像素灰度偏移量
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType NV_GetImageOffset(int *imageOffset);

/* SystemStatus  */


/////////////////////////////////////////////////////////////////////////
/// @brief						设置连接断开消息通知超时时间
/// @param [in] iTimeSec		连接断开后消息通知的超时时间，单位秒
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note 超时时间单位秒,范围1sec~30sec,缺省为30sec，超时时间不能够被记录
NVDENTALDET_API NV_StatusType	NV_SetConnbreakTime(int iTimeSec);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取连接断开消息通知超时时间
/// @param [in] iTimeSec		获取到的连接断开后消息通知的超时时间，单位秒
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetConnbreakTime(int * iTimeSec);

/* ErrorMsg	*/

/////////////////////////////////////////////////////////////////////////
/// @brief						获取详细错误信息
/// @param [out] errorMsg		错误信息缓存区
/// @param [in] bufflen			缓存区长度
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
/// @note						如果函数接口返回错误码，用该函数获取详细错误信息
NVDENTALDET_API NV_StatusType	NV_LastErrorMsg(char *errorMsg, unsigned int bufflen);		

/////////////////////////////////////////////////////////////////////////
/// @brief						设置最后一次详细得错误信息
/// @param [in] errorMsg		错误信息缓存区
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetLastErrorMsg(char *errorMsg);		

/* ParamFile */


/////////////////////////////////////////////////////////////////////////
/// @brief						初始化SDK的语言设置
/// @param [in] lang		语言类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_InitLanguage(NV_LANGUAGE &lang);

/////////////////////////////////////////////////////////////////////////
/// @brief						获取当前SDK配置的语言类型
/// @param [in out] lang		语言类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetLanguage(NV_LANGUAGE& lang);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置SDK配置的语言类型
/// @param [in] lang		语言类型
/// @retval	NV_StatusCodes		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetLanguage(NV_LANGUAGE lang);

/////////////////////////////////////////////////////////////////////////
/// @brief					设置SDK与探测器传输数据块大小
/// @param [in] frameType		帧类型
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_SetFrameType(NV_FRAME_TYPE frameType);

/////////////////////////////////////////////////////////////////////////
/// @brief					获取SDK与探测器传输数据块大小
/// @param [out] frameType		帧类型
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType	NV_GetFrameType(NV_FRAME_TYPE * frameType);

/// @brief					获取网卡MTU大小
/// @param [out] iMtuSize		MTU大小
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_GetAdapterMtuSize(int * iMtuSize);

/// @brief					获取网卡理论最大带宽
/// @param [out] iBandwidth	带宽大小（兆字节）
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_GetAdapterBandWidth(int * iBandwidth);

/// @brief					获取通讯协商的包大小
/// @param [out] iPackSize		数据包大小
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_GetCommPackageSize(int * iPackSize);


/// @brief					添加坏点
/// @param [in] pPixelPos		坐标序列首地址
/// @param [in] iCnt			坐标序列个数
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					在当前binning和增益档位下增加一组坏点，如果需要在不同档位下增加，需调用档位切换函数NV_SetBinningMode以及增益切换函数NV_SetGainEx
NVDENTALDET_API NV_StatusType SV_AppendManualDefectPixel(const SV_PixelPos * pPixelPos, int iCnt);

/// @brief					删除坏点
/// @param [in] pPixelPos		坐标序列首地址
/// @param [in] iCnt			坐标序列个数
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					在当前binning和增益档位下删除一组坏点，如果需要在不同档位下增加，需调用档位切换函数NV_SetBinningMode以及增益切换函数NV_SetGainEx
NVDENTALDET_API NV_StatusType SV_RemoveManualDefectPixel(const SV_PixelPos * pPixelPos, int iCnt);

/// @brief					添加坏线
/// @param [in] bHorzLine		是否是水平线
/// @param [in] iIndex			坏线序号，从0开始编号
/// @param [in] mode			binning模式
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					在当前binning和增益档位下增加一条坏线，如果需要在不同档位下增加，需调用档位切换函数NV_SetBinningMode以及增益切换函数NV_SetGainEx
NVDENTALDET_API NV_StatusType SV_AppendManualDefectLine(bool bHorzLine, int iIndex);

/// @brief					删除坏线
/// @param [in] bHorzLine		是否是水平线
/// @param [in] iIndex			坏线序号，从0开始编号
/// @param [in] mode			binning模式
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					在当前binning和增益档位下删除一条坏线，如果需要在不同档位下增加，需调用档位切换函数NV_SetBinningMode以及增益切换函数NV_SetGainEx
NVDENTALDET_API NV_StatusType SV_RemoveManualDefectLine(bool bHorzLine, int iIndex);

/// @brief					获取缺省坏点模板映射图
/// @param [in out] pMapData	模板数据缓冲区
/// @param [in] iMaxSize		外部提供的缓冲区最大长度
/// @param [in out] iRetSize	返回的缓冲数据长度
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					缓存需外部提供，建议使用NV_GetImageRange获取图像尺寸，并使用unsigned short类型，申请获取尺寸的缓冲，用于存放获取的模板数据
NVDENTALDET_API NV_StatusType SV_GetManualDefectTemplateMap(unsigned short * pMapData, int iMaxSize, int * iRetSize);

/// @brief					设置是否自动接受亮场校正结果
/// @param [in] bEanble		是否自动接受亮场校正结果
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_SetAcceptCorrRltAutomaticEnable(bool bEnable);


/// @brief					获取是否自动接受亮场校正结果使能
/// @param [in] bEanble		是否自动接受亮场校正结果
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_GetAcceptCorrRltAutomaticEnable(bool * bEnable);

/// @brief					使能动态暗场校正
/// @param [in] bEanble		是否启用动态暗场校正
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_SetDynamicOffsetCorrectEnable(bool bEnable);

/// @brief					获取动态暗场校正使能状态
/// @param [in] bEanble		查看动态暗场校正的启用状态 
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_GetDynamicOffsetCorrectEnable(bool * bEnable);

/// @brief					使能手动更新动态校正模板
/// @param [in] bEanble		是否手动启动更新动态暗场校正模板
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_SetManualUpdateDOCTEnable(bool bEnable);

/// @brief					获取手动更新动态校正模板的使能状态
/// @param [in] bEanble		查看是否启动了手动更新动态暗场校正模板
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_GetManualUpdateDOCTEnable(bool * bEnable);

/////////////////////////////////////////////////////////////////////////
/// @brief						设置是否启用多帧叠加输出,是否启用运动侦测,同时设置叠加张数，即采集输出的图像为叠加后的图像
/// @param [in] bEnable			是否启用多帧叠加输出
/// @param [in] bMotionDetection是否启用运动侦测
/// @param [in] iMeanCnt		设置叠加张数
/// @retval	bool				返回是否正在采集的状态，未采集为false,已采集为true
///								采集过程中用户调用该函数以结束采集。
/// @note						可在采集过程中或者采集前进行设置
NVDENTALDET_API NV_StatusType	SV_SetMeanFrameOutputEnable(bool bEnable, bool bMotionDetection, int iMeanCnt) ;

/////////////////////////////////////////////////////////////////////////
/// @brief						获取是否启用多帧叠加输出,是否启用运动侦测,同时设置叠加张数，即采集输出的图像为叠加后的图像
/// @param [in] bEnable			是否启用多帧叠加输出
/// @param [in] bMotionDetection 是否启用运动侦测
/// @param [in] iMeanCnt		设置叠加张数	
/// @retval	bool				返回是否正在采集的状态，未采集为false,已采集为true
///								采集过程中用户调用该函数以结束采集。
/// @note						可在采集过程中或者采集前进行设置
NVDENTALDET_API NV_StatusType	SV_GetMeanFrameOutputEnable(bool * bEnable, bool * bMotionDetection, int * iMeanCnt) ;

/// @brief								设置图像传输模式
/// @param [in] HDET				探测器句柄,由NV_CreateDetectorInstance函数创建
/// @param [in] eTransMode		图像传输方式
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note SV_DTMODE_CT：CT传输模式：在有限缓存下，尽可能保证图像完整。（在传输链路信号质量差时，帧率波动以及图像传输延迟较大，推荐单次有限张数图像采集场景）
/// @note SV_DTMODE_XR：二维X光摄影传输模式：丢弃丢包严重的图像，保证图像采集的实时性。（在传输链路信号质量差时，帧率波动以及图像传输延迟较小，推荐实时性有要求的连续采集场景）
NVDENTALDET_API NV_StatusType SV_SetDataTransMode(SV_DATATRANS_MODE eTransMode);

/// @brief								获取图像传输模式
/// @param [in] HDET				探测器句柄,由NV_CreateDetectorInstance函数创建
/// @param [in out] eTransMode		图像传输方式
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note SV_DTMODE_CT：CT传输模式：在有限缓存下，尽可能保证图像完整。（在传输链路信号质量差时，帧率波动以及图像传输延迟较大，推荐单次有限张数图像采集场景）
/// @note SV_DTMODE_XR：二维X光摄影传输模式：丢弃丢包严重的图像，保证图像采集的实时性。（在传输链路信号质量差时，帧率波动以及图像传输延迟较小，推荐实时性有要求的连续采集场景）
NVDENTALDET_API NV_StatusType SV_GetDataTransMode(SV_DATATRANS_MODE * eTransMode);

/// @brief						设置DSA模式触发使能
/// @param [in] bEnable			true 打开使能 false 关闭使能
/// @retval	NV_StatusType		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_SetDSATrigger(bool bEnable);

/// @brief						获取DSA模式触发使能
/// @param [out] bEnable			true 打开使能 false 关闭使能
/// @retval	NV_StatusType		返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_GetDSATrigger(bool * bEnable);


/// @brief					获取日志储存的绝对路径
/// @param [in out] pPath	获取储存路径的缓冲
/// @param [in] pPath		储存路径的缓冲大小
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
NVDENTALDET_API NV_StatusType SV_GetLogStoragePath(char * pPathBuf, int iPathSize);

/// @brief					设置日志储存的绝对路径
/// @param [in] pPath		设置储存路径的缓冲
/// @param [in] pPath		储存路径的缓冲大小
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					在所有接口调用前调用
/// @note					调用接口时，请确保设置日志的绝对路径（pPath）已经存在，否则将会使用默认路径
NVDENTALDET_API NV_StatusType SV_SetLogStoragePath(const char * pPath, int iPathSize);

/// @brief					获取日志文件在本地储存的天数
/// @param [in out] iDay	获取本地储存的天数
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					过期的日志自动清除
NVDENTALDET_API NV_StatusType SV_GetLogStorageDay(int * iDay);

/// @brief					设置日志文件在本地储存的天数
/// @param [in] iDay		设置本地储存的天数
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					在所有接口调用前调用
/// @note					过期的日志自动清除
NVDENTALDET_API NV_StatusType SV_SetLogStorageDay(int iDay);

/// @brief					获取日志储存的类型限制
/// @param [in] iType		获取储存类型的组合值
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					将获取的组合值与类型列表LOG_MSG_TYPE中的值&运算，结果值为类型本身表示该项开启，值为0表示该项关闭
/// @note					示例：((iType & LOG_MSG_INFO) == LOG_MSG_INFO ?) "开启" : "关闭"
NVDENTALDET_API NV_StatusType SV_GetLogStorageType(int * iType);

/// @brief					设置日志文件在本地储存的天数
/// @param [in] iType		设置储存类型的组合值
/// @retval	NV_StatusCodes	返回状态码，若成功则返回NV_SC_SUCCESS
/// @note					在所有接口调用前调用
/// @note					将类型列表LOG_MSG_TYPE中需要开启日志记录的值进行 | 运算得到组合值，
/// @note					示例：SV_SetLogStorageType(LOG_MSG_INFO | LOG_MSG_WARNING); 开启LOG_MSG_INFO与LOG_MSG_WARNING的记录，其它关闭
NVDENTALDET_API NV_StatusType SV_SetLogStorageType(int iType);


#ifdef __cplusplus
}
#endif


#endif	//NVDENTALDET_H