tmm_elev_profile_get()
注意: 需要地形建模模块(Terrain Modeling Module)功能。
摘要
沿路径按指定间隔返回地形高度。
语法
tmm_elev_profile_get (point1_ptr, point2_ptr, meters_between_samples)
| 参数 | 类型 | 说明 |
|---|---|---|
point1_ptr |
const TmmT_Position * |
指向第一个位置的指针 该参数使用 TmmT_Position 数据结构的纬度和经度字段来指定一个点。高程字段不使用。 |
point2_ptr |
const TmmT_Position * |
指向第二个位置的指针 该参数使用 TmmT_Position 数据结构的纬度和经度字段来指定一个点。高程字段不使用。 |
meters_between_samples |
float |
沿指定路径的高程值期望间隔,或 TMMC_RESOLUTION_BEST。 |
返回类型
TmmT_Elev_Profile *
指向地形剖面数据结构的指针。
头文件
tmm.h
示例
elevation_profile_ptr = tmm_elev_profile_get (tx_pos_ptr, rx_pos_ptr, TMMC_RESOLUTION_BEST);
if ((elevation_profile_ptr == OPC_NIL) ||
(elevation_profile_ptr->data_status != TmmC_Elev_Data_All_Good))
{
/* No terrain */
/* Use freespace */
power_freespace (pkptr);
}
详情
调用本函数与调用 Tmm_Elev_Profile_Get_With_Dist() 并将 lat_dist 和 lon_dist 参数指定为 VOSC_NIL 完全相同。
用途
本函数返回沿连接两点的直线指定地形剖面所需的数据。高程沿路径按等间隔给出。
错误
- 地形数据目录(
<name>)无效。无法打开地形文件。
参考
- 使用函数 tmm_elev_point_get() 获取指定位置处的地形高度。
- 使用函数 tmm_elev_profile_destroy() 销毁剖面数据数组。