Grid Creator vTool#
若要設計網格，您必須指定列數與欄數，以及個別儲存格的高度與寬度。您也可以設定希望網格涵蓋整張圖像或僅涵蓋其中一部分。根據預設，網格會從圖像的左上像素開始。透過指定偏移量，您可以將網格放置在感興趣區域 (ROI) 開始的位置。
下載 pylon Software Suite 即可使用 Grid Creator vTool。
先決條件#
- 在您的應用程式中，圖像大小必須保持不變。如果圖像大小有所差異，網格可能就會不再適用。
- 在您設定 Grid Creator vTool 之前，必須先將其 Image 輸入接腳連接至另一個 vTool 的 Image 輸出接腳。
使用案例情境#
根據感興趣區域 (ROI)，使用 Grid Creator 時有兩種不同的情境：
- ROI 涵蓋整個圖像。
- ROI 僅涵蓋圖像的一部分。
這些情境在設定 vTool 時需要不同的方法。
覆蓋整張影像的 ROI#
這是最直接的情況。您取得來源圖像、計算列數與欄數，並啟用 Auto Size Grid 功能。這是範例輸入圖像：
共有 5 欄和 5 列。必要的設定如下所示：
開啟 pin data view 並選取 ImageLoading Image 與 GridCreator Rectangles 接腳。如果您現在執行配方 (recipe)，您將會看到已偵測到 25 個儲存格：
如果您同時啟用 Regions 輸出接腳，彩色疊加層會更清楚地顯示網格：
覆蓋部分影像的 ROI#
這個使用案例需要更多步驟。範例影像顯示一個箱子裡放了 30 個 AA 電池。有些方向放錯了，也就是上下顛倒。電池之間的間距不規則，且沒有 Fill 整個影像。
您可以再次從計算欄數和列數開始：5 欄和 6 列。如果您輸入這些數值並啟用 Auto Size Grid 功能，結果會如下所示：
如您所見，一個具有 30 個儲存格的網格已覆蓋在影像上。然而，由於未考慮邊距，並非每個儲存格都剛好包含一個電池。特別是在第 4 欄中，結果會變得模糊，因為在一個儲存格中可以看到兩個電池的部分。
若要改善網格配置，請停用 Auto Size Grid 功能。相反地，您必須手動指定儲存格寬度和高度（即電池的寬度和高度），以及垂直和水平位移（即您希望網格開始的位置）。根據預設，網格的原點位於左上角 (0,0)。
將滑鼠指向像素，即可在影像視窗的狀態列中檢視該像素的座標。
使用像素座標，您可以決定網格所需的 Property，並指定對應的參數值。
在 recipe 執行時，您可以微調寬度、高度和尺寸，直到滿意為止。最終結果可能如下所示：
您可以看到每個電池都被網格的一個儲存格所覆蓋。所有 30 個電池皆已被偵測到。
設定 vTool#
若要設定 Grid Creator vTool，請在 Workbench 中按兩下它。隨即會開啟一個對話方塊，顯示所有可用的設定。或者，您也可以在 Features - All 窗格中找到相同的設定。
- 將 Grid Creator 的 Image 輸入接腳連接到另一個 vTool 的 Image 輸出接腳。
- 計算影像中的欄數和列數，並分別在 Number of Columns 和 Number of Rows 輸入欄位中輸入數值。
- 如果您希望網格覆蓋整個影像，請選取 Auto Size Grid 參數。
這可讓 vTool 根據您指定的欄數和列數將影像分割成儲存格。如果您需要較小的網格，請繼續下一個步驟。 - 停用 Auto Size Grid 參數。
- 決定個別儲存格的寬度和高度，並分別在 Cell Width 和 Cell Height 參數中輸入數值。
請參閱下方的提示。 - 指定水平和垂直位移。
提示
如果您啟用 Regions 輸出接腳，輸入影像上方將會顯示覆疊，以顯示不同的區域（即儲存格）。這可讓您在 recipe 執行時，直接在 pin data view 中立即查看設定的效果。若要這麼做：
- 選取 Regions Output Pin 參數。
- 開啟 pin data view，然後選取影像來源 vTool 的 Image 接腳以及 Grid Creator 的 Regions 接腳。
- 啟動 recipe。
您可能需要稍微調整設定才能讓網格完美契合。如果將滑鼠懸停在影像中的像素上，pin data view 的狀態列會顯示該像素的座標 (X/Y)。這應該有助於您找到正確的設定。
Inputs#
Image#
直接接受來自 Camera vTool 或任何其他輸出影像之 vTool 的影像。
- 資料類型：Image
- 影像格式：8 位元與 16 位元單色或彩色影像（請參閱支援的 Pixel Format）
Outputs#
矩形#
傳回網格中每個儲存格的矩形。
- 資料類型：RectangleF 陣列
Regions#
傳回網格中的區域數量並在影像中視覺化這些區域。
- 資料類型：Region Array
支援的 Pixel Format#
原生存取支援以下 Pixel Format：
- Mono 8
- Mono 16
- Bayer XX 8
- Bayer XX 16
- RGB 8
- BGR 8