ClassesClassesClassesClasses | | | | Operators

get_region_polygonT_get_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon (Operator)

Name

get_region_polygonT_get_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon — Polygon approximation of a region.

Signature

get_region_polygon(Region : : Tolerance : Rows, Columns)

Herror T_get_region_polygon(const Hobject Region, const Htuple Tolerance, Htuple* Rows, Htuple* Columns)

Herror get_region_polygon(Hobject Region, const HTuple& Tolerance, HTuple* Rows, HTuple* Columns)

HTuple HRegion::GetRegionPolygon(const HTuple& Tolerance, HTuple* Columns) const

void GetRegionPolygon(const HObject& Region, const HTuple& Tolerance, HTuple* Rows, HTuple* Columns)

void HRegion::GetRegionPolygon(const HTuple& Tolerance, HTuple* Rows, HTuple* Columns) const

void HRegion::GetRegionPolygon(double Tolerance, HTuple* Rows, HTuple* Columns) const

void HOperatorSetX.GetRegionPolygon(
[in] IHUntypedObjectX* Region, [in] VARIANT Tolerance, [out] VARIANT* Rows, [out] VARIANT* Columns)

VARIANT HRegionX.GetRegionPolygon(
[in] VARIANT Tolerance, [out] VARIANT* Columns)

static void HOperatorSet.GetRegionPolygon(HObject region, HTuple tolerance, out HTuple rows, out HTuple columns)

void HRegion.GetRegionPolygon(HTuple tolerance, out HTuple rows, out HTuple columns)

void HRegion.GetRegionPolygon(double tolerance, out HTuple rows, out HTuple columns)

Description

The operator get_region_polygonget_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon calculates a polygon to approximate the edge of a region. A polygon is a sequence of line (RowsRowsRowsRowsRowsrows) and column coordinates (ColumnsColumnsColumnsColumnsColumnscolumns). It describes the contour of the region. Only the base points of the polygon are returned. The parameter ToleranceToleranceToleranceToleranceTolerancetolerance indicates how large the maximum distance between the polygon and the edge of the region may be. Holes of the region are ignored. The operator get_region_polygonget_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon returns the coordinates in the form of tuples.

Attention

Holes of the region are ignored. Only one region may be passed, and this region must have exactly one connection component.

Parallelization

Parameters

RegionRegionRegionRegionRegionregion (input_object)  region objectHRegionHRegionHRegionHRegionXHobject

Region to be approximated.

ToleranceToleranceToleranceToleranceTolerancetolerance (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Maximum distance between the polygon and the edge of the region.

Default value: 5.0

Suggested values: 0.0, 2.0, 5.0, 10.0

Typical range of values: 0.0 ≤ Tolerance Tolerance Tolerance Tolerance Tolerance tolerance (lin)

Minimum increment: 0.01

Recommended increment: 1.0

RowsRowsRowsRowsRowsrows (output_control)  polygon.y-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Line numbers of the base points of the contour.

ColumnsColumnsColumnsColumnsColumnscolumns (output_control)  polygon.x-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column numbers of the base points of the contour.

Number of elements: Columns == Rows

Result

The operator get_region_polygonget_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon normally returns the value 2 (H_MSG_TRUE). If more than one connection component is passed an exception is raised. The behavior in case of empty input (no input regions available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>).

Possible Predecessors

sobel_ampsobel_ampSobelAmpsobel_ampSobelAmpSobelAmp, thresholdthresholdThresholdthresholdThresholdThreshold, skeletonskeletonSkeletonskeletonSkeletonSkeleton, edges_imageedges_imageEdgesImageedges_imageEdgesImageEdgesImage

See also

copy_objcopy_objCopyObjcopy_objCopyObjCopyObj, gen_region_polygongen_region_polygonGenRegionPolygongen_region_polygonGenRegionPolygonGenRegionPolygon, disp_polygondisp_polygonDispPolygondisp_polygonDispPolygonDispPolygon, get_region_chainget_region_chainGetRegionChainget_region_chainGetRegionChainGetRegionChain, get_region_contourget_region_contourGetRegionContourget_region_contourGetRegionContourGetRegionContour, set_line_approxset_line_approxSetLineApproxset_line_approxSetLineApproxSetLineApprox

Module

Foundation


ClassesClassesClassesClasses | | | | Operators