get_region_polygonT_get_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon (Operator)

Name

get_region_polygonT_get_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon — Polygonapproximation einer Region.

Signatur

get_region_polygon(Region : : Tolerance : Rows, Columns)

get_region_polygonget_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon berechnet ein Polygon, das den Rand einer Region annähern soll. Ein Polygon ist eine Folge von Zeilen- (RowsRowsRowsRowsRowsrows) und Spaltenkoordinaten (ColumnsColumnsColumnsColumnsColumnscolumns), die die Kontur der Region beschreibt. Von dem Polygon werden nur die Stützpunkte ausgegeben. Der Parameter ToleranceToleranceToleranceToleranceTolerancetolerance gibt an, wie groß der maximale Abstand zwischen dem Polygon und dem Regionenrand sein darf. Hohlflächen der Region werden ignoriert. get_region_polygonget_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon liefert die Koordinaten in Form von Tupeln ab.

Achtung

Hohlflächen der Region werden ignoriert. Es darf nur eine Region übergeben werden und die muss genau eine Zusammenhangskomponente haben.

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

RegionRegionRegionRegionRegionregion (input_object) region → object

Zu approximierende Region.

ToleranceToleranceToleranceToleranceTolerancetolerance (input_control) number → (real / integer)

Maximaler Abstand zwischen dem Polygon und dem Regionenrand.

Defaultwert: 5.0

Wertevorschläge: 0.0, 2.0, 5.0, 10.0

Typischer Wertebereich: 0.0 ≤ Tolerance Tolerance Tolerance Tolerance Tolerance tolerance (lin)

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 1.0

RowsRowsRowsRowsRowsrows (output_control) polygon.y-array → (integer)

Zeilennummern der Stützpunkte der Kontur.

ColumnsColumnsColumnsColumnsColumnscolumns (output_control) polygon.x-array → (integer)

Spaltennummern der Stützpunkte der Kontur.

Parameteranzahl: Columns == Rows

Ergebnis

get_region_polygonget_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon liefert normalerweise den Wert 2 (H_MSG_TRUE). Wird mehr als eine Zusammenhangskomponente übergeben, wird eine Fehlerbehandlung ausgelöst. Das Verhalten bei leerer Eingabe (keine Eingaberegionen vorhanden) lässt sich mittels 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>) festlegen.

Vorgänger

sobel_ampsobel_ampSobelAmpsobel_ampSobelAmpSobelAmp, thresholdthresholdThresholdthresholdThresholdThreshold, skeletonskeletonSkeletonskeletonSkeletonSkeleton, edges_imageedges_imageEdgesImageedges_imageEdgesImageEdgesImage

Siehe auch

copy_objcopy_objCopyObjcopy_objCopyObjCopyObj, gen_region_polygongen_region_polygonGenRegionPolygongen_region_polygonGenRegionPolygonGenRegionPolygon, disp_polygondisp_polygonDispPolygondisp_polygonDispPolygonDispPolygon, get_region_contourget_region_contourGetRegionContourget_region_contourGetRegionContourGetRegionContour, set_line_approxset_line_approxSetLineApproxset_line_approxSetLineApproxSetLineApprox

Modul

Foundation

Operatoren