ClassesClassesClassesClasses | | | | Operators

gen_region_contour_xldgen_region_contour_xldGenRegionContourXldgen_region_contour_xldGenRegionContourXldGenRegionContourXld (Operator)

Name

gen_region_contour_xldgen_region_contour_xldGenRegionContourXldgen_region_contour_xldGenRegionContourXldGenRegionContourXld — Create a region from an XLD contour.

Signature

gen_region_contour_xld(Contour : Region : Mode : )

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)

Herror gen_region_contour_xld(Hobject Contour, Hobject* Region, const HTuple& Mode)

HRegion HXLDCont::GenRegionContourXld(const HTuple& Mode) const

HRegionArray HXLDContArray::GenRegionContourXld(const HTuple& Mode) const

void GenRegionContourXld(const HObject& Contour, HObject* Region, const HTuple& Mode)

HRegion HXLDCont::GenRegionContourXld(const HString& Mode) const

HRegion HXLDCont::GenRegionContourXld(const char* Mode) const

void HOperatorSetX.GenRegionContourXld(
[in] IHUntypedObjectX* Contour, [out] IHUntypedObjectX*Region, [in] VARIANT Mode)

IHRegionX* HXLDContX.GenRegionContourXld([in] BSTR Mode)

static void HOperatorSet.GenRegionContourXld(HObject contour, out HObject region, HTuple mode)

HRegion HXLDCont.GenRegionContourXld(string mode)

Description

gen_region_contour_xldgen_region_contour_xldGenRegionContourXldgen_region_contour_xldGenRegionContourXldGenRegionContourXld creates a region RegionRegionRegionRegionRegionregion from a subpixel XLD contour ContourContourContourContourContourcontour. The contour is sampled according to the Bresenham algorithm and influenced by the parameter 'neighborhood'"neighborhood""neighborhood""neighborhood""neighborhood""neighborhood" of the operator set_systemset_systemSetSystemset_systemSetSystemSetSystem. Open contours are closed before converting them to regions. Finally, the parameter ModeModeModeModeModemode defines whether the region is filled up ('filled'"filled""filled""filled""filled""filled") or returned by its contour ('margin'"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_xldGenContourRegionXldgen_contour_region_xldGenContourRegionXldGenContourRegionXld to gen_region_contour_xldgen_region_contour_xldGenRegionContourXldgen_region_contour_xldGenRegionContourXldGenRegionContourXld: When setting ModeModeModeModeModemode of gen_contour_region_xldgen_contour_region_xldGenContourRegionXldgen_contour_region_xldGenContourRegionXldGenContourRegionXld to 'border'"border""border""border""border""border", the input region of gen_contour_region_xldgen_contour_region_xldGenContourRegionXldgen_contour_region_xldGenContourRegionXldGenContourRegionXld and the output region of gen_region_contour_xldgen_region_contour_xldGenRegionContourXldgen_region_contour_xldGenRegionContourXldGenRegionContourXld differ. For example, let us assume that the input region of gen_contour_region_xldgen_contour_region_xldGenContourRegionXldgen_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_xldGenContourRegionXldgen_contour_region_xldGenContourRegionXldGenContourRegionXld with ModeModeModeModeModemode set to 'border'"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_xldGenRegionContourXldgen_region_contour_xldGenRegionContourXldGenRegionContourXld, the resulting region consists of the points (1,1), (1,2), (2,2), and (2,1).

Parallelization

Parameters

ContourContourContourContourContourcontour (input_object)  xld_cont(-array) objectHXLDContHXLDContHXLDContHXLDContXHobject

Input contour(s).

RegionRegionRegionRegionRegionregion (output_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject *

Created region(s).

ModeModeModeModeModemode (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Fill mode of the region(s).

Default value: 'filled' "filled" "filled" "filled" "filled" "filled"

Suggested values: 'filled'"filled""filled""filled""filled""filled", 'margin'"margin""margin""margin""margin""margin"

Possible Predecessors

gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXld, gen_contour_polygon_rounded_xldgen_contour_polygon_rounded_xldGenContourPolygonRoundedXldgen_contour_polygon_rounded_xldGenContourPolygonRoundedXldGenContourPolygonRoundedXld

Alternatives

gen_region_polygongen_region_polygonGenRegionPolygongen_region_polygonGenRegionPolygonGenRegionPolygon, gen_region_polygon_xldgen_region_polygon_xldGenRegionPolygonXldgen_region_polygon_xldGenRegionPolygonXldGenRegionPolygonXld

See also

set_systemset_systemSetSystemset_systemSetSystemSetSystem

Module

Foundation


ClassesClassesClassesClasses | | | | Operators