ROI Creator vTool#
透過定義興趣區，您可以縮減影像處理工作流程中下一個 vTool 所處理的影像區域。這可讓您僅在指定的目標區域上執行影像處理。如此有助於避免得出錯誤的結果或縮短處理時間。
ROI Creator vTool 透過 Image 輸入接腳接收影像，並透過 Roi 輸出接腳輸出矩形興趣區的大小、方向和位置。
下載 pylon Software Suite 以使用 ROI Creator vTool。
運作原理#
若要使用 ROI Creator，您需要將其 Image 輸入接腳連接至另一個 vTool 的 Image 輸出接腳。
接著，您可以在 ROI Creator 的設定對話方塊中定義所需的興趣區。您不需要為此開啟影像。如果您知道興趣區的大小、方向和位置，可以使用 ROI Settings 區域中的輸入框。
或者，您也可以擷取或開啟影像。影像中將會顯示一個表示興趣區的矩形。您可以使用控制代碼或 ROI Settings 區域中的輸入框來移動、調整大小和旋轉它。
如果您載入不同的影像，先前指定的 ROI 將會保留。如果新影像小得多或大得多，ROI 可能無法涵蓋影像中有意義的部分。它甚至可能位於影像外部。您無須手動調整大小和重新定位，只需按一下 Restore Default。這會將興趣區恢復為預設值（佔影像的 85% 並置中）。
提示
建立興趣區的另一種方法是使用可輸出區域的其中一個 vTools。這些 vTools 如下：
- Absolute Thresholding vTool
- Auto Thresholding vTool
- Relative Thresholding vTool
- Color Classifier vTool
- Template Matching vTool
- Region Morphology vTool
您可以將這些 vTools 的 Region/Regions 輸出接腳連接至其他 vTools 的 Roi 輸入接腳。支援 RectangleF、RectangleF Array、Region 和 Region Array 資料類型。
RectangleF 和 RectangleF Array 資料類型會逐像素轉換為區域。若是陣列，則會在內部合併個別的矩形或區域以建立單一區域。
將 ROI Creator vTool 新增至影像來源（例如 Camera vTool）與影像處理工具（例如 Template Matching vTool）之間，如下列螢幕擷取畫面所示。Image 輸出接腳必須連接至兩個 Image 輸入接腳，且 ROI 輸出接腳必須連接至 Roi 輸入接腳。
常見使用案例#
縮減 Matching vTools 的 ROI#
假設有一項印刷檢測任務，您的目標是確保已印上特定的標誌。通常，您會讓 Template Matching vTool 學習所需的標誌。然而，標籤通常包含其他相似的標誌或字串，這可能會導致不理想的結果。
下圖顯示了突顯所需標誌的範本影像。理想情況下，待檢測的影像應該與之類似，且標誌位於幾乎相同的位置。
如果您在整個檢測影像上執行 template matching，將會找到另外兩個匹配項。相鄰的標誌很相似且具有良好的評分。如果您想在 template matching 期間容許一定程度的印刷劣化，0.6 到 0.7 的最低匹配評分是很常見的。因此，此評分不足以區分這三個不同的標誌。
為了解決這個問題，請使用 ROI Creator vTool。在設定對話方塊中，將標誌的中心部分定義為感興趣區域。如此一來，就只會找到範本中心位於感興趣區域內的匹配項。
資訊
如果您使用感興趣區域將影像處理或多或少精確地限制在特定位置，則被檢測的物件必須位於完全相同的位置。如果物件定位存在變異，請將 Image Alignment vTool 用作前置步驟。
縮減 Segmentation 的 ROI#
您也可以使用 ROI Creator vTool 以不同的方式解決上述印刷檢測任務。
首先，定義一個涵蓋要檢測的整個標誌加上特定容差的感興趣區域。接下來，使用 thresholding vTool，例如 Auto Thresholding vTool。最後，使用 Region Feature Extraction vTool 來計算包含深色標誌的區域面積。指定面積的最低閾值，以區分印刷良品或不良品。
設定 vTool#
若要設定 ROI Creator vTool：
- 將 Image 輸入接腳連接至另一個 vTool 的 Image 輸出接腳。
- 在 vTool Settings 區域的 Recipe Management 窗格中，按一下 Open Settings 或按兩下該 vTool。
隨即會開啟 ROI Creator 對話方塊。 - 擷取或開啟影像。
- 在 ROI Settings 區域中，手動定義感興趣區域。
或者，您可以使用影像中顯示的矩形控點來隨心所欲地移動、調整大小和旋轉它。
Inputs#
Image#
直接接收來自 Camera vTool 或輸出影像之 vTool（例如 Image Format Converter vTool）的影像。
- 資料類型：Image
- 影像格式：8 位元至 16 位元單色或彩色影像。彩色影像會在內部轉換為單色影像。
Outputs#
ROI#
傳回感興趣區域。
- 資料類型：RectangleF