Mech-Eye SDK 2.3.0 Release Notes
This topic introduces the new features, improvements, and resolved issues of Mech-Eye SDK 2.3.0.
Mech-Eye Viewer
Select Location for Extracting Profile in Laser Lines
After the laser profiler firmware has been upgraded to 2.3.0, an Edge Selection parameter is added to the Profile Extraction category in the profile mode. Through this parameter, you can select to extract the profile from the top edge, center, or bottom edge of the laser lines, better suiting different scenarios and target objects. For example, if the target object is a transparent/translucent object, such as glue, you can select Top edge.
Meanwhile, a Min Sharpness parameter has been added to this category. This parameter is used to exclude the dark and blurry laser lines produced by stray light or interreflection.
| As the performance of the profile extraction algorithm has been improved, users do not need to manually set the intensity range of the needed spots anymore. Therefore, the Min Spot Intensity and Max Spot Intensity parameters in this category have been removed from version 2.3.0. Upgrading the software will not affect the profile extraction result. |
Select Point to Be Retained among Points with the Same X Values
After the laser profiler firmware has been upgraded to 2.3.0, a Resampling parameter is added to the Profile Processing category in the profile mode. Through this parameter, when multiple points with different Z values exist at the same location on the X-axis, you can select to retain the point closest to or farthest from the laser profiler, better suiting different scenarios and target objects. For example, if the needed feature is at the bottom of the target object (such as the inner bottom of a cylindrical container), you can select Farthest.
Meanwhile, a Resampling Edge Preservation parameter has been added to this category. This parameter is used to set the degree of preservation of object edges during resampling.
Adjust Brightness of Intensity Image
After the laser profiler firmware has been upgraded to 2.3.0, a Brightness Adjustment parameter is added to the Scan Settings category in the scan mode. This parameter is used to adjust the brightness of the intensity image.
Added Encoder Settings Tool
Mech-Eye Viewer 2.3.0 provides an Encoder Settings tool used to check the encoder value and motion direction, calculate the encoder resolution, and obtain the recommended value of the Trigger Interval parameter.
To open this tool: In the scan mode, set the Line Scan Trigger Source parameter value to Encoder, and then click the Edit button to the right of the Encoder Settings category.
Meanwhile, the Trigger Direction, Trigger Signal Counting Mode, and Trigger Interval parameters are moved to the Encoder Settings category.
Control Permission to Connection and Acquisition Based on IP Address
After the laser profiler firmware has been upgraded to 2.3.0, multiple computers cannot connect to the same laser profiler at the same time, avoiding interference from other users. The following clients on the same computer can still connect to the same laser profiler at the same time:
-
Mech-Eye Viewer
-
Mech-Eye API program
-
Third-party machine vision software using Mech-Eye API
Meanwhile, when a client is acquiring the intensity image, depth map, or point cloud, another client on the same computer cannot perform acquisition at the same time, avoiding interference among multiple clients.
Stop Single Round of Data Acquisition in Scan Mode
In Mech-Eye Viewer 2.3.0, when using the 
button in the scan mode to perform a single round of data acquisition, clicking this button again can stop the current round of data acquisition. You can now perform other actions such as parameter adjustments immediately, instead of waiting until the number of lines set in Scan Line Count have been fully acquired.
Save Virtual Device File
In Mech-Eye Viewer 2.3.0, you can save the virtual device file through the Save Virtual Device File option in the File menu. The virtual device can be used to reproduce an acquisition.
|
Mech-Eye Viewer currently does not support loading a virtual device file saved from a laser profiler. These files can be using in Mech-Eye API. |
Added Built-in Settings to HDR Exposure Settings
In Mech-Eye Viewer 2.3.0, when using the HDR exposure mode in the profile mode, you can select and apply built-in settings directly in HDR Exposure Settings, simplifying the process of parameter adjustment.
Resolved Issues
The following issues have been resolved in Mech-Eye SDK 2.3.0:
-
Extraction points in the raw image had offset.
-
In Measurement Tool, when the profile was enlarged, narrowing the width of the detection area caused the measurement result to show Error.
-
In Measurement Tool, when the profile was enlarged, widening the detection area with the handles resulted in the abnormal layout of the detection area.
-
The width of the Measurement Tool window could be narrowed, and narrowing the width resulted the abnormal layout of the window.
Mech-Eye API
Select Location for Extracting Profile in Laser Lines
After the laser profiler firmware has been upgraded to 2.3.0, an Edge Selection parameter is added. Through this parameter, you can select to extract the profile from the top edge, center, or bottom edge of the laser lines, better suiting different scenarios and target objects. For example, if the target object is a transparent/translucent object, such as glue, you can select TopEdge.
Meanwhile, a Min Sharpness parameter has been added. This parameter is used to exclude the dark and blurry laser lines produced by stray light or interreflection.
| As the performance of the profile extraction algorithm has been improved, users do not need to manually set the intensity range of the needed spots anymore. Therefore, the Min Spot Intensity and Max Spot Intensity parameters has been removed from version 2.3.0. It is recommended to remove the code relevant to these parameters from the client program. |
Select Point to Be Retained at the Same Location on X-Axis
After the laser profiler firmware has been upgraded to 2.3.0, a Resampling parameter is added. Through this parameter, when multiple points with different Z values exist at the same location on the X-axis, you can select to retain the point closest to or farthest from the laser profiler, better suiting different scenarios and target objects. For example, if the needed feature is at the bottom of the target object (such as the inner bottom of a cylindrical container), you can select Farthest.
Meanwhile, a Resampling Edge Preservation parameter has been added. This parameter is used to set the degree of preservation of object edges during resampling.
Adjust Brightness of Intensity Image
After the laser profiler firmware has been upgraded to 2.3.0, a Brightness Adjustment parameter is added. This parameter is used to adjust the brightness of the intensity image.
Save and Load Virtual Device File
Mech-Eye API 2.3.0 provides methods and classes used to save and load virtual device files. The virtual device can be used to reproduce an acquisition.
-
Call the following methods to save a virtual device file:
-
C++
-
C#
-
Python
ErrorStatus Profiler::saveVirtualDeviceFile(const ProfileBatch& data, const std::string& filePath);ErrorStatus Profiler.SaveVirtualDeviceFile(ref ProfileBatch batch, string filePath);Profiler.save_virtual_device_file(self, data, filePath) -
-
Call the methods in the
VirtualProfilerandVirtualUserSetclasses to load a virtual device file and view the data in the file.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.
GenICam Interface
Select Location for Extracting Profile in Laser Lines
After the laser profiler firmware has been upgraded to 2.3.0, an Edge Selection parameter is added. Through this parameter, you can select to extract the profile from the top edge, center, or bottom edge of the laser lines, better suiting different scenarios and target objects. For example, if the target object is a transparent/translucent object, such as glue, you can select TopEdge.
Meanwhile, a Min Sharpness parameter has been added. This parameter is used to exclude the dark and blurry laser lines produced by stray light or interreflection.
| As the performance of the profile extraction algorithm has been improved, users do not need to manually set the intensity range of the needed spots anymore. Therefore, the Min Spot Intensity and Max Spot Intensity parameters has been removed from version 2.3.0. It is recommended to remove the code relevant to these parameters from the client program. |
Adjust Brightness of Intensity Image
After the laser profiler firmware has been upgraded to 2.3.0, a Brightness Adjustment parameter is added. This parameter is used to adjust the brightness of the intensity image.