Mech-Eye SDK 2.4.1 Release Notes

You are currently viewing the documentation for the latest version (2.5.0). To access a different version, click the "Switch version" button located in the upper-right corner of the page.

■ If you are not sure which version of the product you are currently using, please feel free to contact Mech-Mind Technical Support.

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

Measurement Tool in Point Cloud Display Interface

A new measurement icon 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 continuous cap 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 continuous cap 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.

Display DLL Version

The version number of the .dll file is now provided.

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.

We Value Your Privacy

We use cookies to provide you with the best possible experience on our website. By continuing to use the site, you acknowledge that you agree to the use of cookies. If you decline, a single cookie will be used to ensure you're not tracked or remembered when you visit this website.