merge_cont_line_scan_xldmerge_cont_line_scan_xldMergeContLineScanXldMergeContLineScanXld (Operator)

Name

merge_cont_line_scan_xldmerge_cont_line_scan_xldMergeContLineScanXldMergeContLineScanXld — Merge XLD contours from successive line scan images.

Signature

Description

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

With the help of the parameter MergeBorderMergeBorderMergeBorderMergeBordermergeBorder two cases can be distinguished: If the top (first) line of the current image touches the bottom (last) line of the previous image, MergeBorderMergeBorderMergeBorderMergeBordermergeBorder must be set to 'top'"top""top""top""top", otherwise set MergeBorderMergeBorderMergeBorderMergeBordermergeBorder to 'bottom'"bottom""bottom""bottom""bottom". MergeBorderMergeBorderMergeBorderMergeBordermergeBorder 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_xldmerge_cont_line_scan_xldMergeContLineScanXldMergeContLineScanXldMergeContLineScanXld is used recursively, the parameter MaxImagesContMaxImagesContMaxImagesContMaxImagesContmaxImagesCont 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_xldmerge_cont_line_scan_xldMergeContLineScanXldMergeContLineScanXldMergeContLineScanXld returns two contour arrays. PrevMergedContsPrevMergedContsPrevMergedContsPrevMergedContsprevMergedConts contains all those contours from the previous input contours PrevContsPrevContsPrevContsPrevContsprevConts, which could not be merged with a current contour. CurrMergedContsCurrMergedContsCurrMergedContsCurrMergedContscurrMergedConts 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 (MergeBorderMergeBorderMergeBorderMergeBordermergeBorder='top'"top""top""top""top") or downward (MergeBorderMergeBorderMergeBorderMergeBordermergeBorder='bottom'"bottom""bottom""bottom""bottom") according to the image height.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

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

Module

Foundation