]> git.mxchange.org Git - flightgear.git/blobdiff - src/Airports/simple.hxx
Prepare and implement reinit methods for instruments
[flightgear.git] / src / Airports / simple.hxx
index 0e79c8675ee36212f7c4320d5cfc376f369876ab..dfa83657057a8d0bc1da7cb7c07f8c44e7f6b4a8 100644 (file)
 #ifndef _FG_SIMPLE_HXX
 #define _FG_SIMPLE_HXX
 
-
-#ifndef __cplusplus
-# error This library requires C++
-#endif
-
-
-#ifdef HAVE_CONFIG_H
-#  include <config.h>
-#endif
-#include <simgear/math/point3d.hxx>
-
 #include <simgear/compiler.h>
 
-#include STL_STRING
-#include <map>
-#include <set>
+#include <string>
 #include <vector>
 
-#include "runwayprefs.hxx"
-#include "parking.hxx"
-#include "groundnetwork.hxx"
-#include "dynamics.hxx"
+#include <Navaids/positioned.hxx>
+
+// forward decls
+class FGAirportDynamics;
+class FGRunway;
+class FGTaxiway;
+class FGPavement;
+class SGPropertyNode;
 
+typedef SGSharedPtr<FGRunway> FGRunwayPtr;
+typedef SGSharedPtr<FGTaxiway> FGTaxiwayPtr;
+typedef SGSharedPtr<FGPavement> FGPavementPtr;
 
-SG_USING_STD(string);
-SG_USING_STD(map);
-SG_USING_STD(set);
-SG_USING_STD(vector);
+namespace flightgear {
+  class SID;
+  class STAR;
+  class Approach;
+  class Waypt;
+  class CommStation;
 
+  typedef SGSharedPtr<Waypt> WayptRef;
+  typedef std::vector<WayptRef> WayptVec;
+  
+  typedef std::vector<CommStation*> CommStationList;
+}
 
 
 
 /***************************************************************************************
  *
  **************************************************************************************/
-class FGAirport {
-private:
-    string _id;
-    double _longitude;    // degrees
-    double _latitude;     // degrees
-    double _elevation;    // ft
-    string _name;
-    bool _has_metar;
-    FGAirportDynamics *dynamics;
-
+class FGAirport : public FGPositioned
+{
 public:
-    FGAirport();
-    // FGAirport(const FGAirport &other);
-    FGAirport(const string& id, double lon, double lat, double elev, const string& name, bool has_metar);
+    FGAirport(const std::string& id, const SGGeod& location, const SGGeod& tower, 
+            const std::string& name, bool has_metar, Type aType);
     ~FGAirport();
 
-    const string& getId() const { return _id; }
-    const string& getName() const { return _name; }
-    double getLongitude() const { return _longitude; }
+    const std::string& getId() const { return ident(); }
+    const std::string& getName() const { return _name; }
+    double getLongitude() const { return longitude(); }
     // Returns degrees
-    double getLatitude()  const { return _latitude; }
+    double getLatitude()  const { return latitude(); }
     // Returns ft
-    double getElevation() const { return _elevation; }
+    double getElevation() const { return elevation(); }
     bool   getMetar()     const { return _has_metar; }
+    bool   isAirport()    const;
+    bool   isSeaport()    const;
+    bool   isHeliport()   const;
 
-    void setId(const string& id) { _id = id; }
-    void setMetar(bool value) { _has_metar = value; }
-
-    FGAirportDynamics *getDynamics();
-
-private:
-    FGAirport operator=(FGAirport &other);
-    FGAirport(const FGAirport&);
-};
-
-
+    static bool isAirportType(FGPositioned* pos);
+    
+    virtual const std::string& name() const
+    { return _name; }
 
-typedef map < string, FGAirport* > airport_map;
-typedef airport_map::iterator airport_map_iterator;
-typedef airport_map::const_iterator const_airport_map_iterator;
+    const SGGeod& getTowerLocation() const { return _tower_location; }
 
-typedef vector < FGAirport * > airport_list;
-typedef airport_list::iterator airport_list_iterator;
-typedef airport_list::const_iterator const_airport_list_iterator;
-
-
-
-class FGAirportList {
-private:
-
-    airport_map airports_by_id;
-    airport_list airports_array;
-    //set < string > ai_dirs;
+    void setMetar(bool value) { _has_metar = value; }
 
-public:
-    // Constructor (new)
-    FGAirportList();
-
-    // Destructor
-    ~FGAirportList();
-
-    // add an entry to the list
-    void add( const string& id, const double longitude, const double latitude,
-              const double elevation, const string& name, const bool has_metar );
-
-    // search for the specified id.
-    // Returns NULL if unsucessfull.
-    FGAirport* search( const string& id );
-
-    // Search for the next airport in ASCII sequence to the supplied id.
-    // eg. id = "KDC" or "KDCA" would both return "KDCA".
-    // If exact = true then only exact matches are returned.
-    // NOTE: Numbers come prior to A-Z in ASCII sequence so id = "LD" would return "LD57", not "LDDP"
-    // Implementation assumes airport codes are unique.
-    // Returns NULL if unsucessfull.
-    const FGAirport* findFirstById( const string& id, bool exact = false );
-
-    // search for the airport closest to the specified position
-    // (currently a linear inefficient search so it's probably not
-    // best to use this at runtime.)  If with_metar is true, then only
-    // return station id's marked as having metar data.
-    // Returns NULL if fails (unlikely unless none have metar and with_metar spec'd!)
-    FGAirport* search( double lon_deg, double lat_deg, bool with_metar );
+    FGRunway* getActiveRunwayForUsage() const;
 
+    FGAirportDynamics *getDynamics();
+    
+    unsigned int numRunways() const;
+    FGRunway* getRunwayByIndex(unsigned int aIndex) const;
+
+    bool hasRunwayWithIdent(const std::string& aIdent) const;
+    FGRunway* getRunwayByIdent(const std::string& aIdent) const;
+    FGRunway* findBestRunwayForHeading(double aHeading) const;
+    
     /**
-     * Return the number of airports in the list.
+     * return the most likely target runway based on a position.
+     * Specifically, return the runway for which the course from aPos
+     * to the runway end, mostly closely matches the runway heading.
+     * This is a good approximation of which runway the position is on or
+     * aiming towards.
      */
-    int size() const;
-
+    FGRunway* findBestRunwayForPos(const SGGeod& aPos) const;
+    
+     /**
+     * Useful predicate for FMS/GPS/NAV displays and similar - check if this
+     * aiport has a hard-surfaced runway of at least the specified length.
+     */
+    bool hasHardRunwayOfLengthFt(double aLengthFt) const;
+
+    unsigned int numTaxiways() const;
+    FGTaxiway* getTaxiwayByIndex(unsigned int aIndex) const;
+
+    unsigned int numPavements() const;
+    FGPavement* getPavementByIndex(unsigned int aIndex) const;
+
+    void setRunwaysAndTaxiways(std::vector<FGRunwayPtr>& rwys,
+      std::vector<FGTaxiwayPtr>& txwys,
+      std::vector<FGPavementPtr>& pvts);
+    
+    class AirportFilter : public Filter
+     {
+     public:
+       virtual bool pass(FGPositioned* aPos) const { 
+         return passAirport(static_cast<FGAirport*>(aPos));
+       }
+       
+       virtual Type minType() const {
+         return AIRPORT;
+       }
+       
+       virtual Type maxType() const {
+         return AIRPORT;
+       }
+       
+       virtual bool passAirport(FGAirport* aApt) const {
+         return true;
+       }
+     };
+     
+     /**
+      * Filter which passes heliports and seaports in addition to airports
+      */
+     class PortsFilter : public AirportFilter
+     {
+     public:
+       virtual Type maxType() const {
+         return SEAPORT;
+       }
+     };
+     
+     class HardSurfaceFilter : public AirportFilter
+     {
+     public:
+       HardSurfaceFilter(double minLengthFt = -1);
+       
+       virtual bool passAirport(FGAirport* aApt) const;
+       
+     private:
+       double mMinLengthFt;
+     };
+     
+     
+     void setProcedures(const std::vector<flightgear::SID*>& aSids,
+      const std::vector<flightgear::STAR*>& aStars,
+      const std::vector<flightgear::Approach*>& aApproaches);
+     
+     void addSID(flightgear::SID* aSid);
+      void addSTAR(flightgear::STAR* aStar);
+      void addApproach(flightgear::Approach* aApp);
+
+      unsigned int numSIDs() const;
+      flightgear::SID* getSIDByIndex(unsigned int aIndex) const;
+      flightgear::SID* findSIDWithIdent(const std::string& aIdent) const;
+      
+      unsigned int numSTARs() const;
+      flightgear::STAR* getSTARByIndex(unsigned int aIndex) const;
+      flightgear::STAR* findSTARWithIdent(const std::string& aIdent) const;
+      
+      unsigned int numApproaches() const;
+      flightgear::Approach* getApproachByIndex(unsigned int aIndex) const;
+      flightgear::Approach* findApproachWithIdent(const std::string& aIdent) const;
+  
+     /**
+      * Syntactic wrapper around FGPositioned::findClosest - find the closest
+      * match for filter, and return it cast to FGAirport. The default filter
+      * passes airports, but not seaports or heliports
+      */
+     static FGAirport* findClosest(const SGGeod& aPos, double aCuttofNm, Filter* filter = NULL);
+     
+     /**
+      * Helper to look up an FGAirport instance by unique ident. Throws an 
+      * exception if the airport could not be found - so callers can assume
+      * the result is non-NULL.
+      */
+     static FGAirport* getByIdent(const std::string& aIdent);
+     
+     /**
+      * Helper to look up an FGAirport instance by unique ident. Returns NULL
+      * if the airport could not be found.
+      */
+     static FGAirport* findByIdent(const std::string& aIdent);
+     
+     /**
+      * Specialised helper to implement the AirportList dialog. Performs a
+      * case-insensitive search on airport names and ICAO codes, and returns
+      * matches in a format suitable for use by a puaList. 
+      */
+     static char** searchNamesAndIdents(const std::string& aFilter);
+     
+    void setCommStations(flightgear::CommStationList& comms);
+    
+    flightgear::CommStationList commStationsOfType(FGPositioned::Type aTy) const;
+    
+    const flightgear::CommStationList& commStations() const
+        { return mCommStations; }
+private:
+    typedef std::vector<FGRunwayPtr>::const_iterator Runway_iterator;
     /**
-     * Return a specific airport, by position.
+     * Helper to locate a runway by ident
      */
-    const FGAirport *getAirport( unsigned int index ) const;
+    Runway_iterator getIteratorForRunwayIdent(const std::string& aIdent) const;
 
+    // disable these
+    FGAirport operator=(FGAirport &other);
+    FGAirport(const FGAirport&);
+  
     /**
-     * Return a pointer to the raw airport list
+     * helper to read airport data from the scenery XML files.
      */
-    inline const airport_list* getAirportList() { return (&airports_array); }
-
+    void loadSceneryDefinitions() const;
+    
     /**
-     * Mark the specified airport record as not having metar
+     * Helpers to process property data loaded from an ICAO.threshold.xml file
      */
-    void no_metar( const string &id );
-
+    void readThresholdData(SGPropertyNode* aRoot);
+    void processThreshold(SGPropertyNode* aThreshold);
+    
     /**
-     * Mark the specified airport record as (yes) having metar
+     * Helper to parse property data loaded from an ICAO.twr.xml filke
      */
-    void has_metar( const string &id );
-
+    void readTowerData(SGPropertyNode* aRoot);
+    
+    SGGeod _tower_location;
+    std::string _name;
+    bool _has_metar;
+    FGAirportDynamics *_dynamics;
+
+    void loadRunways() const;
+    void loadTaxiways() const;
+    void loadProcedures() const;
+    
+    mutable bool mRunwaysLoaded;
+    mutable bool mTaxiwaysLoaded;
+    mutable bool mProceduresLoaded;
+    
+    std::vector<FGRunwayPtr> mRunways;
+    std::vector<FGTaxiwayPtr> mTaxiways;
+    std::vector<FGPavementPtr> mPavements;
+    
+    std::vector<flightgear::SID*> mSIDs;
+    std::vector<flightgear::STAR*> mSTARs;
+    std::vector<flightgear::Approach*> mApproaches;
+    
+    flightgear::CommStationList mCommStations;
 };
 
 // find basic airport location info from airport database
-const FGAirport *fgFindAirportID( const string& id);
+const FGAirport *fgFindAirportID( const std::string& id);
 
 // get airport elevation
-double fgGetAirportElev( const string& id );
-
-// get airport position
-Point3D fgGetAirportPos( const string& id );
+double fgGetAirportElev( const std::string& id );
 
 #endif // _FG_SIMPLE_HXX