gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXld (Operator)
Name
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXld — Create a region from an XLD contour.
Signature
Herror gen_region_contour_xld(const Hobject Contour, Hobject* Region, const char* Mode)
Herror T_gen_region_contour_xld(const Hobject Contour, Hobject* Region, const Htuple Mode)
Description
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXld 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_systemSetSystemSetSystemSetSystem. 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_xldGenContourRegionXldGenContourRegionXldGenContourRegionXld to
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXld: When setting ModeModeModeModemode of
gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXld to 'border'"border""border""border""border", the input region
of gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXld and the output region of
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXld differ. For example, let us assume
that the input region of gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXld consists of
the single pixel (1,1). Then, the resulting contour that is
obtained when calling gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXld 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_xldGenRegionContourXldGenRegionContourXldGenRegionContourXld, the resulting region consists of the
points (1,1), (1,2), (2,2), and (2,1).
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
ContourContourContourContourcontour (input_object) xld_cont(-array) → objectHXLDContHXLDContHobject
Input contour(s).
RegionRegionRegionRegionregion (output_object) region(-array) → objectHRegionHRegionHobject *
Created region(s).
ModeModeModeModemode (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Fill mode of the region(s).
Default value:
'filled'
"filled"
"filled"
"filled"
"filled"
Suggested values: 'filled'"filled""filled""filled""filled", 'margin'"margin""margin""margin""margin"
Possible Predecessors
gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXld,
gen_contour_polygon_rounded_xldgen_contour_polygon_rounded_xldGenContourPolygonRoundedXldGenContourPolygonRoundedXldGenContourPolygonRoundedXld
Alternatives
gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygon,
gen_region_polygon_xldgen_region_polygon_xldGenRegionPolygonXldGenRegionPolygonXldGenRegionPolygonXld
See also
set_systemset_systemSetSystemSetSystemSetSystem
Module
Foundation