HALCON Reference Manual 10.0.2
Table of Contents / XLD / Transformations ClassesClassesClasses | | | Operators

clip_end_points_contours_xldclip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXld (Operator)

Name

clip_end_points_contours_xldclip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXld — 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)

Herror clip_end_points_contours_xld(Hobject Contours, Hobject* ClippedContours, const HTuple& Mode, const HTuple& Length)

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

HXLDContArray HXLDContArray::ClipEndPointsContoursXld(const HTuple& Mode, const HTuple& Length) const

void HOperatorSetX.ClipEndPointsContoursXld(
[in] IHUntypedObjectX* Contours, [out] IHUntypedObjectX** ClippedContours, [in] VARIANT Mode, [in] VARIANT Length)

IHXLDContX* HXLDContX.ClipEndPointsContoursXld(
[in] BSTR Mode, [in] VARIANT Length)

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)

Description

The operator clip_end_points_contours_xldclip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXld 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 ClippedContoursClippedContoursClippedContoursClippedContoursclippedContours. 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.

Parallelization

Parameters

ContoursContoursContoursContourscontours (input_object)  xld_cont(-array) → objectHXLDContHXLDContHXLDContXHobject

Input contour

ClippedContoursClippedContoursClippedContoursClippedContoursclippedContours (output_object)  xld_cont(-array) → objectHXLDContHXLDContHXLDContXHobject *

Clipped contour

ModeModeModeModemode (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Clipping mode.

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

List of values: 'num_points'"num_points""num_points""num_points""num_points", 'length'"length""length""length""length"

LengthLengthLengthLengthlength (input_control)  number → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Clipping length in unit pixels (ModeModeModeModemode = 'length') or number (ModeModeModeModemode = 'num_points')

Default value: 3

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

Result

clip_end_points_contours_xldclip_end_points_contours_xldclip_end_points_contours_xldClipEndPointsContoursXldClipEndPointsContoursXld 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary an exception is raised.

Possible Predecessors

segment_contours_xldsegment_contours_xldsegment_contours_xldSegmentContoursXldSegmentContoursXld

See also

clip_contours_xldclip_contours_xldclip_contours_xldClipContoursXldClipContoursXld, crop_contours_xldcrop_contours_xldcrop_contours_xldCropContoursXldCropContoursXld

Module

Foundation

Table of Contents / XLD / Transformations ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH