1 // commlist.hxx -- comm frequency lookup class
3 // Written by David Luff and Alexander Kappes, started Jan 2003.
4 // Based on navlist.hxx by Curtis Olson, started April 2000.
6 // Copyright (C) 2000 Curtis L. Olson - curt@flightgear.org
8 // This program is free software; you can redistribute it and/or
9 // modify it under the terms of the GNU General Public License as
10 // published by the Free Software Foundation; either version 2 of the
11 // License, or (at your option) any later version.
13 // This program is distributed in the hope that it will be useful, but
14 // WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 // General Public License for more details.
18 // You should have received a copy of the GNU General Public License
19 // along with this program; if not, write to the Free Software
20 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22 /*****************************************************************
24 * FGCommList is used to store communication frequency information
25 * for the ATC and AI subsystems. Two maps are maintained - one
26 * searchable by location and one searchable by frequency. The
27 * data structure returned from the search is the ATCData struct
28 * defined in ATC.hxx, containing location, frequency, name, range
29 * and type of the returned station.
31 ******************************************************************/
33 #ifndef _FG_COMMLIST_HXX
34 #define _FG_COMMLIST_HXX
37 #include <simgear/compiler.h>
38 #include <simgear/misc/sg_path.hxx>
51 // A list of ATC stations
52 typedef list < ATCData > comm_list_type;
53 typedef comm_list_type::iterator comm_list_iterator;
54 typedef comm_list_type::const_iterator comm_list_const_iterator;
56 // A map of ATC station lists
57 typedef map < int, comm_list_type > comm_map_type;
58 typedef comm_map_type::iterator comm_map_iterator;
59 typedef comm_map_type::const_iterator comm_map_const_iterator;
69 // load all comm frequencies and build the map
70 bool init( SGPath path );
72 // query the database for the specified frequency, lon and lat are
73 // in degrees, elev is in meters.
74 // If no atc_type is specified, it returns true if any non-invalid type is found.
75 // If atc_type is specifed, returns true only if the specified type is found.
76 // Returns the station closest to the supplied position.
77 // The data found is written into the passed-in ATCData structure.
78 bool FindByFreq( double lon, double lat, double elev, double freq, ATCData* ad, atc_type tp = INVALID );
80 // query the database by location, lon and lat are
81 // in degrees, elev is in meters
82 // Returns the number of stations of the specified type that are in range, and pushes them into stations
83 // If atc_type is specifed, returns the number of all stations in range, and pushes them into stations
84 // ** stations is erased before use **
85 int FindByPos( double lon, double lat, double elev, comm_list_type* stations, atc_type tp = INVALID );
87 // Find by Airport code.
88 bool FindByCode( string ICAO, ATCData& ad, atc_type tp = INVALID );
90 // Return the callsign for an ATIS transmission given transmission time and airpord id
91 // This maybe should get moved somewhere else!!
92 int GetCallSign( string apt_id, int hours, int mins );
96 // Comm stations mapped by frequency
97 comm_map_type commlist_freq;
99 // Comm stations mapped by bucket
100 comm_map_type commlist_bck;
102 // Load comms from a specified path (which must include the filename)
103 bool LoadComms(SGPath path);
105 //----------- This stuff is left over from atislist.[ch]xx and maybe should move somewhere else
106 // Add structure and map for storing a log of atis transmissions
107 // made in this session of FlightGear. This allows the callsign
108 // to be allocated correctly wrt time.
113 } atis_transmission_type;
115 typedef map < string, atis_transmission_type > atis_log_type;
116 typedef atis_log_type::iterator atis_log_iterator;
117 typedef atis_log_type::const_iterator atis_log_const_iterator;
119 atis_log_type atislog;
120 //-----------------------------------------------------------------------------------------------
125 extern FGCommList *current_commlist;
128 #endif // _FG_COMMLIST_HXX