PixelNeighbours1xM 運算子

Operator Library: Filter

運算子 PixelNeighbours1xM 會建立一個由 1 行和 M 列組成的核窗。 這 M 個像素位於每個輸入影像像素的左側。

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

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

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

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

若要產生二維核,請將此運算子與 運算子 LineNeighborsNxM 的先決模組配合使用。

運算子 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 1 any
Kernel Rows any as I
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

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