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>)无效。无法打开地形文件。
参考
- 使用函数 tmm_elev_profile_get() 仅获取高程剖面,而不带 lat_dist 和 lon_dist。
- 使用函数 tmm_elev_point_get() 获取指定位置处的地形高度。
- 使用函数 tmm_elev_profile_destroy() 销毁剖面数据数组。