vTools#
每個 vTool 都可以執行特定的任務,例如相機校正、影像格式轉換或條碼讀取(僅舉幾例)。在 Workbench 中,新增所需的 vTools,以您想要的順序將其連接,然後將設計儲存為 recipe 檔案(.precipe)。最後,您可以將該 recipe 新增至您的應用程式中。
設定 vTools 時,您可以透過載入影像並執行 recipe 來快速測試您所做的任何變更。在 Workbench 中稱為 pin data view 的區段中,您可以查看執行階段的結果。調整設定並重複此過程,直到您滿意為止。
將 vTools 整合至您的應用程式#
若要將影像處理設計整合到您自己的應用程式中,請使用 pylon C++ Data Processing API,它提供各種簡單的函數,可用於載入和執行 recipe 以及評估程式碼中的結果。
當您再次將 recipe 載入應用程式時,在 pylon Viewer 中對 recipe 設定所做的變更即會生效。您不必變更或重新編譯應用程式碼。
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 新增至 recipe 時的行為。
顧名思義,data-generating vTools 會隨著新的更新產生資料,無論是它們本身(即它們沒有 input pin),還是透過將透過其 input pins 接收到的資料轉換為新資料。如需關於更新概念的詳細資訊,請參閱 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
所有其他 vTools 僅處理資料。資料產生型 vTools的 output pins 是三角形的,可協助您在視覺上將其與處理型 vTools 區分開來。
依預設,來自資料產生型 pin 的 connections 佇列模式會設定為 Unlimited。

可用的 vTools#
某些 vTool 是免費的,並包含在 pylon Viewer 安裝程式中。對於其他 vTool,您需要一個授權。如需有關如何取得與啟用授權的詳細資訊,請參閱vTool 授權。
除了個別 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 的入門版本
可授權的 vTools#
- Absolute Thresholding vTool
- Anomaly Detection vTool
- Auto Thresholding vTool
- Aztec Code Reader vTool
- Barcode Reader vTool
- 校準vTool
- Circle Measurements Pro vTool
- Classification vTool
- Color Classifier 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
示範版 vTools#
提供 Demo vTool 是為了讓您可以執行 pylon 中隨附的範例,以展示某些常見的使用情境。
如需 Demo vTool 的說明文件,請參閱 pylon Viewer 中隨附的 vTool Documentation 窗格。
- Test Image Generator vTool
- Stamp vTool
實驗性 vTools#
實驗性 vTools 通常是應客戶要求或作為通用開發工具而建立的。它們在開發的早期階段發布。在可用性和成熟度方面,它們不提供與其他 vTools 相同的高標準,並且在未來版本中可能會經歷重大變更。Basler 歡迎對這些 vTools 提供意見反應(透過設定對話方塊中的意見反應連結)。
如需實驗性 vTool 的說明文件,請參閱 pylon Viewer 中隨附的 vTool Documentation 窗格。
- Data Writer vTool
- Free-Form OCR 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。
您可以結合 Calibration vTool 使用量測 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 版本中的所有程式碼讀取 vTool。
- 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
- Geometric Pattern Matching
- 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 的 Image 輸出接腳連接至 Barcode Reader vTool 的 Image 輸入接腳。
輸入和輸出端子可視為配方的輸入/輸出接腳。您可以使用輸入端子將資料推送至 vTool 的輸入接腳,並使用輸出端子從 vTool 的輸出接腳接收資料。
此外,您可以透過 input terminal 直接將相機指派給配方。這可讓您在配方中使用相機的影像串流,而不需使用 Camera vTool。
以下螢幕擷取畫面說明如何連接 vTools 和端子:

迷你地圖#
如果您的配方包含大量 vTools,則根據 Workbench 窗格的大小,可能無法全部顯示。在這種情況下,您可以檢查迷你地圖,它會顯示可見區域之外的所有 vTools。
設定 vTools#
根據 vTool 的不同,您可以透過設定對話方塊、Features - All 窗格中的 vTool 參數,或兩者結合的方式來進行設定。如需更多詳細資訊,請參閱您要設定的 vTool 主題。