跳至內容
測試伺服器
開發伺服器

使用配方#

Recipes 是您在 Workbench 中建立的影像處理設計。

Recipes 會以副檔名 .precipe 儲存,且可以匯入您的應用程式程式碼中。如需有關在應用程式中匯入和使用 Recipes 的詳細資訊,請參閱 C++ Data Processing Programmer's Guide(透過 Help 功能表存取)或 Data Processing SDK 範例。

根據您想要執行的影像處理任務,選取所需的 vTools 並以所需的順序將其連接。

建立 Recipe#

若要建立 Recipe:

  1. 在 Workbench 中,開啟新的 Recipe:

    • 在 Workbench 功能表中,選取 New Recipe 或 New from Template。
    • 在 Workbench 工具列中,按一下 New Recipe 按鈕:

      新增 Recipe 圖示

  2. 透過在 vTools pane 中選取 vTools,或在 Recipe 中按一下滑鼠右鍵並從操作功能表中選取所需的 vTools,來新增 vTools。

  3. 按一下某個 vTool 的輸出接腳並將連線拖曳到輸入接腳上,將該 vTool 的輸出與設計中下一個 vTool 的對應輸入相連接。
  4. 按一下輸出接腳並將連線拖曳到輸出端子上,將最後一個 vTool 的輸出連接到輸出端子。
  5. 儲存 Recipe。

    資訊

    如果您想要儲存配置在 Camera vTool 中的相機相機參數設定,請先按一下 Workbench 工具列中的 Lock Resources 按鈕。否則,將不會在 Recipe 中儲存任何相機設定。如需詳細資訊,請參閱 Camera vTool 主題。

Recipe Templates#

Workbench 提供了許多 Recipe 範本,可協助您快速上手並執行。適用於以下應用情境的範本可供使用:

  • Aztec 碼讀取
  • 條碼讀取
  • 斑點分析
  • 色彩斑點分析
  • Data Matrix 碼讀取
  • 幾何圖案比對
  • 灰階值轉換
  • 影像對齊
  • 影像組合
  • 影像格式轉換
  • 圖片載入中
  • 影像形態學
  • 測量(圓形、橢圓形、直線、矩形)
  • PDF417 碼讀取
  • QR 碼讀取
  • ROI 建立
  • 範本匹配

執行 Recipe#

在將 recipe 匯入您的應用程式程式碼之前,建議先進行測試。這樣您可以驗證一切配置是否正確,並產生所需的結果。

若要執行 recipe:

  1. 按一下 Lock Resources 以專屬配置您要使用的相機。
    如果您需要配置任何相機設定,請前往 Features - All 窗格。
  2. 在 Workbench 工具列中,按一下 Run 按鈕:

    Run Recipe 圖示

  3. 在 Recipe Management 窗格的 Preview Pin Data 區域中,會顯示進出目前選定 vTool pin 的資料。
    若要檢視較大的畫面,請按一下 Workbench 工具列中的 Pin Data View 按鈕以開啟 pin 資料檢視:

    Open Pin Data View 圖示

收集統計資料#

若要檢查您的 recipe 是否符合應用程式的時序要求,您可以測量個別 vTool 或 recipe 中包含的所有 vTool 的執行時間。

若要收集統計資料:

  1. 啟動您要檢查的 recipe。
  2. 如果您要收集關於某個 vTool 的資料,請在 recipe 中選取該 vTool。
    如果您要收集關於 recipe 的資料,請按一下 recipe 中的任意位置(不要點擊 vTool)來選取它。recipe 周圍的藍色框線表示該 recipe 已被選取。
  3. 在 Recipe Management 窗格中,按一下 Statistics 標籤頁。
  4. 按一下 Start Measurement。
    根據您在步驟 2 中的選擇,相應的資料將顯示在 Recipe Statistics 或 (vTool) Statistics 區域中。
    結果將記錄在 .CSV 檔案中。預設情況下,此檔案將儲存在您的使用者資料夾中:C:/Users/username。

若要變更資料夾:

  1. 按一下 recipe 中的任意位置來選取 recipe(不要點擊 vTool)。
    recipe 周圍的藍色框線表示該 recipe 已被選取。
  2. 在 General Settings 區域中,變更輸出資料夾。

如需關於統計功能的更多資訊,請參閱 Recipe Management。

最佳化 Recipe#

您可以指定 CPU 同時處理多少個 Workbench執行緒。

若要最佳化您的 recipe:

  1. 在 Recipe Management 窗格中,按一下 Optimization 標籤頁。
  2. 輸入所需的執行緒數量。

如需關於最佳化的更多資訊,請參閱 Recipe Management。