length_xldlength_xldLengthXldLengthXld (Operator)
Name
length_xldlength_xldLengthXldLengthXld
— Länge von Konturen oder Polygonen.
Signatur
Herror length_xld(const Hobject XLD, double* Length)
Herror T_length_xld(const Hobject XLD, Htuple* Length)
Beschreibung
length_xldlength_xldLengthXldLengthXldLengthXld
berechnet die Gesamtlänge der Konturen oder
der Polygone, die in XLDXLDXLDXLDXLD
übergeben werden. Die Länge
ergibt sich als Summe der Euklidschen Abstände der einzelnen
Kurvenpunkte. Wird mehr als eine Kontur oder ein Polygon übergeben,
dann werden die Ergebnisse in Tupeln in der Reihenfolge ihrer
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) →
objectHXLDHXLDHobject
Zu untersuchende Konturen bzw. Polygone.
LengthLengthLengthLengthlength
(output_control) real(-array) →
HTupleHTupleHtuple (real) (double) (double) (double)
Länge der Kontur bzw. des Polygons.
Zusicherung: Length >= 0
Komplexität
Sei n die Anzahl der Punkte in der Kontur bzw. dem
Polygon. Dann ist die Laufzeit O(n).
Ergebnis
length_xldlength_xldLengthXldLengthXldLengthXld
liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe
nicht leer ist. Das Verhalten bei leerer Eingabe 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
,
smooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXldSmoothContoursXld
,
gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldGenPolygonsXld
Siehe auch
area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld
,
moments_any_xldmoments_any_xldMomentsAnyXldMomentsAnyXldMomentsAnyXld
,
moments_xldmoments_xldMomentsXldMomentsXldMomentsXld
,
contlengthcontlengthContlengthContlengthContlength
Modul
Foundation