Operator SplitLine

Operator Library: Synchronization

This operator splits the input lines into a number of shorter lines. The output line width is specified by parameter LineLength. For example, setting LineLength to 512 with an input line length of 1024 pixels, will result in two new shorter lines per 1 input line with the length of 512.

If the length of the input line is not divisible by the LineLength parameter value, the input line will be split into lines of the specified length as far as possible. The remaining pixel result in a shorter line width. For example, an input line of 1024 pixels is split into sub lines of length 400, the operator will output 2 lines of the length 400 and the last 3rd line of the length 224.

Note that the operator might generate output images with multiple line lengths. Not all VisualApplets operators can process images using varying line lengths.

The SplitLine operator can also be used to perform a 0D to 1D conversion. Connect a link using the image protocol VALT_PIXEL0D to perform the conversion.

If the value of LineLength is changed dynamically during image acquisition, the operator will keep the old LineLength value internally until the currently being processed line is provided at the output link O. After the line is completed, the next split operation will use the new LineLength value.

I/O Properties

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

Supported Link Format

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

1

The range of the input bit width is [1, 64] for unsigned inputs. 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].

2

The output image protocol is the same as the input image protocol if VALT_IMAGE2D or VALT_LINE1D is used. If VALT_PIXEL0D image protocol is used at the input, the operator performs a conversion to the VALT_LINE1D image protocol.

3

The output maximum image width has to be less or equal than the input maximum image width and greater or equal than parameter LineLength.

4

The output maximum image height has to be grater or equal than the input image height.

Parameters

LineLength
Type dynamic read/write parameter
Default 1
Range [Input Parallelism, Maximum Output Image Width], step size = Input Parallelism

Maximum line length of the split output lines.

Examples of Use

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