]> git.mxchange.org Git - flightgear.git/blobdiff - src/Airports/simple.hxx
Update FGRunway to process information from threshold.xml files.
[flightgear.git] / src / Airports / simple.hxx
index 2fdbcd02224aa8305dd4306332af300fec946b85..93c76fbe1d63a6377083abeb7103fad404cb42b2 100644 (file)
@@ -1,5 +1,5 @@
 // simple.hxx -- a really simplistic class to manage airport ID,
-//                 lat, lon of the center of one of it's runways, and 
+//                 lat, lon of the center of one of it's runways, and
 //                 elevation in feet.
 //
 // Written by Curtis Olson, started April 1998.
 #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 <simgear/xml/easyxml.hxx>
 
-#include STL_STRING
-#include <map>
-#include <set>
+#include <string>
 #include <vector>
 
-#include "runwayprefs.hxx"
-#include "parking.hxx"
-#include "groundnetwork.hxx"
-#include "dynamics.hxx"
-
-SG_USING_STD(string);
-SG_USING_STD(map);
-SG_USING_STD(set);
-SG_USING_STD(vector);
-
+#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;
 
 /***************************************************************************************
  *
  **************************************************************************************/
-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();
-
-  string getId() const { return _id;};
-  const string &getName() const { return _name;};
-  double getLongitude() const { return _longitude;};
-  // Returns degrees
-  double getLatitude()  const { return _latitude; };
-  // Returns ft
-  double getElevation() const { return _elevation;};
-  bool   getMetar()     const { return _has_metar;};
-
-  void setId(const string& id) { _id = id;};
-  void setMetar(bool value) { _has_metar = value; };
-
-  FGAirportDynamics *getDynamics();
-private:
-  FGAirport operator=(FGAirport &other);
-  FGAirport(const FGAirport&);
-};
-
-typedef map < string, FGAirport* > airport_map;
-typedef airport_map::iterator airport_map_iterator;
-typedef airport_map::const_iterator const_airport_map_iterator;
-
-typedef vector < FGAirport * > airport_list;
-typedef airport_list::iterator airport_list_iterator;
-typedef airport_list::const_iterator const_airport_list_iterator;
-
-
-class FGAirportList {
-
+    FGAirport(const std::string& id, const SGGeod& location, const SGGeod& tower, 
+            const std::string& name, bool has_metar, Type aType);
+    ~FGAirport();
+
+    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(); }
+    // Returns ft
+    double getElevation() const { return elevation(); }
+    bool   getMetar()     const { return _has_metar; }
+    bool   isAirport()    const;
+    bool   isSeaport()    const;
+    bool   isHeliport()   const;
+
+    virtual const std::string& name() const
+    { return _name; }
+
+    const SGGeod& getTowerLocation() const { return _tower_location; }
+
+    void setMetar(bool value) { _has_metar = value; }
+
+    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;
+    
+     /**
+     * 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 SEAPORT;
+       }
+       
+       virtual bool passAirport(FGAirport* aApt) const {
+         return true;
+       }
+     };
+     
+     class HardSurfaceFilter : public AirportFilter
+     {
+     public:
+       HardSurfaceFilter(double minLengthFt);
+       
+       virtual bool passAirport(FGAirport* aApt) const;
+       
+       virtual Type maxType() const {
+         return AIRPORT;
+       }
+     private:
+       double mMinLengthFt;
+     };
+     
+     /**
+      * Syntactic wrapper around FGPositioned::findClosest - find the closest
+      * match for filter, and return it cast to FGAirport. The default filter
+      * passes all airports, including seaports and 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);
 private:
-
-    airport_map airports_by_id;
-    airport_list airports_array;
-  //set < string > ai_dirs;
-
-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 );
-
+    typedef std::vector<FGRunwayPtr>::const_iterator Runway_iterator;
     /**
-     * Return the number of airports in the list.
+     * Helper to locate a runway by ident
      */
-    int size() const;
+    Runway_iterator getIteratorForRunwayIdent(const std::string& aIdent) const;
 
+    // disable these
+    FGAirport operator=(FGAirport &other);
+    FGAirport(const FGAirport&);
+  
     /**
-     * Return a specific airport, by position.
+     * helper to read airport data from the scenery XML files.
      */
-    const FGAirport *getAirport( unsigned int index ) const;
-       
+    void loadSceneryDefintions() const;
+    
     /**
-     * Return a pointer to the raw airport list
+     * Helpers to process property data loaded from an ICAO.threshold.xml file
      */
-     inline const airport_list* getAirportList() { return(&airports_array); }
-
-    /**
-     * Mark the specified airport record as not having metar
-     */
-    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;
+    
+    mutable bool mRunwaysLoaded;
+    mutable bool mTaxiwaysLoaded;
+    
+    std::vector<FGRunwayPtr> mRunways;
+    std::vector<FGTaxiwayPtr> mTaxiways;
+    std::vector<FGPavementPtr> mPavements;
 };
 
 // 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