使用配方#
Recipes 會以副檔名 .precipe 儲存,且可以匯入您的應用程式程式碼中。如需有關在應用程式中匯入和使用 Recipes 的詳細資訊,請參閱 C++ Data Processing Programmer's Guide(透過 Help 功能表存取)或 Data Processing SDK 範例。
根據您想要執行的影像處理任務,選取所需的 vTools 並以所需的順序將其連接。
建立 Recipe#
若要建立 Recipe:
-
在 Workbench 中,開啟新的 Recipe:
- 在 Workbench 功能表中,選取 New Recipe 或 New from Template。
-
在 Workbench 工具列中,按一下 New Recipe 按鈕:
-
透過在 vTools pane 中選取 vTools,或在 Recipe 中按一下滑鼠右鍵並從操作功能表中選取所需的 vTools,來新增 vTools。
- 按一下某個 vTool 的輸出接腳並將連線拖曳到輸入接腳上,將該 vTool 的輸出與設計中下一個 vTool 的對應輸入相連接。
- 按一下輸出接腳並將連線拖曳到輸出端子上,將最後一個 vTool 的輸出連接到輸出端子。
-
儲存 Recipe。
資訊
如果您想要儲存配置在 Camera vTool 中的相機相機參數設定,請先按一下 Workbench 工具列中的 Lock Resources 按鈕。否則,將不會在 Recipe 中儲存任何相機設定。如需詳細資訊,請參閱 Camera vTool 主題。
Recipe Templates#
Workbench 提供了許多 Recipe 範本,可協助您快速上手並執行。適用於以下應用情境的範本可供使用:
- Aztec 碼讀取
- 條碼讀取
- 斑點分析
- 色彩斑點分析
- Data Matrix 碼讀取
- 幾何圖案比對
- 灰階值轉換
- 影像對齊
- 影像組合
- 影像格式轉換
- 圖片載入中
- 影像形態學
- 測量(圓形、橢圓形、直線、矩形)
- PDF417 碼讀取
- QR 碼讀取
- ROI 建立
- 範本匹配
執行 Recipe#
在將 recipe 匯入您的應用程式程式碼之前,建議先進行測試。這樣您可以驗證一切配置是否正確,並產生所需的結果。
若要執行 recipe:
- 按一下 Lock Resources 以專屬配置您要使用的相機。
如果您需要配置任何相機設定,請前往 Features - All 窗格。 -
在 Workbench 工具列中,按一下 Run 按鈕:
-
在 Recipe Management 窗格的 Preview Pin Data 區域中,會顯示進出目前選定 vTool pin 的資料。
若要檢視較大的畫面,請按一下 Workbench 工具列中的 Pin Data View 按鈕以開啟 pin 資料檢視:
收集統計資料#
若要檢查您的 recipe 是否符合應用程式的時序要求,您可以測量個別 vTool 或 recipe 中包含的所有 vTool 的執行時間。
若要收集統計資料:
- 啟動您要檢查的 recipe。
- 如果您要收集關於某個 vTool 的資料,請在 recipe 中選取該 vTool。
如果您要收集關於 recipe 的資料,請按一下 recipe 中的任意位置(不要點擊 vTool)來選取它。recipe 周圍的藍色框線表示該 recipe 已被選取。 - 在 Recipe Management 窗格中,按一下 Statistics 標籤頁。
- 按一下 Start Measurement。
根據您在步驟 2 中的選擇,相應的資料將顯示在 Recipe Statistics 或 (vTool) Statistics 區域中。
結果將記錄在 .CSV 檔案中。預設情況下,此檔案將儲存在您的使用者資料夾中:C:/Users/username。
若要變更資料夾:
- 按一下 recipe 中的任意位置來選取 recipe(不要點擊 vTool)。
recipe 周圍的藍色框線表示該 recipe 已被選取。 - 在 General Settings 區域中,變更輸出資料夾。
如需關於統計功能的更多資訊,請參閱 Recipe Management。
最佳化 Recipe#
您可以指定 CPU 同時處理多少個 Workbench執行緒。
若要最佳化您的 recipe:
- 在 Recipe Management 窗格中,按一下 Optimization 標籤頁。
- 輸入所需的執行緒數量。
如需關於最佳化的更多資訊,請參閱 Recipe Management。