V4.5.0_November/2024

About Upgrade

Changed nImageBufLen of image information structure MV_CC_IMAGE to nImageLen. For normal execution of the program in this version of client, you should upgrade the above codes in your program.

New Features

Supported purple fringing correction feature. Added an API MV_CC_PurpleFringing() and a corresponding data structure MV_CC_PURPLE_FRINGING_PARAM for correcting purple fringing occurred in high-contrast or low light areas to enhance image quality. You can set different values of nKernelSize and nEdgeThreshold in MV_CC_PURPLE_FRINGING_PARAM to change the effect of purple fringing correction. And added Specified Error Codes of Correcting Purple Fringing, with range from 0x10405000 to 0x10405002, which refers to errors occurred during calling MV_CC_PurpleFringing(). These error codes help you troubleshoot corresponding issues.

Note
This feature is applicable to images in RGB and BGR formats.
Supported image grabbing, image rendering and image saving for images over 4 GB.
- Supported calling MV_CC_GetPayloadSize() to register a buffer over 4 GB.
- Supported calling MV_CC_RegisterImageCallBackEx() and MV_CC_GetImageBuffer() to get an image over 4 GB.
- Supported calling MV_CC_DisplayOneFrameEx2() to render an image over 4 GB.
  Note
  To execute rendering of an image over 4 GB, the OpenGL should be 2.0 or later version.
- Supported calling MV_CC_SaveImageToFileEx2() to save image over 4 GB in PNG or TIFF format.

Improvements

In frame information data structure MV_FRAME_OUT_INFO_EX , added SubImageList: It refers to information of sub images in image buffer list for image stitching of frame grabbers, including pstSubImage (sub image information) and nAligning (alignment). In time-phased flashing scenes, when dividing images via the frame grabber, you can use SubImageList to get the sub image.
In frame information data structure MV_FRAME_OUT_INFO_EX , added UserPtr: It refers to user-defined pointers for registering buffer , including pUser (sub image information) and nAligning (alignment).
In Status Code, added 0x80000017 to refer to the image height error (below the set height), and the incomplete image will be discarded.
Updated the ParametrizeCamera_AreaScanIOSettings.cpp in console sample programs for configuring trigger node IO settings of area scan cameras.

Deprecations

Deprecated the sample program of ForceIP.cpp.

Structures Adjusted

Updated Programming Guide, and you can quick start the SDK based on this chapter.
Updated FAQs, and you can troubleshoot the frequent program issues based on this chapter.

V4.4.1_August/2024

New Features

Added an extended API for getting Enum attribute value: MV_CC_GetEnumValueEx(), supporting up to 256 nodes, and added a corresponding data structure: MVCC_ENUMVALUE_EX .
Added an extended API for displaying one frame of image: MV_CC_DisplayOneFrameEx2(), and added a corresponding data structure: MV_CC_IMAGE .
Added an extended API for image saving: MV_CC_SaveImageToFileEx2(), and added a corresponding data structure: MV_CC_SAVE_IMAGE_PARAM .
Added an API for enumerating cameras by corresponding frame grabber handles: MV_CC_EnumDevicesByInterface().
Added APIs for enabling and disabling specified events of cameras and frame grabbers: MV_CC_EventNotificationOn() and MV_CC_EventNotificationOff().
Added some console sample programs: MultiLightCtrl_ImageStitching.cpp, Events_Interface.cpp, ImageSave.cpp, and ParametrizeCamera_LineScanIOSettings.cpp.

Improvements

Optimized ::MV_FRAME_OUT_INFO_EX() by adding nFrameLenEx.
Optimized some console sample programs: Display.cpp, InterfaceAndDeviceDemo.cpp, etc.
Optimized some Status Codes.
- Decoding error: 0x80000015.
- The image size exceeded the upper limit of unsigned integer data: 0x80000016.
- IP mode editing is not supported in static IP mode: 0x8000020E.

Deprecations

Deprecated camera initialization related APIs: MV_CC_EnumerateTls() and MV_CC_CreateHandleWithoutLog().
Deprecated image acquisition related APIs: MV_CC_RegisterImageCallBackForRGB(), MV_CC_RegisterImageCallBackForBGR(), MV_CC_GetImageForRGB(), and MV_CC_GetImageForBGR().
Deprecated image rendering related API MV_CC_DisplayOneFrame() and MV_DISPLAY_FRAME_INFO . API MV_CC_DisplayOneFrameEx() or MV_CC_DisplayOneFrameEx2() are recommended.
Deprecated a camera attribute configuration API: MV_CC_OpenParamsGUI().
Deprecated 3D point cloud related API MV_CC_SavePointCloudData(), the data structure MV_SAVE_POINT_CLOUD_PARAM, the enumeration MV_SAVE_POINT_CLOUD_FILE_TYPE ,
and the sample programs SavePointCloudData_3D.cpp.

V4.4.0_June/2024

New Features

Added an API for importing device attribute: MV_CC_FeatureLoadEx().
Added data structures: MVCC_NODE_ERROR for node error and MVCC_NODE_ERROR_LIST for node error list.
Added sample programs for quick software trigger: QuickSoftwareTrigger.cpp.

Improvements

Changed the name of sample programs for acquiring image via callback to GrabImage_Callback.cpp.
Optimized some console sample programs: InterfaceDemo.cpp, ReconnectDemo.cpp, etc.
Optimized some Status Codes.

Structures Adjusted

Moved Status Code to API Interface.

V4.3.0_December/2023

New Features

Added APIs of SDK Initialization: MV_CC_Initialize() for initializing SDK and MV_CC_Finalize() for deinitializing SDK.
Added APIs of frame grabber initialization: MV_CC_EnumInterfaces() for enumerating frame grabbers, MV_CC_CreateInterface() and MV_CC_CreateInterfaceByID() for creating frame grabber handles,
MV_CC_OpenInterface() for opening frame grabbers, MV_CC_CloseInterface() for closing frame grabbers, and MV_CC_DestroyInterface() for destroying frame grabber handles.
Added APIs of Camera Link Camera: MV_CAML_GetSerialPortList() for getting serial port information list and MV_CAML_SetEnumSerialPorts() for setting specified enumeration list of serial ports.
For APIs of Image Rendering, supports rendering images of width (max. 16384) and height (max. 163840).
For the API MV_CC_SetBayerCvtQuality() in Image Processing, extended the parameter BayerCvtQuality by adding the value of optimal plus.
For APIs of Image Processing and Attribute Configuration, supports frame grabber handles.
For APIs of Device Upgrade, supports frame grabber firmware upgrade.
For APIs of Event and Exception, supports frame grabber events.
Added structures: MV_INTERFACE_INFO of frame grabber information, and MV_INTERFACE_INFO_LIST of frame grabber information list.
Added structures: MV_CAML_SERIAL_PORT of serial port information, and MV_CAML_SERIAL_PORT_LIST of serial port information list.
Added structures: MV_CXP_DEVICE_INFO of CoaXPress camera information, MV_CML_DEVICE_INFO of Camera Link camera information list, and MV_XOF_DEVICE_INFO of XoFLink camera information.
Added some console sample programs: Display.cpp, ForceIPEx.cpp, Grab_Asynchronous.cpp, InterfaceAndDeviceDemo.cpp, and InterfaceDemo.cpp.

Improvements

Updated structures: MV_SAVE_IMAGE_TO_FILE_PARAM_EX for saving images to files parameters, and MV_SAVE_IMAGE_PARAM_EX3 for image saving parameters.
Updated the structures of display frame information: MV_DISPLAY_FRAME_INFO and MV_DISPLAY_FRAME_INFO_EX .
Updated the structures of CCM parameters: MV_CC_CCM_PARAM and MV_CC_CCM_PARAM_EX .
Updated the structure of device information: MV_CC_DEVICE_INFO .
Updated the sharpness structure: MV_CC_SHARPEN_PARAM .
Updated Status Code.

Structures Adjusted

Adjusted the structure of API Reference.

V4.1.0_March 2023

New Features

All APIs supported being used in multiple systems (Windows32/64, Linux32/64, armhf, aarch64, arm-none). The SDK function modules became consistent in Linux and Windows.
Supported controlling camera demo (BasicDemoByGenTL) and line scan camera demo (BasicDemoLineScan) by loading CTI files.
Added lossless decoding sample program: HighBandwithDecode.cpp.
Added an API for saving images: MV_CC_SaveImageEx3(), and deprecated the API MV_CC_SaveImageEx2().
Added an API for saving images to files: MV_CC_SaveImageToFileEx(), and deprecated the API MV_CC_SaveImageToFile().
Added an API for converting pixel format: MV_CC_ConvertPixelTypeEx(), and deprecated the API MV_CC_ConvertPixelType().
Added a structure of images saving parameters: MV_SAVE_IMAGE_PARAM_EX3 .
Added a structure of saving images to files parameters: MV_SAVE_IMAGE_TO_FILE_PARAM_EX .
Added a structure of pixel format conversion parameters: MV_CC_PIXEL_CONVERT_PARAM_EX .
Optimized some Status Codes.

Structures Adjusted

Added driver installation steps in Software Environment Configuration.

V3.2.0_July 2021

New Features

Added an API for clearing buffer for image grabbing: MV_CC_ClearImageBuffer().
Added an API for rotating images: :: MV_CC_RotateImage().
Added an API for flipping images: :: MV_CC_FlipImage().
Added an API for setting Gamma parameters of images in Bayer format: MV_CC_SetBayerGammaParam().
Added an API for decoding the lossless compression stream into raw data: MV_CC_HB_Decode().
Added an API for setting the packet size of USB3 vision device: MV_USB_SetTransferSize().
Added an API for getting the packet size of USB3 vision device: MV_USB_GetTransferSize().
Added an API for setting the number of transmission channels for USB3 vision device: MV_USB_SetTransferWays().
Added an API for getting the number of transmission channels for USB3 vision device: MV_USB_GetTransferWays().
Added an API for getting timeout for GVCP command: MV_GIGE_GetGvcpTimeout().
Added an API for setting resending times of GVCP command: MV_GIGE_SetRetryGvcpTimes().
Added an API for getting resending times of GVCP command: MV_GIGE_GetRetryGvcpTimes().
Added a structure of rotating images: MV_CC_ROTATE_IMAGE_PARAM .
Added a structure of flipping images: MV_CC_FLIP_IMAGE_PARAM .
Added a structure about Gamma information: MV_CC_GAMMA_PARAM .
Added a structure about watermark information: MV_CC_FRAME_SPEC_INFO .
Added a structure about lossless decoding parameters: MV_CC_HB_DECODE_PARAM .

Improvements

Adopted static linking library of GenICam, excluding GenICam dynamic library.
The GigE driver supported the ARM structure and two types of ARM boards: NVIDIA TX2 and ODROID-XU4.
Provided the SDK installation package (Runtime package), which includes the script of driver installation and the script of enabling read and write caching for USB3 vision cameras. The provided installation packages vary with the system (ARM or x86).
Updated the driver name to gevfilter.
Updated an API for registering single event callback (supporting USB devices): MV_CC_RegisterEventCallBackEx().
Updated an API for registering multiple events callback (supporting USB devices): MV_CC_RegisterAllEventCallBack().

V3.1.0_March 2020

New Features

Added the driver support for connecting to GigE cameras.
Supported image grabbing support for 3D cameras.
Supported BGR image grabbing and rendering.
Supported Chunk Data support for new cameras (in 3.1.0 and later versions).

V3.0.0_June 2018

New Features

Added an API for sending PTP (Precision Time Protocol) command of taking photo: MV_GIGE_IssueActionCommand().
Added an API for checking if device is connected: MV_CC_IsDeviceConnected().
Added an API for clearing cache for GenICam node: MV_CC_InvalidateNodes().
Added an API for releasing image buffer: MV_CC_FreeImageBuffer().
Added an API for high-performance image grabbing: MV_CC_GetImageBuffer().

Improvements

Optimized an API for getting all types of information: MV_CC_GetAllMatchInfo().
Optimized an API for getting network transmission information: MV_GIGE_GetNetTransInfo().

V2.4.0_June 2018

New Features

Added an API for reading files from device: MV_CC_FileAccessRead().
Added an API for writing files to device: MV_CC_FileAccessWrite().
Added an API for importing camera attributes: MV_CC_FeatureLoad().
Added an API for saving camera attributes: MV_CC_FeatureSave().
Added an API for registering single event callback: MV_CC_RegisterEventCallBackEx().
Added an API for registering multiple events callback: MV_CC_RegisterAllEventCallBack().
Added an API for setting the preferred network mode inside the SDK: MV_GIGE_SetTransmissionType().
Added an API for setting file saving path of SDK logs: MV_CC_SetSDKLogPath().
Added an API for saving images: MV_CC_SaveImageEx2().
Added an API for getting 64-bit integer node value of cameras: MV_CC_GetIntValueEx().
Added an API for setting 64-bit integer node value of cameras: MV_CC_SetIntValueEx().
Added an API for setting 64-bit enumeration node value of cameras: MV_CC_SetEnumValueByString().
Added an API for getting the import/export progress of camera parameters: MV_CC_GetFileAccessProgress().

V2.2.0.7_November 2017

New Features

Added an API for converting pixel format: MV_CC_ConvertPixelType().
Added an API for getting a frame of image directly: MV_CC_GetOneFrameTimeout().
Added an API for saving images: ::MV_CC_SaveImage().
Added an extended API for saving images: MV_CC_SaveImageEx().

Improvements

Deprecated the API for getting one frame of image: MV_CC_GetOneFrame().