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

length_xldlength_xldlength_xldLengthXldLengthXld (Operator)

Name

length_xldlength_xldlength_xldLengthXldLengthXld — Length of contours or polygons.

Signature

length_xld(XLD : : : Length)

Herror length_xld(const Hobject XLD, double* Length)

Herror T_length_xld(const Hobject XLD, Htuple* Length)

Herror length_xld(Hobject XLD, double* Length)

Herror length_xld(Hobject XLD, HTuple* Length)

double HXLD::LengthXld() const

HTuple HXLDArray::LengthXld() const

void HOperatorSetX.LengthXld(
[in] IHUntypedObjectX* XLD, [out] VARIANT* Length)

VARIANT HXLDX.LengthXld()

VARIANT HXLDContX.LengthXld()

VARIANT HXLDPolyX.LengthXld()

VARIANT HXLDParaX.LengthXld()

VARIANT HXLDModParaX.LengthXld()

VARIANT HXLDExtParaX.LengthXld()

static void HOperatorSet.LengthXld(HObject XLD, out HTuple length)

HTuple HXLD.LengthXld()

Description

length_xldlength_xldlength_xldLengthXldLengthXld calculates the length of the contours or polygons XLDXLDXLDXLDXLD. The length is calculated as the sum of the euclidian distances of successive points on the contour or polygon. If more than one contour or polygon is passed, the results are stored in tuples in the same order as the respective contours or polygons in XLDXLDXLDXLDXLD.

Parallelization

Parameters

XLDXLDXLDXLDXLD (input_object)  xld(-array) objectHXLDHXLDHXLDXHobject

Contours or polygons to be examined.

LengthLengthLengthLengthlength (output_control)  real(-array) HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Length of the contour or polygon.

Assertion: Length >= 0

Complexity

Let n be the number of points of the contour or polygon. Then the run time is O(n).

Result

length_xldlength_xldlength_xldLengthXldLengthXld returns 2 (H_MSG_TRUE) if the input is not empty. If the input is empty the behavior can be set via 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

gen_contours_skeleton_xldgen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXld, smooth_contours_xldsmooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXld, gen_polygons_xldgen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXld

See also

area_center_xldarea_center_xldarea_center_xldAreaCenterXldAreaCenterXld, moments_any_xldmoments_any_xldmoments_any_xldMomentsAnyXldMomentsAnyXld, moments_xldmoments_xldmoments_xldMomentsXldMomentsXld, contlengthcontlengthcontlengthContlengthContlength

Module

Foundation


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