SE_shape_find_along

Returns the points or lines along a shape as defined by the shape’s measures and the supplied measure value

Usage syntax

LONG SE_shape_find_along (SE_SHAPE shape, LFLOAT measure, LONG *num_shapes, SE_SHAPE **new_shapes);

Parameters
shape A handle to an active shape object
measure The 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 along a shape as defined by the shape’s measures and the supplied distance value. The resulting point or line shapes are returned as shapes in the array new_shapes. If the shape is a point or multipoint type, the point or points with an exact matching measure are returned. For other shape types, the measure value is interpolated before the results are returned.

This function allocates memory for the array of shape objects and should be deallocated with 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