clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXld (Operator)
Name
clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXld — Abschneiden der Endpunkte einer XLD-Kontur.
Signatur
Beschreibung
clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXldClipEndPointsContoursXld 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 ClippedContoursClippedContoursClippedContoursClippedContoursclippedContours
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) → objectHXLDContHXLDContHobject
Eingabekontur.
ClippedContoursClippedContoursClippedContoursClippedContoursclippedContours (output_object) xld_cont(-array) → objectHXLDContHXLDContHobject *
Verkürzte Kontur
ModeModeModeModemode (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Clipping-Modus.
Defaultwert:
'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 → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Clipping-Länge in der Einheit Pixel (ModeModeModeModemode
= 'length') oder Zahl (ModeModeModeModemode =
'num_points')
Defaultwert: 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_xldClipEndPointsContoursXldClipEndPointsContoursXldClipEndPointsContoursXld 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>)SetSystem("no_object_result",<Result>) festlegen.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
segment_contours_xldsegment_contours_xldSegmentContoursXldSegmentContoursXldSegmentContoursXld
Siehe auch
clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldClipContoursXld,
crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldCropContoursXld
Modul
Foundation