| SE_ptable_create | |
Creates an empty point table
LONG SE_ptable_create (SE_ENVELOPE *window, SE_COORDREF coordref SE_PTABLE *ptable);
| window | A pointer to an SE_ENVELOPE structure |
| coordref | A pointer to an SE_COORDREF structure |
| ptable | The handle to a point table |
The SE_ptable_create function initializes a point table and must be called before using any of the other point table routines. Memory allocation for the point table is automatic. When a point table is no longer being used, call SE_ptable_free to free the memory associated with the point table.
An SE_ENVELOPE structure is required for point table creation. The envelope defines the region where all points will reside and all point snapping will occur. Any point not located within the envelope is discarded.
You must call this function before using any other point table routines.
Tip: Multiple point tables can be active concurrently. Each point table has a unique point table handle.
SE_SUCCESS
SE_INVALID_COORDREF_OBJECT
SE_INVALID_ENVELOPE
SE_INVALID_POINTER
SE_OUT_OF_CLMEM
SE_SDE_NOT_STARTED