资讯详情

em120.gige.h

#ifndef MVGIGE_H_INCLUDE_ #define MVGIGE_H_INCLUDE_  #ifdef MVGIGE_EXPORTS #define MVGIGE_API __declspec(dllexport) #else #define MVGIGE_API __declspec(dllimport) #endif  #include "GigECamera_Types.h"  #define MSG_ID_LOST 0x1 //!< 消息ID，相机断开 #define MSG_ID_RECONNECT 0x2 //!< 消息ID，相机重新连接  #ifdef _MSC_VER #include "MVimage.h" #else typedef void* HANDLE; typedef unsigned int UINT; #define FALSE 0 #define TRUE 1 #endif   #ifdef __cplusplus extern "C" { 
        #endif   /*! * \brief 初始化函数库。在调用所有函数之前。 * \retval MVST_SUCCESS : 成功 */  MVGIGE_API MVSTATUS_CODES __stdcall MVInitLib(); /*! * \brief 退出函数库。在程序退出前调用，以释放资源。 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVTerminateLib(); /*! * \brief 查找连接到计算机上的相机 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVUpdateCameraList(); /*! * \brief 获取连接到计算机上的相机的数量 * \param [out] pNumCams 相机数量 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetNumOfCameras(int* pNumCams); /*! * \brief 得到第idx个相机的信息。 * \param [in] idx idx从0开始，按照相机的IP地址排序，地址小的排在前面。 * \param [out] pCamInfo 相机的信息 (IP,MAC,SN,型号...) * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetCameraInfo(unsigned char idx, MVCamInfo* pCamInfo); /*! * \brief 打开第idx个相机 * \param [in] idx idx从0开始，按照相机的IP地址排序，地址小的排在前面。 * \param [out] hCam 如果成功,返回的相机句柄 * \retval MVST_INVALID_PARAMETER : idx取值不对 * MVST_ACCESS_DENIED : 相机无法访问，可能正被别的软件控制 * MVST_ERROR : 其他错误 * MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVOpenCamByIndex(unsigned char idx, HANDLE* hCam); /*! * \brief 打开指定UserDefinedName的相机 * \param [in] name UserDefinedName。 * \param [out] hCam 如果成功,返回的相机句柄。如果失败，为NULL。 * \retval * MVST_ACCESS_DENIED : 相机无法访问，可能正被别的软件控制 * MVST_ERROR : 其他错误 * MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVOpenCamByUserDefinedName(char* name, HANDLE* hCam); /*! * \brief 打开指定IP的相机 * \param [in] ip 相机的IP地址。 * \param [out] hCam 如果成功,返回的相机句柄。如果失败，为NULL。 * \retval * MVST_ACCESS_DENIED : 相机无法访问，可能正被别的软件控制 * MVST_ERROR : 其他错误 * MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVOpenCamByIP( char *ip,HANDLE *hCam ); /*! * \brief 关闭相机。断开和相机的连接。 * \param [in] hCam 相机的句柄 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVCloseCam(HANDLE hCam); MVGIGE_API MVSTATUS_CODES __stdcall MVGetDeviceVersion(HANDLE hCam, char* pData, int size); MVGIGE_API MVSTATUS_CODES __stdcall MVGetDeviceFirmwareVersion(HANDLE hCam, char* pData, int size); /*! * \brief 读取图像宽度 * \param [in] hCam 相机句柄 * \param [out] pWidth 图像宽度[像素] * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetWidth(HANDLE hCam, int* pWidth); /*! * \brief 读取图像宽度可设置的范围 * \param [in] hCam 相机句柄 * \param [out] pWidthMin 图像宽度可设置的最小值 * \param [out] pWidthMax 图像宽度可设置的最大值 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetWidthRange(HANDLE hCam, int* pWidthMin, int* pWidthMax); /*! * \brief 读取图像宽度调整的步长 * \param [in] hCam 相机句柄 * \param [out] pWidthInc 图像宽度的调整的步长，即图像的宽度 = 最小宽度 + 步长 x 整数 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetWidthInc(HANDLE hCam, int* pWidthInc); /*! * \brief 设置图像的宽度 * \param [in] hCam 相机句柄 * \param [in] nWidth 图像宽度，应该在宽度可设置范围之内，并且 = 最小宽度 + 步长 x 整数 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetWidth(HANDLE hCam, int nWidth); /*! * \brief 读取图像高度 * \param [in] hCam 相机句柄 * \param [out] pHeight 图像高度[像素] * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetHeight(HANDLE hCam, int* pHeight); /*! * \brief 读取图像高度可设置的范围 * \param [in] hCam 相机句柄 * \param [out] pHeightMin 图像高度可设置的最小值 * \param [out] pHeightMax 图像高度可设置的最大值 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetHeightRange(HANDLE hCam, int* pHeightMin, int* pHeightMax); /*! * \brief 设置图像的高度 * \param [in] hCam 相机句柄 * \param [in] nHeight 图像高度，应该在高度可设置范围之内 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetHeight(HANDLE hCam, int nHeight); /*! * \brief 读取水平方向偏移量。图像宽度设置到小于最大宽度时，可以调整水平偏移量，设置采集窗口的水平起始位置。 * \param [in] hCam * \param [out] pOffsetX 水平偏移量 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetOffsetX(HANDLE hCam, int* pOffsetX); /*! * \brief 读取水平方向偏移量取值范围。 * \param [in] hCam * \param [out] pOffsetXMin 水平偏移量最小值 * \param [out] pOffsetXMax 水平偏移量最大值 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetOffsetXRange(HANDLE hCam, int* pOffsetXMin, int* pOffsetXMax); /*! * \brief 设置水平方向偏移量。图像宽度设置到小于最大宽度时，可以调整水平偏移量，设置采集窗口的水平起始位置。 * \param [in] hCam * \param [in] nOffsetX 水平偏移量。应该在水平偏移量允许的范围之内。 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetOffsetX(HANDLE hCam, int nOffsetX); /*! * \brief 读取垂直方向偏移量。图像宽度设置到小于最大宽度时，可以调整垂直偏移量，设置采集窗口的垂直起始位置。 * \param [in] hCam * \param [out] pOffsetY 垂直偏移量 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetOffsetY(HANDLE hCam, int* pOffsetY); /*! * \brief 读取垂直方向偏移量取值范围。 * \param [in] hCam * \param [out] pOffsetYMin 垂直偏移量最小值 * \param [out] pOffsetYMax 垂直偏移量最大值 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetOffsetYRange(HANDLE hCam, int* pOffsetYMin, int* pOffsetYMax); /*! * \brief 设置垂直方向偏移量。图像宽度设置到小于最大宽度时，可以调整垂直偏移量，设置采集窗口的垂直起始位置。 * \param [in] hCam * \param [in] nOffsetY 垂直偏移量。应该在垂直偏移量允许的范围之内。 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetOffsetY(HANDLE hCam, int nOffsetY); /*! * \brief 读取图像的像素格式 * \param [in] hCam 相机句柄 * \param [out] pPixelFormat * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetPixelFormat(HANDLE hCam, MV_PixelFormatEnums* pPixelFormat); /*! * \brief 设置图像的像素格式 * \param [in] hCam 相机句柄 * \param [out] PixelFormat * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetPixelFormat( HANDLE hCam,MV_PixelFormatEnums PixelFormat ); /*! * \brief 读取传感器的通道数 * \param [in] hCam 相机句柄 * \param [out] pSensorTaps * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetSensorTaps(HANDLE hCam, SensorTapsEnums* pSensorTaps); /*! * \brief 读取当前增益值 * \param [in] hCam 相机句柄 * \param [out] pGain * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetGain(HANDLE hCam, double* pGain); /*! * \brief 读取增益可以设置的范围 * \param [in] hCam 相机句柄 * \param [out] pGainMin 最小值 * \param [out] pGainMax 最大值 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetGainRange(HANDLE hCam, double* pGainMin, double* pGainMax); /*! * \brief 设置增益 * \param [in] hCam 相机句柄 * \param [in] fGain 增益 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetGain(HANDLE hCam, double fGain); /*! * \brief 当相机传感器为多通道时，设置某个通道的增益 * \param [in] hCam 相机句柄 * \param [in] fGain 增益 * \param [in] nTap 通道。双通道[0,1],四通道[0,1,2,3] * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetGainTaps(HANDLE hCam, double fGain, int nTap); /*! * \brief 当相机传感器为多通道时，读取某个通道的增益 * \param [in] hCam 相机句柄 * \param [out] pGain * \param [in] nTap 通道。双通道[0,1],四通道[0,1,2,3] * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetGainTaps(HANDLE hCam, double* pGain, int nTap); /*! * \brief 当相机传感器为多通道时，读取某个通道的增益可设置的范围 * \param [in] hCam 相机句柄 * \param [out] pGainMin 增益最小值 * \param [out] pGainMax 增益最大值 * \param [in] nTap 通道。双通道[0,1],四通道[0,1,2,3] * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetGainRangeTaps(HANDLE hCam, double* pGainMin, double* pGainMax, int nTap); /*! * \brief 读取当前白平衡系数 * \param [in] hCam 相机句柄 * \param [out] pRed 红色平衡系数 * \param [out] pGreen 绿色平衡系数 * \param [out] pBlue 蓝色平衡系数 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetWhiteBalance(HANDLE hCam, double* pRed, double* pGreen, double* pBlue); /*! * \brief 读取白平衡设置的范围 * \param [in] hCam 相机句柄 * \param [out] pMin 系数最小值 * \param [out] pMax 系数最大值 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetWhiteBalanceRange(HANDLE hCam, double* pMin, double* pMax); /*! * \brief 设置白平衡系数 * \param [in] hCam 相机句柄 * \param [in] fRed 红色平衡系数 * \param [in] fGreen 绿色平衡系数 * \param [in] fBlue 蓝色平衡系数 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetWhiteBalance(HANDLE hCam, double fRed, double fGreen, double fBlue); /*! * \brief 读取是否通道自动平衡 * \param [in] hCam 相机句柄 * \param [out] pBalance 是否自动平衡 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetGainBalance(HANDLE hCam, int* pBalance); /*! * \brief 设置是否自动通道平衡 * \param [in] hCam 相机句柄 * \param [in] nBalance 是否自动通道平衡 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetGainBalance(HANDLE hCam, int nBalance); /*! * \brief 读取当前曝光时间 * \param [in] hCam * \param [in] pExposuretime 单位us * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetExposureTime(HANDLE hCam, double* pExposuretime); /*! * \brief 读取曝光时间的设置范围 * \param [in] hCam 相机句柄 * \param [out] pExpMin 最短曝光时间 单位为us * \param [out] pExpMax 最长曝光时间 单位为us * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetExposureTimeRange(HANDLE hCam, double* pExpMin, double* pExpMax); /*! * \brief 设置曝光时间 * \param [in] hCam 相机句柄 * \param [in] nExp_us 曝光时间 单位为us * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetExposureTime(HANDLE hCam,double nExp_us); /*! * \brief 读取帧率可设置的范围 * \param [in] hCam 相机句柄 * \param [out] pFpsMin 最低帧率 * \param [out] pFpsMax 最高帧率 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetFrameRateRange(HANDLE hCam, double* pFpsMin, double* pFpsMax); /*! * \brief 读取当前帧率 * \param [in] hCam 相机句柄 * \param [out] fFPS 帧率 帧/秒 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetFrameRate(HANDLE hCam, double* fFPS); /*! * \brief 设置帧率 * \param [in] hCam 相机句柄 * \param [in] fps 帧率 帧/秒 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetFrameRate(HANDLE hCam, double fps); /*! * \brief 开始采集图像 * \param [in] hCam 相机句柄 * \param [in] StreamCB 回调函数指针 * \param [in] nUserVal 用户数据，传递到回调函数的形参 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVStartGrab(HANDLE hCam, MVStreamCB StreamCB, ULONG_PTR nUserVal); /*! * \brief 停止采集图像 * \param [in] hCam 相机句柄 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVStopGrab(HANDLE hCam); /*! * \brief 读取触发模式 * \param [in] hCam 相机句柄 * \param [out] pMode 触发模式 TriggerMode_Off,TriggerMode_On * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetTriggerMode(HANDLE hCam, TriggerModeEnums* pMode); /*! * \brief 设置触发模式 * \param [in] hCam 相机句柄 * \param [in] mode 触发模式 TriggerMode_Off：相机工作在连续采集模式， TriggerMode_On:相机工作在触发模式，需要有外触发信号或软触发指令才拍摄 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetTriggerMode(HANDLE hCam, TriggerModeEnums mode); /*! * \brief 读取触发源 * \param [in] hCam 相机句柄 * \param [out] pSource 触发源，软触发或外触发 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetTriggerSource(HANDLE hCam, TriggerSourceEnums* pSource); /*! * \brief 设置触发源 * \param [in] hCam 相机句柄 * \param [in] source 触发源 TriggerSource_Software：通过\c MVTriggerSoftware()函数触发。 TriggerSource_Line1：通过连接的触发线触发。 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetTriggerSource(HANDLE hCam, TriggerSourceEnums source); /*! * \brief 读取触发极性 * \param [in] hCam 相机句柄 * \param [out] pAct TriggerActivation_RisingEdge: 上升沿触发 TriggerActivation_FallingEdge: 下降沿触发 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetTriggerActivation(HANDLE hCam, TriggerActivationEnums* pAct); /*! * \brief 当使用触发线触发时,设置是上升沿触发还是下降沿触发 * \param [in] hCam * \param [in] act 上升沿或下降沿 TriggerActivation_RisingEdge: 上升沿触发 TriggerActivation_FallingEdge: 下降沿触发 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetTriggerActivation(HANDLE hCam, TriggerActivationEnums act); /*! * \brief 读取触发延时 * \param [in] hCam 相机句柄 * \param [out] pDelay_us 触发延时,单位us * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetTriggerDelay(HANDLE hCam, uint32_t* pDelay_us); /*! * \brief 读取触发延时范围 * \param [in] hCam 相机句柄 * \param [out] pMin 触发延时最小值,单位us * \param [out] pMax 触发延时最大值,单位us * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetTriggerDelayRange(HANDLE hCam, uint32_t* pMin, uint32_t* pMax); /*! * \brief 设置相机接到触发信号后延迟多少微秒后再开始曝光。 * \param [in] hCam 相机句柄 * \param [in] nDelay_us * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetTriggerDelay(HANDLE hCam, uint32_t nDelay_us); /*! * \brief 发出软件触发指令 * \param [in] hCam 相机句柄 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVTriggerSoftware(HANDLE hCam); /*! * \brief 读取闪光同步信号源 * \param [in] hCam 相机句柄 * \param [out] pSource 闪光同步信号源 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetStrobeSource(HANDLE hCam, LineSourceEnums* pSource); /*! * \brief 闪光同步信号源 * \param [in] hCam * \param [in] source LineSource_Off：关闭闪光同步 LineSource_ExposureActive：曝光的同时闪光 LineSource_Timer1Active：由定时器控制 LineSource_UserOutput0：由用户通过指令控制 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetStrobeSource(HANDLE hCam, LineSourceEnums source); /*! * \brief 读取闪光同步是否反转 * \param [in] hCam 相机句柄 * \param [out] pInvert * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetStrobeInvert(HANDLE hCam, bool* pInvert); /*! * \brief 闪光同步是否反转，即闪光同步有效时输出高电平还是低电平。 * \param [in] hCam 相机句柄 * \param [in] bInvert * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetStrobeInvert(HANDLE hCam, bool bInvert); /*! * \brief 读取用户设置的闪光同步 * \param [in] hCam 相机句柄 * \param [out] pSet * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetUserOutputValue0(HANDLE hCam, bool* pSet); /*! * \brief 当闪光同步源选为UserOutput时 主机可以通过MVSetUserOutputValue0来控制闪光同步输出高电平或低电平。 * \param [in] hCam 相机句柄 * \param [in] bSet 设置电平 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetUserOutputValue0(HANDLE hCam, bool bSet); /*! * \brief 设置心跳超时时间 * \param [in] hCam 相机句柄 * \param [in] nTimeOut 心跳超时时间 单位ms * \retval MVST_SUCCESS : 成功 * \note 应用程序打开相机后，正常情况下会去关闭相机。但有时程序会意外中断，没有正常关闭相机。 * 这种情况下相机就无法再次打开了（相机认为还在被原来软件控制着）。 * 因此设计了heartbeat，应用程序无论是否在采集图像，每隔一定时间(一般是1000ms)都要去访问一下相机。 * 当超过HeartbeatTimeout时间没有来自应用程序的访问，相机就认为应用程序中断了，会自动关闭原有连接， * 以迎接新的连接。 * 定时访问相机的操作在SDK内部已经实现。编程时无需再次实现。 * 在设置断点调试程序时，可以将nTimeOut设置长一些，否则相机会自动关闭连接。 * Release状态下设置短一些(3000ms),否则应用程序意外退出时，相机会长时间无法重新打开。 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetHeartbeatTimeout(HANDLE hCam, unsigned long nTimeOut);//unit ms /*! * \brief 读取网络数据包大小 * \param [in] hCam 相机句柄 * \param [out] pPacketSize 数据包大小 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetPacketSize(HANDLE hCam, unsigned int* pPacketSize); /*! * \brief 读取网络数据包大小的范围。 * \param [in] hCam 相机句柄 * \param [out] pMin 网络数据包最小值 * \param [out] pMax 网络数据包最大值 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetPacketSizeRange(HANDLE hCam, unsigned int* pMin, unsigned int* pMax); /*! * \brief 设置网络数据包的大小。 * \param [in] hCam 相机句柄 * \param [in] nPacketSize 网络数据包大小(单位:字节)。该大小必须小于网卡能够支持的最大巨型帧(Jumbo Frame)。 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetPacketSize(HANDLE hCam, unsigned int nPacketSize); /*! * \brief 读取网络数据包间隔。 * \param [in] hCam 相机句柄 * \param [out] pDelay_us 数据包间隔时间，单位us * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetPacketDelay(HANDLE hCam, unsigned int* pDelay_us); /*! * \brief 读取网络数据包间隔范围 * \param [in] hCam 相机句柄 * \param [out] pMin 数据包间隔时间最小值，单位us * \param [out] pMax 数据包间隔时间最大值，单位us * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetPacketDelayRange(HANDLE hCam, unsigned int* pMin, unsigned int* pMax); /*! * \brief 设置网络数据包之间的时间间隔。如果网卡或电脑的性能欠佳，无法处理高速到达的数据包，会导致丢失数据包， 从而使图像不完整。可以通过增加数据包之间的时间间隔以保证图像传输。但是增加该值将增加图像的时间延迟， 并有可能影像到帧率。 * \param [in] hCam * \param [in] nDelay_us 时间间隔(单位:微秒) * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetPacketDelay(HANDLE hCam, unsigned int nDelay_us); /*! * \brief 读取定时器延时 * \param [in] hCam 相机句柄 * \param [out] pDelay 定时器延时 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetTimerDelay(HANDLE hCam, uint32_t* pDelay); /*! * \brief 读取定时器延时的范围 * \param [in] hCam 相机句柄 * \param [out] pMin 定时器延时的最小值 * \param [out] pMax 定时器延时的最大值 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetTimerDelayRange(HANDLE hCam, uint32_t* pMin, uint32_t* pMax); /*! * \brief 当闪光同步源选为Timer1时MVSetStobeSource(hCam,LineSource_Timer1Active) 设置Timer1在接到触发信号后延迟多少us开始计时 * \param [in] hCam 相机句柄 * \param [in] nDelay 接到触发信号后延迟多少us开始计时 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetTimerDelay(HANDLE hCam, uint32_t nDelay); /*! * \brief 读取定时器计时时长 * \param [in] hCam 相机句柄 * \param [out] pDuration 定时器计时时长 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetTimerDuration(HANDLE hCam, uint32_t* pDuration); /*! * \brief 读取定时器计时时长取值范围 * \param [in] hCam 相机句柄 * \param [out] pMin 定时器计时时长最小值 * \param [out] pMax 定时器计时时长最大值 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetTimerDurationRange(HANDLE hCam, uint32_t* pMin, uint32_t* pMax); /*! * \brief 当闪光同步源选为Timer1时MVSetStobeSource(hCam,LineSource_Timer1Active) 设置Timer1在开始计时后，计时多长时间。 * \param [in] hCam * \param [in] nDuration 设置Timer1在开始计时后，计时多长时间(us)。即输出高/低电平的脉冲宽度。 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetTimerDuration(HANDLE hCam, uint32_t nDuration); /*! * \brief 将Bayer格式的8bit单通道图转换为BGR格式的8Bit三通道图 * \param [in] hCam 相机句柄 * \param [in] psrc 单通道图像的指针 * \param [out] pdst 三通道图像指针 * \param [in] dststep 三通道图像一行图像的字节数。通常为图像宽度*3，但是会为了4字节对齐会补几个字节。 * \param [in] width 图像宽度 * \param [in] height 图像高度 * \param [in] pixelformat 像素格式，由MVGetPixelFormat取得 * \param [in] bMultiCores 是否使用CPU多核计算 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVBayerToBGR(HANDLE hCam, void *psrc,void *pdst,unsigned int dststep,unsigned int width,unsigned int height,MV_PixelFormatEnums pixelformat,bool bMultiCores=FALSE); /*! * \brief 将Bayer格式的16bit单通道图转换为BGR格式的16Bit三通道图 * \param [in] hCam 相机句柄 * \param [in] psrc 单通道图像的指针 * \param [out] pdst 三通道图像指针 * \param [in] dststep 三通道图像一行图像的字节数。 * \param [in] width 图像宽度 * \param [in] height 图像高度 * \param [in] pixelformat 像素格式，由MVGetPixelFormat取得 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVBayerToBGR16(HANDLE hCam, void *psrc,void *pdst,unsigned int dststep,unsigned int width,unsigned int height,MV_PixelFormatEnums pixelformat ); /*! * \brief 将Bayer格式的8bit单通道图转换为RGB格式的8Bit三通道图 * \param [in] hCam 相机句柄 * \param [in] psrc 单通道图像的指针 * \param [out] pdst 三通道图像指针 * \param [in] dststep 三通道图像一行图像的字节数。通常为图像宽度*3，但是会为了4字节对齐会补几个字节。 * \param [in] width 图像宽度 * \param [in] height 图像高度 * \param [in] pixelformat 像素格式，由MVGetPixelFormat取得 * \param [in] bMultiCores 是否使用CPU多核计算 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVBayerToRGB(HANDLE hCam, void *psrc,void *pdst,unsigned int dststep,unsigned int width,unsigned int height,MV_PixelFormatEnums pixelformat,bool bMultiCores=FALSE); /*! * \brief 将Bayer格式的16bit单通道图转换为RGB格式的16Bit三通道图 * \param [in] hCam 相机句柄 * \param [in] psrc 单通道图像的指针 * \param [out] pdst 三通道图像指针 * \param [in] dststep 三通道图像一行图像的字节数。 * \param [in] width 图像宽度 * \param [in] height 图像高度 * \param [in] pixelformat 像素格式，由MVGetPixelFormat取得 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVBayerToRGB16(HANDLE hCam, void *psrc,void *pdst,unsigned int dststep,unsigned int width,unsigned int height,MV_PixelFormatEnums pixelformat ); #ifdef _MSC_VER /*! * \brief 将Bayer格式的8bit单通道图转换为BGR格式的8Bit三通道图 * \param [in] hCam 相机句柄 * \param [in] pInfo 采集Callback函数中传来的图像信息指针 * \param [out] pImage 转换结果图像的指针 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVImageBayerToBGR(HANDLE hCam, MV_IMAGE_INFO* pInfo, MVImage* pImage); /*! * \brief 将回调函数收到的图像信息转换为图像。 * \param [in] hCam 相机句柄 * \param [in] pInfo 采集Callback函数中传来的图像信息指针 * \param [out] pImage 转换结果图像的指针 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVInfo2Image(HANDLE hCam, MV_IMAGE_INFO* pInfo, MVImage* pImage); /*! * \brief 将Bayer格式的8bit单通道图转换为BGR格式的8Bit三通道图,同时调整图像的GAMMA,颜色和反差 * \param [in] hCam 相机句柄 * \param [in] pInfo 采集Callback函数中传来的图像信息指针 * \param [out] pImage 转换结果图像的指针 * \param [in] fGamma Gamma校正值，1为不校正，<1时，将暗部提升。 * \param [in] bColorCorrect 是否进行颜色校正，进行颜色校正后，图像会变得更鲜艳。 * \param [in] nContrast 是否调整反差，范围为0－50，当该值大于0时，图像反差会更强。 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVImageBayerToBGREx( HANDLE hCam,MV_IMAGE_INFO *pInfo,MVImage *pImage,double fGamma,bool bColorCorrect,int nContrast ); /*! * \brief BGR格式三通道图像缩放 * \param [in] hCam 相机句柄 * \param [in] pSrc 源图像指针 * \param [in] srcWidth 源图像宽度 * \param [in] srcHeight 源图像高度 * \param [out] pDst 缩放后图像指针 * \param [in] fFactorX 缩放比例 * \param [in] fFactorY 缩放比例 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVZoomImageBGR(HANDLE hCam, unsigned char* pSrc, int srcWidth, int srcHeight, unsigned char* pDst, double fFactorX, double fFactorY); #else MVGIGE_API MVSTATUS_CODES __stdcall MVImageBayerToBGR(HANDLE hCam, MV_IMAGE_INFO* pInfo, void* pImage); MVGIGE_API MVSTATUS_CODES __stdcall MVInfo2Image(HANDLE hCam, MV_IMAGE_INFO* pInfo, void* pImage); #endif /*! * \brief 获取数据传输的统计信息 * \param [in] hCam 相机句柄 * \param [out] pStatistic 统计信息 * \retval JMVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetStreamStatistic(HANDLE hCam, MVStreamStatistic* pStatistic); /*! * \brief 读取并应用某组用户预设的参数 * \param [in] hCam 相机句柄 * \param [in] userset * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVLoadUserSet(HANDLE hCam, UserSetSelectorEnums userset); /*! * \brief 将当前相机的参数保存到用户设置中。 * \param [in] hCam 相机句柄 * \param [in] userset * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSaveUserSet(HANDLE hCam, UserSetSelectorEnums userset); /*! * \brief 设置相机上电开机时默认读取并应用哪一组用户设置 * \param [in] hCam 相机句柄 * \param [in] userset * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVSetDefaultUserSet(HANDLE hCam, UserSetSelectorEnums userset); /*! * \brief 读取相机上电开机时默认读取并应用哪一组用户设置 * \param [in] hCam 相机句柄 * \param [out] pUserset 用户设置 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVGetDefaultUserSet(HANDLE hCam, UserSetSelectorEnums* pUserset); #ifdef _MSC_VER /*! * \brief 图像翻转 * \param [in] hCam 相机句柄 * \param [in] pSrcImage 源图像指针 * \param [out] pDstImage 结果图像指针。如果为NULL，则翻转的结果还在源图像内。 * \param [in] flipType 翻转类型。FlipHorizontal:左右翻转,FlipVertical:上下翻转,FlipBoth:旋转180度 * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVImageFlip(HANDLE hCam, MVImage* pSrcImage, MVImage* pDstImage, ImageFlipType flipType); /*! * \brief 图像旋转 * \param [in] hCam 相机句柄 * \param [in] pSrcImage 源图像指针 * \param [out] pDstImage 结果图像指针,不能为NULL。结果图像的宽度和高度应该和源图像的宽度和高度互换。 * \param [in] roateType 旋转类型：Rotate90DegCw, Rotate90DegCcw * \retval MVST_SUCCESS : 成功 */ MVGIGE_API MVSTATUS_CODES __stdcall MVImageRotate(HANDLE hCam, MVImage* pSrcImage, MVImage*

标签： f37h影像传感器

锐单商城拥有海量元器件数据手册、 IC替代型号，打造 电子元器件IC百科大全！

锐单商城 - 一站式电子元器件采购平台