Mech-Eye SDK 2.3.0 Release Notes

You are currently viewing the documentation for version 2.4.0. To access documentation for other versions, click the "Switch Version" button located in the upper-right corner of the page.

■ To use the latest version, visit the Mech-Mind Download Center to download it.

■ If you're unsure about the version of the product you are using, please contact Mech-Mind Technical Support for assistance.

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 single cap 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 VirtualProfiler and VirtualUserSet classes 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.

Resolved Issues

The following issues have been resolved in Mech-Eye SDK 2.3.0:

  • On a Linux-based operating system without graphical user interface, the cv::imshow() command in C++ or Python samples dependent on OpenCV reported error.

  • Some virtual devices were displayed in the device list.

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.

Resolved Issues

The following issue has been resolved in Mech-Eye SDK 2.3.0:

When the LineScanTriggerSource parameter had been set to FixedRate, the parameters in the EncoderControl category were still available.

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.

  • Preference
  • I accept
  • I don't accept