使用配方#
配方保存时的文件扩展名为 .precipe，可以导入到您的应用程序代码中。有关在应用程序中导入和使用配方的更多信息，请参考 C++ Data Processing Programmer's Guide（可通过 Help 菜单访问）或 Data Processing SDK 示例。
有三种类型的 recipe：
- pylon Recipe：这是标准的 recipe 格式。
- pylon Compressed Recipe：这会在保存期间对二进制数据应用压缩。这会使 recipe 文件变小，但会增加保存和加载 recipe 所需的时间。它包含与标准 pylon recipe 相同的数据量，但采用压缩形式。
- pylon Lean Runtime Recipe：这只保存运行时操作所需的数据，从而使加载速度更快。它包含的数据比标准的 pylon recipe 少。这使其成为在工作环境中部署 recipe 的好选择。如果要进一步编辑该 recipe，请确保保留标准 recipe 的副本。包含 Template Matching Basic 和 Geometric Pattern Matching Basic 以及 PRO vTool 的 Lean runtime recipe 不向下兼容。
根据您要执行的图像处理任务，选择所需的 vTools 并按所需顺序连接它们。
创建配方#
要创建配方：
-
在 Workbench 中，打开一个新配方：
- 在 Workbench 菜单中，选择 New Recipe 或 New from Template。
-
在 Workbench 工具栏中，单击新配方按钮：
-
如果要添加 vTools，请在 vTools 窗格中选择它们，或右键单击配方并从上下文菜单中选择所需的 vTools。
- 如果要将一个 vTool 的输出与设计中下一个 vTool 的相应输入相连，请单击输出引脚并将连接拖动到输入引脚上。
- 如果要将最后一个 vTool 的输出连接到输出端子，请单击输出引脚并将连接拖动到输出端子上。
-
以所需的格式保存 recipe。
信息
如果要保存 Camera vTool 中分配的相机的相机参数设置，请先单击 Workbench 工具栏中的 Lock Resources 按钮。否则，配方中不会保存任何相机设置。有关更多信息，请参阅 Camera vTool 主题。
配方模板#
Workbench 提供了许多配方模板，可帮助您快速启动和运行。有以下应用场景的模板可用：
- 阿兹特克码读取
- 条形码读取
- Blob 分析
- 颜色 Blob 分析
- 数据矩阵码读取
- 几何图案匹配
- 灰度值转换
- 图像对齐
- 图像组合
- 图像格式转换
- 图片加载中
- 图像形态学
- 测量（圆形、椭圆形、直线、矩形）
- PDF417 条码读取
- 二维码读取
- ROI 创建
- 模板匹配
运行配方#
将配方导入应用程序代码之前，建议对其进行测试。通过这种方式，您可以验证一切是否正确配置并产生所需的结果。
要运行配方：
- 单击 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 选项卡。
- 输入所需的线程数。
有关优化的更多信息，请参阅配方管理。