TMM 包
函数列表
注意: TMM 包仅在地形建模模块(Terrain Modeling Module)功能下可用。
TMM 包包含以下函数。
- tmm_all_propagation_model_names_list_get() 获取所有已安装传播模型的列表。
- tmm_all_propagation_spec_names_list_get() 获取所有已定义传播规格名称的列表。
- tmm_available_propagation_model_names_list_get() 获取所有可供使用的传播模型的列表。
- tmm_cache_create() 创建用于存储路径损耗值的数据结构,以便后续查找和可能的重复使用。
- tmm_cache_destroy() 销毁现有缓存的内容以及缓存本身。
- tmm_cache_entry_add() 将关于一对位置的数据以及路径损耗计算的状态和(若已计算的)路径损耗值添加到缓存中。
- tmm_cache_entry_find() 判断 TmmT_Cache 数据结构中是否存在与指定位置匹配的条目,并返回该条目。
- tmm_default_propagation_spec_get() 返回默认传播规格的名称。
- tmm_elev_point_get() 返回指定位置处的地形高度。
- tmm_elev_profile_destroy() 释放由 tmm_elev_profile_get() 创建的 TmmT_Elev_Profile 数据结构。
- tmm_elev_profile_get() 返回沿路径按指定间隔的地形高度。
- Tmm_Elev_Profile_Get_With_Dist() 返回沿路径按指定间隔的地形高度以及各点之间的距离。
- tmm_position_valid() 判断某个地理位置是否有效。
- tmm_propagation_model_get() 加载实现特定传播模型的共享对象库。
- tmm_propagation_spec_calc_pathloss() 使用指定的传播规格执行路径损耗计算。
- tmm_propagation_spec_get() 返回所请求传播规格的指针。
- tmm_terrain_model_get() 加载实现特定地形模型的共享对象库。
- tmm_verbose_get() 返回当前的 verbose(详细输出)模式设置。
- tmm_verbose_set() 设置 TMM 的 verbose 模式。
- tmm_zone_valid() 报告某个传播区域是否有效。
回调
TMM 包定义了以下回调类型。
- TmmT_Catalog_Prepare_Step_Notify_Proc 在分多步加载地形数据时被调用。
- TmmT_Parameters_Configure_Method 按需调用,以设置或更新传播模型的参数。
- TmmT_Path_Loss_Calc_Method 按需调用,为传播模型执行路径损耗计算。
- TmmT_Path_Loss_Init_Proc 被调用以初始化传播模型。
- TmmT_Terrain_Reader_Coverage_Proc 被调用以获取给定地形数据源的覆盖范围信息。
- TmmT_Terrain_Reader_Elevation_Proc 被调用以获取给定位置的海拔。
- TmmT_Terrain_Reader_Elevation_Profile_Fill_Proc 被调用以获取沿预定点路径(地形剖面)的海拔。
- TmmT_Terrain_Reader_Exit_Proc 在程序终止时被调用,以关闭地形处理器。
- TmmT_Terrain_Reader_Init_Proc() 用于读取特定地形格式的代码库的入口点。
- TmmT_Terrain_Reader_Load_Proc 被调用以加载给定的地形源。
- TmmT_Terrain_Reader_Num_Source_Steps_Proc 被调用以获取加载特定数据源所需的步骤数。
- TmmT_Terrain_Reader_Resolution_Proc 被调用以获取源数据的分辨率。
- TmmT_Terrain_Reader_Unload_Proc 被调用以卸载给定的地形源。
关于该包的总体说明,参见包概述。