Operator PixelNeighbours1xM

Operator Library: Filter

運算子 PixelNeighbours1xM 會建立 1 行與 M 列的核心視窗。 這 M 個像素位於每個輸入影像像素的左側。

此 operator 類似於 FIRkernelNxM,但包含其他功能。 此 operator 的主要特點在於它是 O-type,這大幅簡化了設計過程中的同步作業。 然而,享有 O-type 功能所付出的代價是某些限制。

與 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, data input
Output Link O, kernel output

支援的 Link 格式

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

The range of the input Bit Width is [1, 64] for unsigned values. For signed inputs, the range is [2, 64]. For unsigned color inputs, the range is [3, 63] and for signed color, the range is [6, 63].

參數

Constant
Type static parameter
Default 0
Range 輸入 link I 的範圍

此參數定義影像邊界外像素的預設值。

此值一律為無號數。 如果您想將參數設定為有號數,則需要將該值重新解釋為無號數。 對於 Color Format,該值是所有元件的組合值。

使用範例

以下範例顯示了運算子 PixelNeighbours1xM 的使用方式: