使用 MVApps 中的图像源

要在 MERLIC Vision App 中使用 Image Source Manager 采集的图像，您必须使用图像源工具。借助此工具，您可以选择应使用其图像进行图像处理的所需图像源。

仅当您使用 Image Source Manager 采集图像时（即通过 MERLIC RTE Setup 的“图像源”选项卡配置图像源时），才需要图像源工具。

可用图像源的概述

要在 MVApp 中使用特定图像源的图像，您必须确保相应图像源配置目前处于活动状态。

如果您想查看哪些图像源目前可在 MVApp 中使用，您可在 MERLIC Creator 的“图像源配置”面板中查看当前状态。该面板显示了哪个配置处于活动状态，并提供了该配置中所有图像源的概述。

对于每个可用图像源，将显示相应图像源名称以及代表图像源类型的图标。图像目录用图标指示。此外，还会显示相应图像目录的位置。对于通过图标指示的相机设备，将显示相应的唯一相机名称。表示灯光或镜头控制器等外围设备的图像源通过图标指示，并显示相应的唯一设备名称。相应状态指示图像源是否已连接且可供使用。如果状态为“已连接”，表示图像源可用且可供使用。如果状态为“已断开连接”，您可能需要再次检查配置。

如果需要调整图像源的设置，或者活动配置中缺少某个图像源，可以通过“ 编辑...”按钮打开 MERLIC RTE Setup 的“图像源”选项卡。

在启动过程中，MERLIC 将自动打开活动配置的所有图像源。如果您不确定哪个配置处于活动状态或您希望使用的图像源是否可用，请检查“图像源配置”面板，确保所需图像源属于当前活动配置的一部分。否则，MVApp 将无法使用该图像源。

在 MVApp 中设置图像源

在 MVApp 中设置图像源只需几个步骤即可完成，如下所述。

在工具流程中选择“图像源”工具。如果您的 MVApp 不包含任何“图像源”工具，则将其添加到工具流程。该工具会自动选择活动配置的第一个图像源。如果您想使用不同图像源的图像，请按下一步中所述更改图像源。
在工具参数“图像源名称”中选择所需的图像源。如果不显示所需的图像源，请检查存储图像源的配置是否处于活动状态。
只能选择当前活动配置的图像源。此外，请记住“图像源”工具用于获取 Image Source Manager 采集的图像。因此，如果添加图像源时选择了不采集图像这一选项，则无法在工具中选择该图像源，例如灯光控制器。
单步或连续运行 MVApp，检查从所选图像源采集的图像。如果是图像文件目录，执行 MVApp 将逐一获取该目录中的图像。采集的图像将在工具面板底部的工具结果“图像”中返回。结果可连接到其他工具，以将图像用于 MERLIC 中的实际图像处理任务。

在每次执行期间，MERLIC 会从活动配置的所有图像源采集图像，即使在此工具中未选择它们。结果仅显示所选图像源的图像。

通过为要使用的每个图像源添加“图像源”工具，可以在 MVApp 中使用多个图像源。多个相机的图像采集将同步进行。但是，请记住，允许的相机设备数量取决于您的 MERLIC 许可。有关更多信息，请参阅图像采集的许可限制主题。

错误处理

要通过 Image Source Manager 采集图像，必须满足以下要求：

在工具中选择的图像源已存在。
包含所选图像源的图像源配置处于活动状态。
已建立与所选图像源（例如相机设备）的连接。

如果没有满足这些条件中的任意一条，则无法采集图像。在这种情况下，工具将报错或显示警告，说明问题的原因。

以下示例图像中的图像源配置都没有处于活动状态。因此，无法从所选图像源中采集图像。在这种情况下，工具面板将显示一条消息，说明问题的原因。此外，还会针对警告图标和“工具状态”结果值指示的工具报告警告。要解决此类问题，您可以使用工具面板中提供的按钮打开图像源配置并予以检查，然后进行所需的调整。

在以下示例图像中，所选图像源代表图像文件目录。但是，在指定位置找不到该图像文件。因此会出现错误，并通过错误图标和“工具状态”结果值予以显示。您可以在 MERLIC Creator 的“图像源配置”面板中检查图像源的状态，也可以在 MERLIC RTE Setup 的“图像源”选项卡中查找问题的原因。

一般而言，您始终可以在 MERLIC Creator 的“图像源配置”面板中检查可用图像源的状态。如果需要调整图像源配置，您可以随时打开 MERLIC RTE Setup 的“图像源”选项卡解决问题。

MERLIC Creator 中的图像采集错误

如果在 MERLIC Creator 中运行 MVApp 时出现图像采集错误，您可以检查“图像源”工具的“工具状态”结果了解有关错误的信息。此外，您还可以在 MERLIC Creator 的“图像源配置”面板中检查可用图像源的状态，并打开 MERLIC RTE Setup 以在“Image Sources”选项卡中调整图像源的配置。

MERLIC RTE 期间的图像采集错误

对于在 MERLIC RTE 运行时（即在流程集成模式下）发生的大多数图像采集错误，其在执行 MVApp 之前已经得到 MERLIC RTE 的检测和处理。如需更多详细信息，请参阅在流程集成期间配置图像源。

但是，如果活动配置中缺少图像源，系统仍将执行 MVApp，但无法采集图像。“图像源”工具则会显示一个错误图像，该图像将被转发到连接的工具。如果后续工具之后可以执行图像处理任务且不出现错误，则可能需要一些时间才能检测到问题。相应的错误会显示在“图像源”工具的“工具状态”结果中。

为了避免这种情况，您可以监视“图像源”工具的“工具状态”结果，并相应地实现应用程序，以便在“工具状态”结果值不“确定”时做出相应的反应，例如，通过发送“Halt”信号停止执行来解决问题。

进一步的故障排除

如果图像采集工作不正常，您还可以检查以下各项：

线缆和网络连接：可能存在带宽不足、线缆断开或防火墙和防病毒扫描程序导致的问题。确认您的网络配置中是否启用了“超大帧”。有关更多信息，请参阅您的操作系统手册。
与相机的连接：如果相机断开连接，则重新连接后非持久性相机参数可能会丢失。如需连接不同的相机，可能需要关闭其他运行中的 MERLIC 进程来中止现有的连接。
采集缓慢或超时：MERLIC 会尝试从通过 Image Source Manager 配置的所有图像源采集图像。这可能会导致超时。可删除 MVApps 中未使用的图像源配置，以加快图像采集。