#ifndef _MV_CAMERA_CTRL_H_ #define _MV_CAMERA_CTRL_H_ #include "MvErrorDefine.h" #include "CameraParams.h" /** * @brief 动态库导入导出定义 */ #ifndef MV_CAMCTRL_API #if (defined (_WIN32) || defined(WIN64)) #if defined(MV_CAMCTRL_EXPORTS) #define MV_CAMCTRL_API __declspec(dllexport) #else #define MV_CAMCTRL_API __declspec(dllimport) #endif #else #ifndef __stdcall #define __stdcall #endif #ifndef MV_CAMCTRL_API #define MV_CAMCTRL_API #endif #endif #endif #ifndef IN #define IN #endif #ifndef OUT #define OUT #endif #ifdef __cplusplus extern "C" { #endif /************************************************************************/ /* 相机的基本指令和操作 */ /************************************************************************/ /************************************************************************ * @fn MV_CC_GetSDKVersion() * @brief 获取SDK版本号 * @param * @return 始终返回4字节版本号 |主 |次 |修正 | 测试| 8bits 8bits 8bits 8bits ************************************************************************/ MV_CAMCTRL_API unsigned int __stdcall MV_CC_GetSDKVersion(); /************************************************************************ * @fn MV_CC_EnumerateTls() * @brief 获取支持的传输层 * @return 支持的传输层编号 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_EnumerateTls(); /************************************************************************ * @fn MV_CC_EnumDevices() * @brief 枚举设备 * @param nTLayerType [IN] 枚举传输层 * @param pstDevList [OUT] 设备列表 * @return 成功，返回MV_OK；错误，返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_EnumDevices(IN unsigned int nTLayerType, IN OUT MV_CC_DEVICE_INFO_LIST* pstDevList); /************************************************************************ * @fn MV_CC_IsDeviceAccessible() * @brief 设备是否可达 * @param pstDevInfo [IN] 设备信息结构体 * @param nAccessMode [IN] 访问权限 * @return 可达，返回true；不可达，返回false ************************************************************************/ MV_CAMCTRL_API bool __stdcall MV_CC_IsDeviceAccessible(IN MV_CC_DEVICE_INFO* pstDevInfo, IN unsigned int nAccessMode); /************************************************************************ * @fn MV_CC_CreateHandle() * @brief 创建设备句柄 * @param handle [OUT] 句柄地址 * @param pstDevInfo [IN] 设备信息结构体 * @return 成功，返回MV_OK；错误，返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_CreateHandle(OUT void ** handle, IN const MV_CC_DEVICE_INFO* pstDevInfo); /************************************************************************ * @fn MV_CC_DestroyHandle() * @brief 销毁设备句柄 * @param handle [IN] 句柄 * @return 成功，返回MV_OK；错误，返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_DestroyHandle(IN void * handle); /************************************************************************ * @fn MV_CC_OpenDevice() * @brief 打开设备 * @param handle [IN] 句柄 * @param nAccessMode [IN] 访问权限 * @param nSwitchoverKey [IN] 切换访问权限时的密钥 * @return 成功，返回MV_OK；错误，返回错误码 ************************************************************************/ #ifdef __APPLE__ MV_CAMCTRL_API int __stdcall MV_CC_OpenDevice(IN void* handle, IN unsigned int nAccessMode, IN unsigned short nSwitchoverKey); #else MV_CAMCTRL_API int __stdcall MV_CC_OpenDevice(IN void* handle, IN unsigned int nAccessMode = MV_ACCESS_Exclusive, IN unsigned short nSwitchoverKey = 0); #endif /*********************************************************************** * @fn MV_CC_CloseDevice * @brief 关闭相机 * @param handle [IN] 句柄 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_CloseDevice(IN void* handle); /*********************************************************************** * @fn MV_CC_RegisterImageCallBack * @brief 注册图像数据回调 * @param handle [IN] 句柄 * @param cbOutput [IN] 回调函数指针 * @param pUser [IN] 用户自定义变量 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_RegisterImageCallBack(void* handle, void(__stdcall* cbOutput)(unsigned char * pData, MV_FRAME_OUT_INFO* pFrameInfo, void* pUser), void* pUser); // 注册图像数据回调,chunk /*********************************************************************** * @fn MV_CC_RegisterImageCallBackEx * @brief 注册图像数据回调，chunk * @param handle [IN] 句柄 * @param cbOutput [IN] 回调函数指针 * @param pUser [IN] 用户自定义变量 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_RegisterImageCallBackEx(void* handle, void(__stdcall* cbOutput)(unsigned char * pData, MV_FRAME_OUT_INFO_EX* pFrameInfo, void* pUser), void* pUser); /*********************************************************************** * @fn MV_CC_StartGrabbing * @brief 开始取流 * @param handle [IN] 句柄 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_StartGrabbing(IN void* handle); /*********************************************************************** * @fn MV_CC_StopGrabbing * @brief 停止取流 * @param handle [IN] 句柄 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_StopGrabbing(IN void* handle); /*********************************************************************** * @fn MV_CC_GetOneFrame * @brief 获取一帧图像，此函数为查询式获取，每次调用查询内部缓存有 无数据，有数据则范围数据，无数据返回错误码 * @param handle [IN] 句柄 * @param pData [OUT] 图像数据接收指针 * @param nDataSize [IN] 接收缓存大小 * @param pFrameInfo [OUT] 图像信息结构体 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetOneFrame(IN void* handle, IN OUT unsigned char * pData , IN unsigned int nDataSize, IN OUT MV_FRAME_OUT_INFO* pFrameInfo); /*********************************************************************** * @fn MV_CC_GetOneFrameEx * @brief 获取一帧trunck数据，此函数为查询式获取，每次调用查询内部 缓存有无数据，有数据则范围数据，无数据返回错误码 * @param handle [IN] 句柄 * @param pData [OUT] 图像数据接收指针 * @param nDataSize [IN] 接收缓存大小 * @param pFrameInfo [OUT] 图像信息结构体 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetOneFrameEx(IN void* handle, IN OUT unsigned char * pData , IN unsigned int nDataSize, IN OUT MV_FRAME_OUT_INFO_EX* pFrameInfo); // 显示一帧图像 /*********************************************************************** * @fn MV_CC_Display * @brief 显示一帧图像，注册显示窗口，内部自动显示 * @param handle [IN] 句柄 * @param hWnd [IN] 显示窗口句柄 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_Display(IN void* handle, void* hWnd); // 设置SDK内部图像缓存节点个数，范围[1, 30]，在抓图前调用 /*********************************************************************** * @fn MV_CC_SetImageNodeNum * @brief 设置SDK内部图像缓存节点个数，范围[1, 30]，在抓图前调用 * @param handle [IN] 句柄 * @param nNum [IN] 缓存节点个数 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetImageNodeNum(IN void* handle, unsigned int nNum); /************************************************************************/ /* XML解析树的生成 */ /************************************************************************/ /*********************************************************************** * @fn MV_XML_GetGenICamXML * @brief 获取相机属性树XML * @param handle [IN] 句柄 * @param pData [OUT] 图像数据接收指针 * @param nDataSize [IN] 接收缓存大小 * @param pnDataLen [OUT] 实际数据大小 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_XML_GetGenICamXML(IN void* handle, IN OUT unsigned char* pData, IN unsigned int nDataSize, OUT unsigned int* pnDataLen); // 获取根节点 /*********************************************************************** * @fn MV_XML_GetRootNode * @brief 获取根节点 * @param handle [IN] 句柄 * @param pstNode [OUT] 根节点信息结构体 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_XML_GetRootNode(IN void* handle, IN OUT MV_XML_NODE_FEATURE* pstNode); // 从xml中获取指定节点的所有子节点，根节点为Root /*********************************************************************** * @fn MV_XML_GetChildren * @brief 从xml中获取指定节点的所有子节点，根节点为Root * @param handle [IN] 句柄 * @param pstNode [IN] 根节点信息结构体 * @param pstNodesList [OUT] 节点列表结构体 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_XML_GetChildren(IN void* handle, IN MV_XML_NODE_FEATURE* pstNode, IN OUT MV_XML_NODES_LIST* pstNodesList); //获得当前节点的属性 /*********************************************************************** * @fn MV_XML_GetNodeFeature * @brief 获得当前节点的属性 * @param handle [IN] 句柄 * @param pstNode [IN] 根节点信息结构体 * @param pstFeature [OUT] 当前节点属性结构体， pstFeature 具体结构体内容参考 MV_XML_FEATURE_x * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_XML_GetNodeFeature(IN void* handle, IN MV_XML_NODE_FEATURE* pstNode, IN OUT void* pstFeature); // pstFeature 具体结构体内容参考 MV_XML_FEATURE_x /*********************************************************************** * @fn MV_XML_UpdateNodeFeature * @brief 更新节点 * @param handle [IN] 句柄 * @param enType [IN] 节点类型 * @param pstFeature [OUT] 当前节点属性结构体 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_XML_UpdateNodeFeature(IN void* handle, IN enum MV_XML_InterfaceType enType, IN void* pstFeature); // 有节点需要更新时的回调函数 // 当调用MV_XML_UpdateNodeFeature接口更新节点属性时，注册的回调函数cbUpdate会在pstNodesList中返回与之相关联的节点 /*********************************************************************** * @fn MV_XML_RegisterUpdateCallBack * @brief 注册更新回调 * @param handle [IN] 句柄 * @param cbUpdate [IN] 回调函数指针 * @param pUser [IN] 用户自定义变量 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_XML_RegisterUpdateCallBack(IN void* handle, IN void(__stdcall* cbUpdate)(enum MV_XML_InterfaceType enType, void* pstFeature, MV_XML_NODES_LIST* pstNodesList, void* pUser), IN void* pUser); /************************************************************************/ /* 相机参数获取和设置 */ /************************************************************************/ /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetWidth(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); * @brief 获取图像宽度 * @param void* handle [IN] 相机句柄 * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机宽度的信息结构体指针 * 返回的pstValue结构体的意义 * unsigned int nCurValue; // 代表相机当前的宽度值 * unsigned int nMax; // 表示相机允许的最大可设置的宽度值 * unsigned int nMin; // 表示相机允许的最小可设置的宽度值 * unsigned int nInc; // 表示相机设置的宽度增量必须是nInc的倍数，否则无效 * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetWidth(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetWidth(IN void* handle, IN const unsigned int nValue); * @brief 设置图像宽度 * @param void* handle [IN] 相机句柄 * const unsigned int nValue [IN] 想要设置的相机宽度的值,注意此宽度值必须是MV_CC_GetWidth接口返回的pstValue中的nInc的倍数才能设置成功 * @return 成功,返回MV_OK,并且相机宽度将会更改为相应值，失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetWidth(IN void* handle, IN const unsigned int nValue); // 获取和设置图像高度 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetHeight(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); * @brief 获取图像高度 * @param void* handle [IN] 相机句柄 * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机高度的信息结构体指针 * @return 成功,返回MV_OK,并将高度信息返回到结构体中，失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetHeight(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetHeight(IN void* handle, IN const unsigned int nValue); * @brief 设置图像高度 * @param void* handle [IN] 相机句柄 * const unsigned int nValue [IN] 想要设置的相机宽度的值,注意此宽度值必须是MV_CC_GetWidth接口返回的pstValue中的nInc的倍数才能设置成功 * @return 成功,返回MV_OK,并且相机高度将会更改为相应值，失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetHeight(IN void* handle, IN const unsigned int nValue); // 获取和设置AOI的偏移 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetAOIoffsetX(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); * @brief 获取图像X偏移 * @param void* handle [IN] 相机句柄 * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机X偏移的信息结构体指针 * @return 成功,返回MV_OK,失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetAOIoffsetX(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetAOIoffsetX(IN void* handle, IN const unsigned int nValue); * @brief 设置图像AOI偏移 * @param void* handle [IN] 相机句柄 * const unsigned int nValue [IN] 想要设置的相机AOI的值 * @return 成功,返回MV_OK,并且相机AOI偏移将会更改为相应值，失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetAOIoffsetX(IN void* handle, IN const unsigned int nValue); // 获取和设置AOI的偏移 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetAOIoffsetY(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); * @brief 获取图像Y偏移 * @param void* handle [IN] 相机句柄 * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机Y偏移的信息结构体指针 * @return 成功,返回MV_OK,失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetAOIoffsetY(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetAOIoffsetX(IN void* handle, IN const unsigned int nValue); * @brief 设置图像AOI偏移 * @param void* handle [IN] 相机句柄 * const unsigned int nValue [IN] 想要设置的相机AOI的值 * @return 成功,返回MV_OK,并且相机AOI偏移将会更改为相应值，失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetAOIoffsetY(IN void* handle, IN const unsigned int nValue); // 调整自动曝光值下限 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetAutoExposureTimeLower(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); * @brief 获取曝光下限 * @param void* handle [IN] 相机句柄 * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机曝光值下限结构体指针 * @return 成功,返回MV_OK,失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetAutoExposureTimeLower(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetAutoExposureTimeLower(IN void* handle, IN const unsigned int nValue); * @brief 设置曝光值下限 * @param void* handle [IN] 相机句柄 * const unsigned int nValue [IN] 想要设置的曝光值下限 * @return 成功,返回MV_OK,并且相机曝光下限将会更改为相应值，失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetAutoExposureTimeLower(IN void* handle, IN const unsigned int nValue); //调整自动曝光值上限 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetAutoExposureTimeUpper(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); * @brief 获取曝光上限 * @param void* handle [IN] 相机句柄 * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机曝光值上限结构体指针 * @return 成功,返回MV_OK,失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetAutoExposureTimeUpper(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetAutoExposureTimeUpper(IN void* handle, IN const unsigned int nValue); * @brief 设置曝光值上限 * @param void* handle [IN] 相机句柄 * const unsigned int nValue [IN] 想要设置的曝光值上限 * @return 成功,返回MV_OK,并且相机曝光上限将会更改为相应值，失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetAutoExposureTimeUpper(IN void* handle, IN const unsigned int nValue); // 明亮度调整 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetBrightness(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); * @brief 获取亮度值 * @param void* handle [IN] 相机句柄 * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机亮度结构体指针 * @return 成功,返回MV_OK,失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetBrightness(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetBrightness(IN void* handle, IN const unsigned int nValue); * @brief 设置亮度值 * @param void* handle [IN] 相机句柄 * const unsigned int nValue [IN] 想要设置的亮度值 * @return 成功,返回MV_OK,并且相机亮度将会更改为相应值，失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetBrightness(IN void* handle, IN const unsigned int nValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetFrameRate(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue); * @brief 获取帧率 * @param void* handle [IN] 相机句柄 * MVCC_FLOATVALUE* pstValue [IN][OUT] 返回给调用者有关相机帧率的信息结构体指针 * 返回的pstValue结构体的意义 * float fCurValue; // 表示相机当前的帧率 * float fMax; // 表示相机允许设置的最大帧率 * float fMin; // 表示相机允许设置的最小帧率 * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码 * * 其他浮点型结构体参数的接口可参照此接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetFrameRate(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetFrameRate(IN void* handle, IN const float fValue); * @brief 设置帧率 * @param void* handle [IN] 相机句柄 * const float fValue [IN] 想要设置的相机帧率 * @return 成功,返回MV_OK,并且相机帧率将会更改为相应值，失败,返回错误码 * * 其他浮点型结构体参数的接口可参照此接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetFrameRate(IN void* handle, IN const float fValue); // 调整增益值 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetGain(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue); * @brief 获取增益 * @param void* handle [IN] 相机句柄 * MVCC_FLOATVALUE* pstValue [IN][OUT] 返回给调用者有关相机增益的信息结构体指针 * 返回的pstValue结构体的意义 * float fCurValue; // 表示相机当前的帧率 * float fMax; // 表示相机允许设置的最大帧率 * float fMin; // 表示相机允许设置的最小帧率 * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码 * * 其他浮点型结构体参数的接口可参照此接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetGain(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetGain(IN void* handle, IN const float fValue); * @brief 设置帧率 * @param void* handle [IN] 相机句柄 * const float fValue [IN] 想要设置的相机帧率 * @return 成功,返回MV_OK,并且相机帧率将会更改为相应值，失败,返回错误码 * * 其他浮点型结构体参数的接口可参照此接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetGain(IN void* handle, IN const float fValue); // 调整当前曝光值 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetExposureTime(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue); * @brief 获取曝光时间 * @param void* handle [IN] 相机句柄 * MVCC_FLOATVALUE* pstValue [IN][OUT] 返回给调用者有关相机曝光时间的信息结构体指针 * 返回的pstValue结构体的意义 * float fCurValue; // 表示相机当前的帧率 * float fMax; // 表示相机允许设置的最大帧率 * float fMin; // 表示相机允许设置的最小帧率 * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码 * * 其他浮点型结构体参数的接口可参照此接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetExposureTime(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetExposureTime(IN void* handle, IN const float fValue); * @brief 设置曝光时间 * @param void* handle [IN] 相机句柄 * const float fValue [IN] 想要设置的相机帧率 * @return 成功,返回MV_OK,并且相机帧率将会更改为相应值，失败,返回错误码 * * 其他浮点型结构体参数的接口可参照此接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetExposureTime(IN void* handle, IN const float fValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetPixelFormat(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue); * @brief 获取像素格式 * @param void* handle [IN] 相机句柄 * MVCC_ENUMVALUE* pstValue [IN][OUT] 返回给调用者的有关像素格式的信息结构体指针 * 返回的pstValue结构体的意义 * unsigned int nCurValue; // 相机当前的像素格式，是枚举类型,比如说PixelType_Gvsp_Mono8, 这里获得的是其整型值,具体数值参照PixelType.h的MvGvspPixelType枚举类型 * unsigned int nSupportedNum; // 相机支持的像素格式的个数 * unsigned int nSupportValue[MV_MAX_XML_SYMBOLIC_NUM]; // 相机所有支持的像素格式对应的整型值列表，后面要设置像素格式时，参数必须是这个数组中的一种，否则无效 * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码 * 其他枚举类型参数接口可参照此接口，有关相应参数的枚举类型对应的整型值请查找PixelType.h 和 CameraParams.h中相应的定义 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetPixelFormat(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetPixelFormat(IN void* handle, IN const unsigned int nValue); * @brief 设置像素格式 * @param void* handle [IN] 相机句柄 * const unsigned int nValue [IN] 要设置的像素格式对应的整型值，调用此接口时可以直接填写枚举值，如MV_CC_SetPixelFormat(m_handle, PixelType_Gvsp_RGB8_Packed); * @return 成功,返回MV_OK,并且相机像素格式将会更改为相应值，失败,返回错误码 * * 其他枚举类型参数接口可参照此接口，要设置的枚举类型必须是Get接口返回的nSupportValue[MV_MAX_XML_SYMBOLIC_NUM]中的一种，否则会失败 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetPixelFormat(IN void* handle, IN const unsigned int nValue); // 采集模式，参考 CameraParam.h 中的 MV_CAM_ACQUISITION_MODE 定义 MV_CAMCTRL_API int __stdcall MV_CC_GetAcquisitionMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetAcquisitionMode(IN void* handle, IN const unsigned int nValue); // 增益模式，参考 CameraParam.h 中的 MV_CAM_GAIN_MODE 定义 MV_CAMCTRL_API int __stdcall MV_CC_GetGainMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetGainMode(IN void* handle, IN const unsigned int nValue); // 自动曝光模式，参考 CameraParam.h 中的 MV_CAM_EXPOSURE_AUTO_MODE 定义 MV_CAMCTRL_API int __stdcall MV_CC_GetExposureAutoMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetExposureAutoMode(IN void* handle, IN const unsigned int nValue); // 触发模式，参考 CameraParam.h 中的 MV_CAM_TRIGGER_MODE 定义 MV_CAMCTRL_API int __stdcall MV_CC_GetTriggerMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetTriggerMode(IN void* handle, IN const unsigned int nValue); // 触发延时 MV_CAMCTRL_API int __stdcall MV_CC_GetTriggerDelay(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetTriggerDelay(IN void* handle, IN const float fValue); // 触发源，参考 CameraParam.h 中的 MV_CAM_TRIGGER_SOURCE 定义 MV_CAMCTRL_API int __stdcall MV_CC_GetTriggerSource(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetTriggerSource(IN void* handle, IN const unsigned int nValue); // 软触发一次（接口仅在已选择的触发源为软件触发时有效） MV_CAMCTRL_API int __stdcall MV_CC_TriggerSoftwareExecute(IN void* handle); // Gamma 类型，参考 CameraParam.h 中的 MV_CAM_GAMMA_SELECTOR 定义 MV_CAMCTRL_API int __stdcall MV_CC_GetGammaSelector(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetGammaSelector(IN void* handle, IN const unsigned int nValue); // Gamma值 MV_CAMCTRL_API int __stdcall MV_CC_GetGamma(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetGamma(IN void* handle, IN const float fValue); // 锐度 MV_CAMCTRL_API int __stdcall MV_CC_GetSharpness(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetSharpness(IN void* handle, IN const unsigned int nValue); // 灰度 MV_CAMCTRL_API int __stdcall MV_CC_GetHue(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetHue(IN void* handle, IN const unsigned int nValue); // 饱和度 MV_CAMCTRL_API int __stdcall MV_CC_GetSaturation(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetSaturation(IN void* handle, IN const unsigned int nValue); // 自动白平衡，参考 CameraParam.h 中的 MV_CAM_BALANCEWHITE_AUTO 定义 MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceWhiteAuto(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceWhiteAuto(IN void* handle, IN const unsigned int nValue); // 白平衡 红 MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceRatioRed(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceRatioRed(IN void* handle, IN const unsigned int nValue); // 白平衡 绿 MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceRatioGreen(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceRatioGreen(IN void* handle, IN const unsigned int nValue); // 白平衡 蓝 MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceRatioBlue(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceRatioBlue(IN void* handle, IN const unsigned int nValue); // 获取水印信息内包含的信息类型 MV_CAMCTRL_API int __stdcall MV_CC_GetFrameSpecInfoAbility(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetFrameSpecInfoAbility(IN void* handle, IN const unsigned int nValue); // 用户自定义ID MV_CAMCTRL_API int __stdcall MV_CC_GetDeviceUserID(IN void* handle, IN OUT MVCC_STRINGVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetDeviceUserID(IN void* handle, IN const char* chValue); // 获取和设置相机一次触发的帧数 MV_CAMCTRL_API int __stdcall MV_CC_GetBurstFrameCount(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetBurstFrameCount(IN void* handle, IN const unsigned int nValue); // 获取和设置行频 MV_CAMCTRL_API int __stdcall MV_CC_GetAcquisitionLineRate(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetAcquisitionLineRate(IN void* handle, IN const unsigned int nValue); // 获取图像基本信息 MV_CAMCTRL_API int __stdcall MV_CC_GetImageInfo(IN void* handle, IN OUT MV_IMAGE_BASIC_INFO* pstInfo); MV_CAMCTRL_API int __stdcall MV_CC_GetDeviceInfo(IN void * handle, IN OUT MV_CC_DEVICE_INFO* pstDevInfo); // 获取各种类型的信息 MV_CAMCTRL_API int __stdcall MV_CC_GetAllMatchInfo(IN void* handle, IN OUT MV_ALL_MATCH_INFO* pstInfo); // 获取设备心跳信息 MV_CAMCTRL_API int __stdcall MV_CC_GetHeartBeatTimeout(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_CC_SetHeartBeatTimeout(IN void* handle, IN const unsigned int nValue); // 万能接口 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetIntValue(IN void* handle, IN const char* strKey, OUT MVCC_INTVALUE *pIntValue); * @brief 获取Integer属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值，如获取宽度信息则为"Width" * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机属性结构体指针 * @return 成功,返回MV_OK,失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetIntValue(IN void* handle,IN const char* strKey,OUT MVCC_INTVALUE *pIntValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetIntValue(IN void* handle, IN const char* strKey, IN unsigned int nValue); * @brief 设置Integer型属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值，如获取宽度信息则为"Width" * const unsigned int nValue [IN] 想要设置的相机的属性值 * @return 成功,返回MV_OK,失败,返回错误码 * * 其他整型结构体参数的接口可参照接口 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetIntValue(IN void* handle,IN const char* strKey,IN unsigned int nValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetEnumValue(IN void* handle, IN const char* strKey, OUT MVCC_ENUMVALUE *pEnumValue); * @brief 获取Enum属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值，如获取像素格式信息则为"PixelFormat" * @param MVCC_ENUMVALUE* pEnumValue [IN][OUT] 返回给调用者有关相机属性结构体指针 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetEnumValue(IN void* handle,IN const char* strKey,OUT MVCC_ENUMVALUE *pEnumValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetEnumValue(IN void* handle, IN const char* strKey, IN unsigned int nValue); * @brief 设置Enum型属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值，如获取像素格式信息则为"PixelFormat" * const unsigned int nValue [IN] 想要设置的相机的属性值 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetEnumValue(IN void* handle,IN const char* strKey,IN unsigned int nValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetFloatValue(IN void* handle, IN const char* strKey, OUT MVCC_FLOATVALUE *pFloatValue); * @brief 获取Float属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值 * @param MVCC_FLOATVALUE *pFloatValue [IN][OUT] 返回给调用者有关相机属性结构体指针 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetFloatValue(IN void* handle,IN const char* strKey,OUT MVCC_FLOATVALUE *pFloatValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetFloatValue(IN void* handle, IN const char* strKey, IN float fValue); * @brief 设置Enum型属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值 * float fValue [IN] 想要设置的相机的属性值 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetFloatValue(IN void* handle,IN const char* strKey,IN float fValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetBoolValue(IN void* handle, IN const char* strKey, OUT bool *pBoolValue); * @brief 获取Boolean属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值 * @param bool *pBoolValue [IN][OUT] 返回给调用者有关相机属性值 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetBoolValue(IN void* handle,IN const char* strKey,OUT bool *pBoolValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetBoolValue(IN void* handle, IN const char* strKey, IN bool bValue); * @brief 设置Boolean型属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值 * bool bValue [IN] 想要设置的相机的属性值 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetBoolValue(IN void* handle,IN const char* strKey,IN bool bValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetStringValue(IN void* handle, IN const char* strKey, OUT MVCC_STRINGVALUE *pStringValue); * @brief 获取String属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值 * @param MVCC_STRINGVALUE *pStringValue [IN][OUT] 返回给调用者有关相机属性结构体指针 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetStringValue(IN void* handle,IN const char* strKey,OUT MVCC_STRINGVALUE *pStringValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetStringValue(IN void* handle, IN const char* strKey, IN const char * sValue); * @brief 设置String型属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值 * char * sValue [IN] 想要设置的相机的属性值 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetStringValue(IN void* handle,IN const char* strKey,IN const char * sValue); /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_SetCommandValue(IN void* handle, IN const char* strKey); * @brief 设置Command型属性值 * @param void* handle [IN] 相机句柄 * @param char* strKey [IN] 属性键值 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SetCommandValue(IN void* handle,IN const char* strKey); /************************************************************************/ /* 设备升级 和 寄存器读写 和异常回调 */ /************************************************************************/ // 设备本地升级 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_LocalUpgrade(IN void* handle, const void *pFilePathName); * @brief 设备本地升级 * @param void* handle [IN] 相机句柄 * @param void *pFilePathName [IN] 文件名 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_LocalUpgrade(IN void* handle, const void *pFilePathName); // 获取当前升级进度 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetUpgradeProcess(IN void* handle, unsigned int* pnProcess); * @brief 获取升级进度 * @param void* handle [IN] 相机句柄 * @param unsigned int* pnProcess [OUT] 进度接收地址 * @return 成功,返回MV_OK,失败,返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetUpgradeProcess(IN void* handle, unsigned int* pnProcess); // 获取最佳的packet size，对应GigEVision设备是 SCPS，对应U3V设备是每次从驱动读取的包大小 /************************************************************************ * @fn MV_CAMCTRL_API int __stdcall MV_CC_GetOptimalPacketSize(IN void* handle); * @brief 获取最佳的packet size，对应GigEVision设备是 SCPS，对应U3V设备是每次从驱动读取的包大小 * @param void* handle [IN] 相机句柄 * @return 最佳packetsize ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetOptimalPacketSize(IN void* handle); /************************************************************************ * @fn MV_CC_ReadMemory * @brief 读内存 * @param handle：设备句柄 * @param pBuffer：作为返回值使用，保存读到的内存值（内存值是按照大端模式存储的） * @param nAddress：待读取的内存地址，该地址可以从设备的Camera.xml文件中获取，形如xxx_RegAddr的xml节点值 （设备的Camera.xml文件会在设备打开之后自动生成在应用程序的当前目录中） * @param nLength：待读取的内存长度 * @return 见返回错误码 *************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_ReadMemory(IN void* handle , void *pBuffer, int64_t nAddress, int64_t nLength); /************************************************************************ * @fn MV_CC_WriteMemory * @brief 写内存 * @param handle：设备句柄 * @param pBuffer：待写入的内存值（注意内存值要按照大端模式存储） * @param nAddress：待写入的内存地址，该地址可以从设备的Camera.xml文件中获取，形如xxx_RegAddr的xml节点值 （设备的Camera.xml文件会在设备打开之后自动生成在应用程序的当前目录中） * @param nLength：待写入的内存长度 * @return 见返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_WriteMemory(IN void* handle , const void *pBuffer, int64_t nAddress, int64_t nLength); // 注册异常消息回调，在打开设备之后调用 /************************************************************************ * @fn MV_CC_RegisterExceptionCallBack * @brief 注册异常消息回调，在打开设备之后调用 * @param handle：设备句柄 * @param cbException [IN] 异常回调函数指针 * @param pUser [IN] 用户自定义变量 * @return 见返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_RegisterExceptionCallBack(IN void* handle, void(__stdcall* cbException)(unsigned int nMsgType, void* pUser), void* pUser); // 注册EVENT异常回调，在打开设备之后调用,只支持GIGE /************************************************************************ * @fn MV_CC_RegisterEventCallBack * @brief 注册事件回调，在打开设备之后调用 * @param handle：设备句柄 * @param cbEvent [IN] 异常回调函数指针 * @param pUser [IN] 用户自定义变量 * @return 见返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_RegisterEventCallBack(void* handle, void(__stdcall* cbEvent)(unsigned int nExternalEventId, void* pUser), void* pUser); /************************************************************************/ /* GigEVision 设备独有的接口 */ /************************************************************************/ // 强制IP /************************************************************************ * @fn MV_GIGE_ForceIp * @brief 强制IP * @param handle：设备句柄 * @param nIP [IN] 设置的IP * @return 见返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_GIGE_ForceIp(IN void* handle, unsigned int nIP); // 配置IP方式，type：MV_IP_CFG_x /************************************************************************ * @fn MV_GIGE_SetIpConfig * @brief 配置IP方式 * @param handle：设备句柄 * @param nType [IN] IP类型，见MV_IP_CFG_x * @return 见返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_GIGE_SetIpConfig(IN void* handle, unsigned int nType); // 设置仅使用某种模式,type: MV_NET_TRANS_x，不设置时，默认优先使用driver /************************************************************************ * @fn MV_GIGE_SetNetTransMode * @brief 设置仅使用某种模式,type: MV_NET_TRANS_x，不设置时，默认优先使用driver * @param handle：设备句柄 * @param nType [IN] 网络传输模式，见MV_NET_TRANS_x * @return 见返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_GIGE_SetNetTransMode(IN void* handle, unsigned int nType); /************************************************************************ * @fn MV_GIGE_GetNetTransInfo * @brief 获取网络传输信息 * @param handle：设备句柄 * @param pstInfo [OUT] 信息结构体 * @return 见返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_GIGE_GetNetTransInfo(IN void* handle, MV_NETTRANS_INFO* pstInfo); // 配置网络包大小 MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCPSPacketSize(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCPSPacketSize(IN void* handle, IN const unsigned int nValue); // 配置网络包发送间隔 MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCPD(IN void* handle, IN OUT MVCC_INTVALUE* pstValue); MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCPD(IN void* handle, IN const unsigned int nValue); // 配置接收端IP地址，0xa9fe0102 表示 169.254.1.2 MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCDA(IN void* handle, unsigned int* pnIP); MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCDA(IN void* handle, unsigned int nIP); // 配置发送端的端口号 MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCSP(IN void* handle, unsigned int* pnPort); MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCSP(IN void* handle, unsigned int nPort); /************************************************************************ * @fn MV_CC_CreateHandleWithoutLog * @brief 创建设备句柄，不生成日志 * @param handle [OUT] 句柄地址 * @param pstDevInfo [IN] 设备信息结构体 * @return 成功，返回MV_OK；错误，返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_CreateHandleWithoutLog(OUT void ** handle, IN const MV_CC_DEVICE_INFO* pstDevInfo); // 附加接口 /************************************************************************ * @fn MV_CC_SaveImage * @brief 保存图片 * @param pSaveParam [IN][OUT] 保存图片参数结构体 pData; // [IN] 输入数据缓存 nDataLen; // [IN] 输入数据大小 enPixelType; // [IN] 输入数据的像素格式 nWidth; // [IN] 图像宽 nHeight; // [IN] 图像高 pImageBuffer; // [OUT] 输出图片缓存 nImageLen; // [OUT] 输出图片大小 nBufferSize; // [IN] 提供的输出缓冲区大小 enImageType; // [IN] 输出图片格式 * @return 成功，返回MV_OK；错误，返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SaveImage(IN OUT MV_SAVE_IMAGE_PARAM* pSaveParam); // 附加接口 支持Bmp和Jpeg.编码质量在50-99之前 /************************************************************************ * @fn MV_CC_SaveImageEx * @brief 保存图片 * @param pSaveParam [IN][OUT] 保存图片参数结构体 pData; // [IN] 输入数据缓存 nDataLen; // [IN] 输入数据大小 enPixelType; // [IN] 输入数据的像素格式 nWidth; // [IN] 图像宽 nHeight; // [IN] 图像高 pImageBuffer; // [OUT] 输出图片缓存 nImageLen; // [OUT] 输出图片大小 nBufferSize; // [IN] 提供的输出缓冲区大小 enImageType; // [IN] 输出图片格式 nJpgQuality; // [IN] 编码质量, (50-99] nReserved[4]; * @return 成功，返回MV_OK；错误，返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_SaveImageEx(IN OUT MV_SAVE_IMAGE_PARAM_EX* pSaveParam); // 设置gvcp超时时间 /************************************************************************ * @fn MV_GIGE_SetGvcpTimeout * @brief 设置GVCP命令超时时间 * @param handle [IN] 句柄地址 * @param nMillisec [IN] 超时时间，以毫秒位单位，范围：0-10000 * @return 成功，返回MV_OK；错误，返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_GIGE_SetGvcpTimeout(void* handle, unsigned int nMillisec); /************************************************************************ * @fn MV_GIGE_SetResend * @brief 设置是否打开重发包支持，及重发包设置 * @param handle [IN] 句柄地址 * @param bEnable [IN] 是否支持重发包 * @param nMaxResendPercent [IN] 最大重发比 * @param nResendTimeout [IN] 重发超时时间 * @return 成功，返回MV_OK；错误，返回错误码 ************************************************************************/ MV_CAMCTRL_API int __stdcall MV_GIGE_SetResend(void* handle, unsigned int bEnable, unsigned int nMaxResendPercent = 10, unsigned int nResendTimeout = 50); // 调试命令 // GenICam传输层代理类，在open之后调用。正常返回值非NULL；异常返回NULL /************************************************************************ * @fn MV_CC_GetTlProxy * @brief 获取GenICam代理 * @param handle [IN] 句柄地址 * @return GenICam代理类指针 ************************************************************************/ MV_CAMCTRL_API void* __stdcall MV_CC_GetTlProxy(IN void* handle); /************************************************************************/ /* 对取流平稳性要求极高的用户建议调用以下，带Timeout的接口，替换原先的 */ /************************************************************************/ // 等待方式获取一帧图像 /*********************************************************************** * @fn MV_CC_GetOneFrameTimeout * @brief 采用超时机制获取一帧图片，SDK内部等待直到有数据时返回， 此接口可以增加取流平稳性，适合用于对平稳性要求较高的场合 * @param handle [IN] 句柄 * @param pData [OUT] 图像数据接收指针 * @param nDataSize [IN] 接收缓存大小 * @param pFrameInfo [OUT] 图像信息结构体 * @param nMsec [IN] 等待超时时间 * @return 成功，返回MV_OK；错误，返回错误码 ***********************************************************************/ MV_CAMCTRL_API int __stdcall MV_CC_GetOneFrameTimeout(IN void* handle, IN OUT unsigned char * pData , IN unsigned int nDataSize, IN OUT MV_FRAME_OUT_INFO_EX* pFrameInfo, int nMsec); #ifdef __cplusplus } #endif #endif //_MV_CAMERA_CTRL_H_