]> 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 2ec8a917395386aedf7e15ee33b6d452e70b2578..dfa83657057a8d0bc1da7cb7c07f8c44e7f6b4a8 100644 (file)
 #include <simgear/compiler.h>
 
 #include <string>
-#include <map>
-#include <set>
 #include <vector>
 
-#include <simgear/math/point3d.hxx>
-#include "Navaids/positioned.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;
+
+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 : public FGPositioned
 {
-private:
-    SGGeod _tower_location;
-    std::string _name;
-    bool _has_metar;
-    FGAirportDynamics *_dynamics;
-
 public:
     FGAirport(const std::string& id, const SGGeod& location, const SGGeod& tower, 
             const std::string& name, bool has_metar, Type aType);
@@ -71,6 +82,11 @@ public:
     bool   isSeaport()    const;
     bool   isHeliport()   const;
 
+    static bool isAirportType(FGPositioned* pos);
+    
+    virtual const std::string& name() const
+    { return _name; }
+
     const SGGeod& getTowerLocation() const { return _tower_location; }
 
     void setMetar(bool value) { _has_metar = value; }
@@ -86,10 +102,127 @@ public:
     FGRunway* getRunwayByIdent(const std::string& aIdent) const;
     FGRunway* findBestRunwayForHeading(double aHeading) const;
     
+    /**
+     * 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.
+     */
+    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;
-    FGRunway* getTaxiwayByIndex(unsigned int aIndex) 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);
     
-    void addRunway(FGRunway* aRunway);
+    flightgear::CommStationList commStationsOfType(FGPositioned::Type aTy) const;
+    
+    const flightgear::CommStationList& commStations() const
+        { return mCommStations; }
 private:
     typedef std::vector<FGRunwayPtr>::const_iterator Runway_iterator;
     /**
@@ -97,102 +230,48 @@ private:
      */
     Runway_iterator getIteratorForRunwayIdent(const std::string& aIdent) const;
 
+    // disable these
     FGAirport operator=(FGAirport &other);
     FGAirport(const FGAirport&);
-    
-    std::vector<FGRunwayPtr> mRunways;
-    std::vector<FGRunwayPtr> mTaxiways;
-};
-
-
-class FGAirportSearchFilter {
-public:
-    virtual ~FGAirportSearchFilter() {}
-    // all airports pass the filter by default
-    virtual bool pass(FGAirport*) { return true; }
-};
-
-class FGIdentOrdering {
-public:
-  virtual ~FGIdentOrdering()
-  { ; }
   
-  virtual bool compare(const std::string& aA, const std::string& aB) const
-  { return aA < aB; }
-};
-
-typedef std::map < std::string, FGAirport* > airport_map;
-typedef airport_map::iterator airport_map_iterator;
-typedef airport_map::const_iterator const_airport_map_iterator;
-
-typedef std::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;
-
-public:
-    // Constructor (new)
-    FGAirportList();
-
-    // Destructor
-    ~FGAirportList();
-
-    // add an entry to the list
-    FGAirport* add( const std::string& id, const SGGeod& location, const SGGeod& tower,
-              const std::string& name, bool has_metar, FGPositioned::Type aType);
-
-    // search for the specified id.
-    // Returns NULL if unsucessfull.
-    FGAirport* search( const std::string& id );
-
-    // Search for the next airport in ASCII sequence to the supplied id.
-    // eg. id = "KDC" or "KDCA" would both return "KDCA".
-    // NOTE: Numbers come prior to A-Z in ASCII sequence so id = "LD" would return "LD57", not "LDDP"
-    // optional ordering can make letters come before numbers
-    // Implementation assumes airport codes are unique.
-    // Returns NULL if unsucessfull.
-    const FGAirport* findFirstById(const std::string& aIdent, FGIdentOrdering* aOrder = NULL);
-
-    // 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.)  An FGAirportSearchFilter class
-    // can be used to restrict the possible choices to a subtype.
-    // max_range limits search - specified as an arc distance, in degrees
-    FGAirport* search( double lon_deg, double lat_deg, double max_range );
-    FGAirport* search( double lon_deg, double lat_deg, double max_range, FGAirportSearchFilter& );
-
-    /**
-     * Return the number of airports in the list.
-     */
-    int size() const;
-
-    /**
-     * Return a specific airport, by position.
-     */
-    const FGAirport *getAirport( unsigned int index ) const;
-
     /**
-     * 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 std::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 std::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
@@ -201,9 +280,6 @@ const FGAirport *fgFindAirportID( const std::string& id);
 // get airport elevation
 double fgGetAirportElev( const std::string& id );
 
-// get airport position
-Point3D fgGetAirportPos( const std::string& id );
-
 #endif // _FG_SIMPLE_HXX