length_xldlength_xldLengthXldLengthXld (Operator)

Name

length_xldlength_xldLengthXldLengthXld — Length of contours or polygons.

Signature

length_xld(XLD : : : Length)

Description

length_xldlength_xldLengthXldLengthXldLengthXld 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.

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

XLDXLDXLDXLDXLD (input_object) xld(-array) → object

Contours or polygons to be examined.

LengthLengthLengthLengthlength (output_control) real(-array) → (real)

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_xldLengthXldLengthXldLengthXld 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>)SetSystem("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_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXld, smooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXldSmoothContoursXld, gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldGenPolygonsXld

Module

Foundation

Operators