gen_region_contour_xld ( Contour : Region : Mode : )

Create a region from an XLD contour.

gen_region_contour_xld creates a region Region from a subpixel XLD contour Contour. The contour is sampled according to the Bresenham algorithm and influenced by the parameter neighborhood of the operator set_system. Open contours are closed before converting them to regions. Finally, the parameter Mode defines whether the region is filled up (filled) or returned by its contour (margin).

Please note that the coordinates of the contour points are rounded to their nearest integer pixel coordinates during the conversion. This may lead to unexpected results when passing the contour obtained by the operator gen_contour_region_xld to gen_region_contour_xld: When setting Mode of gen_contour_region_xld to border, the input region of gen_contour_region_xld and the output region of gen_region_contour_xld differ. For example, let us assume that the input region of gen_contour_region_xld consists of the single pixel (1,1). Then, the resulting contour that is obtained when calling gen_contour_region_xld with Mode set to border consists of the five points (0.5,0.5), (0.5,1.5), (1.5,1.5), (1.5,0.5), and (0.5,0.5). Consequently, when passing this contour again to gen_region_contour_xld, the resulting region consists of the points (1,1), (1,2), (2,2), and (2,1).


Parameters

Contour (input_object)
xld_cont -> object
Input contour.

Region (output_object)
region -> object
Created region.

Mode (input_control)
string -> string
Fill mode of the region.
Default value: 'filled'
Suggested values: 'filled', 'margin'


Parallelization Information

gen_region_contour_xld is reentrant and processed without parallelization.


Possible Predecessors

gen_contour_polygon_xld, gen_contour_polygon_rounded_xld


Alternatives

gen_region_polygon, gen_region_polygon_xld


See also

set_system


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH