SE_shape_as_simple_line

Returns a shape of simple line type, given a shape of any type.

Usage syntax

LONG SE_shape_as_simple_line (const SE_SHAPE src_shape, SE_SHAPE tgt_shape);

Parameters
src_shape A handle to an active shape object to convert to a simple line shape
tgt_shape A handle to an active simple line shape object
Description

Given a shape of any type, returns it as a shape of simple line (linestring) type. If the input shape consists of a single point, this function returns a nil shape. If the resulting shape fails any of the verification rules for requested shape type, an error is returned and the tgt_shape is a nil shape.

Returns

SE_SUCCESS
SE_INVALID_SHAPE

SE_INVALID_SHAPE_OBJECT

SE_OUT_OF_CLMEM

SE_READ_ONLY_SHAPE

Notes

• If you pass a shape returned from SE_stable_search or SE_stable_get_shape to 'shape', the SE_READ_ONLY_SHAPE error is returned. See 'Shape table functions' for more information.

•  Ignores any CAD data in the source shape, and removes any CAD data in the target shape.