Merge XLD contours from successive line scan images.

The operator merge_cont_line_scan_xld connects adjacent XLD contours, which were extracted from adjacent images with the height ImageHeight. This operator was especially designed to connect contours that were extracted from images grabbed by a line scan camera. CurrConts contains the contours from the current image and PrevConts the contours from the previous one.

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, MergeBorder must be set to 'top', otherwise set MergeBorder to 'bottom'. MergeBorder defines a margin to the border. Only those end points of the contours which are inside this margin are considered for the following merging process.

If the operator merge_cont_line_scan_xld is used recursivly, the parameter MaxImagesCont determines the maximum number of images which are covered by a merged contour. All points of the merged contour from an older image are removed.

The operator merge_cont_line_scan_xld returns two contour arrays. PrevMergedConts contains all those contours from the previous input contours PrevConts, which could not be merged with a current contour. CurrMergedConts collects all current contours together with the merged parts from the previous images. Merged contours will exceed the original image, because the previous contours are moved upward (MergeBorder='top') or downward (MergeBorder='bottom') according to the image height.

The operator merge_cont_line_scan_xld returns the value 2 (H_MSG_TRUE) if the given parameters are correct. Otherwise, an exception will be raised.

merge_cont_line_scan_xld is reentrant and processed without parallelization.

Sub-pixel operators