Tmm_Elev_Profile_Get_With_Dist()

注意: 需要地形建模模块(Terrain Modeling Module)功能。

摘要

沿路径按指定间隔返回地形高度,并返回点之间的距离。

语法

Tmm_Elev_Profile_Get_With_Dist (point1_ptr, point2_ptr, meters_between_samples, lat_dist, lon_dist)
参数 类型 说明
point1_ptr const TmmT_Position * 指向第一个位置的指针
该参数使用 TmmT_Position 数据结构的纬度和经度字段来指定一个点。高程字段不使用。
point2_ptr const TmmT_Position * 指向第二个位置的指针
该参数使用 TmmT_Position 数据结构的纬度和经度字段来指定一个点。高程字段不使用。
meters_between_samples float 沿指定路径的高程值期望间隔,或 TMMC_RESOLUTION_BEST(参见详情)。
lat_dist double * 指向一块区域的指针,该区域将被填入路径上相邻点之间的南北间隔(以纬度度计)
lon_dist double * 指向一块区域的指针,该区域将被填入路径上相邻点之间的东西间隔(以经度度计)

返回类型

TmmT_Elev_Profile *

指向地形剖面数据结构的指针。

头文件

tmm.h

示例

elevation_profile_ptr = Tmm_Elev_Profile_Get_With_Dist (tx_pos_ptr, rx_pos_ptr, TMMC_RESOLUTION_BEST, lat_dist_ptr, lon_dist_ptr);

if ((elevation_profile_ptr == OPC_NIL) ||
    (elevation_profile_ptr->data_status != TmmC_Elev_Data_All_Good))
    {
    /* No terrain */
    /* Use freespace */
    power_freespace (pkptr);
    }

详情

本函数分配一个新的 TmmT_Elev_Profile 结构,并填入在两个请求点之间的高程值数组。剖面沿两点之间的大圆路径展开。

meters_between_samples 指定剖面路径上点之间的期望距离。该值被视为最小距离,必要时会增大以创建等大小的间隔。如果 meters_between_samples 为 TMMC_RESOLUTION_BEST,则采样间隔将是地形数据的分辨率。

高程剖面放置在 TmmT_Elev_Profile 数据结构中,其内容如下:

表 20:TmmT_Elev_Profile 数据结构

值 类型 说明
reserved1 int 不使用
point1 TmmT_Position 第一个位置的纬度和经度。(高程值为 0.0。)
point2 TmmT_Position 第二个位置的纬度和经度。(高程值为 0.0。)
distance_between_samples float 高程点之间的恒定间隔,以米计
data_status TmmT_Elev_Data_Status 通过返回表 88“TMM Elevation Data Status Symbolic Constants“(第 27 页)中的某个常量,指示是否有高程数据缺失。
reserved2 float 不使用
reserved3 float 不使用
number_samples int profile_elevations 数组的大小
profile_elevations float * 指向包含高程采样值的数组的指针

不再需要时,必须使用 tmm_elev_profile_destroy() 销毁该数据结构。

用途

本函数返回沿连接两点的直线指定地形剖面所需的数据,以及相邻点之间的纬度和经度距离。高程沿路径按等间隔给出。

错误

  • 地形数据目录(<name>)无效。无法打开地形文件。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com