convexity_xldconvexity_xldConvexityXldConvexityXldconvexity_xld (Operator)

Name

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

Signatur

Beschreibung

convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXldconvexity_xld 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_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXldtest_self_intersection_xld ü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.

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

Ergebnis

convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXldconvexity_xld 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>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPixedges_sub_pix, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPixthreshold_sub_pix, gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXldgen_contour_polygon_xld, test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXldtest_self_intersection_xld

Siehe auch

area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXldarea_center_xld, select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXldselect_shape_xld, shape_trans_xldshape_trans_xldShapeTransXldShapeTransXldShapeTransXldshape_trans_xld

Modul

Foundation