gen_region_contour_xldgen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXld (Operator)

Name

gen_region_contour_xldgen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXld — Create a region from an XLD contour.

Signature

Description

gen_region_contour_xldgen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXld creates a region RegionRegionRegionRegionregion from a subpixel XLD contour ContourContourContourContourcontour. The contour is sampled according to the Bresenham algorithm and influenced by the parameter 'neighborhood'"neighborhood""neighborhood""neighborhood""neighborhood" of the operator set_systemset_systemset_systemSetSystemSetSystem. Open contours are closed before converting them to regions. Finally, the parameter ModeModeModeModemode defines whether the region is filled up ('filled'"filled""filled""filled""filled") or returned by its contour ('margin'"margin""margin""margin""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_xldgen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXld to gen_region_contour_xldgen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXld: When setting ModeModeModeModemode of gen_contour_region_xldgen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXld to 'border'"border""border""border""border", the input region of gen_contour_region_xldgen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXld and the output region of gen_region_contour_xldgen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXld differ. For example, let us assume that the input region of gen_contour_region_xldgen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXld consists of the single pixel (1,1). Then, the resulting contour that is obtained when calling gen_contour_region_xldgen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXld with ModeModeModeModemode set to 'border'"border""border""border""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_xldgen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXld, the resulting region consists of the points (1,1), (1,2), (2,2), and (2,1).

Parallelization

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

Parameters

Possible Predecessors

gen_contour_polygon_xldgen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXld, gen_contour_polygon_rounded_xldgen_contour_polygon_rounded_xldgen_contour_polygon_rounded_xldGenContourPolygonRoundedXldGenContourPolygonRoundedXld

Alternatives

gen_region_polygongen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygon, gen_region_polygon_xldgen_region_polygon_xldgen_region_polygon_xldGenRegionPolygonXldGenRegionPolygonXld

See also

set_systemset_systemset_systemSetSystemSetSystem

Module

Foundation