SE_shape_generate_ellipse

Generates a polygon shape in the form of an ellipse.

Usage syntax

LONG SE_shape_generate_ellipse (SE_POINT center,

Parameters
 
center An SE_POINT structure that contains the center coordinate of the ellipse
semi_major_axis The semimajor axis of the ellipse
semi_minor_axis The semiminor axis of the ellipse
angle The angle of the ellipse
num_pts The number of points to use in the resulting elliptical 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 ellipse based on the supplied center, radii, angle, and number of points.

The parameters have some restrictions:

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

semi_major_axis > 0.0

semi_minor_axis > 0.0

0.0 <= angle <= 360.0

The semimajor axis must be greater or equal to the semiminor axis. The angle of the ellipse is given in degrees.

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.