orientation_xld
— Orientierung von Konturen oder Polygonen.
orientation_xld
berechnet die Orientierung (Phi
)
für jede Eingabekontur bzw. jedes Eingabepolygon. Das Verfahren basiert auf
dem Winkel, der mit
elliptic_axis_xld
bestimmt wird. Es wird jedoch zusätzlich
der Punkt auf der Kontur bzw. dem Polygon mit maximalem Abstand bestimmt.
Ist dessen Spaltenkoordinate kleiner als die Spaltenkoordinate des
Schwerpunkts, so wird zu dem Winkel hinzugezählt. Es
wird vorausgesetzt, dass die Kontur geschlossen ist. Ist das nicht
der Fall, wird sie künstlich geschlossen.
Es ist zu beachten, dass orientation_xld
nur dann sinnvolle
Ergebnisse liefert, falls die Kontur oder das Polygon eine Fläche in
der Ebene einschließt. Insbesondere darf sich die Kontur oder das
Polygon nicht selbst schneiden. Dies ist insbesondere dann zu
beachten, wenn offene Konturen und Polygone übergeben werden, da
diese automatisch geschlossen werden, was dazu führen kann, dass sich
die Kontur oder das Polygon selbst schneidet. Ob sich die Konturen
oder Polygone selbst schneiden, kann leicht mit
test_self_intersection_xld
überprüft werden. Falls sich die
Kontur oder das Polygon selbst schneidet, kann ein sinnvoller Wert
für die Orientierung mit orientation_points_xld
berechnet
werden.
Wird mehr als eine Kontur oder ein Polygon übergeben, dann werden
die Ergebnisse für die Orientierungen in einem Tupel in der Reihenfolge
ihrer entsprechenden Konturen bzw. Polygone in XLD
abgespeichert.
XLD
(input_object) xld(-array) →
object
Zu untersuchende Konturen bzw. Polygone.
Phi
(output_control) angle.rad(-array) →
(real)
Orientierung der Konturen bzw. Polygone (Bogenmaß).
Zusicherung: - pi < Phi && Phi <= pi
orientation_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>)
festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
gen_contours_skeleton_xld
,
edges_sub_pix
,
threshold_sub_pix
,
gen_contour_polygon_xld
,
test_self_intersection_xld
elliptic_axis_xld
,
smallest_rectangle2_xld
Foundation