函数
废弃接口

废弃原因:新开发的万能接口代替了具体节点的设置、获取参数功能;效率低的接口由新的接口替代;实际开发中部分接口使用频率较低。 更多...

函数

MV_CAMCTRL_API int __stdcall MV_CC_GetImageInfo (IN void *handle, IN OUT MV_IMAGE_BASIC_INFO *pstInfo)
 获取图像基本信息 更多...
 
MV_CAMCTRL_API void *__stdcall MV_CC_GetTlProxy (IN void *handle)
 获取GenICam代理 更多...
 
MV_CAMCTRL_API int __stdcall MV_XML_GetRootNode (IN void *handle, IN OUT MV_XML_NODE_FEATURE *pstNode)
 获取根节点 更多...
 
MV_CAMCTRL_API int __stdcall MV_XML_GetChildren (IN void *handle, IN MV_XML_NODE_FEATURE *pstNode, IN OUT MV_XML_NODES_LIST *pstNodesList)
 从xml中获取指定节点的所有子节点,根节点为Root 更多...
 
MV_CAMCTRL_API int __stdcall MV_XML_GetNodeFeature (IN void *handle, IN MV_XML_NODE_FEATURE *pstNode, IN OUT void *pstFeature)
 获得当前节点的属性 更多...
 
MV_CAMCTRL_API int __stdcall MV_XML_UpdateNodeFeature (IN void *handle, IN enum MV_XML_InterfaceType enType, IN void *pstFeature)
 更新节点 更多...
 
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)
 注册更新回调 更多...
 
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)
 
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)
 获取一帧trunck数据,此函数为查询式获取,每次调用查询内部 缓存有无数据,有数据则范围数据,无数据返回错误码 (该接口已弃用,建议改用 MV_CC_GetOneFrameTimeOut接口) 更多...
 
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)
 注册图像数据回调(该接口已弃用,建议改用 MV_CC_RegisterImageCallBackEx() 接口) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SaveImage (IN OUT MV_SAVE_IMAGE_PARAM *pSaveParam)
 
MV_CAMCTRL_API int __stdcall MV_CC_SaveImageEx (IN OUT MV_SAVE_IMAGE_PARAM_EX *pSaveParam)
 保存图片,支持Bmp和Jpeg,编码质量在50-99之前 (该接口已弃用,建议改用 MV_CC_SaveImageEx3() 接口) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_BayerNoiseEstimate (IN void *handle, IN OUT MV_CC_BAYER_NOISE_ESTIMATE_PARAM *pstNoiseEstimateParam)
 Bayer噪声估计 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_BayerSpatialDenoise (IN void *handle, IN OUT MV_CC_BAYER_SPATIAL_DENOISE_PARAM *pstSpatialDenoiseParam)
 Bayer空域降噪 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetBayerCLUTParam (IN void *handle, IN MV_CC_CLUT_PARAM *pstCLUTParam)
 设置Bayer格式的CLUT使能和信息 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_ImageSharpen (IN void *handle, IN OUT MV_CC_SHARPEN_PARAM *pstSharpenParam)
 图像锐化 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_ColorCorrect (IN void *handle, IN OUT MV_CC_COLOR_CORRECT_PARAM *pstColorCorrectParam)
 色彩校正(包括CCM和CLUT) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_NoiseEstimate (IN void *handle, IN OUT MV_CC_NOISE_ESTIMATE_PARAM *pstNoiseEstimateParam)
 噪声估计 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SpatialDenoise (IN void *handle, IN OUT MV_CC_SPATIAL_DENOISE_PARAM *pstSpatialDenoiseParam)
 空域降噪 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_LSCCalib (IN void *handle, IN OUT MV_CC_LSC_CALIB_PARAM *pstLSCCalibParam)
 LSC标定 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_LSCCorrect (IN void *handle, IN OUT MV_CC_LSC_CORRECT_PARAM *pstLSCCorrectParam)
 LSC校正 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_ForceIp (IN void *handle, unsigned int nIP)
 强制IP(该接口已弃用,建议改用 MV_GIGE_ForceIpEx() 接口) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_RegisterEventCallBack (void *handle, void(__stdcall *cbEvent)(unsigned int nExternalEventId, void *pUser), void *pUser)
 注册事件回调(该接口已弃用,建议改用 MV_CC_RegisterEventCallBackEx() 接口) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_Display (IN void *handle, void *hWnd)
 显示图像,注册显示窗口,内部自动显示(该接口已弃用,建议改用 MV_CC_DisplayOneFrameEx() 接口) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetIntValue (IN void *handle, IN const char *strKey, OUT MVCC_INTVALUE *pIntValue)
 获取Integer属性值 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetIntValue (IN void *handle, IN const char *strKey, IN unsigned int nValue)
 设置Integer型属性值 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetWidth (IN void *handle, IN OUT MVCC_INTVALUE *pstValue)
 获取图像宽度 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetWidth (IN void *handle, IN const unsigned int nValue)
 设置图像宽度 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetHeight (IN void *handle, IN OUT MVCC_INTVALUE *pstValue)
 获取图像高度 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetHeight (IN void *handle, IN const unsigned int nValue)
 设置图像高度 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetAOIoffsetX (IN void *handle, IN OUT MVCC_INTVALUE *pstValue)
 获取图像X偏移 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetAOIoffsetX (IN void *handle, IN const unsigned int nValue)
 设置图像AOI偏移 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetAOIoffsetY (IN void *handle, IN OUT MVCC_INTVALUE *pstValue)
 获取图像Y偏移 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetAOIoffsetY (IN void *handle, IN const unsigned int nValue)
 设置图像AOI偏移 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetAutoExposureTimeLower (IN void *handle, IN OUT MVCC_INTVALUE *pstValue)
 获取曝光下限 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetAutoExposureTimeLower (IN void *handle, IN const unsigned int nValue)
 设置曝光值下限 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetAutoExposureTimeUpper (IN void *handle, IN OUT MVCC_INTVALUE *pstValue)
 获取曝光上限 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetAutoExposureTimeUpper (IN void *handle, IN const unsigned int nValue)
 设置曝光值上限 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetBrightness (IN void *handle, IN OUT MVCC_INTVALUE *pstValue)
 获取亮度值 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetBrightness (IN void *handle, IN const unsigned int nValue)
 设置亮度值 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetFrameRate (IN void *handle, IN OUT MVCC_FLOATVALUE *pstValue)
 获取帧率 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetFrameRate (IN void *handle, IN const float fValue)
 设置帧率 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetGain (IN void *handle, IN OUT MVCC_FLOATVALUE *pstValue)
 获取增益 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetGain (IN void *handle, IN const float fValue)
 设置增益 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetExposureTime (IN void *handle, IN OUT MVCC_FLOATVALUE *pstValue)
 获取曝光时间 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetExposureTime (IN void *handle, IN const float fValue)
 设置曝光时间 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetPixelFormat (IN void *handle, IN OUT MVCC_ENUMVALUE *pstValue)
 获取像素格式 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetPixelFormat (IN void *handle, IN const unsigned int nValue)
 设置像素格式 更多...
 
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)
 设置像素格式 更多...
 
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)
 设置增益模式 更多...
 
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)
 设置自动曝光模式 更多...
 
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)
 设置触发延时 更多...
 
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)
 软触发一次(接口仅在已选择的触发源为软件触发时有效) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetGammaSelector (IN void *handle, IN OUT MVCC_ENUMVALUE *pstValue)
 获取Gamma类型 更多...
 
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)
 获取Gamma值 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetGamma (IN void *handle, IN const float fValue)
 设置Gamma值 更多...
 
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)
 设置饱和度 更多...
 
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)
 设置水印信息内包含的信息类型 更多...
 
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_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)
 设置心跳信息 更多...
 
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)
 设置网络包发送间隔 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCDA (IN void *handle, unsigned int *pnIP)
 获取接收端IP地址,0xa9fe0102 表示 169.254.1.2 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCDA (IN void *handle, unsigned int nIP)
 设置接收端IP地址 更多...
 
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)
 设置发送端的端口号 更多...
 
MV_CAMCTRL_API int __stdcall MV_CAML_SetDeviceBauderate (IN void *handle, unsigned int nBaudrate)
 设置设备波特率 更多...
 
MV_CAMCTRL_API int __stdcall MV_CAML_GetDeviceBauderate (IN void *handle, unsigned int *pnCurrentBaudrate)
 获取设备波特率 更多...
 
MV_CAMCTRL_API int __stdcall MV_CAML_GetSupportBauderates (IN void *handle, unsigned int *pnBaudrateAblity)
 获取设备与主机间连接支持的波特率 更多...
 
MV_CAMCTRL_API int __stdcall MV_USB_RegisterStreamExceptionCallBack (IN void *handle, IN void(__stdcall *cbException)(MV_CC_STREAM_EXCEPTION_TYPE enExceptionType, void *pUser), IN void *pUser)
 注册流异常消息回调,在打开设备之后调用(只支持U3V相机,不支持GenTL设备) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SaveImageEx2 (IN void *handle, MV_SAVE_IMAGE_PARAM_EX *pstSaveParam)
 保存图片,支持Bmp和Jpeg,编码质量在50-99之前(该接口已弃用,建议改用 MV_CC_SaveImageEx3() 接口) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SaveImageToFile (IN void *handle, MV_SAVE_IMG_TO_FILE_PARAM *pstSaveFileParam)
 保存图像到文件(该接口已弃用,建议改用 MV_CC_SaveImageToFileEx() 接口) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_ConvertPixelType (IN void *handle, IN OUT MV_CC_PIXEL_CONVERT_PARAM *pstCvtParam)
 像素格式转换(该接口已弃用,建议改用 MV_CC_ConvertPixelTypeEx() 接口) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetSDKLogPath (IN const char *strSDKLogPath)
 设置SDK日志路径 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_DisplayOneFrame (IN void *handle, IN MV_DISPLAY_FRAME_INFO *pstDisplayInfo)
 显示一帧图像(该接口已启用,建议改用 MV_CC_DisplayOneFrameEx2() 接口) 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_EnumerateTls ()
 获取支持的传输层 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_CreateHandleWithoutLog (IN OUT void **handle, IN const MV_CC_DEVICE_INFO *pstDevInfo)
 创建设备句柄,不生成日志 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_RegisterImageCallBackForRGB (IN void *handle, IN void(__stdcall *cbOutput)(unsigned char *pData, MV_FRAME_OUT_INFO_EX *pFrameInfo, void *pUser), IN void *pUser)
 注册图像数据回调,RGB 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_RegisterImageCallBackForBGR (IN void *handle, IN void(__stdcall *cbOutput)(unsigned char *pData, MV_FRAME_OUT_INFO_EX *pFrameInfo, void *pUser), IN void *pUser)
 注册图像数据回调,BGR 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetImageForRGB (IN void *handle, IN OUT unsigned char *pData, IN unsigned int nDataSize, IN OUT MV_FRAME_OUT_INFO_EX *pstFrameInfo, IN int nMsec)
 获取一帧RGB数据,此函数为查询式获取,每次调用查询内部 缓存有无数据,有数据则获取数据,无数据返回错误码 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetImageForBGR (IN void *handle, IN OUT unsigned char *pData, IN unsigned int nDataSize, IN OUT MV_FRAME_OUT_INFO_EX *pstFrameInfo, IN int nMsec)
 获取一帧BGR数据,此函数为查询式获取,每次调用查询内部 缓存有无数据,有数据则获取数据,无数据返回错误码 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_OpenParamsGUI (IN void *handle)
 打开获取或设置相机参数的GUI界面 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SavePointCloudData (IN void *handle, IN OUT MV_SAVE_POINT_CLOUD_PARAM *pstPointDataParam)
 保存3D点云数据,支持PLY、CSV和OBJ三种格式 更多...
 

详细描述

废弃原因:新开发的万能接口代替了具体节点的设置、获取参数功能;效率低的接口由新的接口替代;实际开发中部分接口使用频率较低。

函数说明

◆ MV_CC_GetImageInfo()

MV_CAMCTRL_API int __stdcall MV_CC_GetImageInfo ( IN void *  handle,
IN OUT MV_IMAGE_BASIC_INFO *  pstInfo 
)

获取图像基本信息

参数
handle[IN] 相机句柄
pstInfo[IN][OUT] 返回给调用者有关相机图像基本信息结构体指针
返回
成功,返回MV_OK;失败,返回状态码

◆ MV_CC_GetTlProxy()

MV_CAMCTRL_API void* __stdcall MV_CC_GetTlProxy ( IN void *  handle)

获取GenICam代理

参数
handle[IN] 句柄地址
返回
GenICam代理类指针 ,正常返回值非NULL;异常返回NULL

◆ MV_XML_GetRootNode()

MV_CAMCTRL_API int __stdcall MV_XML_GetRootNode ( IN void *  handle,
IN OUT MV_XML_NODE_FEATURE *  pstNode 
)

获取根节点

参数
handle[IN] 句柄
pstNode[OUT] 根节点信息结构体
返回
成功,返回MV_OK;失败,返回状态码

◆ MV_XML_GetChildren()

MV_CAMCTRL_API int __stdcall MV_XML_GetChildren ( IN void *  handle,
IN MV_XML_NODE_FEATURE *  pstNode,
IN OUT MV_XML_NODES_LIST *  pstNodesList 
)

从xml中获取指定节点的所有子节点,根节点为Root

参数
handle[IN] 句柄
pstNode[IN] 根节点信息结构体
pstNodesList[OUT] 节点列表结构体
返回
成功,返回MV_OK;失败,返回状态码

◆ MV_XML_GetNodeFeature()

MV_CAMCTRL_API int __stdcall MV_XML_GetNodeFeature ( IN void *  handle,
IN MV_XML_NODE_FEATURE *  pstNode,
IN OUT void *  pstFeature 
)

获得当前节点的属性

参数
handle[IN] 句柄
pstNode[IN] 根节点信息结构体
pstFeature[OUT] 当前节点属性结构体,pstFeature 具体结构体内容参考 MV_XML_FEATURE_x
返回
成功,返回MV_OK;失败,返回状态码

◆ MV_XML_UpdateNodeFeature()

MV_CAMCTRL_API int __stdcall MV_XML_UpdateNodeFeature ( IN void *  handle,
IN enum MV_XML_InterfaceType  enType,
IN void *  pstFeature 
)

更新节点

参数
handle[IN] 句柄
enType[IN] 节点类型
pstFeature[OUT] 当前节点属性结构体
返回
成功,返回MV_OK;失败,返回状态码

◆ MV_XML_RegisterUpdateCallBack()

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 
)

注册更新回调

参数
handle[IN] 句柄
cbUpdate[IN] 回调函数指针
pUser[IN] 用户自定义变量
返回
成功,返回MV_OK;失败,返回状态码

◆ MV_CC_GetOneFrame()

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 
)

◆ MV_CC_GetOneFrameEx()

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 
)

获取一帧trunck数据,此函数为查询式获取,每次调用查询内部 缓存有无数据,有数据则范围数据,无数据返回错误码 (该接口已弃用,建议改用 MV_CC_GetOneFrameTimeOut接口)

参数
handle[IN] 句柄
pData[IN][OUT] 图像数据接收指针
nDataSize[IN] 接收缓存大小
pFrameInfo[OUT] 图像信息结构体
返回
成功,返回MV_OK ;失败,返回状态码
注解
此函数为查询式获取,每次调用查询内部缓存有无数据,有数据则范围数据,无数据返回状态码

◆ MV_CC_RegisterImageCallBack()

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 
)

注册图像数据回调(该接口已弃用,建议改用 MV_CC_RegisterImageCallBackEx() 接口)

参数
handle[IN] 句柄
cbOutput[IN] 回调函数指针
pUser[IN] 用户自定义变量
返回
成功,返回MV_OK ;失败,返回状态码

◆ MV_CC_SaveImage()

MV_CAMCTRL_API int __stdcall MV_CC_SaveImage ( IN OUT MV_SAVE_IMAGE_PARAM *  pSaveParam)

◆ MV_CC_SaveImageEx()

MV_CAMCTRL_API int __stdcall MV_CC_SaveImageEx ( IN OUT MV_SAVE_IMAGE_PARAM_EX *  pSaveParam)

保存图片,支持Bmp和Jpeg,编码质量在50-99之前 (该接口已弃用,建议改用 MV_CC_SaveImageEx3() 接口)

参数
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];
返回
成功,返回MV_OK;错误,返回错误码

◆ MV_CC_BayerNoiseEstimate()

MV_CAMCTRL_API int __stdcall MV_CC_BayerNoiseEstimate ( IN void *  handle,
IN OUT MV_CC_BAYER_NOISE_ESTIMATE_PARAM *  pstNoiseEstimateParam 
)

Bayer噪声估计

参数
handle[IN] 设备句柄
pstNoiseEstimateParam[IN][OUT] Bayer噪声估计参数结构体
返回
成功,返回MV_OK ;失败,返回状态码
注解
该接口只支持Bayer格式,不支持Bayerxx_Packed;以相机实际支持为准。

◆ MV_CC_BayerSpatialDenoise()

MV_CAMCTRL_API int __stdcall MV_CC_BayerSpatialDenoise ( IN void *  handle,
IN OUT MV_CC_BAYER_SPATIAL_DENOISE_PARAM *  pstSpatialDenoiseParam 
)

Bayer空域降噪

参数
handle[IN] 设备句柄
pstSpatialDenoiseParam[IN][OUT] Bayer空域降噪参数结构体
返回
成功,返回MV_OK ;失败,返回状态码
注解
该接口只支持Bayer格式,不支持Bayerxx_Packed;以相机实际支持为准。

◆ MV_CC_SetBayerCLUTParam()

MV_CAMCTRL_API int __stdcall MV_CC_SetBayerCLUTParam ( IN void *  handle,
IN MV_CC_CLUT_PARAM *  pstCLUTParam 
)

设置Bayer格式的CLUT使能和信息

参数
handle[IN] 设备句柄
pstCLUTParam[IN] CLUT参数
返回
成功,返回MV_OK ;错误,返回状态码
注解
 • 开启CLUT并设置CLUT信息后,在调用 MV_CC_ConvertPixelType()MV_CC_SaveImageEx2() 接口将Bayer8/10/12/16格式转成RGB24/48, RGBA32/64,BGR24/48,BGRA32/64时起效。
 • 以相机实际支持为准。

◆ MV_CC_ImageSharpen()

MV_CAMCTRL_API int __stdcall MV_CC_ImageSharpen ( IN void *  handle,
IN OUT MV_CC_SHARPEN_PARAM pstSharpenParam 
)

图像锐化

参数
handle[IN] 设备句柄
pstSharpenParam[IN] 锐化参数
返回
成功,返回MV_OK ;错误,返回状态码
注解
以相机实际支持为准。

◆ MV_CC_ColorCorrect()

MV_CAMCTRL_API int __stdcall MV_CC_ColorCorrect ( IN void *  handle,
IN OUT MV_CC_COLOR_CORRECT_PARAM *  pstColorCorrectParam 
)

色彩校正(包括CCM和CLUT)

参数
handle[IN] 设备句柄
pstColorCorrectParam[IN] 色彩校正参数
返回
成功,返回MV_OK ;错误,返回状态码
注解
 • 该接口支持单独CCM或者CLUT,也支持同时进行CCM和CLUT,用户可以通过CCM和CLUT信息中的使能开关进行选择。
 • 以相机实际支持为准。

◆ MV_CC_NoiseEstimate()

MV_CAMCTRL_API int __stdcall MV_CC_NoiseEstimate ( IN void *  handle,
IN OUT MV_CC_NOISE_ESTIMATE_PARAM pstNoiseEstimateParam 
)

噪声估计

参数
handle[IN] 设备句柄
pstNoiseEstimateParam[IN] 噪声估计参数
返回
成功,返回MV_OK ;错误,返回状态码
注解
 • 如果用户选择全图做噪声估计,nROINum可输入0,pstROIRect可置空。
 • 以相机实际支持为准。

◆ MV_CC_SpatialDenoise()

MV_CAMCTRL_API int __stdcall MV_CC_SpatialDenoise ( IN void *  handle,
IN OUT MV_CC_SPATIAL_DENOISE_PARAM *  pstSpatialDenoiseParam 
)

空域降噪

参数
handle[IN] 设备句柄
pstSpatialDenoiseParam[IN] 空域降噪参数
返回
成功,返回MV_OK ;错误,返回状态码
注解
以相机实际支持为准。

◆ MV_CC_LSCCalib()

MV_CAMCTRL_API int __stdcall MV_CC_LSCCalib ( IN void *  handle,
IN OUT MV_CC_LSC_CALIB_PARAM pstLSCCalibParam 
)

LSC标定

参数
handle[IN] 设备句柄
pstLSCCalibParam[IN] 标定参数
返回
成功,返回MV_OK ;错误,返回状态码
注解
以相机实际支持为准。

◆ MV_CC_LSCCorrect()

MV_CAMCTRL_API int __stdcall MV_CC_LSCCorrect ( IN void *  handle,
IN OUT MV_CC_LSC_CORRECT_PARAM pstLSCCorrectParam 
)

LSC校正

参数
handle[IN] 设备句柄
pstLSCCorrectParam[IN] 校正参数
返回
成功,返回MV_OK ;错误,返回状态码
注解
以相机实际支持为准。

◆ MV_GIGE_ForceIp()

MV_CAMCTRL_API int __stdcall MV_GIGE_ForceIp ( IN void *  handle,
unsigned int  nIP 
)

强制IP(该接口已弃用,建议改用 MV_GIGE_ForceIpEx() 接口)

参数
handle[IN] 设备句柄
nIP[IN] 设置的IP
返回
成功,返回MV_OK ;失败,返回状态码

◆ MV_CC_RegisterEventCallBack()

MV_CAMCTRL_API int __stdcall MV_CC_RegisterEventCallBack ( void *  handle,
void(__stdcall *cbEvent)(unsigned int nExternalEventId, void *pUser)  ,
void *  pUser 
)

注册事件回调(该接口已弃用,建议改用 MV_CC_RegisterEventCallBackEx() 接口)

参数
handle[IN] 设备句柄
cbEvent[IN] 事件回调函数指针
pUser[IN] 用户自定义变量
返回
成功,返回MV_OK ;失败,返回状态码

◆ MV_CC_Display()

MV_CAMCTRL_API int __stdcall MV_CC_Display ( IN void *  handle,
void *  hWnd 
)

显示图像,注册显示窗口,内部自动显示(该接口已弃用,建议改用 MV_CC_DisplayOneFrameEx() 接口)

参数
handle[IN] 句柄
hWnd[IN] 显示窗口句柄
返回
成功,返回MV_OK ;失败,返回状态码

◆ MV_CC_GetIntValue()

MV_CAMCTRL_API int __stdcall MV_CC_GetIntValue ( IN void *  handle,
IN const char *  strKey,
OUT MVCC_INTVALUE pIntValue 
)

获取Integer属性值

参数
handle[IN] 设备句柄
strKey[IN] 属性键值,如获取宽度信息则为"Width"
pIntValue[IN][OUT] 返回给调用者有关相机属性结构体指针
返回
成功,返回MV_OK;失败,返回状态码
注解
连接设备之后调用该接口可以获取int类型的指定节点的值,具体可以查看客户端属性描述,如下图所示:

示例
GrabImage_HighPerformance.cpp, ImageProcess.cpp, ImageSave.cpp , 以及 SetParam.cpp.

◆ MV_CC_SetIntValue()

MV_CAMCTRL_API int __stdcall MV_CC_SetIntValue ( IN void *  handle,
IN const char *  strKey,
IN unsigned int  nValue 
)

设置Integer型属性值

参数
handle[IN] 设备句柄
strKey[IN] 属性键值,如获取宽度信息则为"Width"
nValue[IN] 想要设置的相机的属性值
返回
成功,返回MV_OK;失败,返回状态码
注解
连接设备之后调用该接口可以设置int类型的指定节点的值,具体可以查看客户端属性描述,如下图所示:

示例
ImageSave.cpp , 以及 MultiLightCtrl_ImageStitching.cpp.

◆ MV_CC_GetWidth()

MV_CAMCTRL_API int __stdcall MV_CC_GetWidth ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取图像宽度

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机宽度的信息结构体指针
返回的pstValue结构体的意义:
变量 意义
- unsigned int    nCurValue 代表相机当前的宽度值
- unsigned int    nMax 表示相机允许的最大可设置的宽度值
- unsigned int    nMin 表示相机允许的最小可设置的宽度值
- unsigned int    nInc 表示相机设置的宽度增量必须是nInc的倍数,否则无效
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
其他整型结构体参数的接口可参照此接口

◆ MV_CC_SetWidth()

MV_CAMCTRL_API int __stdcall MV_CC_SetWidth ( IN void *  handle,
IN const unsigned int  nValue 
)

设置图像宽度

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的相机宽度的值,注意此宽度值必须是 MV_CC_GetWidth() 接口返回的pstValue中的nInc的倍数才能设置成功
返回
成功,返回MV_OK ,并且相机宽度将会更改为相应值;失败,返回状态码

◆ MV_CC_GetHeight()

MV_CAMCTRL_API int __stdcall MV_CC_GetHeight ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取图像高度

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机高度的信息结构体指针
返回
成功,返回MV_OK ,并将高度信息返回到结构体中;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetHeight()

MV_CAMCTRL_API int __stdcall MV_CC_SetHeight ( IN void *  handle,
IN const unsigned int  nValue 
)

设置图像高度

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的相机宽度的值,注意此宽度值必须是 MV_CC_GetWidth() 接口返回的pstValue中的nInc的倍数才能设置成功
返回
成功,返回MV_OK ,并且相机高度将会更改为相应值;失败,返回状态码

◆ MV_CC_GetAOIoffsetX()

MV_CAMCTRL_API int __stdcall MV_CC_GetAOIoffsetX ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取图像X偏移

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机X偏移的信息结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetAOIoffsetX()

MV_CAMCTRL_API int __stdcall MV_CC_SetAOIoffsetX ( IN void *  handle,
IN const unsigned int  nValue 
)

设置图像AOI偏移

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的相机AOI的值
返回
成功,返回MV_OK ,并且相机AOI偏移将会更改为相应值;失败,返回状态码

◆ MV_CC_GetAOIoffsetY()

MV_CAMCTRL_API int __stdcall MV_CC_GetAOIoffsetY ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取图像Y偏移

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机Y偏移的信息结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetAOIoffsetY()

MV_CAMCTRL_API int __stdcall MV_CC_SetAOIoffsetY ( IN void *  handle,
IN const unsigned int  nValue 
)

设置图像AOI偏移

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的相机AOI的值
返回
成功,返回MV_OK ,并且相机AOI偏移将会更改为相应值;失败,返回状态码

◆ MV_CC_GetAutoExposureTimeLower()

MV_CAMCTRL_API int __stdcall MV_CC_GetAutoExposureTimeLower ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取曝光下限

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机曝光值下限结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetAutoExposureTimeLower()

MV_CAMCTRL_API int __stdcall MV_CC_SetAutoExposureTimeLower ( IN void *  handle,
IN const unsigned int  nValue 
)

设置曝光值下限

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的曝光值下限
返回
成功,返回MV_OK ,并且相机曝光下限将会更改为相应值;失败,返回状态码

◆ MV_CC_GetAutoExposureTimeUpper()

MV_CAMCTRL_API int __stdcall MV_CC_GetAutoExposureTimeUpper ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取曝光上限

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机曝光值上限结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetAutoExposureTimeUpper()

MV_CAMCTRL_API int __stdcall MV_CC_SetAutoExposureTimeUpper ( IN void *  handle,
IN const unsigned int  nValue 
)

设置曝光值上限

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的曝光值上限
返回
成功,返回MV_OK ,并且相机曝光上限将会更改为相应值;失败,返回状态码

◆ MV_CC_GetBrightness()

MV_CAMCTRL_API int __stdcall MV_CC_GetBrightness ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取亮度值

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机亮度结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetBrightness()

MV_CAMCTRL_API int __stdcall MV_CC_SetBrightness ( IN void *  handle,
IN const unsigned int  nValue 
)

设置亮度值

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的亮度值
返回
成功,返回MV_OK ,并且相机亮度将会更改为相应值;失败,返回状态码

◆ MV_CC_GetFrameRate()

MV_CAMCTRL_API int __stdcall MV_CC_GetFrameRate ( IN void *  handle,
IN OUT MVCC_FLOATVALUE pstValue 
)

获取帧率

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机帧率的信息结构体指针
返回的pstValue结构体的意义:
变量 意义
- float    fCurValue 表示相机当前的帧率
- float    fMax 表示相机允许设置的最大帧率
float    fMin 表示相机允许设置的最小帧率
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
其他浮点型结构体参数的接口可参照此接口

◆ MV_CC_SetFrameRate()

MV_CAMCTRL_API int __stdcall MV_CC_SetFrameRate ( IN void *  handle,
IN const float  fValue 
)

设置帧率

参数
handle[IN] 相机句柄
fValue[IN] 想要设置的相机帧率
返回
成功,返回MV_OK ,并且相机帧率将会更改为相应值;失败,返回状态码

◆ MV_CC_GetGain()

MV_CAMCTRL_API int __stdcall MV_CC_GetGain ( IN void *  handle,
IN OUT MVCC_FLOATVALUE pstValue 
)

获取增益

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机增益的信息结构体指针
返回的pstValue结构体的意义:
变量 意义
- float    fCurValue 表示相机当前的增益
- float    fMax 表示相机允许设置的最大增益
- float  &nbsp 表示相机允许设置的最小增益
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
其他浮点型结构体参数的接口可参照此接口

◆ MV_CC_SetGain()

MV_CAMCTRL_API int __stdcall MV_CC_SetGain ( IN void *  handle,
IN const float  fValue 
)

设置增益

参数
handle[IN] 相机句柄
fValue[IN] 想要设置的相机增益
返回
成功,返回MV_OK ,并且相机帧率将会更改为相应值;失败,返回状态码

◆ MV_CC_GetExposureTime()

MV_CAMCTRL_API int __stdcall MV_CC_GetExposureTime ( IN void *  handle,
IN OUT MVCC_FLOATVALUE pstValue 
)

获取曝光时间

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机曝光时间的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码

◆ MV_CC_SetExposureTime()

MV_CAMCTRL_API int __stdcall MV_CC_SetExposureTime ( IN void *  handle,
IN const float  fValue 
)

设置曝光时间

参数
handle[IN] 相机句柄
fValue[IN] 想要设置的曝光时间
返回
成功,返回MV_OK ,并且相机帧率将会更改为相应值;失败,返回状态码

◆ MV_CC_GetPixelFormat()

MV_CAMCTRL_API int __stdcall MV_CC_GetPixelFormat ( IN void *  handle,
IN OUT MVCC_ENUMVALUE pstValue 
)

获取像素格式

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者的有关像素格式的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码

◆ MV_CC_SetPixelFormat()

MV_CAMCTRL_API int __stdcall MV_CC_SetPixelFormat ( IN void *  handle,
IN const unsigned int  nValue 
)

设置像素格式

参数
handle[IN] 相机句柄
nValue[IN] 要设置的像素格式对应的整型值,调用此接口时可以直接填写枚举值,如 MV_CC_SetPixelFormat() ;
返回
成功,返回MV_OK ,并且相机像素格式将会更改为相应值;失败,返回状态码
注解
要设置的枚举类型必须是Get接口返回的nSupportValue[MV_MAX_XML_SYMBOLIC_NUM]中的一种,否则会失败

◆ MV_CC_GetAcquisitionMode()

MV_CAMCTRL_API int __stdcall MV_CC_GetAcquisitionMode ( IN void *  handle,
IN OUT MVCC_ENUMVALUE pstValue 
)

获取采集模式

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者的有关采集模式的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
可参照接口 MV_CC_GetPixelFormat() ,参考 CameraParams.h 中的 MV_CAM_ACQUISITION_MODE 定义

◆ MV_CC_SetAcquisitionMode()

MV_CAMCTRL_API int __stdcall MV_CC_SetAcquisitionMode ( IN void *  handle,
IN const unsigned int  nValue 
)

设置像素格式

参数
handle[IN] 相机句柄
nValue[IN] 要设置的采集模式对应的整型值
返回
成功,返回MV_OK ,并且相机采集模式将会更改为相应值;失败,返回状态码

◆ MV_CC_GetGainMode()

MV_CAMCTRL_API int __stdcall MV_CC_GetGainMode ( IN void *  handle,
IN OUT MVCC_ENUMVALUE pstValue 
)

获取增益模式

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者的有关增益模式的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
可参照接口 MV_CC_GetPixelFormat() ,参考 CameraParams.h 中的 MV_CAM_GAIN_MODE 定义

◆ MV_CC_SetGainMode()

MV_CAMCTRL_API int __stdcall MV_CC_SetGainMode ( IN void *  handle,
IN const unsigned int  nValue 
)

设置增益模式

参数
handle[IN] 相机句柄
nValue[IN] 要设置的增益模式对应的整型值
返回
成功,返回MV_OK ,并且相机增益模式将会更改为相应值;失败,返回状态码

◆ MV_CC_GetExposureAutoMode()

MV_CAMCTRL_API int __stdcall MV_CC_GetExposureAutoMode ( IN void *  handle,
IN OUT MVCC_ENUMVALUE pstValue 
)

获取自动曝光模式

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者的有关自动曝光模式的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
可参照接口 MV_CC_GetPixelFormat() ,参考 CameraParams.h 中的::MV_CAM_EXPOSURE_AUTO_MODE 定义

◆ MV_CC_SetExposureAutoMode()

MV_CAMCTRL_API int __stdcall MV_CC_SetExposureAutoMode ( IN void *  handle,
IN const unsigned int  nValue 
)

设置自动曝光模式

参数
handle[IN] 相机句柄
nValue[IN] 要设置的自动曝光模式对应的整型值
返回
成功,返回MV_OK ,并且相机自动曝光模式将会更改为相应值;失败,返回状态码

◆ MV_CC_GetTriggerMode()

MV_CAMCTRL_API int __stdcall MV_CC_GetTriggerMode ( IN void *  handle,
IN OUT MVCC_ENUMVALUE pstValue 
)

获取触发模式

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者的有关触发模式的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
可参照接口 MV_CC_GetPixelFormat() ,参考 CameraParams.h 中的 MV_CAM_TRIGGER_MODE 定义

◆ MV_CC_SetTriggerMode()

MV_CAMCTRL_API int __stdcall MV_CC_SetTriggerMode ( IN void *  handle,
IN const unsigned int  nValue 
)

设置触发模式

参数
handle[IN] 相机句柄
nValue[IN] 要设置的触发模式对应的整型值
返回
成功,返回MV_OK ,并且相机触发模式将会更改为相应值;失败,返回状态码

◆ MV_CC_GetTriggerDelay()

MV_CAMCTRL_API int __stdcall MV_CC_GetTriggerDelay ( IN void *  handle,
IN OUT MVCC_FLOATVALUE pstValue 
)

获取触发延时

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机触发延时的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
可参照接口 MV_CC_GetFrameRate()

◆ MV_CC_SetTriggerDelay()

MV_CAMCTRL_API int __stdcall MV_CC_SetTriggerDelay ( IN void *  handle,
IN const float  fValue 
)

设置触发延时

参数
handle[IN] 相机句柄
fValue[IN] 想要设置的相机触发延时
返回
成功,返回MV_OK ,并且相机触发延时将会更改为相应值;失败,返回状态码

◆ MV_CC_GetTriggerSource()

MV_CAMCTRL_API int __stdcall MV_CC_GetTriggerSource ( IN void *  handle,
IN OUT MVCC_ENUMVALUE pstValue 
)

获取触发源

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者的有关触发源的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
可参照接口 MV_CC_GetPixelFormat() ,参考 CameraParams.h 中的 MV_CAM_TRIGGER_SOURCE 定义

◆ MV_CC_SetTriggerSource()

MV_CAMCTRL_API int __stdcall MV_CC_SetTriggerSource ( IN void *  handle,
IN const unsigned int  nValue 
)

设置触发源

参数
handle[IN] 相机句柄
nValue[IN] 要设置的触发源对应的整型值
返回
成功,返回MV_OK ,并且相机触发源将会更改为相应值;失败,返回状态码

◆ MV_CC_TriggerSoftwareExecute()

MV_CAMCTRL_API int __stdcall MV_CC_TriggerSoftwareExecute ( IN void *  handle)

软触发一次(接口仅在已选择的触发源为软件触发时有效)

参数
handle[IN] 相机句柄
返回
成功,返回MV_OK , 失败,返回错误码

◆ MV_CC_GetGammaSelector()

MV_CAMCTRL_API int __stdcall MV_CC_GetGammaSelector ( IN void *  handle,
IN OUT MVCC_ENUMVALUE pstValue 
)

获取Gamma类型

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者的有关Gamma类型的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
可参照接口 MV_CC_GetPixelFormat() ,参考 CameraParams.h 中的 MV_CAM_GAMMA_SELECTOR 定义

◆ MV_CC_SetGammaSelector()

MV_CAMCTRL_API int __stdcall MV_CC_SetGammaSelector ( IN void *  handle,
IN const unsigned int  nValue 
)

设置Gamma类型

参数
handle[IN] 相机句柄
nValue[IN] 要设置的Gamma类型对应的整型值
返回
成功,返回MV_OK ,并且相机Gamma类型将会更改为相应值;失败,返回状态码

◆ MV_CC_GetGamma()

MV_CAMCTRL_API int __stdcall MV_CC_GetGamma ( IN void *  handle,
IN OUT MVCC_FLOATVALUE pstValue 
)

获取Gamma值

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机Gamma值的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
可参照接口 MV_CC_GetExposureTime()

◆ MV_CC_SetGamma()

MV_CAMCTRL_API int __stdcall MV_CC_SetGamma ( IN void *  handle,
IN const float  fValue 
)

设置Gamma值

参数
handle[IN] 相机句柄
fValue[IN] 想要设置的相机Gamma值
返回
成功,返回MV_OK ,并且相机Gamma值将会更改为相应值;失败,返回状态码

◆ MV_CC_GetSharpness()

MV_CAMCTRL_API int __stdcall MV_CC_GetSharpness ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取锐度

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机锐度结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetSharpness()

MV_CAMCTRL_API int __stdcall MV_CC_SetSharpness ( IN void *  handle,
IN const unsigned int  nValue 
)

设置锐度

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的锐度
返回
成功,返回MV_OK ,并且相机锐度将会更改为相应值;失败,返回状态码

◆ MV_CC_GetHue()

MV_CAMCTRL_API int __stdcall MV_CC_GetHue ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取灰度

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机灰度结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetHue()

MV_CAMCTRL_API int __stdcall MV_CC_SetHue ( IN void *  handle,
IN const unsigned int  nValue 
)

设置灰度

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的灰度
返回
成功,返回MV_OK ,并且相机灰度将会更改为相应值;失败,返回状态码

◆ MV_CC_GetSaturation()

MV_CAMCTRL_API int __stdcall MV_CC_GetSaturation ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取饱和度

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机饱和度结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetSaturation()

MV_CAMCTRL_API int __stdcall MV_CC_SetSaturation ( IN void *  handle,
IN const unsigned int  nValue 
)

设置饱和度

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的饱和度
返回
成功,返回MV_OK ,并且相机饱和度将会更改为相应值;失败,返回状态码

◆ MV_CC_GetBalanceWhiteAuto()

MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceWhiteAuto ( IN void *  handle,
IN OUT MVCC_ENUMVALUE pstValue 
)

获取自动白平衡

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者的有关自动白平衡的信息结构体指针
返回
成功,返回MV_OK ,并获得相应参数信息的结构体;失败,返回状态码
注解
可参照接口 MV_CC_GetPixelFormat() ,参考 CameraParams.h 中的 MV_CAM_BALANCEWHITE_AUTO 定义

◆ MV_CC_SetBalanceWhiteAuto()

MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceWhiteAuto ( IN void *  handle,
IN const unsigned int  nValue 
)

设置自动白平衡

参数
handle[IN] 相机句柄
nValue[IN] 要设置的自动白平衡对应的整型值
返回
成功,返回MV_OK ,并且相机自动白平衡将会更改为相应值;失败,返回状态码

◆ MV_CC_GetBalanceRatioRed()

MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceRatioRed ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取白平衡 红

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机白平衡 红结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetBalanceRatioRed()

MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceRatioRed ( IN void *  handle,
IN const unsigned int  nValue 
)

设置白平衡 红

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的白平衡 红
返回
成功,返回MV_OK ,并且相机白平衡 红将会更改为相应值;失败,返回状态码

◆ MV_CC_GetBalanceRatioGreen()

MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceRatioGreen ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取白平衡 绿

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机白平衡 绿结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetBalanceRatioGreen()

MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceRatioGreen ( IN void *  handle,
IN const unsigned int  nValue 
)

设置白平衡 绿

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的白平衡 绿
返回
成功,返回MV_OK ,并且相机白平衡 绿将会更改为相应值;失败,返回状态码

◆ MV_CC_GetBalanceRatioBlue()

MV_CAMCTRL_API int __stdcall MV_CC_GetBalanceRatioBlue ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取白平衡 蓝

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机白平衡 蓝结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetBalanceRatioBlue()

MV_CAMCTRL_API int __stdcall MV_CC_SetBalanceRatioBlue ( IN void *  handle,
IN const unsigned int  nValue 
)

设置白平衡 蓝

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的白平衡 蓝
返回
成功,返回MV_OK ,并且相机白平衡 蓝将会更改为相应值;失败,返回状态码

◆ MV_CC_GetFrameSpecInfoAbility()

MV_CAMCTRL_API int __stdcall MV_CC_GetFrameSpecInfoAbility ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取水印信息内包含的信息类型

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机水印信息内包含的信息类型结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetFrameSpecInfoAbility()

MV_CAMCTRL_API int __stdcall MV_CC_SetFrameSpecInfoAbility ( IN void *  handle,
IN const unsigned int  nValue 
)

设置水印信息内包含的信息类型

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的水印信息内包含的信息类型
返回
成功,返回MV_OK ,并且相机水印信息内包含的信息类型会更改为相应值;失败,返回状态码

◆ MV_CC_GetDeviceUserID()

MV_CAMCTRL_API int __stdcall MV_CC_GetDeviceUserID ( IN void *  handle,
IN OUT MVCC_STRINGVALUE pstValue 
)

获取设备自定义名字

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机名字结构体指针
返回
成功,返回MV_OK ,并且获取到相机的自定义名字;失败,返回状态码

◆ MV_CC_SetDeviceUserID()

MV_CAMCTRL_API int __stdcall MV_CC_SetDeviceUserID ( IN void *  handle,
IN const char *  chValue 
)

设置设备自定义名字

参数
handle[IN] 相机句柄
chValue[IN] 设备名字
返回
成功,返回MV_OK ,并且设置设备自定义名字;失败,返回状态码

◆ MV_CC_GetBurstFrameCount()

MV_CAMCTRL_API int __stdcall MV_CC_GetBurstFrameCount ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取一次触发的帧数

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机一次触发的帧数结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetBurstFrameCount()

MV_CAMCTRL_API int __stdcall MV_CC_SetBurstFrameCount ( IN void *  handle,
IN const unsigned int  nValue 
)

设置一次触发的帧数

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的一次触发的帧数
返回
成功,返回MV_OK ,并且相机一次触发的帧数会更改为相应值;失败,返回状态码

◆ MV_CC_GetAcquisitionLineRate()

MV_CAMCTRL_API int __stdcall MV_CC_GetAcquisitionLineRate ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取行频

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机行频结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetAcquisitionLineRate()

MV_CAMCTRL_API int __stdcall MV_CC_SetAcquisitionLineRate ( IN void *  handle,
IN const unsigned int  nValue 
)

设置行频

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的行频
返回
成功,返回MV_OK ,并且相机行频会更改为相应值;失败,返回状态码

◆ MV_CC_GetHeartBeatTimeout()

MV_CAMCTRL_API int __stdcall MV_CC_GetHeartBeatTimeout ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取心跳信息

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机心跳信息结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_CC_SetHeartBeatTimeout()

MV_CAMCTRL_API int __stdcall MV_CC_SetHeartBeatTimeout ( IN void *  handle,
IN const unsigned int  nValue 
)

设置心跳信息

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的心跳信息
返回
成功,返回MV_OK ,并且相机心跳信息会更改为相应值;失败,返回状态码

◆ MV_GIGE_GetGevSCPSPacketSize()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCPSPacketSize ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取网络包大小

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机网络包大小结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_GIGE_SetGevSCPSPacketSize()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCPSPacketSize ( IN void *  handle,
IN const unsigned int  nValue 
)

设置网络包大小

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的网络包大小
返回
成功,返回MV_OK ,并且相机网络包大小会更改为相应值;失败,返回状态码

◆ MV_GIGE_GetGevSCPD()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCPD ( IN void *  handle,
IN OUT MVCC_INTVALUE pstValue 
)

获取网络包发送间隔

参数
handle[IN] 相机句柄
pstValue[IN][OUT] 返回给调用者有关相机网络包发送间隔结构体指针
返回
成功,返回MV_OK ;失败,返回状态码
注解
可参照接口 MV_CC_GetWidth()

◆ MV_GIGE_SetGevSCPD()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCPD ( IN void *  handle,
IN const unsigned int  nValue 
)

设置网络包发送间隔

参数
handle[IN] 相机句柄
nValue[IN] 想要设置的网络包发送间隔
返回
成功,返回MV_OK ,并且相机网络包发送间隔会更改为相应值;失败,返回状态码

◆ MV_GIGE_GetGevSCDA()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCDA ( IN void *  handle,
unsigned int *  pnIP 
)

获取接收端IP地址,0xa9fe0102 表示 169.254.1.2

参数
handle[IN] 相机句柄
pnIP[IN][OUT] 返回给调用者接收端IP地址
返回
成功,返回MV_OK ;失败,返回状态码

◆ MV_GIGE_SetGevSCDA()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCDA ( IN void *  handle,
unsigned int  nIP 
)

设置接收端IP地址

参数
handle[IN] 相机句柄
nIP[IN] 想要设置的接收端IP地址
返回
成功,返回MV_OK ,并且相机接收端IP地址会更改为相应值;失败,返回状态码

◆ MV_GIGE_GetGevSCSP()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetGevSCSP ( IN void *  handle,
unsigned int *  pnPort 
)

获取发送端的端口号

参数
handle[IN] 相机句柄
pnPort[IN][OUT] 返回给调用者发送端的端口号
返回
成功,返回MV_OK ;失败,返回状态码

◆ MV_GIGE_SetGevSCSP()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetGevSCSP ( IN void *  handle,
unsigned int  nPort 
)

设置发送端的端口号

参数
handle[IN] 相机句柄
nPort[IN] 想要设置的发送端的端口号
返回
成功,返回MV_OK ,并且相机发送端的端口号会更改为相应值;失败,返回状态码

◆ MV_CAML_SetDeviceBauderate()

MV_CAMCTRL_API int __stdcall MV_CAML_SetDeviceBauderate ( IN void *  handle,
unsigned int  nBaudrate 
)

设置设备波特率

参数
handle[IN] 设备句柄
nBaudrate[IN] 设置的波特率值,数值参考CameraParams.h中宏定义
返回
成功,返回MV_OK ;失败,返回状态码
注解
(该接口已弃用,建议改用 MV_CAML_SetDeviceBaudrate() 接口)

◆ MV_CAML_GetDeviceBauderate()

MV_CAMCTRL_API int __stdcall MV_CAML_GetDeviceBauderate ( IN void *  handle,
unsigned int *  pnCurrentBaudrate 
)

获取设备波特率

参数
handle[IN] 设备句柄
pnCurrentBaudrate[OUT] 波特率信息指针,数值参考CameraParams.h中宏定义
返回
成功,返回MV_OK ;失败,返回状态码
注解
(该接口已弃用,建议改用 MV_CAML_GetDeviceBaudrate() 接口)

◆ MV_CAML_GetSupportBauderates()

MV_CAMCTRL_API int __stdcall MV_CAML_GetSupportBauderates ( IN void *  handle,
unsigned int *  pnBaudrateAblity 
)

获取设备与主机间连接支持的波特率

参数
handle[IN] 设备句柄
pnBaudrateAblity[OUT] 支持的波特率信息的指针。所支持波特率的或运算结果,单个数值参考CameraParams.h中宏定义,如MV_CAML_BAUDRATE_9600 0x00000001
返回
成功,返回MV_OK ;失败,返回状态码
弃用:
该接口已弃用,建议改用 MV_CAML_GetSupportBaudrates() 接口

◆ MV_USB_RegisterStreamExceptionCallBack()

MV_CAMCTRL_API int __stdcall MV_USB_RegisterStreamExceptionCallBack ( IN void *  handle,
IN   void__stdcall *cbException)(MV_CC_STREAM_EXCEPTION_TYPE enExceptionType, void *pUser,
IN void *  pUser 
)

注册流异常消息回调,在打开设备之后调用(只支持U3V相机,不支持GenTL设备)

参数
handle[IN] 设备句柄
cbException[IN] 异常回调函数指针
pUser[IN] 用户自定义变量
返回
成功,返回MV_OK ;失败,返回状态码
弃用:
自V4.6.0废弃。建议改用 MV_CC_RegisterStreamExceptionCallBack()

◆ MV_CC_SaveImageEx2()

MV_CAMCTRL_API int __stdcall MV_CC_SaveImageEx2 ( IN void *  handle,
MV_SAVE_IMAGE_PARAM_EX *  pstSaveParam 
)

保存图片,支持Bmp和Jpeg,编码质量在50-99之前(该接口已弃用,建议改用 MV_CC_SaveImageEx3() 接口)

参数
handle[IN] 设备句柄
pstSaveParam[IN][OUT] 保存图片参数结构体
返回
成功,返回MV_OK ;失败,返回状态码
注解
 • 通过该接口可以将从设备采集到的原始图像数据转换成JPEG或者BMP等格式并存放在指定内存中,然后用户可以将转换之后的数据直接保存成图片文件。该接口调用无接口顺序要求,有图像源数据就可以进行转换,可以先调用图像采集 接口,获取一帧图像数据,然后再通过该接口转换格式。
 • MV_CC_SaveImageEx2()MV_CC_SaveImageEx() 增加参数handle,为了保证与其他接口的统一。
示例
ImageProcess.cpp.

◆ MV_CC_SaveImageToFile()

MV_CAMCTRL_API int __stdcall MV_CC_SaveImageToFile ( IN void *  handle,
MV_SAVE_IMG_TO_FILE_PARAM *  pstSaveFileParam 
)

保存图像到文件(该接口已弃用,建议改用 MV_CC_SaveImageToFileEx() 接口)

参数
handle[IN] 设备句柄
pstSaveFileParam[IN][OUT] 保存图片文件参数结构体
返回
成功,返回MV_OK ;失败,返回状态码
注解
该接口支持BMP/JPEG/PNG/TIFF。

◆ MV_CC_ConvertPixelType()

MV_CAMCTRL_API int __stdcall MV_CC_ConvertPixelType ( IN void *  handle,
IN OUT MV_CC_PIXEL_CONVERT_PARAM *  pstCvtParam 
)

像素格式转换(该接口已弃用,建议改用 MV_CC_ConvertPixelTypeEx() 接口)

参数
handle[IN] 设备句柄
pstCvtParam[IN][OUT] 像素格式转换参数结构体
返回
成功,返回MV_OK ;失败,返回状态码
注解
 • 通过该接口可以将从设备采集到的原始图像数据转换成用户所需的像素格式并存放在指定内存中。
 • 该接口调用无接口顺序要求,有图像源数据就可以进行转换,可以先调用 MV_CC_GetOneFrameTimeout() 或者 MV_CC_RegisterImageCallBackEx() 设置回调函数,获取一帧图像数据,然后再通过该接口转换格式。如果设备当前采集图像是JPEG压缩的格式,则不支持调用该接口进行转换。
示例
ImageProcess.cpp.

◆ MV_CC_SetSDKLogPath()

MV_CAMCTRL_API int __stdcall MV_CC_SetSDKLogPath ( IN const char *  strSDKLogPath)

设置SDK日志路径

参数
strSDKLogPath[IN] SDK日志路径
返回
成功,返回MV_OK;失败,返回状态码
注解
设置路径之后,可以指定路径存放日志,V2.4.1版本新增日志服务,开启服务之后该接口无效,默认日志服务为开启状态。

◆ MV_CC_DisplayOneFrame()

MV_CAMCTRL_API int __stdcall MV_CC_DisplayOneFrame ( IN void *  handle,
IN MV_DISPLAY_FRAME_INFO *  pstDisplayInfo 
)

显示一帧图像(该接口已启用,建议改用 MV_CC_DisplayOneFrameEx2() 接口)

参数
handle[IN] 设备句柄
pstDisplayInfo[IN] 图像信息
返回
成功,返回MV_OK;失败,返回状态码
注解
与设备类型无关,渲染模式为D3D时,支持的最大分辨率为16384 * 163840

◆ MV_CC_EnumerateTls()

MV_CAMCTRL_API int __stdcall MV_CC_EnumerateTls ( )

获取支持的传输层

返回
当前支持的传输层协议类型和数值总和
注解
包含GigE、U3V、Camera Link、CoaXPress、XoFLink传输层。

◆ MV_CC_CreateHandleWithoutLog()

MV_CAMCTRL_API int __stdcall MV_CC_CreateHandleWithoutLog ( IN OUT void **  handle,
IN const MV_CC_DEVICE_INFO pstDevInfo 
)

创建设备句柄,不生成日志

参数
handle[IN][OUT] 设备句柄
pstDevInfo[IN] 设备信息结构体
返回
成功,返回MV_OK;失败,返回状态码
注解
 • 根据输入的设备信息,创建库内部必须的资源和初始化内部模块。
 • 通过该接口创建句柄,调用SDK接口,不会默认生成SDK日志文件,如果需要生成日志文件可以通过 MV_CC_CreateHandle() 创建句柄,日志文件自动生成。

◆ MV_CC_RegisterImageCallBackForRGB()

MV_CAMCTRL_API int __stdcall MV_CC_RegisterImageCallBackForRGB ( IN void *  handle,
IN   void__stdcall *cbOutput)(unsigned char *pData, MV_FRAME_OUT_INFO_EX *pFrameInfo, void *pUser,
IN void *  pUser 
)

注册图像数据回调,RGB

参数
handle[IN] 设备句柄
cbOutput[IN] 回调函数指针
pUser[IN] 用户自定义变量
返回
成功,返回MV_OK;失败,返回状态码
注解
 • 通过该接口可以设置图像数据回调函数,在 MV_CC_CreateHandle() 之后即可调用。
 • 图像数据采集有两种方式,两种方式不能复用:
  1. 调用 MV_CC_RegisterImageCallBackEx() 设置图像数据回调函数,然后调用 MV_CC_StartGrabbing() 开始采集,采集的图像数据在设置的回调函数中返回。
  2. 调用 MV_CC_StartGrabbing() 开始采集,然后在应用层循环调用 MV_CC_GetImageForRGB() 获取RGB24格式的帧数据,获取帧数据时上层应用程序需要根据帧率控制好调用该接口的频率。
 • 该接口不支持CameraLink设备。

◆ MV_CC_RegisterImageCallBackForBGR()

MV_CAMCTRL_API int __stdcall MV_CC_RegisterImageCallBackForBGR ( IN void *  handle,
IN   void__stdcall *cbOutput)(unsigned char *pData, MV_FRAME_OUT_INFO_EX *pFrameInfo, void *pUser,
IN void *  pUser 
)

注册图像数据回调,BGR

参数
handle[IN] 设备句柄
cbOutput[IN] 回调函数指针
pUser[IN] 用户自定义变量
返回
成功,返回MV_OK;失败,返回状态码
注解
 • 通过该接口可以设置图像数据回调函数,在 MV_CC_CreateHandle() 之后即可调用。
 • 图像数据采集有两种方式,两种方式不能复用:
  1. 调用 MV_CC_RegisterImageCallBackForBGR() 设置BGR24图像数据回调函数,然后调用 MV_CC_StartGrabbing() 开始采集,采集的图像数据在设置的回调函数中返回。
  2. 调用 MV_CC_StartGrabbing() 开始采集,然后在应用层循环调用 MV_CC_GetImageForBGR() 获取BGR24格式的帧数据,获取帧数据时上层应用程序需要根据帧率控制好调用该接口的频率。
 • 该接口不支持CameraLink设备。

◆ MV_CC_GetImageForRGB()

MV_CAMCTRL_API int __stdcall MV_CC_GetImageForRGB ( IN void *  handle,
IN OUT unsigned char *  pData,
IN unsigned int  nDataSize,
IN OUT MV_FRAME_OUT_INFO_EX pstFrameInfo,
IN int  nMsec 
)

获取一帧RGB数据,此函数为查询式获取,每次调用查询内部 缓存有无数据,有数据则获取数据,无数据返回错误码

参数
handle[IN] 设备句柄
pData[IN][OUT] 图像数据接收指针
nDataSize[IN] 接收缓存大小
pstFrameInfo[IN][OUT] 图像信息结构体
nMsec[IN] 等待超时时间
返回
成功,返回MV_OK;失败,返回状态码
注解
 • 每次调用该接口,将查询内部缓存是否有数据,如果有数据则转换成RGB24格式返回,如果没有数据则返回错误码。因为图像转换成RGB24格式有耗时,所以当数据帧率过高时该接口可能会导致丢帧。
 • 调用该接口获取图像数据帧之前需要先调用 MV_CC_StartGrabbing() 启动图像采集。该接口为主动式获取帧数据,上层应用程序需要根据帧率,控制好调用该接口的频率。
 • 该接口不支持CameraLink设备。

◆ MV_CC_GetImageForBGR()

MV_CAMCTRL_API int __stdcall MV_CC_GetImageForBGR ( IN void *  handle,
IN OUT unsigned char *  pData,
IN unsigned int  nDataSize,
IN OUT MV_FRAME_OUT_INFO_EX pstFrameInfo,
IN int  nMsec 
)

获取一帧BGR数据,此函数为查询式获取,每次调用查询内部 缓存有无数据,有数据则获取数据,无数据返回错误码

参数
handle[IN] 设备句柄
pData[IN][OUT] 图像数据接收指针
nDataSize[IN] 接收缓存大小
pstFrameInfo[IN][OUT] 图像信息结构体
nMsec[IN] 等待超时时间
返回
成功,返回MV_OK;失败,返回状态码
注解
 • 每次调用该接口,将查询内部缓存是否有数据,如果有数据则转换成BGR24格式返回,如果没有数据则返回错误码。因为图像转换成BGR24格式有耗时,所以当数据帧率过高时该接口可能会导致丢帧。
 • 调用该接口获取图像数据帧之前需要先调用 MV_CC_StartGrabbing() 启动图像采集。该接口为主动式获取帧数据,上层应用程序需要根据帧率,控制好调用该接口的频率。
 • 该接口不支持CameraLink设备。

◆ MV_CC_OpenParamsGUI()

MV_CAMCTRL_API int __stdcall MV_CC_OpenParamsGUI ( IN void *  handle)

打开获取或设置相机参数的GUI界面

参数
handle[IN] 设备句柄
返回
成功,返回MV_OK;失败,返回状态码
注解
通过 MV_CC_OpenDevice() 连接设备后,可以通过该接口获取或设置设备参数。

◆ MV_CC_SavePointCloudData()

MV_CAMCTRL_API int __stdcall MV_CC_SavePointCloudData ( IN void *  handle,
IN OUT MV_SAVE_POINT_CLOUD_PARAM *  pstPointDataParam 
)

保存3D点云数据,支持PLY、CSV和OBJ三种格式

参数
handle[IN] 设备句柄
pstPointDataParam[IN][OUT] 保存点云数据参数结构体
返回
成功,返回MV_OK;失败,返回状态码
注解
 • 3D数据格式保存成3D文件格式,支持PLY/CSV/OBJ。
 • 目前支持PixelType_Gvsp_Coord3D_ABC32、PixelType_Gvsp_Coord3D_ABC32f、PixelType_Gvsp_Coord3D_AB32、PixelType_Gvsp_Coord3D_AB32f、PixelType_Gvsp_Coord3D_AC32、PixelType_Gvsp_Coord3D_AC32f,暂不支持其他3D格式。