merge_regions_line_scan — Merge regions from line scan images.
merge_regions_line_scan connects adjacent
regions, which were segmentated from adjacent images with the height
ImageHeight. This operator was especially designed to
process regions that were extracted from images grabbed by a
line scan camera.
CurrRegions contains the regions from the
current image and
PrevRegions the regions from the previous
With the help of the parameter
MergeBorder two cases can be
distinguished: If the top (first) line of the current image touches
the bottom (last) line of the previous image,
must be set to 'top', otherwise set
If the operator
merge_regions_line_scan is used
recursivly, the parameter
MaxImagesRegion determines the
maximum number of images which are covered by a merged region. All
older region parts are removed.
merge_regions_line_scan returns two region
PrevMergedRegions contains all those regions from
the previous input regions
PrevRegions, which could not be
merged with a current region.
all current regions together with the merged parts from the previous
images. Merged regions will exceed the original image, because the
previous regions are moved upward
MergeBorder='top') or downward
MergeBorder='bottom') according to the image
height. For this the system parameter 'clip_region' (see
set_system) will internaly be set to 'false'.
Current input regions.
Merged regions from the previous iteration.
Current regions, merged with old ones where applicable.
Regions from the previous iteration which could not be merged with the current ones.
Height of the line scan images.
Default value: 512
Suggested values: 240, 480, 512, 1024
Image line of the current image, which touches the previous image.
Default value: 'top'
List of values: 'bottom', 'top'
Maximum number of images for a single region.
Default value: 3
Suggested values: 1, 2, 3, 4, 5
merge_regions_line_scan returns the value 2 (H_MSG_TRUE)
if the given parameters are correct.
Otherwise, an exception will be raised.