SE_shape_find_between

Returns the points or lines along a shape as defined by the shape’s measures between the given from- and to-values.

Usage syntax

LONG SE_shape_find_between (SE_SHAPE shape, LFLOAT from_measure, LFLOAT to_measure, LONG *num_shapes, SE_SHAPE **new_shapes);

Parameters
shape A handle to an active shape object
from_measure The from-measure value along the supplied shape to locate
to_measure The to-measure value along the supplied shape to locate
num_shapes The number of shapes returned
new_shapes An address of a pointer to a shape object handle, which is returned as an array of active shape object handles containing the results
Description

Returns the points or lines that have measure values equal to or between two specified measure values. SE_shape_find_between will return a point shape if the source shape is a point type. For other shape types, a multipart line is returned if a path can be interpolated; otherwise a multipoint shape containing the point locations is returned.

An empty point is returned when a path or location can't be interpolated. The resulting point or line shapes are returned as shapes in the array new_shapes. This function allocates memory for the array of shape objects and should be deallocated by using the SE_shape_free_array function.

Returns

SE_SUCCESS
SE_COORD_OUT_OF_BOUNDS

SE_INVALID_POINTER

SE_INVALID_SHAPE

SE_INVALID_SHAPE_OBJECT

SE_OUT_OF_CLMEM

SE_SHAPE_INTEGRITY_ERROR

Notes

∙  Ignores any CAD data