gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld (Operator)
Name
gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld — Approximate XLD contours by polygons.
Signature
def gen_polygons_xld(contours: HObject, type: str, alpha: Union[float, int]) -> HObject
Description
gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldGenPolygonsXldgen_polygons_xld approximates XLD contours
(ContoursContoursContoursContourscontourscontours) by polygons. The type of the approximation
can be set by TypeTypeTypeTypetypetype. The threshold for the approximation
is set via AlphaAlphaAlphaAlphaalphaalpha. The procedure is able to process open
as well as closed contours. The resulting approximating XLD
polygons are returned in PolygonsPolygonsPolygonsPolygonspolygonspolygons.
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 AlphaAlphaAlphaAlphaalphaalpha 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
ContoursContoursContoursContourscontourscontours (input_object) xld_cont-array → objectHXLDContHObjectHXLDContHobject
Contours to be approximated.
PolygonsPolygonsPolygonsPolygonspolygonspolygons (output_object) xld_poly-array → objectHXLDPolyHObjectHXLDPolyHobject *
Approximating polygons.
TypeTypeTypeTypetypetype (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Type of approximation.
Default:
'ramer'
"ramer"
"ramer"
"ramer"
"ramer"
"ramer"
List of values:
'ramer'"ramer""ramer""ramer""ramer""ramer"
AlphaAlphaAlphaAlphaalphaalpha (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_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld,
lines_gausslines_gaussLinesGaussLinesGaussLinesGausslines_gauss,
lines_facetlines_facetLinesFacetLinesFacetLinesFacetlines_facet,
edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPixedges_sub_pix
Possible Successors
gen_parallels_xldgen_parallels_xldGenParallelsXldGenParallelsXldGenParallelsXldgen_parallels_xld,
split_contours_xldsplit_contours_xldSplitContoursXldSplitContoursXldSplitContoursXldsplit_contours_xld
See also
get_region_polygonget_region_polygonGetRegionPolygonGetRegionPolygonGetRegionPolygonget_region_polygon
Module
Foundation