FreeBSD Manual Pages
FGELEV(1) FlightGear man pages FGELEV(1) NAME fgelev - Compute FlightGear scenery elevation for a given list of points SYNOPSIS fgelev [--expire num] [--print-solidness] [--fg-root rootdir] [--fg-scenery scenerydir] [--tile-file osgbfilename] [--use-vpb] DESCRIPTION fgelev is a standalone utility that, given a list of points on standard in- put, prints the corresponding elevation for each of them on standard out- put. It can also (optionally) print whether the material covering that point is solid or not. The list of points must be in the following form: id lon lat where id is an arbitrary identifier for the point, lon is the longitude of the point and lat is the latitude of the point. Positive longitudes (lati- tudes) correspond to points located in the Eastern (Northern) hemisphere; negative ones correspond to points located in the Western (Southern) hemi- sphere. The list of elevations returned by fgelev is in the following form: id: elev solid where id is the identifier of the point passed as input, elev is the eleva- tion of the point in meters (or -1000 if the elevation of the given point was not found) and solid is: * the string solid if the parameter --print-solidness was passed to fgelev and the material covering the point is solid; * the string - if the parameter --print-solidness was passed to fgelev and the material covering the point is not solid; * absent if the parameter --print-solidness was not passed to fgelev. OPTIONS --expire num To speed up elevation data retrieval, fgelev uses an internal cache. This option lets the user specify the number of requests after which, if a point was not queried in them, it should be marked as expired. By default, fgelev expires points not queried in the last 10 requests. --print-solidness Require fgelev to print the solidness of the material covering the queried point. See the DESCRIPTION section for more details. --fg-root rootdir Set the FlightGear data root directory ($FG_ROOT) to rootdir. If this option is not set, fgelev uses the path specified in the FG_ROOT environment variable or, absent that, the FlightGear data directory chosen at the time the program was compiled. --fg-scenery scenerydir Set the FlightGear scenery directory ($FG_SCENERY) to scenerydir. If this option is not set, fgelev uses the path specified in the FG_SCENERY environment variable or, absent that, the Scenery subdi- rectory inside $FG_ROOT. --tile-file osgbfilename Use a specific tile file when searching for elevation details, in- stead of scanning through the whole world. --use-vpb If specified, enables WS3.0 scenery behaviour, searching under the vpb/ subdirectory. EXIT STATUS fgelev exits with EXIT_SUCCESS on success, with EXIT_FAILURE if it is un- able to read data from standard input or to load the scenery. ENVIRONMENT FG_ROOT If FG_ROOT is set and --fg-root is not set, it specifies the root data directory to use. FG_SCENERY If FG_SCENERY is set and --fg-scenery is not set, it specifies the scenery directory to use. SEE ALSO fgfs(1) FlightGear 2020-11-15 FGELEV(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | ENVIRONMENT | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fgelev&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>