SE_shape_generate_convex_hull |
Computes the convex hull polygon for a shape’s points.
LONG SE_shape_generate_convex_hull (SE_SHAPE src_shape, SE_SHAPE tgt_shape);
src_shape | A handle to an active shape object that contains the points to use |
tgt_shape | Pointer to an allocated shape that will contain the convex hull polygon upon successful completion |
For any set of three or more points, only one polygon can comprise (some or all of) the point set that is convex and contains all the unused points. The calculation of this convex hull is often the first step in operations like the development of ARC TIN networks from a set of points. This routine is provided as a convenience for such operations.
SE_SUCCESS
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.