clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXldclip_end_points_contours_xld (Operator)
Name
clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXldclip_end_points_contours_xld — Abschneiden der Endpunkte einer XLD-Kontur.
Signatur
def clip_end_points_contours_xld(contours: HObject, mode: str, length: Union[int, float]) -> HObject
Beschreibung
clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXldclip_end_points_contours_xld schneidet von einer XLD-Kontur
die Endpunkte ab. Dabei kann über den Parameter ModeModeModemodemode
festgelegt werden, mit welchem Maß abgeschnitten wird.
Falls ModeModeModemodemode = 'length'"length""length""length""length", wird in LengthLengthLengthlengthlength
die euklidische Länge des abzuschneidenden Konturstückes angegeben.
Falls ModeModeModemodemode = 'num_points'"num_points""num_points""num_points""num_points", wird in
LengthLengthLengthlengthlength die Anzahl an abzuschneidenden Punkte übergeben.
Die beschnittene Kontur wird in ClippedContoursClippedContoursClippedContoursclippedContoursclipped_contours
zurückgegeben. Für den Fall, dass alle Punkte einer Kontur entfernt
würden, wird keine Kontur zurückgegeben. Deshalb ist die Anzahl an
Ausgabekonturen kleiner oder gleich der Anzahl an Eingabekonturen.
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
ContoursContoursContourscontourscontours (input_object) xld_cont(-array) → objectHXLDContHObjectHObjectHobject
Eingabekontur.
ClippedContoursClippedContoursClippedContoursclippedContoursclipped_contours (output_object) xld_cont(-array) → objectHXLDContHObjectHObjectHobject *
Verkürzte Kontur
ModeModeModemodemode (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Clipping-Modus.
Default:
'num_points'
"num_points"
"num_points"
"num_points"
"num_points"
Werteliste:
'length'"length""length""length""length", 'num_points'"num_points""num_points""num_points""num_points"
LengthLengthLengthlengthlength (input_control) number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Clipping-Länge in der Einheit
Pixel (ModeModeModemodemode = 'length'"length""length""length""length") oder
Zahl (ModeModeModemodemode = 'num_points'"num_points""num_points""num_points""num_points")
Default:
3
Wertevorschläge:
1, 2, 3, 4, 5, 6, 7, 8, 9, 10
Ergebnis
Sind die Parameterwerte korrekt, liefert
clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXldclip_end_points_contours_xld den Wert 2 (
H_MSG_TRUE)
. 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>)set_system("no_object_result",<Result>) festlegen.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
segment_contours_xldsegment_contours_xldSegmentContoursXldSegmentContoursXldsegment_contours_xld
Siehe auch
clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldclip_contours_xld,
crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldcrop_contours_xld
Modul
Foundation