Operator HitOrMiss

Operator Library: Filter

「HitOrMiss」運算子會對二值影像執行形態學上的「命中或未命中」運算,可用於識別 結構或物件。 其輸入為一個核流(參見例如 FIRkernelNxM)。 輸出連結提供中心像素的計算值。 用於「命中或錯過」運算的結構元素由一個可參數化的矩陣定義。 該矩陣的大小與輸入核相同。

若某個像素的核鄰域與參數StructElement 中定義的模式完全匹配, 則該像素的輸出值將設為「1」。 若存在一處或多處不匹配,則輸出值將設為「0」。 透過參數StructElement定義的搜尋模式,可使用 0 或 1 來定義匹配條件。 此外,也允許使用值 -1。此值用於定義結構元素中應被忽略部分的「不關心」值。 若搜尋模式中的所有值皆為 '-1',其行為將取決於 StructElement 的靜態/動態屬性。 在靜態情況下,結果將始終為「未匹配」;在動態情況下,結果將始終為「匹配」。

讓我們來看一個例子。以下給出一個 struct 元素。

我們將把它與下圖一配對

若將結構元素與圖像進行配對,則輸出 O 為

若要產生所需的輸入核心,請使用諸如 FIRkernelNxM、 LineNeighboursNx1 或 PixelNeighbours1xM 等運算子。

I/O Properties

Property Value
Operator Type O
Input Link I, kernel input
Output Link O,資料輸出

Supported Link Format

Link Parameter Input Link I Output Link O
Bit Width 1 as I
Arithmetic 無號數 as I
Parallelism any as I
Kernel Columns any 1
Kernel Rows any 1
Img Protocol {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D} as I
Color Format VAF_GRAY as I
Color Flavor FL_NONE as I
Max. Img Width any as I
Max. Img Height any as I

Parameters

StructElement
Type static/dynamic 讀寫參數
Default -1
Range {-1, 0, 1}

此參數定義結構元素的形狀。

  • 結構體元素中的「0」必須與對應的核函式輸入中的「0」相符。

  • 結構體元素中的「1」必須與對應的核函式輸入中的「1」相符。

  • 結構元素中的「-1」將該位置標記為不關心 (don't care) 並將被忽略。

如果變更運算子的輸入核心大小,係數也會隨之改變。 變更輸入核心大小後,請檢查係數。

若將參數設定為「靜態」,則會在設計階段選取數值。 若將參數設定為「動態」,則可在執行階段變更數值。 執行階段的變更會立即生效,不會同步至幀結束或行結束時。

Examples of Use

以下範例展示了 HitOrMiss 運算子的使用方式:

  • 'Hit or Miss'

    範例 - 此實作可以在二元影像中偵測四個簡單的圖案。 每找到一個符合項,輸出就會設為 1。