Operator Library: Synchronization
The operator AppendLine concatenates image lines from the input image at the link I into a larger line in the output image at the link O. The number of lines merged into a new line is defined by the parameter AppendNumber. For example, when AppendNumber is set to 2, the operator will concatenate 2 successive lines from the input image into a new larger line in the output image. When the input image height is not divisible by the AppendNumber parameter value, the last line in the output image will be shorter and will contain the remaining last lines of the input image concatenated together.
Note that the operator does not change the frame rate nor does it change the bandwidth.
The output link image protocol of the operator can also be set to VALT_PIXEL0D, i.e. the operator appends all incoming lines into a line of unlimited width. Thus, the operator can be used to convert a 2D image stream or 1D line stream into a 0D pixel stream.
By changing the AppendNumber value dynamically while acquisition is running, the operator guarantees line integrity. The operator keeps the old AppendNumber value until the output line is finished. After the completion of the current output line, the operator will start using the new AppendNumber value for further merging.
![[Warning]](../common/images/admon/warning.png) |
Prevent Exceeding the Maximum Image Dimensions |
|---|---|
|
By using this operator, it is possible to exceed the maximum image width and height defined in the output link. Therefore, always ensure that the concatenated input lines do not exceed the parameterized maximum image width of the output link. Also make sure that the parameterized maximum image height of the output link is large enough. Subsequent operators may not work correctly, if the image width or height exceeds the limits specified by the link properties. For example, 3 input lines of width 1024 are concatenated. The output image width will be 3072. This width has to be specified in the output link to ensure a correct functionality of the VisualApplets operators. |
|
|
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]. |
|
|
The maximum image width has to be greater than or equal to parameter AppendNumber times the input image width. |
| AppendNumber | |
|---|---|
| Type | dynamic read/write parameter |
| Default | 1 |
| Range | Input IMAGE2D: [1, Input Maximum Image Height]; Input LINE1D: [1, Output Maximum Image Width / Parallelism] |
|
The number of input lines which are concatenated into a single output line. This parameter can only be changed, if the output link image protocol is not set to VALT_PIXEL0D. |
|
| LinesToSimulate | |
|---|---|
| Type | static read/write parameter |
| Default | 1 |
| Range | [1, 2^32 - 1] |
|
The number of lines in the simulated 1D output stream. This parameter can only be used during simulation, if the input image protocol is set to VALT_IMAGE2D and the output protocol is set to VALT_IMAGE1D. Exactly one output image is generated. Remaining input lines are discarded. |
|
| PixelsToSimulate | |
|---|---|
| Type | static read/write parameter |
| Default | 1 |
| Range | [1, 2^32 - 1] |
|
The number of input pixels in the simulated 0D output stream. This parameter can only be used during simulation, if the input image protocol is set to VALT_IMAGE2D or VALT_IMAGE1D and the output protocol is set to VALT_IMAGE0D. Exactly one output image is generated. Remaining input pixels are discarded. |
|
The use of operator AppendLine is shown in the following examples:
-
Tutorial - Use of the operator for stitching the images of two cameras.
-
Examples - Scaling A Line Scan Image
Prev
