Operator LineNeighboursNx1

Operator Library: Filter

運算子 LineNeighboursNx1 會建立一個具有 N 行、1 欄的核窗。 這 N 個像素位於每個輸入影像像素的正上方。

該運算子與 FIRkernelNxM ,但具備其他功能。 此運算子的關鍵特點在於其屬於 O 型,這能大幅簡化設計過程中的同步作業。 然而,O 型功能所付出的代價是存在某些限制。

與 FIRkernelNxM 的首要差異在於,此運算子不會將當前像素置於核的中心。 假設定義了一個 3x1 尺寸的核。 在輸出影像 O(x, y) 的核索引 0 處,會提供位於位置 I(x, y) 的當前像素。 在輸出影像的核索引 1 處,會提供輸入影像中位於輸入位置 I(x, y-1) 的像素。 因此,在核行索引 n 處,輸出影像為

換句話說,該運算子無法輸出「未來」行中的像素,也就是尚未處理過的像素。 這就是為什麼該運算子屬於 O 型,且不會造成行或像素延遲的原因。

由於運算子無法提供當前行之前的資訊,因此不存在 如在 FIRkernelNxM中的 鏡像邊緣處理功能。 取而代之的是,輸出鏈路中所有來源位於影像邊界之外的像素,都會被設定為 參數Constant 的數值。

若要產生二維核,請將此運算子與 運算子 PixelNeighbours1xM 模組,即可在影像處理流程中生成二維核函數。

I/O Properties

Property Value
Operator Type O
Input Link I,資料輸入
Output Link O,核心輸出

Supported Link Format

Link Parameter Input Link I Output Link O
Bit Width any1 as I
Arithmetic {unsigned, signed} as I
Parallelism any as I
Kernel Columns any as I
Kernel Rows 1 any
Img Protocol {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D} as I
Color Format any as I
Color Flavor any as I
Max. Img Width any as I
Max. Img Height any as I

1

未帶正負號數值的輸入 Bit Width 範圍為 [1, 64]。 對於帶正負號的輸入,範圍為 [2, 64]。 對於未帶正負號的彩色輸入,範圍為 [3, 63],對於帶正負號的彩色輸入,範圍則為 [6, 63]。

Parameters

Constant
Type 靜態參數
Default 0
Range 輸入連結 I 的範圍

此參數用以定義位於影像邊界之外之像素的預設值。

該值始終為無符號數值。 若要將參數設定為有符號數值,則需將該值重新詮釋為無符號數值。 對於色彩格式而言,該值是所有色成分的綜合值。

Examples of Use

以下範例展示了運算子 LineNeighboursNx1 的用法: