length_xldlength_xldLengthXldLengthXldlength_xld (Operator)
Name
length_xldlength_xldLengthXldLengthXldlength_xld — Länge von Konturen oder Polygonen.
Signatur
Herror length_xld(const Hobject XLD, double* Length)
Herror T_length_xld(const Hobject XLD, Htuple* Length)
def length_xld(xld: HObject) -> Sequence[float]
def length_xld_s(xld: HObject) -> float
Beschreibung
length_xldlength_xldLengthXldLengthXldlength_xld 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) → objectHXLDHObjectHObjectHobject
Zu untersuchende Konturen bzw. Polygone.
LengthLengthLengthlengthlength (output_control) real(-array) → HTupleSequence[float]HTupleHtuple (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_xldLengthXldLengthXldlength_xld 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>)set_system("no_object_result",<Result>)
festlegen. Gegebenenfalls wird eine Fehlerbehandlung
durchgeführt.
Vorgänger
gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld,
smooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXldsmooth_contours_xld,
gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld
Siehe auch
area_center_xldarea_center_xldAreaCenterXldAreaCenterXldarea_center_xld,
moments_any_xldmoments_any_xldMomentsAnyXldMomentsAnyXldmoments_any_xld,
moments_xldmoments_xldMomentsXldMomentsXldmoments_xld,
contlengthcontlengthContlengthContlengthcontlength
Modul
Foundation