相机vTool#

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

下载 pylon Software Suite 以使用 Camera vTool。

分配相机#

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

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

使用 Camera vTool 对话#

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

为此：

1. 在 配方管理 窗格（位于 vTool 设置 区域）中，单击 打开设置 或双击 vTool。
   
2. 选择要分配的相机，然后单击 分配.
   相机名称旁边会出现一个绿色复选标记。这表示相机现已分配给 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 的相机设备在保存配方时可能未连接，或者相机设备的设置可能已被其他程序更改。

请改用 Features - All 窗格中 vTool > Configuration Set Persistence 下方的参数，以便在配置好参数后保存相机设备及其随附的设置。

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

1. 单击工具栏中的 锁定资源 单击 Workbench 工具栏中的按钮，与指定的相机设备建立独占连接。
   
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。

使用 Event Notification 和 Chunk Data#

Camera vTool 还允许您访问相机的事件和块数据。您可以添加用于事件和块数据的附加输出引脚，以便利用它们来控制您的应用。相机事件（例如曝光结束）可用于控制外部设备。块数据（例如 Timestamp 或 Exposure Time）可用于控制和同步应用中的任务。

访问相机事件#

1. 在相机上启用所需的 event。
2. 在 Workbench 中选择 Camera vTool。
3. 打开 Features - All 窗格。
4. 转到 vTool > Event Output Control 组。
5. 执行 Event Pin Add 命令。
6. 在 Event Pin 配置 字段中，输入要添加的事件引脚的配置。使用以下语法：
   <MyPinName>.Type=<MyPinType>.EventName=<CameraEvent>.ValueName=<CameraEventValue>
   其中：
   <MyPinName>：新输出引脚的名称
   <MyPinType>：要访问的事件的数据类型（允许的值：Boolean、Float、Integer 和 String）
   <CameraEvent>：相机中要访问的事件的名称
   <CameraEventValue>：相机中的事件值名称，例如 EventExposureEnd
7. 按 Enter。
   新引脚将显示在 vTool 中。

配置示例#

假设您要创建一个名为 ExposureEnd、数据类型为 Integer 的输出 pin，用于输出曝光结束相机事件的信息。为此，请输入以下字符串：

ExposureEnd.Type=Integer.EventName=ExposureEnd.ValueName=EventExposureEnd

访问 Chunk Data#

1. 在相机上启用 chunk mode 和所需的数据块。
   
2. 在 Workbench 中选择 Camera vTool。
3. 打开 Features - All 窗格。
4. 转到 vTool > Chunk Data Output Control 组。
5. 执行 Chunk Pin Add 命令。
6. 在 Chunk Pin 配置 字段中，输入要添加的数据块引脚的配置。使用以下语法：
   <MyPinName>.Type=<MyPinType>.ValueName=<ChunkName>
   其中：
   <MyPinName>：新输出引脚的名称
   <MyPinType>：您希望访问的块数据的价值类型，类似于相机中的类型
   <ChunkName>：您希望访问的块的名称，类似于相机中的名称，例如 ChunkExposureTime
7. 按 Enter。
   新引脚将显示在 vTool 中。

配置示例#

假设您想创建一个名为 ExposureTimeChunk 且数据类型为 Integer 的输出引脚，用于输出相机曝光时间块的信息。为此，请输入以下字符串：

ExposureTimeChunk.Type=Float.ValueName=ChunkExposureTime

故障排除#

输出#

图像#

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

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

相关的 vTools#

典型后置项#

• 校准vTool
• Relative Thresholding vTool
• Auto Thresholding vTool
• Absolute Thresholding vTool
• 颜色分类器vTool
• 条码读取器vTool
• Data Matrix Code Reader vTool
• QR Code Reader vTool
• Measurements Basic vTool
• Geometric Pattern Matching vTool