tmm_elev_profile_get()

Note: Requires Terrain Modeling Module functionality

Abstract

Returns the terrain height at specified intervals along a path.

Syntax

tmm_elev_profile_get (point1_ptr, point2_ptr, meters_between_samples)
Argument Type Description
point1_ptr const TmmT_Position * pointer to the first position
This argument uses the latitude and longitude fields of the TmmT_Position data structure to specify a point. The elevation field is not used.
point2_ptr const TmmT_Position * pointer to the second position
This argument uses the latitude and longitude fields of the TmmT_Position data structure to specify a point. The elevation field is not used.
meters_between_samples float desired spacing of elevation values along the specified path, or TMMC_RESOLUTION_BEST.

Return Value

TmmT_Elev_Profile *

Pointer to a terrain profile data structure.

tmm.h

Example

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);
    }

Details

A call to this function is identical to calling Tmm_Elev_Profile_Get_With_Dist() with the lat_dist and lon_dist arguments specified as VOSC_NIL.

Purpose

This function returns the data necessary to specify a terrain profile along the line connecting two points. Elevations are given at equally spaced intervals along the path.

Errors

  • The terrain data directory (<name>) is invalid. Unable to open terrain file.

Reference

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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