SE_shape_generate_circle

Generates a polygon shape in the form of a circle based on the supplied center, radius, and number of points.

Usage syntax

LONG SE_shape_generate_circle (SE_POINT center, LFLOAT radius, LONG num_pts, SE_SHAPE tgt_shape);

Parameters
center An SE_POINT structure that contains the center coordinate of the circle
radius The radius of the circle
num_pts The number of points to use in the resulting circular shape
tgt_shape A handle to an active shape object, returned as the new shape
Description

Generates a polygon shape in the form of a circle based on the supplied center, radius, and number of points.

The parameters have some restrictions:

num_pts >= 9          /* 8 points to define the shape; the 9th, to close it. */

radius  >  0.0

Returns

SE_SUCCESS
SE_COORD_OUT_OF_BOUNDS

SE_INVALID_PARAM_VALUE

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 ‘tgt_shape’, the SE_READ_ONLY_SHAPE error is returned.

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