Mech-Eye SDK 2.4.1 Release Notes
This topic introduces the new features, improvements, and resolved issues of Mech-Eye SDK 2.4.1.
Mech-Eye Viewer
Provides New Model LNX-75150-GL
The LNX-7500 series introduces the new model LNX-75150-GL to fulfill various FOV requirements and provide high-accuracy solutions. LNX-75150-GL is suitable for dimension measurement and defect detection of products such as laptops, tablets, automotive parts, casting parts, injection molded parts. Hardware specifications of this model are detailed in Laser Profiler Model Comparison.
Parameter Group Feature Upgrade
Added support for creating new parameter groups from templates and managing them in bulk.
Measurement Tool in Point Cloud Display Interface
A new measurement icon 
has been added to the point cloud display interface, allowing users to easily toggle the measurement tool on or off.
Parameter Upgrade: Scan Line Count
The minimum value for Scan Line Count in the Scan Settings category of the Scan mode can now be set to 1.
New Parameter: Outlier Removal
A new Outlier Removal parameter has been added to the Profile Processing category in the Profile mode, which is used to remove outliers from each profile.
New Parameter: Data Acquisition Method
A new Data Acquisition Method parameter has been added to the Trigger Settings category of the Scan mode. When this parameter is set to Nonstop and the continuous acquisition button 
is used to trigger data acquisition, the laser profiler will continuously scan the target object and return fixed-length data segments without interruption. For details, refer to the data acquisition process in continuous scanning.
Change of Parameter Visibility
The visibility of the following parameters is changed from Beginner to Expert of Guru to improve usability.
| Data mode | Parameter | Visibility (in version 2.5.0) |
|---|---|---|
Profile Mode |
Min Laser Line Width |
Expert |
Max Laser Line Width |
Expert |
|
Gap Filling Edge Preservation |
Guru |
|
Resampling |
Guru |
|
Resampling Edge Preservation |
Guru |
|
Scan Mode |
Timeout Period |
Expert |
X-Axis Profile Alignment |
Expert |
|
Z-Axis Profile Alignment |
Expert |
|
Blind Spot Filtering |
Expert |
|
Noise Removal |
Expert |
Resolved Issues
The following issues have been resolved in Mech-Eye SDK 2.5.0:
-
Occasional: After a firmware upgrade, the Upgrade button might still briefly appear on the information card in Mech-Eye Viewer.
-
When the IPC had two network interface cards, if the one with a smaller hop count and with connection to the router was not on the same subnet as laser profiler, an error occurred when trying to connect to laser profiler after modifying the IP address of laser profiler.
-
When the parameter value of Min Laser Line Width was greater than 2 and the laser line moved to the center of the raw image, the laser profiler might fail to extract the laser line in the Scan mode, resulting in a large number of invalid points in the intensity image and depth map.
-
Occasional: When the Exposure Mode was set to HDR and the set exposure times were not configured in a decreasing sequence, the laser profiler might fail to acquire data in the Scan mode.
Mech-Eye API
New Parameter: Outlier Removal
A new Outlier Removal parameter has been added to the Profile Processing category, which is used to remove outliers from each profile. In the Mech-Eye API, you can enable this function using the EnableOutlierRemoval parameter and adjust the removal intensity using the OutlierRemovalIntensity parameter.
New Parameter: Data Acquisition Method
A new DataAcquisitionMethod parameter has been introduced, enabling continuous scanning of a target object. When this parameter is set to Nonstop and the continuous acquisition button is used to trigger data acquisition, the laser profiler will continuously scan the target object and return fixed-length data segments without interruption. For details, refer to the data acquisition process in continuous scanning.
|
The relevant samples can be obtained from the installation path or GitHub. For the sample usage guide of different languages, please refer to Sample Usage Guide. |
Parameter Upgrade: Scan Line Count
The minimum value for ScanLineCount can now be set to 1.
Calibration for Multiple Laser Profilers Scanning the Same Object
Supports calibration of multiple laser profilers simultaneously scanning the same object, providing output for calibration results, errors, stitching results, and the stitched depth map. A custom calibration target is required based on the specific scene. Refer to the Calibration Target Design and Machining Guide for more information.
|
The relevant samples can be obtained from the installation path or GitHub. For the sample usage guide of different languages, please refer to Sample Usage Guide. |
Register Events
Added support for monitoring the following events:
-
Data acquisition start (EventFrameStart)
-
Line trigger missed (EventLineTriggerMissed)
-
Input signal terminal level change events (Line[X]RisingEdge, Line[X]FallingEdge)
[X] refers to the terminal number. Range: 1–6.
After defining and registering callback functions for the above events, the client program can automatically monitor the event status and call the corresponding functions when the events occur.
Timeout Parameter for laser profiler Discovery Method
The discoverProfilers() method now includes a timeoutMs parameter with a default value of 5000. Users can adjust the timeout based on network conditions.
New Log Interface
By calling the following method, users can retrieve logs that record API call information.
-
C++
-
C#
-
Python
ErrorStatus mmind::eye::exportLogs(const std::string& dstPath, bool coverIfExist);var errorStatus = Log.ExportLogs(string dstPath, bool coverIfExist)status = export_logs(dstPath, coverIfExist)New Device Name Field
The following field is added to the ProfilerInfo structure for retrieving the device name.
-
C++
-
C#
-
Python
std::string deviceName;public string DeviceName { get; set; }device_name = property(_profiler.ProfilerInfo_device_name_get, _profiler.ProfilerInfo_device_name_set)ROS Interfaces Provided
Mech-Eye SDK now provides the ROS interfaces. You can realize the communication between the laser profiler and the robot through ROS.
ROS interfaces can be obtained through GitHub:
Resolved Issues
The following issues have been resolved in Mech-Eye SDK 2.5.0:
-
When the IPC had two network interface cards, if the one with a smaller hop count and with connection to the router was not on the same subnet as laser profiler, an error occurred when trying to connect to laser profiler after modifying the IP address of laser profiler.
GenICam Interface
IP Configuration Tool: New Sample
Provides the sample modify_ip_configurations, which is used to modify the IP configurations of the laser profiler, including the IP address, subnet mask, and gateway.
Register Events
Added support for monitoring the following events:
-
Data acquisition start (EventFrameStart)
-
Line trigger missed (EventLineTriggerMissed)
-
Input signal terminal level change events (Line[X]RisingEdge, Line[X]FallingEdge)
[X] refers to the terminal number. Range: 1–6.
Once these events are registered and enabled, the client program can automatically monitor their status and pop up a prompt.
| Please refer to Usage Guide for HALCON Samples to obtain the samples and check the prerequisites for using the samples. |
New Parameter: Outlier Removal
A new Outlier Removal parameter has been added to the Profile Processing category, which is used to remove outliers from each profile. In the Mech-Eye API, you can enable this function using the EnableOutlierRemoval parameter and adjust the removal intensity using the OutlierRemovalIntensity parameter.
Parameter Upgrade: Scan Line Count
The minimum value for Height (Scan Line Count) can now be set to 1.
Change of Parameter Visibility
The visibility of the following parameters is changed from Beginner to Expert of Guru to improve usability.
| Category in GenICam client | Parameter available in GenICam client | Parameter available in Mech-Eye Viewer | Visibility (in version 2.5.0) |
|---|---|---|---|
Profile Extraction |
MinLaserLineWidth |
Min Laser Line Width |
Expert |
MaxLaserLineWidth |
Max Laser Line Width |
Expert |
|
Profile Processing |
GapFillingEdgePreservation |
Gap Filling Edge Preservation |
Guru |
Resampling |
Resampling |
Guru |
|
ResamplingEdgePreservation |
Resampling Edge Preservation |
Guru |
|
AcquisitionControl |
DepthTimeout |
Timeout Period |
Expert |
Resolved Issues
The following issues have been resolved in Mech-Eye SDK 2.5.0:
-
The parameter visibility of LaserPower was incorrect.
-
When the IPC and laser profiler belongs to different subnets of the same local network, the laser profiler was not displayed in the GenICam client.
-
When multiple parameter groups were set in the profiler, and external triggering was enabled in one of the groups (DataAcquisitionTriggerSource=1), after changing the TriggerMode parameter in the current group to "off", saving the parameters using UserSetSave, and reloading them using UserSetLoad, the TriggerMode was still "on".
-
The "threshold" operator in HALCON examples included the "max" parameter, which was not supported in HALCON 19.11 and earlier versions, causing runtime errors.