发版说明

发版说明

V4.7.0

V4.7.0版本发布于2025年11月。

【功能新增】

• 开放外部注册缓存。新增 MV_CC_AllocAlignedBuffer() 、 MV_CC_FreeAlignedBuffer() 、 MV_CC_RegisterBuffer() 和 MV_CC_UnRegisterBuffer() ，分别用于分配对齐内存、释放对齐内存、外部注册缓存到SDK内部和取消SDK内部注册缓存。
  • 在您调用 MV_CC_StartGrabbing() 之前，若未注册缓存，则SDK默认使用内部缓存。
  • 在您调用 MV_CC_StartGrabbing() 之前，若已注册缓存（通过 MV_CC_GetPayloadSize() 、 MV_CC_AllocAlignedBuffer() 和 MV_CC_RegisterBuffer() ），则SDK是外部注册缓存模式。
    该模式支持动态调整缓存大小。即在调用 MV_CC_StartGrabbing() 之后，您仍可根据实际需求，动态调用 MV_CC_RegisterBuffer() 和 MV_CC_UnRegisterBuffer() 调整缓存。

    注解

    您可参考 配置缓存 中的介绍，了解相关接口调用流程。
    

• 支持RGB12格式图像的渲染和保存。
  • 支持渲染RGB12像素格式的图像。
  • 支持调用 MV_CC_SaveImageEx3() ， MV_CC_SaveImageToFileEx() 和 MV_CC_SaveImageToFileEx2() 保存RGB12格式的图像。
• 支持快速FileAccess功能。若相机和其固件支持，则可通过该功能，大幅提高文件的导入导出速率。

【功能更新】

• MV_CC_DisplayOneFrameEx() 和 MV_CC_DisplayOneFrameEx2() 支持渲染 PixelType_Gvsp_YUV420SP_NV12 和 PixelType_Gvsp_YUV420SP_NV21 格式。
• MV_CC_ConvertPixelTypeEx() 支持将部分Bayer8（包含BayerRG8、BayerGR8、BayerGB8、BayerBG8）像素格式图像转换为RGB8 Planar像素格式图像。
• 事件相关功能优化。
  • 单进程下，支持同一采集卡的多个句柄同时注册事件。在同一进程下，假设您分别对其句柄A和句柄B调用 MV_CC_RegisterEventCallBackEx() 注册同一事件M，句柄A和句柄B会同时接收到事件M。

    注解

    对同一句柄多次注册同一事件时，旧注册的回调函数和自定义信息会被覆盖。

  • SDK支持接收CoaXPress相机事件。
• MV_CC_STREAM_EXCEPTION_TYPE 中新增 MV_CC_STREAM_EXCEPTION_IMAGE_BUFFER_OVERFLOW ，表示设备发送的图像数据大小超过了图像缓冲区容量，该帧被丢弃。
• MV_FRAME_OUT_INFO_EX 新增“nFirstLineEncoderCount”和“nLastLineEncoderCount”成员，分别表示首行编码器计数和尾行编码器计数。
• VisionPro插件支持VP9.23和VP9.24。
• 优化采集卡事件性能，降低CPU占用。

V4.6.0

V4.6.0版本发布于2025年6月。

【功能新增】

• 该版本新增支持串口光源控制器。您可通过 串口设备 相关接口，完成打开、控制串口光源控制器等操作。
• 新增取图回调扩展接口 MV_CC_RegisterImageCallBackEx2() 。该接口支持您在回调函数外手动调用 MV_CC_FreeImageBuffer() 释放缓存。

  注解

  关于该接口的更多使用说明，请参见接口描述。

• 新增流异常回调相关功能，用于通过回调函数上报取流过程中出现的异常。
  • 新增 MV_CC_RegisterStreamExceptionCallBack() ，用于注册流异常消息回调。该接口支持GEV、U3V和采集卡下的所有相机。
  • MV_CC_STREAM_EXCEPTION_TYPE 中，新增流异常类型。
  • 新增 MV_CC_STREAM_EXCEPTION_INFO ，表示流异常回调信息。
• 新增 串口控制相关 接口。该类接口用于在工业相机外接串口设备时（如液态镜头），通过SDK串口控制相关接口，实现与相机外接的串口设备进行通信。
  • 支持通过 MV_CC_SerialPort_Open() 打开串口。
  • 支持读取（ MV_CC_SerialPort_Read() ）、写入（ MV_CC_SerialPort_Write() ）、或清空已获取的串口数据（ MV_CC_SerialPort_ClearBuffer() ）。
  • 支持通过 MV_CC_SerialPort_Close() 关闭串口。
• 新增 回调函数定义 ，用于注册图像数据、异常消息等。
• MV_CC_ConvertPixelTypeEx() 支持将Bayer10/12转为Bayer16格式。

  注解

  对于Bayer10 packed和Bayer12 packed格式，您需首先将图像格式转为Bayer10和Bayer12后，再转为Bayer16。

• 新增 通用状态码 ：
  • 0x80000018：DDR缓存不足。
  • 0x80000019：流通道不足。

【示例程序】

• 新增 LineScanSoftwareTrigger.cpp 示例，用于演示控制线阵相机设置帧触发，开启软触发取图。
• 修改 ParametrizeCamera_LineScanIOSettings.cpp 示例程序，您可参考该程序，了解如何兼容新版本的相机节点。
• 修改 ChunkData.cpp 、 Grab_Asynchronous.cpp 等示例程序。

【功能废弃】

• 废弃 MV_USB_RegisterStreamExceptionCallBack() ，您可使用 MV_CC_RegisterStreamExceptionCallBack() 实现相关需求。

V4.5.1

该版本新增ISP配置相关接口，您可在程序调用相应接口对图像进行ISP算法处理。

【功能新增】

• 支持传入ISP参数以对图像进行ISP算法处理。在通过ISP工具配置图像处理参数并保存配置文件后，您可通过 MV_CC_SetISPConfig() 及 MV_CC_ISP_CONFIG_PARAM 将ISP配置文件传入程序。之后，您可调用 MV_CC_ISPProcess() 对图像数据进行ISP算法处理。

V4.5.0

【升级必看】

该版本将 MV_CC_IMAGE 图像信息结构体中的 nImageBufLen 成员名称更改为 nImageLen。为确保您程序的正常运行，您需要在升级到该版本后，更新您程序中的代码。

【功能新增】

• 支持图像去紫边功能。新增去紫边接口 MV_CC_PurpleFringing() 和结构体 MV_CC_PURPLE_FRINGING_PARAM ，用于去除图像中物体边缘由高反差、逆光等引起的紫边，从而提高图像质量。您可设置 MV_CC_PURPLE_FRINGING_PARAM 中 nKernelSize 和 nEdgeThreshold 的值，调整去紫边的处理效果。
  同时，新增去紫边特有错误码，范围为0x10405000-0x10405002，用于表示在调用 MV_CC_PurpleFringing() 时可能存在的错误。您可根据错误信息，排查问题。

  注解

  该功能支持RGB和BGR像素格式的图像。

• 支持4GB以上大小的图像取流、渲染和存图。
  • 支持通过 MV_CC_GetPayloadSize() 注册4GB以上的缓存。
  • 支持调用 MV_CC_RegisterImageCallBackEx() 和 MV_CC_GetImageBuffer() 获取4GB以上图像。
  • 支持调用 MV_CC_DisplayOneFrameEx2() 渲染4GB以上超大图。

    注解

    渲染4GB以上超大图时，需确保OpenGL为2.0及之后版本。

  • 支持调用 MV_CC_SaveImageToFileEx2() 以PNG或TIFF格式保存4G以上超大图。

【功能更新】

• 帧信息结构体 MV_FRAME_OUT_INFO_EX 新增 SubImageList：用于表示采集卡拼图时图像缓存中的子图个数，包含子图信息 pstSubImage 和校准 nAligning。在分时频闪场景，通过采集卡端拆图时，您可通过SubImageList获取子图。
• 帧信息结构体 MV_FRAME_OUT_INFO_EX 新增 UserPtr：用于表示外部注册缓存时的用户自定义指针，包含自定义指针 pUser 和校准 nAligning。
• 状态码 中，新增0x80000017，表示图像高度异常（残帧丢弃）。
• 新增控制台demo ParametrizeCamera_AreaScanIOSettings.cpp，您可以参照该demo，在您的程序中配置面阵相机触发节点IO。

【功能废弃】

• 废弃ForceIP.cpp示例程序。

【文档调整】

• 优化编程引导内容，您可参照编程引导 快速上手和使用本SDK。
• 更新常见问题章节，详情请参见常见问题 。

V4.4.1

【功能新增】

• 新增获取Enum属性值扩展接口 MV_CC_GetEnumValueEx() 和对应的枚举类型值结构体 MVCC_ENUMVALUE_EX 。该接口最大支持到256个节点。
• 新增显示一帧图像扩展接口 MV_CC_DisplayOneFrameEx2() 和对应的图像信息结构体 MV_CC_IMAGE 。
• 新增保存图像到文件扩展接口 MV_CC_SaveImageToFileEx2() 和对应的保存图片所需参数结构体 MV_CC_SAVE_IMAGE_PARAM 。
• 新增通过采集卡句柄枚举相机接口 MV_CC_EnumDevicesByInterface() 。
• 新增开启设备指定事件接口 MV_CC_EventNotificationOn() 和关闭设备指定事件接口 MV_CC_EventNotificationOff() 。
• 新增Linux控制台demo，包含MultiLightCtrl_ImageStitching.cpp 、Events_Interface.cpp 、ImageSave.cpp 和ParametrizeCamera_LineScanIOSettings.cpp 。

【功能更新】

• 更新 MV_FRAME_OUT_INFO_EX() 输出帧的信息结构体，新增nFrameLenEx字段。
• 更新部分Linux控制台demo，包含Display.cpp 、InterfaceAndDeviceDemo.cpp 等。
• 新增部分状态码 。
  • 0x80000015：表示解码错误。
  • 0x80000016：表示图像大小超出unsigned int数据类型上限值。
  • 0x8000020E：表示在固定IP模式下不支持修改设备IP模式。

【功能废弃】

• 废弃相机初始化相关接口： MV_CC_EnumerateTls() 和 MV_CC_CreateHandleWithoutLog() 。
• 废弃图像采集相关接口： MV_CC_RegisterImageCallBackForRGB() 、 MV_CC_RegisterImageCallBackForBGR() 、 MV_CC_GetImageForRGB() 和 MV_CC_GetImageForBGR() 。
• 废弃显示相关接口和结构体： MV_CC_DisplayOneFrame() 和 MV_DISPLAY_FRAME_INFO 。
• 废弃相机属性相关接口： MV_CC_OpenParamsGUI() 。
• 废弃3D点云图像相关接口、结构体及枚举类型： MV_CC_SavePointCloudData() 、 MV_SAVE_POINT_CLOUD_PARAM 和 MV_SAVE_POINT_CLOUD_FILE_TYPE() 。
• 废弃SetIO.cpp示例程序。

V4.4.0

【功能新增】

• 新增导入设备属性扩展接口 MV_CC_FeatureLoadEx() 。
• 新增节点错误信息结构体 MVCC_NODE_ERROR 、节点错误信息列表结构体 MVCC_NODE_ERROR_LIST 。
• 支持采集卡快速软触发功能，并新增示例程序：QuickSoftwareTrigger.cpp 。

【功能更新】

• 调整通过回调获取相机图像demo的文件名：GrabImage_Callback.cpp 。
• 更新Linux控制台demo，包含InterfaceDemo.cpp 、ReconnectDemo.cpp 等。
• 新增部分状态码 。

【文档调整】

• 合并状态码 至接口说明中介绍。

V4.3.0

【功能新增】

• 新增初始化SDK接口 MV_CC_Initialize() 、反初始化SDK接口 MV_CC_Finalize() 。
• 新增枚举采集卡接口 MV_CC_EnumInterfaces() 、创建采集卡句柄接口 MV_CC_CreateInterface() 和 MV_CC_CreateInterfaceByID() 。
• 新增打开采集卡接口 MV_CC_OpenInterface() 、关闭采集卡接口 MV_CC_CloseInterface() 、销毁采集卡句柄接口 MV_CC_DestroyInterface() 。
• 新增获取串口信息列表接口 MV_CAML_GetSerialPortList() 、设置指定串口列表接口 MV_CAML_SetEnumSerialPorts() 。
• 图像渲染 接口支持对大图（宽高上限为16384*163840）进行渲染。
• 图像处理 中的设置插值算法类型接口 MV_CC_SetBayerCvtQuality() 新增“最优+”插值方法。
• 图像处理 和属性配置 接口支持采集卡句柄。
• 设备升级 接口支持采集卡固件升级。
• 事件及异常 接口支持采集卡事件。
• 新增采集卡信息结构体 MV_INTERFACE_INFO 、采集卡信息列表结构体 MV_INTERFACE_INFO_LIST 。
• 新增串口信息结构体 MV_CAML_SERIAL_PORT 、串口信息列表结构体 MV_CAML_SERIAL_PORT_LIST 。
• 新增CoaXPress相机信息结构体 MV_CXP_DEVICE_INFO 、CameraLink相机信息结构体 MV_CML_DEVICE_INFO 、XoFLink相机信息结构体 MV_XOF_DEVICE_INFO 。
• 新增Linux控制台demo：Display.cpp 、ForceIPEx.cpp 、Grab_Asynchronous.cpp 、InterfaceAndDeviceDemo.cpp 、InterfaceDemo.cpp 。

【功能更新】

• 更新保存图片到文件参数结构体 MV_SAVE_IMAGE_TO_FILE_PARAM_EX 、图片保存参数结构体 MV_SAVE_IMAGE_PARAM_EX3 。
• 更新显示帧信息结构体 MV_DISPLAY_FRAME_INFO 和 MV_DISPLAY_FRAME_INFO_EX 。
• 更新CCM参数结构体 MV_CC_CCM_PARAM 和 MV_CC_CCM_PARAM_EX 。
• 更新设备信息结构体 MV_CC_DEVICE_INFO 。
• 更新锐化结构体 MV_CC_SHARPEN_PARAM 。
• 更新状态码 。

【文档调整】

• 调整接口说明的模块划分。

V4.2.0

【功能新增】

• 支持采集卡GE1104。

V4.1.0

【功能新增】

• 所有接口支持跨平台（Windows32/64、Linux32/64、armhf、aarch64、arm-none），Linux和Windows下工业相机SDK功能模块统一。
• 新增通过加载cti文件的方式控制相机的demo（BasicDemoByGenTL）和线阵相机demo（BasicDemoLineScan）。
• 新增HB解码demo：HighBandwithDecode.cpp 。
• 新增图像保存接口： MV_CC_SaveImageEx3()，废弃旧接口 MV_CC_SaveImageEx2() 。
• 新增保存图像到文件接口： MV_CC_SaveImageToFileEx()，废弃旧接口 MV_CC_SaveImageToFile()。
• 新增像素格式转换接口： MV_CC_ConvertPixelTypeEx()，废弃旧接口 MV_CC_ConvertPixelType()。
• 新增图片保存参数结构体： MV_SAVE_IMAGE_PARAM_EX3 。
• 新增保存图片到文件参数结构体： MV_SAVE_IMAGE_TO_FILE_PARAM_EX 。
• 新增像素转换结构体： MV_CC_PIXEL_CONVERT_PARAM_EX 。
• 新增部分状态码 。

【文档调整】

• 更新环境配置 章节的驱动安装步骤。

V3.2.0

【功能新增】

• 新增清除取流数据缓存接口： MV_CC_ClearImageBuffer() 。
• 新增图像旋转接口： MV_CC_RotateImage() 。
• 新增图像翻转接口： MV_CC_FlipImage() 。
• 新增设置Bayer格式的Gamma信息接口： MV_CC_SetBayerGammaParam() 。
• 新增无损解码接口： MV_CC_HB_Decode() 。
• 新增设置U3V的传输包大小接口： MV_USB_SetTransferSize() 。
• 新增获取U3V的传输包大小接口： MV_USB_GetTransferSize() 。
• 新增设置U3V的传输通道个数接口： MV_USB_SetTransferWays() 。
• 新增获取U3V的传输通道个数接口： MV_USB_GetTransferWays() 。
• 新增获取GVCP命令超时时间接口： MV_GIGE_GetGvcpTimeout() 。
• 新增设置重传GVCP命令次数接口： MV_GIGE_SetRetryGvcpTimes() 。
• 新增获取重传GVCP命令次数接口： MV_GIGE_GetRetryGvcpTimes() 。
• 新增图像旋转结构体： MV_CC_ROTATE_IMAGE_PARAM 。
• 新增图像翻转结构体： MV_CC_FLIP_IMAGE_PARAM 。
• 新增Gamma信息结构体： MV_CC_GAMMA_PARAM 。
• 新增水印信息结构体： MV_CC_FRAME_SPEC_INFO 。
• 新增无损解码参数结构体： MV_CC_HB_DECODE_PARAM 。

【功能优化】

• 采用静态链接GenICam库的方式，不提供GenICam动态库。
• GigE 驱动支持arm架构设备，支持两款开发板环境： NVIDIA TX2 和 ODROID-XU4 。
• 提供SDK安装包（Runtime包），包括驱动安装、U3V开缓存等脚本，不包含巨帧设置，区分arm和x86安装包。
• 更新驱动名称为 gevfilter。
• 更新注册单个Event事件回调接口，支持USB设备： MV_CC_RegisterEventCallBackEx() 。
• 更新注册多个Event事件回调接口，支持USB设备： MV_CC_RegisterAllEventCallBack() 。

V3.1.0

【功能新增】

• X86架构对接Gige相机，新增驱动支持。
• 新增枚举以广播包回复的智能相机的支持。
• 新增3D相机的取流支持。
• 新增BGR图像取流及渲染的支持。
• 新增新相机（3.1.0及以后固件）ChunkData的支持。

V3.0.0

【功能新增】

• 新增发出PTP时钟拍照动作命令函数接口： MV_GIGE_IssueActionCommand() 。
• 新增判断相机是否处于连接状态函数接口： MV_CC_IsDeviceConnected() 。
• 新增清除GenICam节点缓存接口： MV_CC_InvalidateNodes() 。
• 新增释放图像缓存接口： MV_CC_FreeImageBuffer() 。
• 新增高性能取流接口： MV_CC_GetImageBuffer() 。

【功能优化】

• 优化获取各种类型的信息函数接口： MV_CC_GetAllMatchInfo() 。
• 优化获取网络传输相关信息函数接口： MV_GIGE_GetNetTransInfo() 。

V2.4.0

【功能新增】

• 新增读取相机文件接口： MV_CC_FileAccessRead() 。
• 新增将本地文件写入相机接口： MV_CC_FileAccessWrite() 。
• 新增导入相机属性接口： MV_CC_FeatureLoad() 。
• 新增保存相机属性接口： MV_CC_FeatureSave() 。
• 新增注册单个Event事件回调接口： MV_CC_RegisterEventCallBackEx() 。
• 新增注册多个Event事件回调接口： MV_CC_RegisterAllEventCallBack() 。
• 新增设置SDK内部优先使用的网络模式接口： MV_GIGE_SetTransmissionType() 。
• 新增设置sdklog文件保存路径接口： MV_CC_SetSDKLogPath() 。
• 新增新增图片保存接口： MV_CC_SaveImageEx2() 。
• 新增获取相机64位int型节点值接口： MV_CC_GetIntValueEx() 。
• 新增设置相机64位int型节点值接口： MV_CC_SetIntValueEx() 。
• 新增设置相机Enum型节点值接口： MV_CC_SetEnumValueByString() 。
• 新增获取相机参数导入导出进度接口： MV_CC_GetFileAccessProgress() 。

V2.2.0.7

【功能新增】

• 新增转换像素格式的接口： MV_CC_ConvertPixelType() 。
• 新增直接取图接口： MV_CC_GetOneFrameTimeout() 。
• 新增图像保存接口： MV_CC_SaveImage() 。
• 新增图像保存拓展接口： MV_CC_SaveImageEx() 。

【功能调整】

• 逐渐废弃获取一帧图像接口： MV_CC_GetOneFrame() 。