Operator PixelNeighbours1xM

Operator Library: Filter

The operator PixelNeighbours1xM creates kernel window of 1 row and M columns. The M pixel are located on the left of each input image pixel.

The operator is comparable to FIRkernelNxM but comprises other functionality. The key feature of this operator is that it is of O-type what strongly simplifies synchronizations in the design process. However, the price to pay for the O-type functionality are some restrictions.

The first difference to FIRkernelNxM is that the operator does not center the current pixel in the kernel. Suppose a kernel of size 1x3 is defined. At kernel index 0 of the output image O(x, y), the current pixel at position I(x, y) is provided. At kernel index 1 of the output image, the pixel of the input image at input position I(x-1, y) is provided. Thus, at kernel column index m the output image is

In other words, the operator cannot output 'future' pixel, i.e., pixels which have not been processed yet. That's the reason why the operator is of O-type and will not cause line or pixel delays.

Because the operator does not provide information prior to the current pixel, there is no mirrored edge handling like in FIRkernelNxM. Instead all pixels in the output link which origin is outside image borders are set to the value of parameter Constant.

To generate a two dimensional kernel, use this operator together with an antecedent module of operator LineNeighborsNxM in the image processing pipeline.

Operator PixelNeighbours1xM supports variable line lengths.

I/O Properties

Property Value
Operator Type O
Input Link I, data input
Output Link O, kernel output

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

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].

Parameters

Constant
Type static parameter
Default 0
Range range of input link I

This parameter defines the default value for pixel outside the image borders.

The value is always unsigned. If you want to set the parameter to a signed value you need to reinterpret the value as unsigned. For color formats, the value is a combined value for all components.

Examples of Use

The use of operator PixelNeighbours1xM is shown in the following examples: