SE_shape_generate_circle |
Generates a polygon shape in the form of a circle based on the supplied center, radius, and number of points.
LONG SE_shape_generate_circle (SE_POINT center, LFLOAT radius, LONG num_pts, SE_SHAPE tgt_shape);
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 |
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
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.