Operator Reference

HALCON Operator Reference / XLD / Transformations

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXldclip_end_points_contours_xld (Operator)

clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXldclip_end_points_contours_xld — Clip the end points of an XLD contour.

Signature

clip_end_points_contours_xld(Contours : ClippedContours : Mode, Length : )

Herror clip_end_points_contours_xld(const Hobject Contours, Hobject* ClippedContours, const char* Mode, double Length)

Herror T_clip_end_points_contours_xld(const Hobject Contours, Hobject* ClippedContours, const Htuple Mode, const Htuple Length)

void ClipEndPointsContoursXld(const HObject& Contours, HObject* ClippedContours, const HTuple& Mode, const HTuple& Length)

HXLDCont HXLDCont::ClipEndPointsContoursXld(const HString& Mode, const HTuple& Length) const

HXLDCont HXLDCont::ClipEndPointsContoursXld(const HString& Mode, double Length) const

HXLDCont HXLDCont::ClipEndPointsContoursXld(const char* Mode, double Length) const

HXLDCont HXLDCont::ClipEndPointsContoursXld(const wchar_t* Mode, double Length) const   ( Windows only)

static void HOperatorSet.ClipEndPointsContoursXld(HObject contours, out HObject clippedContours, HTuple mode, HTuple length)

HXLDCont HXLDCont.ClipEndPointsContoursXld(string mode, HTuple length)

HXLDCont HXLDCont.ClipEndPointsContoursXld(string mode, double length)

def clip_end_points_contours_xld(contours: HObject, mode: str, length: Union[int, float]) -> HObject

Description

The operator clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXldclip_end_points_contours_xld clips the end points of an XLD contour. The parameter ModeModeModemodemode determines the measure used to determine which part of the contour is clipped.

If ModeModeModemodemode = 'length'"length""length""length""length", the Euclidean length of the part to be clipped is passed in LengthLengthLengthlengthlength. If ModeModeModemodemode = 'num_points'"num_points""num_points""num_points""num_points", the number of points to be clipped is passed in LengthLengthLengthlengthlength.

The clipped contour is returned in ClippedContoursClippedContoursClippedContoursclippedContoursclipped_contours. If all points of the input contour are clipped, no contour is returned. Therefore, the number of returned contours is less or equal to the number of input contours.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.

Parameters

ContoursContoursContourscontourscontours (input_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject

Input contour

ClippedContoursClippedContoursClippedContoursclippedContoursclipped_contours (output_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject *

Clipped contour

ModeModeModemodemode (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Clipping mode.

Default: 'num_points' "num_points" "num_points" "num_points" "num_points"

List of values: '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 length in unit pixels (ModeModeModemodemode = 'length'"length""length""length""length") or number (ModeModeModemodemode = 'num_points'"num_points""num_points""num_points""num_points")

Default: 3

Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

Result

clip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXldclip_end_points_contours_xld returns 2 ( H_MSG_TRUE) if the input is not empty. The behavior in case of empty input (no input contour available) is set via the operator 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>). If necessary an exception is raised.

Possible Predecessors

segment_contours_xldsegment_contours_xldSegmentContoursXldSegmentContoursXldsegment_contours_xld

See also

clip_contours_xldclip_contours_xldClipContoursXldClipContoursXldclip_contours_xld, crop_contours_xldcrop_contours_xldCropContoursXldCropContoursXldcrop_contours_xld

Module

Foundation

---

ClassesClasses | | Operators