Mech-Eye SDK 2.0.0 更新说明

新增功能

Mech-Eye 相机适配 GenICam 标准

从 Mech-Eye SDK 2.0.0 版本开始，Mech-Eye 工业级 3D 相机适配机器视觉行业标准 GenICam 。

适配 GenICam 标准提供如下价值：

  • 支持 GenICam 标准后，相机可适配更多兼容 GenICam/GigE Vision 2 的第三方机器视觉软件，例如 HALCON (MVTec)、VisionPro (Cognex) 等。目前 HALCON 已通过测试。

  • 针对第三方机器视觉软件的使用场景，丰富和优化了用户在网络配置、参数设置及图像采集传输等方面的使用体验。

  • 升级相机固件版本至 2.0.0 后，第三方机器视觉软件可直接连接相机，不再依赖 License，简化使用流程。

提示

相机固件版本升至 2.0.0 后，推荐使用 Mech-Vision 1.6.2 及以后版本。如使用 Mech-Vision 1.6.1 及之前版本，连接 External2D EBUSCamera 中的相机时可能导致软件崩溃。

Mech-Eye Viewer

  • 新增设置深度范围工具

    Mech-Eye Viewer 中新增 设置深度范围 工具，以可视化方式调节深度范围上下限，提升用户体验。

    ../../_images/set_depth_range1.png

  • 新增满垛模拟器

    Mech-Eye Viewer 中新增 满垛模拟器 工具，可以用于生成立方体，模拟满垛场景，确认满垛时顶层物体是否全部位于相机视野内。可使用该工具判断调试前相机安装高度是否合适，并提供大致的相机调整距离。

  • 新增点云展示功能

    Mech-Eye Viewer 中新增 点云展示 功能，以固定移动轨迹移动，全方位展示点云。

    要展示点云，选择 视图 ‣ 点云展示 ，勾选复选框后，点击点云界面右上角的 播放 按钮。

  • 新增图像信息显示功能

    Mech-Eye Viewer 中新增图像信息显示功能，光标移动至 2D 图或深度图上时，右下角显示当前所在像素对应的信息。

    要禁用该功能，选择 视图 ‣ 图像信息 ，取消勾选复选框。

  • 新增自定义相机备注功能

    Mech-Eye Viewer 中新增 自定义相机备注 功能，允许用户在连接真实相机后为其设置备注。通过设置相机备注方便快速区分相机。

  • 新增降采样功能

    Mech-Eye Viewer 中新增降采样功能，LSR L 的彩色 2D 相机可切换相机分辨率，3MP 或 12MP。

    在 管理员 模式下，选择 工具 ‣ 查看 2D 相机并设置参数 ，可启用/关闭 降采样 功能。

  • 新增解决相机连接异常入口

    Mech-Eye Viewer 中相机未连接页面的右下角中新增 path 图标，点击即可查看 相机连接异常 的解决方案。

Mech-Eye API

Mech-Eye API 增加如下参数：

  • ProjectorPowerLevel

    适用于 DLP 相机（不包含 V3 的 Deep 与 Pro L Enhanced）

  • FringeCodingMode

    适用于 PRO S (V4)、PRO M (V4)、NANO (V4)、Nano (V3) 与 Pro XS (V3)

  • AntiFlickerMode

    适用于 PRO S (V4)、PRO M (V4)、NANO (V4) 与 Nano (V3)

C++、C# 及 Python 的新增参数与方法如下所示。

  • C++

    参数

    方法

    ProjectorSettings:: PowerLevel::powerLevel

    ErrorStatus MechEyeDevice::getProjectorPowerLevel (ProjectorSettings::PowerLevel &)

    ErrorStatus MechEyeDevice::setProjectorPowerLevel (ProjectorSettings::PowerLevel)

    ProjectorSettings:: FringeCodingMode::fringeCodingMode

    ErrorStatus MechEyeDevice::getProjectorFringeCodingMode (ProjectorSettings::FringeCodingMode &)

    ErrorStatus MechEyeDevice::setProjectorFringeCodingMode (ProjectorSettings::FringeCodingMode)

    ProjectorSettings:: AntiFlickerMode::antiFlickerMode

    ErrorStatus MechEyeDevice::getProjectorAntiflickerMode (ProjectorSettings:AntiFlickerMode &)

    ErrorStatus MechEyeDevice::setProjectorAntiflickerMode (ProjectorSettings:AntiFlickerMode)

  • C#

    参数

    方法

    ProjectorSettings.projectorPowerLevel Type: ProjectorSettings::PowerLevel

    ErrorStatus MechEyeDevice.GetProjectorPowerLevel (mmind.apiSharp.PowerLevel ref)

    ErrorStatus MechEyeDevice.SetProjectorPowerLevel (mmind.apiSharp.PowerLevel)

    ProjectorSettings.projectorFringeCodingMode Type: ProjectorSettings::FringeCodingMode

    ErrorStatus MechEyeDevice.GetProjectorFringeCodingMode (mmind.apiSharp.FringeCodingMode ref)

    ErrorStatus MechEyeDevice.SetProjectorFringeCodingMode (mmind.apiSharp.FringeCodingMode)

    ProjectorSettings.projectorAntiFlickerMode Type: ProjectorSettings::AntiFlickerMode

    ErrorStatus MechEyeDevice.GetProjectorAntiFlickerMode (mmind.apiSharp.AntiFlickerMode ref)

    ErrorStatus MechEyeDevice.SetProjectorAntiFlickerMode (mmind.apiSharp.AntiFlickerMode)

  • Python (仅包含新增方法)

    Device.get_projector_power_level(self)

    Device.set_projector_power_level(self, value)

    Device.get_projector_fringe_coding_mode(self)

    Device.set_projector_fringe_coding_mode(self, value)

    Device.get_projector_anti_flicker_mode(self)

    Device.set_projector_anti_flicker_mode(self, value)

功能优化

Mech-Eye Viewer

  • 感兴趣区域优化。

    • 优化感兴趣区域设置方式，增加锚点，可修改或移动框选的感兴趣区域。

    • 滑动鼠标滚轮可放大/缩小2D 图。

    • 限制了 2D 图的最大、最小尺寸。

  • 颜色条功能优化。

    Mech-Eye Viewer 中优化深度图/点云左边栏的 颜色条 功能，颜色条与滑块合并，并增加输入数值与切换单位功能。

    • 输入数值：用于微调深度范围。

    • 切换单位：单位包含 mm 与 micron 。UHP 相机推荐使用 micron，其他相机推荐使用 mm。

  • 参数名称与参数描述优化，请参见 附录 。

  • 为 Nano (V3) 与 NANO (V4) 提供抗频闪功能。

  • 支持读取和显示 PRO (V4) 系列相机的 DLP 投影机温度。

  • LSR 系列相机 3D 参数下的最小曝光时间更新为 8ms。

  • 视野计算器 新增 DEEP (V4) 型号。

  • 锐化因子 的可见级别更新为 大师 。

  • 更新说明优化

    更新说明不再以弹窗形式展现。通过选择 帮助 ‣ 更新说明 ，用户可直接跳转至 使用手册 中该版本的更新说明，查看版本变更的详细信息。

Mech-Eye API

问题修复

Mech-Eye Viewer

  • 修复 Pro L Enhanced 与 Laser L Enhanced（V3 及 V3S）高分辨率（12MP）相机开启降采样时彩色点云异常的问题。

  • 修复固件版本为 1.4.0 时无法升级至最新固件版本的问题。

  • 修复在 Mech-Eye Viewer 中修改相机 IP 地址后，偶发出现在 Mech-Vision 中能同时搜索到新旧相机 IP 地址的问题。

  • 修复偶发的 Nano 及 Pro XS（V3）相机采集深度数据异常的问题。

Mech-Eye API

修复 Connect 方法无法重复调用的问题。

附录

参数分组与参数名称

Mech-Eye SDK 2.0.0 更新了 初级 可见级别下的参数名称与描述。具体变更内容详见下表。

2.0.0 之前

2.0.0

3D参数

-

曝光次数

-

曝光时间

-

UHP

-

拍摄模式

-

2D参数

-

曝光模式

-

相机曝光时间

曝光时间

期望灰度值

灰度值

2D自动曝光感兴趣区域

自动曝光感兴趣区域

区域范围

设置值

色调映射

-

HDR曝光序列

曝光时间序列

曝光序列

设置值

彩色相机曝光模式

-

黑白相机曝光模式

-

黑白相机曝光时间

-

点云后处理

-

点云平滑

-

噪点去除

-

投影亮度对比阈值

条纹对比度阈值

深度测量范围

深度范围

上限

-

下限

-

感兴趣区域

-

区域范围

设置值

注解

  • 上表中部分参数仅指定相机可见。

  • 上表中 “-” 表示参数名称无变化，仅参数描述进行优化。