Edit_Polygon

Functions

void DEdit_Polygon (HC_KEY key, int offset, int delete, int insert, const HCD_POINT *points)
 Similar to Edit_Polygon(), but accepts double-precision values. More...
 
void Edit_Polygon (HC_KEY key, int offset, int ndelete, int insert, const HC_POINT *points)
 Adjusts the boundary of a previously declared polygon. More...
 

Detailed Description

Function Documentation

◆ DEdit_Polygon()

void DEdit_Polygon ( HC_KEY  key,
int  offset,
int  delete,
int  insert,
const HCD_POINT *  points 
)

Similar to Edit_Polygon(), but accepts double-precision values.

Parameters
key- The unique identifier returned by a previous call to DInsert_Polygon() .
offset- Number of the point in the original polygon definition just before which to start editing. "0" is the first. If specified as "-1", editing starts after the last position.
delete- Number of points to delete.
insert- The number of points contained in points.
points- Vector of x-y-z triplets to insert. (A simple N x 3 array may also be used.) Passed by reference always.

DETAILS

No additional details. See Edit_Polygon().

◆ Edit_Polygon()

void Edit_Polygon ( HC_KEY  key,
int  offset,
int  ndelete,
int  insert,
const HC_POINT *  points 
)

Adjusts the boundary of a previously declared polygon.

Parameters
key- The unique identifier returned by a previous call to Insert_Polygon() .
offset- Number of the point in the original polygon definition just before which to start editing. "0" is the first. If specified as "-1", editing starts after the last position.
ndelete- Number of points to delete.
insert- The number of points contained in points.
points- Vector of x-y-z triplets to insert. (A simple N x 3 array may also be used.) Passed by reference always.

DETAILS

Edit_Polygon() lets you modify a polygon with a long boundary as it sits in the database. You don't have to delete and reinsert it from scratch.

Edit_Polygon() changes the originally specified points vector (see Insert_Polygon() ), starting at offset in the vector. First ndelete points are removed, then insert points, obtained from the points vector, are inserted.

NOTES

If you delete point #1 and point #2 from a polygon, the next time around the point that was "#3" will now be #1. Insertion works in a similar manner.

If you work in 3-D, make sure all the points are still coplanar. The system does not check for this and non-planar polygons result in undefined behavior.

If you originally specified the last point as your first point, the first point is considered redundant and trimmed off.

RESTRICTIONS

See also
Translate_Object, Delete_By_Key, Flush_Contents, Flush_By_Key, Insert_Polygon, Edit_Polyline.