Operator Reference

HALCON Operator Reference / XLD / Creation

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld (Operator)

gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld — Approximate XLD contours by polygons.

Signature

gen_polygons_xld(Contours : Polygons : Type, Alpha : )

Herror gen_polygons_xld(const Hobject Contours, Hobject* Polygons, const char* Type, double Alpha)

Herror T_gen_polygons_xld(const Hobject Contours, Hobject* Polygons, const Htuple Type, const Htuple Alpha)

void GenPolygonsXld(const HObject& Contours, HObject* Polygons, const HTuple& Type, const HTuple& Alpha)

HXLDPoly HXLDCont::GenPolygonsXld(const HString& Type, const HTuple& Alpha) const

HXLDPoly HXLDCont::GenPolygonsXld(const HString& Type, double Alpha) const

HXLDPoly HXLDCont::GenPolygonsXld(const char* Type, double Alpha) const

HXLDPoly HXLDCont::GenPolygonsXld(const wchar_t* Type, double Alpha) const   ( Windows only)

static void HOperatorSet.GenPolygonsXld(HObject contours, out HObject polygons, HTuple type, HTuple alpha)

HXLDPoly HXLDCont.GenPolygonsXld(string type, HTuple alpha)

HXLDPoly HXLDCont.GenPolygonsXld(string type, double alpha)

def gen_polygons_xld(contours: HObject, type: str, alpha: Union[float, int]) -> HObject

Description

gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld approximates XLD contours (ContoursContoursContourscontourscontours) by polygons. The type of the approximation can be set by TypeTypeTypetypetype. The threshold for the approximation is set via AlphaAlphaAlphaalphaalpha. The procedure is able to process open as well as closed contours. The resulting approximating XLD polygons are returned in PolygonsPolygonsPolygonspolygonspolygons.

Contours can be approximated by the algorithm of Ramer, which approximates contours such that the Euclidean distance of the approximating polygon to the contour is at most AlphaAlphaAlphaalphaalpha pixel units.

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

ContoursContoursContourscontourscontours (input_object)  xld_cont-array → objectHXLDContHObjectHObjectHobject

Contours to be approximated.

PolygonsPolygonsPolygonspolygonspolygons (output_object)  xld_poly-array → objectHXLDPolyHObjectHObjectHobject *

Approximating polygons.

TypeTypeTypetypetype (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Type of approximation.

Default: 'ramer' "ramer" "ramer" "ramer" "ramer"

List of values: 'ramer'"ramer""ramer""ramer""ramer"

AlphaAlphaAlphaalphaalpha (input_control)  number → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Threshold for the approximation.

Default: 2.0

Suggested values: 1.0, 1.5, 2.0, 3.0, 4.0

Restriction: Alpha > 0.0

Possible Predecessors

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld, lines_gausslines_gaussLinesGaussLinesGausslines_gauss, lines_facetlines_facetLinesFacetLinesFacetlines_facet, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixedges_sub_pix

Possible Successors

gen_parallels_xldgen_parallels_xldGenParallelsXldGenParallelsXldgen_parallels_xld, split_contours_xldsplit_contours_xldSplitContoursXldSplitContoursXldsplit_contours_xld

See also

get_region_polygonget_region_polygonGetRegionPolygonGetRegionPolygonget_region_polygon

Module

Foundation

---

ClassesClasses | | Operators