vTools#
每个 vTool 都可以执行特定的任务,例如相机校准、图像格式转换或条形码读取等等。在 Workbench 中,添加所需的 vTools,按照您想要的顺序连接它们,然后将设计保存为配方文件 (.precipe)。最后,您可以将配方添加到您的应用程序中。
在配置 vTools 时,您可以通过加载图像并运行配方来快速测试您所做的任何更改。在 Workbench 中称为 pin data view 的区域中,您可以查看运行时的结果。调整设置并重复此过程,直到您满意为止。
将 vTools 集成到您的应用程序中#
要将图像处理设计集成到您自己的应用程序中,请使用 pylon C++ Data Processing API,它提供了一系列简单的函数,用于加载和执行配方以及在程序代码中评估结果。
当您再次将配方加载到应用程序中时,在 pylon Viewer 中对配方设置所做的更改将生效。您无需更改或重新编译应用程序代码。
pylon C++ Data Processing API 提供了一组示例,演示了某些常见的用例。示例代码中包含许多 demo vTools。
有关详细信息,请参阅 pylon Viewer 的 Help 菜单中或 pylon 安装目录(通常为 C:\Program Files\Basler\pylon\Development\Documentation\PylonCppDataProcessingSDK.chm)中提供的 pylon C++ Data Processing Programmer's Guide。
数据生成型与数据处理型 vTools#
vTools 分为两类:生成数据的 vTools 和处理数据的 vTools。了解这一区别非常重要,因为该特性会影响 vTools 在添加到配方时的行为。
顾名思义,data-generating vTools 通过新的更新生成数据,既可以靠自身生成(即没有输入 pin),也可以通过将通过输入 pin 接收到的数据转化为新数据来生成。有关更新概念的详细信息,请参阅 pylon Viewer 的 Help 菜单中或 pylon 安装目录(通常为 C:\Program Files\Basler\pylon\Development\Documentation\PylonCppDataProcessingSDK.chm)中提供的 pylon C++ Data Processing Programmer's Guide。
以下 vTools 会生成数据:
- Array Element Iterator vTool
- 相机vTool
- Data Synchronizer vTool
- Image Loading vTool
- Multiplexer vTool
- Test Image Generator vTool
所有其他 vTool 都只处理数据。数据生成型 vTool 的输出引脚呈三角形,以便您在视觉上将其与数据处理型 vTool 区分开来。
默认情况下,来自数据生成型引脚的 connections 队列模式设置为 Unlimited。

可用的 vTools#
某些 vTool 是免费的,包含在 pylon Viewer 安装包中。其他 vTool 则需要许可证。有关如何获取和激活许可证的更多信息,请参阅vTool Licensing。
除了单个 vTool 的许可证外,您还可以购买在一个许可证中捆绑在一起的 vTool 组合,例如特定用例所需的 vTool。
免费的 vTools#
- Array Creator vTool
- Array Element Iterator vTool
- Array Element Selector vTool
- 相机vTool
- Data Synchronizer vTool
- Demultiplexer vTool
- Grid Creator vTool
- Histogram Extractor vTool
- Histogram Statistics vTool
- Image Alignment vTool
- Image Concatenation vTool
- Image Cropper vTool
- Image Format Converter vTool
- Image Loading vTool
- Image Transformer vTool
- Mini Script vTool
- Painter vTool
- Region Combiner vTool
- Region Inverter vTool
- ROI Creator vTool
- 所有 vTool 的 Starter 版本
可授权的 vTools#
- Absolute Thresholding vTool
- Anomaly Detection vTool
- Auto Thresholding vTool
- Aztec Code Reader vTool
- 条码读取器vTool
- 校准vTool
- Circle Measurements Pro vTool
- Classification vTool
- 颜色分类器vTool
- Data Matrix Code Reader vTool
- Document Cropper vTool
- Ellipse Measurements Pro vTool
- Geometric Pattern Matching vTool
- Gray Value Transformer vTool
- Image Combiner vTool
- Image Enhancer vTool
- Image Morphology vTool
- Image Sharpening vTool
- Image Smoothing vTool
- Instance Segmentation vTool
- Line Measurements Pro vTool
- Measurements Basic vTool
- Multiplexer vTool
- Object Detection vTool
- OCR vTool
- OPC UA Client vTool
- PDF417 Code Reader vTool
- QR Code Reader vTool
- Rectangle Measurements Pro vTool
- Region Feature Extraction vTool
- Region Morphology vTool
- Region Selection vTool
- Relative Thresholding vTool
- Semantic Segmentation vTool
- Template Matching vTool
演示 vTool#
提供演示 vTool 是为了让您能够运行 pylon 附带的示例,这些示例展示了某些常见的用例。
有关演示 vTool 的文档,请参阅 pylon Viewer 中包含的 vTool Documentation 窗格。
- Test Image Generator vTool
- Stamp vTool
实验性 vTools#
实验性 vTool 通常是应客户要求或作为通用开发工具创建的。它们在开发的早期阶段发布。在可用性和成熟度方面,它们没有达到其他 vTool 那样的高标准,并且在未来的版本中可能会经历重大更改。Basler 欢迎对这些 vTool 提供反馈(通过设置对话框中的反馈链接)。
有关实验性 vTool 的文档,请参阅 pylon Viewer 中包含的 vTool Documentation 窗格。
- Data Writer vTool
- Free-Form OCR vTool
许可证和套装#
某些 vTool 可以单独购买,而其他 vTool 则作为捆绑包的一部分提供,例如用于 Color Blob Analysis 等特定用例。以下是可用许可证和许可证捆绑包的概述。
Blob Analysis Basic#
Blob Analysis 许可证包含用于典型基于阈值的 blob 分析任务的 pylon vTool,例如通过灰度值范围识别区域。
结合区域 vTool,您可以使用阈值 vTool 以出色的鲁棒性、准确性和性能来识别和分析区域、对象和结构。
该许可证包含以下 vTool:
- Absolute Thresholding
- Auto Thresholding
- Relative Thresholding
- Region Feature Extraction
- Region Morphology vTool
- Region Selection vTool
若要购买许可证,请访问 Basler 网站。
Color Blob Analysis Basic#
Color Blob Analysis 许可证包含无法通过常见灰度阈值技术解决的 blob 分析任务的 pylon vTool,例如通过颜色识别对象。
您只需加载一张图像(实时图像或来自磁盘的图像)并标记属于您感兴趣对象的像素,即可训练模型,然后将其应用于新图像。结合区域 vTool,您可以使用该模型以出色的鲁棒性、准确性和性能来识别和分析区域、对象和结构。
该许可证包含以下 vTool:
若要购买许可证,请访问 Basler 网站。
Measurements Pro#
Measurements Pro 许可证提供用于测量单线上边缘之间的距离以及测量矩形和圆形等几何形状的 vTool。
您可以结合使用测量 vTool 和 Calibration vTool。通过连接这些 vTool,测量出的所有距离都将以校准单位返回。
该许可证包含以下 vTool:
- Measurements Basic vTool
- Circle Measurements Pro vTool
- Ellipse Measurements Pro vTool
- Line Measurements Pro vTool
- Rectangle Measurements Pro vTool
若要购买许可证,请访问 Basler 网站。
Preprocessing Basic#
Preprocessing Basic 许可证提供用于图像算术运算以及平滑和形态学运算的 vTool。
借助这些高性能算法,您可以增强、掩膜或弱化图像特征,以便改进和优化图像以进行后续处理步骤。
该许可证包含以下 vTool:
- Gray Value Transformer vTool
- Image Combiner vTool
- Image Enhancer vTool
- Image Morphology vTool
- Image Sharpening vTool
- Image Smoothing vTool
若要购买许可证,请访问 Basler 网站。
Code Reader Bundle#
Code Reader Bundle 许可证包括 Basic 和 Pro 版本中的所有条码读取 vTools。
- Aztec Code Reader Basic
- Aztec Code Reader Pro
- Barcode Reader Basic
- Barcode Reader Pro
- Data Matrix Code Reader Basic
- Data Matrix Code Reader Pro
- PDF417 Code Reader Basic
- PDF417 Code Reader Pro
- QR Code Reader Basic
- QR Code Reader Pro
若要购买许可证,请访问 Basler 网站。
General vTools Pro Bundle#
General vTools Pro Bundle 许可证可让您使用各种 Basler vTools。其中包含以下套装和单个 vTools:
- 校准vTool
- 几何图案匹配
- OCR vTool
- Template Matching
- Code Reader Bundle
- Blob Analysis Basic
- Color Blob Analysis Basic
- Measurements Pro
- Preprocessing Basic
若要购买许可证,请访问 Basler 网站。
输入和输出引脚#
每个 vTool 都有输入和输出引脚,用于将数据输入到 vTools 并将数据传递到设计中的下一步。要连接 vTools,请单击输出引脚,并将连接拖动到另一个 vTool 的相同类型的输入引脚,即从 Camera vTool 的图像输出引脚拖动到 Barcode Reader vTool 的图像输入引脚。
输入和输出端子可以视为配方的输入/输出引脚。您可以使用输入端子将数据推送到 vTool 的输入引脚,且可以使用输出端子从 vTool 的输出引脚接收数据。
此外,您还可以通过输入端子直接将相机分配给配方。这使您能够在配方中使用相机的图像流,而无需使用Camera vTool。
以下屏幕截图说明了如何连接 vTools 和端子:

迷你地图#
如果您的配方包含大量 vTools,可能并非所有都可见,取决于 Workbench 窗格的大小。在这种情况下,您可以查看迷你地图,此地图显示可见区域外部的任何 vTools。
配置 vTools#
根据 vTool 的不同,您可以通过设置对话框或通过 Features - All 窗格中的 vTool 参数或同时使用这两者来配置它。有关更多详细信息,请参阅要配置的 vTool 主题。