使用配方#
Recipes are saved with the extension .precipe and can be imported into your application code. For more information about importing and working with recipes in your application, refer to the C++ Data Processing Programmer's Guide (accessible via the Help menu) or the Data Processing SDK samples.
根据您要执行的图像处理任务,选择所需的 vTools 并按所需顺序连接它们。
创建配方#
要创建配方:
-
在 Workbench 中,打开一个新配方:
- 在 Workbench 菜单中,选择 New Recipe 或 New from Template。
-
在 Workbench 工具栏中,单击新配方按钮:
-
如果要添加 vTools,请在 vTools 窗格中选择它们,或右键单击配方并从上下文菜单中选择所需的 vTools。
- 如果要将一个 vTool 的输出与设计中下一个 vTool 的相应输入相连,请单击输出引脚并将连接拖动到输入引脚上。
- 如果要将最后一个 vTool 的输出连接到输出端子,请单击输出引脚并将连接拖动到输出端子上。
-
保存配方。
信息
如果要保存 Camera vTool 中分配的相机的相机参数设置,请先单击 Workbench 工具栏中的 Lock Resources 按钮。否则,配方中不会保存任何相机设置。有关更多信息,请参阅 Camera vTool 主题。
配方模板#
Workbench 提供了许多配方模板,可帮助您快速启动和运行。有以下应用场景的模板可用:
- Aztec code reading
- 条形码读取
- Blob 分析
- 颜色 Blob 分析
- 数据矩阵码读取
- 几何图案匹配
- Gray value transformation
- Image alignment
- Image combination
- 图像格式转换
- Image loading
- Image morphology
- Measurements (circles, ellipses, lines, rectangles)
- PDF417 code reading
- 二维码读取
- ROI creation
- Template matching
运行配方#
将配方导入应用程序代码之前,建议对其进行测试。通过这种方式,您可以验证一切是否正确配置并产生所需的结果。
要运行配方:
- 单击 Lock Resources 以独占分配您要使用的相机。
如果您需要配置任何相机设置,请转到 Features - All 窗格。 -
在 Workbench 工具栏中,单击运行按钮:
-
在配方管理窗格的预览引脚数据区域中,将显示进出当前所选 vTool 引脚的数据。
要放大视图,请打开引脚数据视图,方式是单击 Workbench 工具栏中的引脚数据视图按钮:
收集统计数据#
要检查您的配方是否满足应用程序的时序要求,您可以测量配方中包含的单个 vTools 或所有 vTools 的执行时间。
要收集统计数据:
- 启动您要检查的配方。
- 如果要收集有关 vTool 的数据,请在配方中选择该 vTool。
如果要收集有关配方的数据,请单击配方中的任意位置(not on a vTool),选择配方。配方周围的蓝框表示配方处于已选中状态。 - 在 Recipe Management 窗格中,单击 Statistics 选项卡。
- 单击开始测量。
根据您在步骤 2 中的选择,相应的数据将显示在配方统计信息或 (vTool) 统计信息区域中。
结果将记录在 .CSV 文件中。默认情况下,此文件将保存在您的用户文件夹中:C:/Users/username。
要更改文件夹:
- 通过单击配方中的任意位置(not on a vTool)来选择配方。
配方周围的蓝框表示已选择配方。 - 在 General Settings 区域中,更改输出文件夹。
有关统计特征的更多信息,请参阅配方管理。
优化配方#
您可以指定 CPU 同时处理多少个 Workbench 线程。
要优化您的配方:
- 在 Recipe Management 窗格中,单击 Optimization 选项卡。
- 输入所需的线程数。
有关优化的更多信息,请参阅配方管理。