Shapeset Sub-Package
This sub-package contains functions for creating and managing shapeset models. A shapeset model is a collection of shapes with the same coordinate system. Shapeset models can be shared by multiple slices in the same or different networks.
You can create a shapeset model with Ets_Shapeset_Model_Create() or, to create a map shapeset from MapInfo data, with Ets_Shapeset_From_MIF_Data_Create(). Shapesets must be named before they can be saved; do this with Ets_Shapeset_Model_Name_Set(). To discover the name of a shapeset, use Ets_Shapeset_Model_Name_Get(). To write a shapeset to disk, use Ets_Shapeset_Model_Save(). To read a shapeset from disk, use Ets_Shapeset_Model_Load().
Unused shapesets are subject to automatic garbage collection. To protect a shapeset, call Ets_Shapeset_Model_Reference() when the shapeset is created and Ets_Shapeset_Model_Unreference() when it is no longer needed. Shapesets are also referenced and unreferenced when added to or removed from a slice. Shapesets are automatically deallocated when the reference count falls to zero. If you need to manually deallocate a shapeset, use Ets_Shapeset_Model_Destroy().
A shapeset can hold any number of shapes. To determine how many shapes are in a shapeset, use Ets_Shapeset_Shape_Count_Get(). To add a shape at a specific position in a shapeset’s list, use Ets_Shapeset_Shape_Nth_Insert(). To remove a shape, use Ets_Shapeset_Shape_Nth_Remove(). To obtain a handle to a specific shape in a shapeset (to find out what kind of shape it is, for example), use Ets_Shapeset_Shape_Nth_Get(). If you want to know if a shapeset has been changed since it was loaded or last saved, use Ets_Shapeset_Model_Is_Modified().