merge_regions_line_scanmerge_regions_line_scanmerge_regions_line_scanMergeRegionsLineScanMergeRegionsLineScan (Operator)

Name

merge_regions_line_scanmerge_regions_line_scanmerge_regions_line_scanMergeRegionsLineScanMergeRegionsLineScan — Merge regions from line scan images.

Signature

Description

The operator merge_regions_line_scanmerge_regions_line_scanmerge_regions_line_scanMergeRegionsLineScanMergeRegionsLineScan connects adjacent regions, which were segmentated from adjacent images with the height ImageHeightImageHeightImageHeightImageHeightimageHeight. This operator was especially designed to process regions that were extracted from images grabbed by a line scan camera. CurrRegionsCurrRegionsCurrRegionsCurrRegionscurrRegions contains the regions from the current image and PrevRegionsPrevRegionsPrevRegionsPrevRegionsprevRegions the regions 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".

If the operator merge_regions_line_scanmerge_regions_line_scanmerge_regions_line_scanMergeRegionsLineScanMergeRegionsLineScan is used recursivly, the parameter MaxImagesRegionMaxImagesRegionMaxImagesRegionMaxImagesRegionmaxImagesRegion determines the maximum number of images which are covered by a merged region. All older region parts are removed.

The operator merge_regions_line_scanmerge_regions_line_scanmerge_regions_line_scanMergeRegionsLineScanMergeRegionsLineScan returns two region arrays. PrevMergedRegionsPrevMergedRegionsPrevMergedRegionsPrevMergedRegionsprevMergedRegions contains all those regions from the previous input regions PrevRegionsPrevRegionsPrevRegionsPrevRegionsprevRegions, which could not be merged with a current region. CurrMergedRegionsCurrMergedRegionsCurrMergedRegionsCurrMergedRegionscurrMergedRegions collects 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 (MergeBorderMergeBorderMergeBorderMergeBordermergeBorder='top'"top""top""top""top") or downward (MergeBorderMergeBorderMergeBorderMergeBordermergeBorder='bottom'"bottom""bottom""bottom""bottom") according to the image height. For this the system parameter 'clip_region'"clip_region""clip_region""clip_region""clip_region" (see also set_systemset_systemset_systemSetSystemSetSystem) will internaly be set to 'false'"false""false""false""false".

Parallelization

• 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_regions_line_scanmerge_regions_line_scanmerge_regions_line_scanMergeRegionsLineScanMergeRegionsLineScan returns the value 2 (H_MSG_TRUE) if the given parameters are correct. Otherwise, an exception will be raised.

Module

Foundation