2D相机

您正在查看最新版本（V2.2.0）的文档。如果您想查阅其他版本的文档，可以点击页面右上角“切换版本”按钮进行切换。

■ 如果您不确定当前使用的产品是哪个版本，请随时联系梅卡曼德技术支持。

功能描述

该步骤可通过工业2D相机采集图像，用于后续的检测、测量与分析。

使用该步骤前，请先在2D相机管理窗口中添加和调试要使用的2D相机。

当前仅支持以下厂商的2D相机，并已通过以下版本软件及SDK的兼容性验证：

厂商 软件版本 SDK版本

华睿

Ver2.5.1.33_Build20250903

2.5.1.33.390167

大恒

3.2.2511.8201

2.5.2512.9221

海康威视

V4.5.1 build20250227

V4.5.1.2 build20250317

巴斯勒（Basler）

25.06.4.17077

10.3.1.606

如需使用大恒或海康威视的2D相机，请先在菜单栏中选择帮助  关于插件，取消勾选camera2d_bsl插件，并重启软件使设置生效。

系统默认会自动加载上述四家厂商的相机插件，但巴斯勒相机插件与大恒及海康威视相机插件存在冲突，在启用巴斯勒相机插件的情况下，大恒或海康威视相机将无法在2D相机管理窗口中被搜索到。

使用场景

该步骤一般作为工程的首个步骤获取图像数据，常与图像预处理、定位等功能的后续步骤相连接。

使用流程

该步骤的使用流程如下：

workflow

  1. 选择是否启用虚拟模式。

  2. 运行步骤，获取图像并输出至其他步骤。

参数说明

相机设置

参数 解释

选择相机

从下拉选项中选择要连接的2D相机。

你可以单击相机管理按钮，打开2D相机管理窗口，管理当前可连接的2D相机及相机参数。

相机类型

用于显示工业2D相机厂商。当前仅支持以下类型的2D相机：

  • HRayCamera：华睿2D相机。

  • MerCamera：大恒2D相机。

  • MvsCamera：海康威视2D相机。

  • BslCamera：巴斯勒（Basler）2D相机。

基础设置

常用参数

参数 解释

虚拟模式

默认不开启。如需使用本地保存的数据运行工程，可开启虚拟模式。开启后的步骤参数请查看虚拟模式。

启用标定

启用后，需选择标定参数组以应用2D相机畸变标定结果。应用标定后，可校正图像畸变、提升测量精度。

高级参数

参数 解释

采集超时时间

相机收到信息至将数据返回给客户端的最大时间，单位为毫秒（ms）。超时自动停止图像采集，防止流程阻塞。

虚拟模式下的参数

参数 解释

数据路径

该参数用于指定图像数据的存放路径，步骤运行时将从该路径读取图像。

播放模式

该参数用于指定图像的读取模式。

值列表：

  • 顺序播放：默认值，按文件夹中图像的顺序依次读取图像。

  • 循环单张：重复读取当前图像。

  • 循环所有：按顺序读取所有图像，当读取完最后一张时，再从头读取。

  • 随机播放：随机读取图像。

根据实际需求选择图像数据的读取模式。

当前播放帧

该参数用于显示当前读取图像的名称。

图像采集设置

步骤运行时，下表中与2D相机管理窗口中重复的参数以步骤参数区设置的值为准。
参数 解释

曝光时间

该参数影响图像的亮度。一般情况下，环境较暗时可适当延长曝光时间使图像更亮；环境较亮时可缩短曝光时间避免过曝。

增益

该参数用于提高图像亮度，但会同时放大噪声。

当设置曝光时间无法达到期望亮度时，可以使用该参数。增益不宜设置过高，以免噪声增大影响检测效果。

采集次数

当拍照失败时允许自动重试的最大次数，用于提高采集成功率。默认值为3。

输出说明

输出项 说明

图像

相机采集的图像，或从本地路径中读取的图像。

时间戳字符串

相机采集的图像对应的时间戳字符串。

错误排查

各步骤通用的错误码，详见错误码列表。 若错误码与错误信息不对应，请联系技术支持获取帮助。

CV-E0201

错误：连接相机失败。

可能原因：

  1. 相机、工控机、路由器/交换机线缆连接异常。

  2. 防火墙/杀毒软件阻止软件使用。

  3. 相机IP地址更改。

  4. 网卡冲突。

解决方案：

  1. 检查相机、工控机、路由器/交换机端的线缆连接，确保连接正常。

  2. 关闭电脑防火墙或将Mech-MSR加入电脑防火墙白名单，然后关闭电脑杀毒软件及安全防护软件。

  3. 检查相机IP地址是否正确。

  4. 禁用电脑中连接相机网口外的其他网口，然后运行Mech-MSR，重新连接相机。

如以上步骤全部尝试后，仍无法搜索到相机，请尝试断电后重新启动相机。

CV-E0202

错误：相机XXX无访问权限。

解决方案：请查看日志，确保网络正常，且其他软件未占用相机后重试。若仍无法解决，请联系技术支持。

CV-E0204

错误：相机XXX连接失败。

可能原因：该相机已被其他软件通过GenICam接口或USB连接占用。

解决方案：请确保相机未被其他软件通过GenICam接口或USB连接占用。

CV-W0207

错误：未连接相机。

解决方案：请先连接相机。

CV-W0208

错误：相机连接失败。

解决方案：

  • 请确保相机处于可用状态。

  • 请确保工控机和相机处于同一网段。

  • 请确保可能占用相机的软件都已关闭。

  • 请确保防火墙处于关闭状态，或者将Mech-MSR添加到防火墙白名单中。

CV-W0211

错误：出现内部错误，无法获取相机参数。

解决方案：请联系技术支持。

CV-W0213

错误：出现内部错误，无法读取相机参数。

解决方案：请联系技术支持。

CV-W0215

错误：图像采集失败。

可能原因：

  • 采集超时时间设置过短；

  • 相机触发延迟时间过长；

  • 相机未响应或掉线；

  • 若使用外部触发，外部触发信号未正常发出。

解决方案：

  • 请调整采集超时时间，确保足够长；

  • 请检查相机触发延迟设置；

  • 请确认相机已连接并正常响应；

  • 若使用外部触发，请检查外部触发信号是否正常。

CV-W0261

错误：软件内部出现错误。

解决方案：请尝试重启相机并重新连接。若问题仍未解决，请联系技术支持。

CV-W0262

错误：软件内部出现错误。

解决方案：请尝试重启相机并重新连接。若问题仍未解决，请联系技术支持。

CV-W0263

错误：软件内部出现错误。

解决方案：请尝试重启相机并重新连接。若问题仍未解决，请联系技术支持。

CV-W0264

错误：相机与工控机的IP地址不在同一网段。

解决方案：请检查相机IP地址与工控机是否在同一网段。若不在同一网段，请将相机IP地址修改为与工控机处于同一网段。

CV-W0265

错误：软件内部出现错误。

解决方案：请尝试重启相机并重新连接。若问题仍未解决，请联系技术支持。

CV-W0266

错误：软件内部出现错误。

解决方案：请尝试重启相机并重新连接。若问题仍未解决，请联系技术支持。

CV-W0267

错误：相机内部出现错误。

解决方案：请尝试重启相机并重新连接。若问题仍未解决，请联系技术支持。

CV-W0268

错误：找不到相机。

可能原因：

  • 网络异常；

  • 相机IP地址与当前工控机不在同一网段。

解决方案：

  • 请确认网络连接正常；

  • 请确认相机IP地址与工控机处在同一网段。

CV-W0269

错误：相机连接失败。

可能原因：

  • 网络异常；

  • 相机已被占用。

解决方案：

  • 请确认网络连接正常；

  • 请确认相机未被占用。

CV-W0270

错误：相机已被占用。

解决方案：请确认相机未被其他程序或设备占用。

CV-W0271

错误：相机已离线。

可能原因：网络连接异常或相机未开启。

解决方案：请检查网络连接并确认相机已启动。

CV-W0272

错误：相机内部出现错误。

解决方案：请尝试重启相机并重新连接。若问题仍未解决，请联系技术支持。

CV-W0273

错误：相机IP地址冲突。

可能原因：当前网段内其他设备占用了相同IP地址。

解决方案：请修改当前相机的IP地址。

CV-W0274

错误：相机内部出现错误。

解决方案：请尝试重启相机并重新连接。若问题仍未解决，请联系技术支持。

CV-W0275

错误：相机内部出现错误。

解决方案：请尝试重启相机并重新连接。若问题仍未解决，请联系技术支持。

该页面是否有帮助？

可以通过以下方式反馈意见：

我们重视您的隐私

我们使用 cookie 为您在我们的网站上提供最佳体验。继续使用该网站即表示您同意使用 cookie。如果您拒绝，将使用一个单独的 cookie 来确保您在访问本网站时不会被跟踪或记住。

  • Preference
  • 同意
  • 不同意