| SE_ptable_add_shape | |
Adds the points in a shape to the point table
LONG SE_ptable_add_shape (SE_PTABLE ptable, const SE_SHAPE shape, ULONG mask);
| ptable | The handle to a point table |
| shape | The pointer to an SE_SHAPE structure |
| mask | The type mask for the points to add |
The SE_ptable_add_shape function adds to the point table all of the supplied shape’s points that fall within the clip window of the point table.
Mask values can help select the types of points for snapping and to differentiate point types after a snap. If a point already exists in the table, the routine performs a logical OR operation on the point mask with the value of the passed type mask.
Mask bits differentiate point types. Do not use a zero mask. Point snap calls use a mask to perform a logical AND operation with each candidate point’s mask. If the result of the logical AND operation is zero, the point is ignored for snapping purposes.
Points are inserted as 2-D or 3-D points based on the presence of z-values.