SE_shape_generate_ellipse |
Generates a polygon shape in the form of an ellipse.
LONG SE_shape_generate_ellipse (SE_POINT center,
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 |
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.
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
• 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.