convexity_xldconvexity_xldConvexityXldconvexity_xldConvexityXldConvexityXld (Operator)

Name

convexity_xldconvexity_xldConvexityXldconvexity_xldConvexityXldConvexityXld — Formfaktor für die Konvexität von Konturen oder Polygonen.

Signatur

convexity_xld(XLD : : : Convexity)

Beschreibung

convexity_xldconvexity_xldConvexityXldconvexity_xldConvexityXldConvexityXld berechnet für jede Eingabekontur bzw. jedes Eingabepolygon die Konvexität. Es muss darauf geachtet werden, dass sich die Eingabekonturen bzw. Eingabepolygone nicht selbst schneiden, da ansonsten die Ausgabeparameter keinen aussagekräftigen Wert enthalten (Ob sich die Eingabekonturen bzw. Eingabepolygone selbst schneiden oder nicht, lässt sich mit test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXld überprüfen). Sind die Eingabekonturen bzw. Eingabepolygone nicht geschlossen, so werden sie vor der Berechnung automatisch geschlossen.

Berechnung: Sei die Fläche der konvexen Hülle und die eingeschlossene Originalfläche der Kontur bzw. des Polygons, dann ist der Formfaktor ConvexityConvexityConvexityConvexityConvexityconvexity definiert als:

Der Formfaktor ConvexityConvexityConvexityConvexityConvexityconvexity ist gleich 1, wenn die Kontur bzw. das Polygon konvex ist (z.B. Rechteck, Kreis etc.). Sind Einbuchtungen vorhanden, dann ist ConvexityConvexityConvexityConvexityConvexityconvexity kleiner als 1.

Wird mehr als eine Kontur oder ein Polygon übergeben, dann werden die Zahlenwerte des Formfaktors in einem Tupel in der Reihenfolge der entsprechenden Konturen bzw. Polygone in XLDXLDXLDXLDXLDXLD abgespeichert.

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf Tupelebene.

Parameter

XLDXLDXLDXLDXLDXLD (input_object) xld(-array) → object

Zu untersuchende Konturen oder Polygone.

ConvexityConvexityConvexityConvexityConvexityconvexity (output_control) real(-array) → (real)

Konvexität der Eingabekonturen bzw. -polygone.

Zusicherung: Convexity <= 1

Ergebnis

convexity_xldconvexity_xldConvexityXldconvexity_xldConvexityXldConvexityXld liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe nicht leer ist. Das Verhalten bei leerer Eingabe (keine Eingabekontur 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. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXld, edges_sub_pixedges_sub_pixEdgesSubPixedges_sub_pixEdgesSubPixEdgesSubPix, threshold_sub_pixthreshold_sub_pixThresholdSubPixthreshold_sub_pixThresholdSubPixThresholdSubPix, gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXld, test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXld

Siehe auch

area_center_xldarea_center_xldAreaCenterXldarea_center_xldAreaCenterXldAreaCenterXld, select_shape_xldselect_shape_xldSelectShapeXldselect_shape_xldSelectShapeXldSelectShapeXld, shape_trans_xldshape_trans_xldShapeTransXldshape_trans_xldShapeTransXldShapeTransXld

Modul

Foundation