跳转到内容

相机vTool#

Camera vTool 提供对相机设备的便捷访问。

相机vTool

分配相机#

如果您尚未定义任何特定相机属性，则 Camera vTool 会随机分配一个可用相机。在单相机设计中，这可以让您快速启动并运行。

如果要在多相机设计中将特定相机分配给 Camera vTool，请阅读以下章节。

使用 Camera vTool 对话#

Basler 建议使用 Camera vTool 对话框将相机分配给 Camera vTool。

为此：

  1. 在 配方管理 窗格（位于 vTool 设置 区域）中，单击 打开设置 或双击 vTool。
    Camera vTool 对话框
  2. 选择要分配的相机，然后单击 分配.
    相机名称旁边会出现一个绿色复选标记。这表示相机现已分配给 vTool：
    Camera vTool 对话框：已分配相机

此外，该对话框还显示用于识别设备的属性。在极少数情况下，您可能需要编辑这些属性。要执行此操作，请使用功能窗格。

使用功能窗格#

您也可以使用功能窗格将相机分配给 Camera vTool。

只有在极少数用例中才需要执行此操作，例如，在没有将实体相机连接到计算机的情况下查看或更改相机分配。

要使用功能窗格分配特定相机：

  1. 在 Workbench 中选择 Camera vTool。
  2. 打开 Features - All 窗格。
  3. 如果要列出可用的相机，请单击 vTool > Device Enumeration Control > Device List Update > Execute。
  4. 使用 Device Selector 参数浏览可用的相机。
    这允许您查看有关各个相机的某些信息，以帮助您选择所需的相机。
  5. 确定所需相机后，单击 Device Choose > Execute 以将该特定相机分配给 Camera vTool。

  6. 要进一步指定您要分配的相机必须匹配的设备属性，请使用 vTool > Device Enumeration Control 组中的 Device Property * 参数。

    信息

    有关设备信息属性的更多信息，请参阅 CDeviceInfo 类以及 pylon C++ API 的 Pylon/Key 名称空间的文档。这为您提供了对相机选择的细粒度控制，并确保相同的配方可以在多台计算机上使用适当的相机运行。

    Basler 建议，如果将多个相机连接到一个系统，则使用 DeviceClass 和 UserDefinedName 属性。您需要先设置相机的 DeviceUserID 参数，然后才能使用 UserDefinedName 属性选择相机。

    请注意，USB 相机需要复位或重启才能使用新设置的设备 DeviceUserID。

配置相机#

将相机分配给 Camera vTool 后，单击 Workbench 工具栏中的锁定资源按钮，以建立与所分配相机设备的专用连接。

“锁定资源”图标

现在，您可以在功能 - 全部窗格中配置相机。

在配方中保存相机设置#

保存配方时，相机设置不会自动保存，因为分配给相机 Camera vTool 的相机设备在保存配方时可能未连接，或者相机设备的设置可能已被其他程序更改。

请改用您在 vTool > Configuration Set Persistence 下的 Features - All 窗格中配置的参数，以保存相机设备的设置和附带的设置。

信息

对于初始相机设备配置，Basler 建议使用经典 pylon Viewer 特征。

要在配方中保存相机设置：

  1. 单击工具栏中的 锁定资源 button in the Workbench toolbar to establish an exclusive connection to the camera device assigned.
    “锁定资源”图标
  2. 在 Features - All 窗格中，打开 Configuration Set Persistence 类别并将 Configuration Set Selector 参数设置为 Camera 以选择相机设备的参数集。
  3. 单击 Configuration Set Fetch 以从相机设备中获取设置并将其存储在 Configuration Set Staged 参数中。

  4. Optional: You can inspect or manually modify the parameter settings by copying the text to a text editor and back into Configuration Set Staged.
    In the text editor, you will see that each line of text contains the name and the value of a parameter separated by a tab or = character. Lines starting with # are treated as comments. A configuration set must start with the following line:
    # {05D8C294-F295-4dfb-9D01-096BD04049F4}

    信息

    或者，您可以使用用户集永久存储相机设置。

  5. 单击 Configuration Set Commit 以应用参数并将参数存储在配方设置中。这样可以确保每次执行锁定资源操作时都会自动设置参数。

    信息

    如果已经分配了相机，则参数设置会立即传输到相机。如果传输失败，参数设置将不会存储在 Configuration Set Active 中。如果没有分配相机，则设置将在分配时传输到相机。如果此传输失败，则无法启动配方。

    某些相机参数，如 Camera Instance 配置集中的参数，只能在相机关闭时更改。在这种情况下，存储在 Configuration Set Active 中的参数在打开相机之前分配时会传输到相机。

  6. 要从配方中清除参数设置，请单击 Clear Data。

故障排除#

找到多个匹配相机

问题：打开 Camera vTool 对话框时，相机名称旁边会出现警告标志：

Camera vTool 对话框：多个匹配相机

原因：这是因为有多个相机与 vTool 中存储的设备属性匹配。

In the example above, the device properties stored are DeviceClass = BaslerUsb and ModelName = acA1920-40uCMT. Three cameras match these properties because all are USB cameras and are named "acA1920-40uCMT".

解决方法：为避免发生这种情况，请使用对话框重新分配相机，或使用功能窗格更改属性。

未找到匹配相机

问题：打开 Camera vTool 对话框时，会显示“未找到匹配相机”的消息。

Camera vTool 对话框：无匹配相机

原因：这是因为没有相机与存储在 vTool 中的设备属性匹配。

In the example above, the device properties stored are DeviceClass = BaslerUsb and ModelName = acA645-100uc. However, no camera named "acA645-100uc" is connected.

解决方法：为避免发生这种情况，请连接匹配相机，然后使用对话框重新分配相机，或使用功能窗格更改属性。

输出#

图像#

返回相机拍摄的图像。任何接受图像作为输入的 vTool 都可以使用此输出图像。

  • 数据类型：图像
  • 图像格式：根据相机配置

典型后置项#