SE_shape_find_between |
Returns the points or lines along a shape as defined by the shapes measures between the given from- and to-values.
LONG SE_shape_find_between (SE_SHAPE shape, LFLOAT from_measure, LFLOAT to_measure, LONG *num_shapes, SE_SHAPE **new_shapes);
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 |
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.
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