src/Main/bfi.hxx

   1 // bfi.hxx - Big Flat Interface
   2 //
   3 // Written by David Megginson, started February, 2000.
   4 //
   5 // Copyright (C) 2000  David Megginson - david@megginson.com
   6 //
   7 // THIS INTERFACE IS DEPRECATED; USE THE PROPERTY MANAGER INSTEAD.
   8 //
   9 // This program is free software; you can redistribute it and/or
  10 // modify it under the terms of the GNU General Public License as
  11 // published by the Free Software Foundation; either version 2 of the
  12 // License, or (at your option) any later version.
  13 //
  14 // This program is distributed in the hope that it will be useful, but
  15 // WITHOUT ANY WARRANTY; without even the implied warranty of
  16 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17 // General Public License for more details.
  18 //
  19 // You should have received a copy of the GNU General Public License
  20 // along with this program; if not, write to the Free Software
  21 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22 //
  23 // $Id$
  24
  25 #include <time.h>
  26 #include <string>
  27
  28 #include <simgear/compiler.h>
  29
  30 FG_USING_NAMESPACE(std);
  31
  32
  33 /**
  34  * Big Flat Interface
  35  *
  36  * This class implements the Facade design pattern (GOF p.185) to provide
  37  * a single, (deceptively) simple flat interface for the FlightGear
  38  * subsystems.
  39  *
  40  * To help cut down on interdependence, subsystems should
  41  * use the BFI whenever possible for inter-system communication.
  42  *
  43  * TODO:
  44  * - add selectors to switch the current plane, throttle, brake, etc.
  45  * - add more autopilot settings
  46  */
  47 class FGBFI
  48 {
  49 public:
  50
  51                                 // Initialize before first use.
  52   static void init ();
  53
  54                                 // Reinit if necessary.
  55   static void update ();
  56
  57                                 // Simulation
  58   static int getFlightModel ();
  59   static void setFlightModel (int flightModel);
  60
  61   static string getAircraft ();
  62   static void setAircraft (string aircraft);
  63
  64   static string getAircraftDir ();
  65   static void setAircraftDir (string aircraftDir);
  66
  67 //   static time_t getTimeGMT ();
  68 //   static void setTimeGMT (time_t time);
  69   static string getDateString ();// ISO 8601 subset
  70   static void setDateString (string time_string); // ISO 8601 subset
  71
  72                                 // deprecated
  73   static string getGMTString ();
  74
  75                                 // Position
  76   static double getLatitude (); // degrees
  77   static void setLatitude (double latitude); // degrees
  78
  79   static double getLongitude (); // degrees
  80   static void setLongitude (double longitude); // degrees
  81
  82   static double getAltitude (); // feet
  83   static void setAltitude (double altitude); // feet
  84
  85   static double getAGL ();      // feet
  86
  87
  88                                 // Attitude
  89   static double getHeading ();    // degrees
  90   static void setHeading (double heading); // degrees
  91
  92   static double getHeadingMag (); // degrees
  93
  94   static double getPitch ();    // degrees
  95   static void setPitch (double pitch); // degrees
  96
  97   static double getRoll ();     // degrees
  98   static void setRoll (double roll); // degrees
  99
 100                                 // Engine
 101   static double getRPM ();      // revolutions/minute
 102   static void setRPM ( double rpm ); // revolutions/minute
 103
 104   static double getEGT ();      // [unit??]
 105   static double getCHT ();      // [unit??]
 106   static double getMP ();       // [unit??]
 107
 108                                 // Velocities
 109   static double getAirspeed (); // knots
 110   static void setAirspeed (double speed); // knots
 111
 112   static double getSideSlip (); // [unit??]
 113
 114   static double getVerticalSpeed (); // feet/second
 115
 116   static double getSpeedNorth (); // feet/second
 117
 118   static double getSpeedEast (); // feet/second
 119
 120   static double getSpeedDown (); // feet/second
 121
 122 //   static void setSpeedNorth (double speed);
 123 //   static void setSpeedEast (double speed);
 124 //   static void setSpeedDown (double speed);
 125
 126
 127                                 // Autopilot
 128   static bool getAPAltitudeLock ();
 129   static void setAPAltitudeLock (bool lock);
 130
 131   static double getAPAltitude (); // feet
 132   static void setAPAltitude (double altitude); // feet
 133
 134   static bool getAPHeadingLock ();
 135   static void setAPHeadingLock (bool lock);
 136
 137   static double getAPHeading (); // degrees
 138   static void setAPHeading (double heading); // degrees
 139
 140   static double getAPHeadingDG (); // degrees
 141   static void setAPHeadingDG (double heading); // degrees
 142
 143   static double getAPHeadingMag (); // degrees
 144   static void setAPHeadingMag (double heading); // degrees
 145
 146   static bool getAPNAV1Lock ();
 147   static void setAPNAV1Lock (bool lock);
 148
 149
 150                                 // GPS
 151   static string getTargetAirport ();
 152   static void setTargetAirport (string targetAirport);
 153
 154   static bool getGPSLock ();
 155   static void setGPSLock (bool lock);
 156
 157   static double getGPSTargetLatitude (); // degrees
 158
 159   static double getGPSTargetLongitude (); // degrees
 160
 161
 162                                 // Weather
 163   static double getVisibility ();// meters
 164   static void setVisibility (double visiblity); // meters
 165   static double getWindNorth (); // feet/second
 166   static void setWindNorth (double speed); // feet/second
 167   static double getWindEast (); // feet/second
 168   static void setWindEast (double speed); // feet/second
 169   static double getWindDown (); // feet/second
 170   static void setWindDown (double speed); // feet/second
 171
 172                                 // View
 173   static double getFOV ();      // degrees
 174   static void setFOV (double fov); // degrees
 175   static void setViewAxisLong (double axis);// -1.0:1.0
 176   static void setViewAxisLat (double axis); // -1.0:1.0
 177
 178
 179                                 // Time (this varies with time) huh, huh
 180   static double getMagVar ();   // degrees
 181   static double getMagDip ();   // degrees
 182
 183
 184 private:
 185                                 // Will cause a linking error if invoked.
 186   FGBFI ();
 187
 188 };
 189
 190 // end of bfi.hxx