Shapeset 子包
此子包包含用于创建和管理 Shapeset 模型的函数。Shapeset 模型是具有相同坐标系的 Shape 集合。Shapeset 模型可以被相同或不同网络中的多个 Slice 共享。
你可以使用 Ets_Shapeset_Model_Create() 创建 Shapeset 模型,或者要基于 MapInfo 数据创建地图 Shapeset,使用 Ets_Shapeset_From_MIF_Data_Create()。Shapeset 必须先命名才能保存;使用 Ets_Shapeset_Model_Name_Set() 完成命名。要查看 Shapeset 的名称,使用 Ets_Shapeset_Model_Name_Get()。要将 Shapeset 写入磁盘,使用 Ets_Shapeset_Model_Save()。要从磁盘读取 Shapeset,使用 Ets_Shapeset_Model_Load()。
未被使用的 Shapeset 会被自动垃圾回收。要保护 Shapeset,在创建 Shapeset 时调用 Ets_Shapeset_Model_Reference(),并在其不再需要时调用 Ets_Shapeset_Model_Unreference()。当 Shapeset 被添加至 Slice 或从中移除时,也会被引用和取消引用。当引用计数降为零时,Shapeset 会被自动释放。如果你需要手动释放 Shapeset,使用 Ets_Shapeset_Model_Destroy()。
Shapeset 可以容纳任意数量的 Shape。要确定 Shapeset 中 Shape 的数量,使用 Ets_Shapeset_Shape_Count_Get()。要在 Shapeset 列表的指定位置添加 Shape,使用 Ets_Shapeset_Shape_Nth_Insert()。要移除 Shape,使用 Ets_Shapeset_Shape_Nth_Remove()。要获取 Shapeset 中特定 Shape 的句柄(例如用以了解它是哪类 Shape),使用 Ets_Shapeset_Shape_Nth_Get()。如果你想知道 Shapeset 自加载或上次保存以来是否被修改,使用 Ets_Shapeset_Model_Is_Modified()。