SE_shape_as_polygon

Returns a shape of type polygon, given a shape of any type.

Usage syntax

LONG SE_shape_as_polygon (const SE_SHAPE src_shape, SE_SHAPE tgt_shape);

Parameters
src_shape A handle to an active shape object to convert to a polygon shape
tgt_shape A handle to an active area shape object
Description

Given a shape of any type, returns it as a shape of type polygon. If the input shape is not a legal polygon shape, a nil shape is returned. 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.