TmmT_Terrain_Reader_Elevation_Profile_Fill_Proc
Note: Requires Terrain Modeling Module functionality
Abstract
Callback: Called to obtain elevations along a path of predetermined points (a terrain profile).
Syntax
<terrain_reader_elevation_profile_fill_proc_name> (terrain_source, start_lat, start_long, inc_lat, inc_long, n_positions, elevations)
| Argument | Type | Description |
|---|---|---|
terrain_source |
struct TmmT_Terrain_Source * |
Terrain source of interest (see TmmT_Terrain_Reader_Load_Proc for details) |
start_lat |
double |
Latitude of the first point on the terrain profile |
start_long |
double |
Longitude of the first point on the terrain profile |
inc_lat |
double |
Increment (in degrees latitude) between consecutive points on the terrain profile |
inc_long |
double |
Increment (in degrees longitude) between consecutive points on the terrain profile |
n_positions |
VosT_uInt32 |
Size of the elevations array |
elevations |
float * |
Array to be filled with elevation data |
Return Value
VosT_uInt32
Number of points successfully filled with elevation data (excluding missing and unknown values)
Details
This callback should fill n_positions entries in the elevations array. Each entry should have either an actual elevation, TMMC_ELEV_UNKNOWN, or TMMC_ELEV_DATA_MISSING.
Purpose
Callback used to obtain elevations along a path of predetermined points (a terrain profile).