convexity_xldconvexity_xldConvexityXldConvexityXld (Operator)

Name

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

Signatur

convexity_xld(XLD : : : Convexity)

Beschreibung

convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXld 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_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXld ü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 ConvexityConvexityConvexityConvexityconvexity definiert als:

Der Formfaktor ConvexityConvexityConvexityConvexityconvexity ist gleich 1, wenn die Kontur bzw. das Polygon konvex ist (z.B. Rechteck, Kreis etc.). Sind Einbuchtungen vorhanden, dann ist ConvexityConvexityConvexityConvexityconvexity 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 XLDXLDXLDXLDXLD abgespeichert.

Ausführungsinformationen

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

Parameter

XLDXLDXLDXLDXLD (input_object) xld(-array) → object

Zu untersuchende Konturen oder Polygone.

ConvexityConvexityConvexityConvexityconvexity (output_control) real(-array) → (real)

Konvexität der Eingabekonturen bzw. -polygone.

Zusicherung: Convexity <= 1

Ergebnis

convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXld 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>)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_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXld, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPix, gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXld, test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXld

Siehe auch

area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld, select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXld, shape_trans_xldshape_trans_xldShapeTransXldShapeTransXldShapeTransXld

Modul

Foundation