跳转到内容

使用配方#

配方是您在 Workbench 中创建的图像处理设计。

配方以 .precipe 为扩展名进行保存,并且可以导入到您的应用代码中。有关在应用程序中导入和使用配方的更多信息,请参阅 C++ 数据处理程序员指南或数据处理 SDK 示例。

根据您要执行的图像处理任务,选择所需的 vTools 并按所需顺序连接它们。

创建配方#

要创建配方:

  1. 在 Workbench 中,打开一个新配方:

    • Workbench 菜单中,选择 New RecipeNew from Template
    • 在 Workbench 工具栏中,单击新配方按钮:

      “新建配方”图标

  2. 如果要添加 vTools,请在 vTools 窗格中选择它们,或右键单击配方并从上下文菜单中选择所需的 vTools。

  3. 如果要将一个 vTool 的输出与设计中下一个 vTool 的相应输入相连,请单击输出引脚并将连接拖动到输入引脚上。
  4. 如果要将最后一个 vTool 的输出连接到输出端子,请单击输出引脚并将连接拖动到输出端子上。
  5. 保存配方。

    信息

    如果要保存 Camera vTool 中分配的相机的相机参数设置,请先单击 Workbench 工具栏中的 Lock Resources 按钮。否则,配方中不会保存任何相机设置。有关更多信息,请参阅 Camera vTool 主题。

配方模板#

Workbench 提供了许多配方模板,可帮助您快速启动和运行。有以下应用场景的模板可用:

  • 条形码读取
  • Blob 分析
  • 颜色 Blob 分析
  • 数据矩阵码读取
  • 几何图案匹配
  • 图像格式转换
  • 测量
  • 二维码读取

运行配方#

将配方导入应用程序代码之前,建议对其进行测试。通过这种方式,您可以验证一切是否正确配置并产生所需的结果。

要运行配方:

  1. 单击 Lock Resources 以独占分配您要使用的相机。
    如果您需要配置任何相机设置,请转到 Features - All 窗格
  2. 在 Workbench 工具栏中,单击运行按钮:

    “运行配方”图标

  3. 配方管理窗格的预览引脚数据区域中,将显示进出当前所选 vTool 引脚的数据。
    要放大视图,请打开引脚数据视图,方式是单击 Workbench 工具栏中的引脚数据视图按钮:

    “打开引脚数据视图”图标

收集统计数据#

要检查您的配方是否满足应用程序的时序要求,您可以测量配方中包含的单个 vTools 或所有 vTools 的执行时间。

要收集统计数据:

  1. 启动您要检查的配方。
  2. 如果要收集有关 vTool 的数据,请在配方中选择该 vTool。
    如果要收集有关配方的数据,请单击配方中的任意位置(not on a vTool),选择配方。配方周围的蓝框表示配方处于已选中状态。
  3. Recipe Management 窗格中,单击 Statistics 选项卡。
  4. 单击开始测量
    根据您在步骤 2 中的选择,相应的数据将显示在配方统计信息(vTool) 统计信息区域中。
    结果将记录在 .CSV 文件中。默认情况下,此文件将保存在您的用户文件夹中:C:/Users/username

要更改文件夹:

  1. 通过单击配方中的任意位置(not on a vTool)来选择配方。
    配方周围的蓝框表示已选择配方。
  2. General Settings 区域中,更改输出文件夹。

有关统计特征的更多信息,请参阅配方管理

优化配方#

您可以指定 CPU 同时处理多少个 Workbench 线程。

要优化您的配方:

  1. Recipe Management 窗格中,单击 Optimization 选项卡。
  2. 输入所需的线程数。

有关优化的更多信息,请参阅配方管理