从相机获取图像

此工具被设置为旧版。为了提供向后兼容性，它仍可用，但在即将发布的 MERLIC 版本中不再获得维护或更新。我们建议使用 Image Source Manager 设置图像采集。

此工具可用于从相机设备采集图像。与通过 Image Source Manager 采集图像不同，以下

  • 相机设备的配置已绑定到 MERLIC Vision App，无法在其他 MVApps 中重复使用。因此，必须在每个 MVApp 中重新配置相机设备。
  • 只能配置相机设备。此工具中不支持灯光或镜头控制器等外围设备。
  • 无法将相机设备配置为使用硬件触发器。
  • 只能配置本地系统上的相机设备。
  • 每次执行时只会从 MVApp 中已配置的相机设备采集图像。

如果您仍要使用此工具采集图像，请参阅以下文档，这些文档说明如何使用此工具配置相机设备和采集图像。

许可限制

使用此工具时会有一些限制：

  • 在 MVApp 中，您只能使用 MERLIC 许可所规定数量的“从相机获取图像”工具。
  • 如果 MVApp 中已包含“图像源”工具，则不允许添加“从相机获取图像”工具至相同的 MVApp 中，反之亦然。
允许“从相机获取图像”工具的数量

MERLIC 许可软件包

允许使用的“从相机获取图像”工具数量

描述

Small

1

在每个 MVApp 中，您只能使用一个“从相机获取图像”。但是，您可以根据需要添加任意数量的“从文件获取图像”工具。

Medium

2

在每个 MVApp 中，您可以使用两个“从相机获取图像”工具。但是，您可以根据需要添加任意数量的“从文件获取图像”工具。

Large 和 X-Large

4

在每个 MVApp 中，您最多可以使用四个“从相机获取图像”工具。但是，您可以根据需要添加任意数量的“从文件获取图像”工具。

受支持的图像采集接口

MERLIC 通过支持最新行业标准 GigE Vision、GenICam GenTL 和 USB3 Vision 的图像采集接口来提供硬件独立性。有关相应系统要求的更多信息，请参阅受支持的图像采集接口主题。

一般信息

您可在“设备”参数中选择所需的相机。每次执行 MERLIC 应用程序，都将从选定相机设备采集一个图像。

如果相机设备支持 GenICam 符合 SFNC 的软件触发，则适用一些特殊功能。请参阅使用支持软件触发的相机设备部分了解更多信息。

配置区域

图形窗口

如要配置已连接的相机，请单击工具面板左上角的 箭头，展开左侧的配置区域。有关已连接相机配置的更多详细信息，请参阅配置部分。如果您已完成相机配置，可再次隐藏配置区域。

在每次测试工具“从相机获取图像”时，仅用了一两个相机。您或许可以使用更多相机，但需要自担风险，我们不保证能正常运行。如果您想使用两个以上的相机，我们建议通过 MERLIC Image Source Manager (ISM) 使用工具 图像源。

如果想要使用两个以上相机测试工具“从相机获取图像”，为确保正常运行，您应该考虑下列问题：

  • 相机所用标准的技术规格
  • 相机和计算机之间的物理连接
  • 计算机的计算能力
  • 计算机中的并发进程数量
  • 计算机为 MERLIC 分配的可用资源数量
  • 等等

测试相机

如需检查相机是否已正确安装，请按照以下步骤操作：

  1. 打开工具“从相机获取图像”。
  2. 打开参数“Device”的下拉菜单，然后选择“<search for devices>”。
  • 如果相机的名称出现在设备列表中，并且没有任何其他表示时间状态的附加显示，则相机已就绪。
  • 如果相机的名称出现在设备列表中，并且带有其他表示时间状态的附加显示，则请参阅相机的安装指南，以了解如何设置必要的驱动程序等。
  • 如果相机未出现在可供使用的设备列表中，请确保其已正确安装且未被拦截，例如被防火墙或杀毒软件拦截。

参数

基本参数

设备：

此参数定义了从中采集图像的相机设备。插入工具时，工具会自动搜索连接至系统的设备。可用相机设备随后在此参数的下拉菜单中列出。该列表显示可用相机的用户定义 ID 以及用于相机的相应接口。如果某个相机未定义用户 ID，则会显示唯一的相机 ID。

如果相机设备既可与 GigEVision2 接口一起使用，也可与 GenICamTL 接口一起使用，则该设备也可列出两次。如果您使用的是带兼容 GenICam 的数字 I/O 线的相机设备，并且想将该相机用作 MERLIC 流程集成模式的通讯设备，必须在 MERLIC RTE Setup 的“I/O”选项卡中再次选择相同的采集接口。如需关于流程集成和相应设置的更多信息，请参阅 MERLIC 流程集成 和 配置带 I/O 通道的相机设备 主题。

除可用相机设备的列表外，该参数还提供以下选项：

值

描述

<未连接>

插入工具时，会默认设置此值。它表示当前没有连接任何相机设备。

<搜索设备>

选择此值以更新可用相机设备的列表。

<使用第一个可用相机>

选择此值以自动打开可用相机列表中的第一个设备。如果 MERLIC Vision App 将在带有未知相机的另一系统上运行，此选择尤其有用。
连接：

此参数确定工具是应该与选定相机设备连接（= 1，默认设置）还是不应该与选定相机设备连接 (= 0)。

如果您使用的是带兼容 GenICam 数字 I/O 线的相机设备，并且想将该相机用作 MERLIC 流程集成模式的通讯设备，必须停用与该设备的连接，以确保在流程集成的设置期间可以找到它。如需关于流程集成和相应设置的更多信息，请参阅 MERLIC 流程集成 和 配置带 I/O 通道的相机设备 主题。

配置

相机配置可在 工具面板 左侧的区域中定义。如果已连接相机设备并激活了配置模式，则会显示包含相应值的所有相机参数的列表。在参数列表顶部，您还可看到当前受支持图像采集接口的名称和版本。

除包含参数列表的表外，配置区域还包含以下控件：

“配置”勾选框：

需要此勾选框才能激活相机参数的配置模式。要显示和编辑可用相机参数，必须激活此勾选框。

相对处于非配置模式，在配置模式下图像采集操作可能会有所延迟。因此，我们建议在启动 MERLIC Vision App 并开始图像采集前禁用此勾选框。

“刷新”按钮：

此按钮会刷新受支持相机参数及其值的列表。这对于产生副作用的参数有用。

快速过滤：

快速过滤让您能够在列表中按名称搜索特定相机参数。

调整相机参数

要调整相机参数，您可执行以下操作：

  1. 连接相机设备。
  2. 激活“配置”勾选框，为相机参数启用配置模式。
  3. 转到想要编辑的相机参数并单击参数值的相应字段。
  4. 为相机参数输入所需的值。
  5. 您还可选择在产生副作用的情况下单击“刷新”按钮来更新参数列表，并作进一步调整。

配置设置中的所有更改都会立即被采用，且工具会在每次调整时从相机设备采集一个图像。

如果 GigE Vision 相机添加为图像源，相机参数 [Stream]GevStreamAbortCheckPeriod 的值会自动设置为 500 µs，以减少图像采集时间。

 

如果使用弃用的“从相机获取图像”工具采集图像，还存在以下限制：一些相机设备不支持保存和加载相机配置调整。在这种情况下，您对相机参数设置进行的调整无法在 MERLIC Vision App 中保存！如果使用了此类设备，再次加载工具时会恢复默认相机设置。但是，即使选定相机设备支持保存和加载功能，该功能仍然取决于实际保存相机参数的相机设备。

如果在弃用的“从相机获取图像”工具中连接了 GigE Vision 相机，相机参数 [Stream]GevStreamAbortCheckPeriod 的值会自动设置为 500 µs，以减少图像采集时间。每次加载相机时，即加载 MVApp 时，都会自动设置该值。要使用其他值，您必须在加载 MVApp 后手动调整该值。

三维传感器的配置提示

如果您使用三维传感器采集带三维高度信息的图像，可能必须在相机配置中进行一些常规调整，以确保可在所有工具中处理所需图像数据。下面提供了一些常规配置提示。

在第一个通道采集图像
  • MERLIC 工具会自动处理图像的第一个通道。因此，您必须确保所需图像（即高度图像、深度图像或视差图像）在第一个通道返回。
    1. 检查“ComponentSelector”和“ComponentEnable”参数的配置，确认是否选择并启用了所需组件。同时确保停用所有其他不必要的组件。
    2. 检查“PixelFormat”相机参数的配置，看看是否设置了正确的像素格式。

    如果无法相应地调整配置以在第一个通道获取图像，您可以使用获取色彩通道工具提取所需通道。

  • 如果激活了多个组件，它们将以图像而非通道的形式返回。
更多配置提示
  • 根据所使用的相机，将超时设为适当的值，例如，对于线性扫描相机，超时可能需要 > 5 秒。
  • 请务必检查暴露时间，必要时调整值。

另请参阅 三维高度图像主题，了解关于如何预处理三维传感器采集的图像的信息。此外，您还可以通过我们的网站查找关于三维传感器特定配置的更多信息。

使用支持软件触发的相机设备

如果要使用此工具从支持 GenICam 符合 SFNC 的软件触发器的相机设备采集图像，则适用一些特殊功能。要实现更高的帧频，MERLIC 会自动激活这些相机设备的软件触发模式。此外，如果您使用其中一款相机，MERLIC 会自动配置几个设置。

以下部分提供适用这种情况的特殊功能的信息。

相机参数设置

以下相机参数由 MERLIC 自动修改以激活软件触发模式：

相机参数

值

TriggerSelector

FrameStart 或 ExposureStart（如果 FrameStart 不可用）

TriggerSource

Software

TriggerMode

"On"

此外，由于这些参数由 MERLIC 设置，因而不会在可配置相机参数的列表中显示。在 MERLIC 关闭时，它们会重置为各自的初始值。

配置模式

通常情况下，图像由 MERLIC 同步抓取。如果您使用支持 GenICam 符合 SFNC 的软件触发的相机，图像是同步还是异步抓取将取决于相机配置模式的状态。当您想要调整一些相机参数而激活相机配置模式时，图像会同步抓取。当您完成设置而停用相机配置模式时，图像会异步抓取。

硬件触发器

如果您使用的是支持 GenICam 符合 SFNC 软件触发器的相机，则无法将相机配置为由硬件触发。

如果使用 Image Source Manager 采集图像，则不适用特殊功能，并且 MERLIC 不会自动设置相机参数。

结果

基本结果

图像：

此结果返回从相机获取的图像。

已连接：

此结果指示是连接了相机设备 (= 1) 还是没有连接相机设备 (= 0)。

工具状态：

“工具状态”返回有关工具状态的信息，因此可用于处理错误。请参阅主题工具状态结果，了解关于不同工具状态结果的更多信息。

其他结果

处理时间:

此结果返回最近一次执行工具的持续时间（以毫秒为单位）。该结果作为附加结果提供。因此，默认情况下它是隐藏的，但是可以通过工具结果旁边的 按钮显示。有关更多信息，处理时间请参工具参考中所阅部分。