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 #if 0
 128                                 // Controls
 129   static double getThrottle (); // 0.0:1.0
 130   static void setThrottle (double throttle); // 0.0:1.0
 131
 132   static double getMixture ();  // 0.0:1.0
 133   static void setMixture (double mixture); // 0.0:1.0
 134
 135   static double getPropAdvance (); // 0.0:1.0
 136   static void setPropAdvance (double pitch); // 0.0:1.0
 137
 138   static double getFlaps ();    // 0.0:1.0
 139   static void setFlaps (double flaps); // 0.0:1.0
 140
 141   static double getAileron ();  // -1.0:1.0
 142   static void setAileron (double aileron); // -1.0:1.0
 143
 144   static double getRudder ();   // -1.0:1.0
 145   static void setRudder (double rudder); // -1.0:1.0
 146
 147   static double getElevator (); // -1.0:1.0
 148   static void setElevator (double elevator); // -1.0:1.0
 149
 150   static double getElevatorTrim (); // -1.0:1.0
 151   static void setElevatorTrim (double trim); // -1.0:1.0
 152
 153   static double getBrakes ();   // 0.0:1.0
 154   static void setBrakes (double brake); // 0.0:1.0
 155
 156   static double getLeftBrake (); // 0.0:1.0
 157   static void setLeftBrake (double brake); // 0.0:1.0
 158
 159   static double getRightBrake (); // 0.0:1.0
 160   static void setRightBrake (double brake); // 0.0:1.0
 161
 162   static double getCenterBrake (); // 0.0:1.0
 163   static void setCenterBrake (double brake); // 0.0:1.0
 164
 165 #endif
 166
 167                                 // Autopilot
 168   static bool getAPAltitudeLock ();
 169   static void setAPAltitudeLock (bool lock);
 170
 171   static double getAPAltitude (); // feet
 172   static void setAPAltitude (double altitude); // feet
 173
 174   static bool getAPHeadingLock ();
 175   static void setAPHeadingLock (bool lock);
 176
 177   static double getAPHeading (); // degrees
 178   static void setAPHeading (double heading); // degrees
 179
 180   static double getAPHeadingMag (); // degrees
 181   static void setAPHeadingMag (double heading); // degrees
 182
 183   static bool getAPNAV1Lock ();
 184   static void setAPNAV1Lock (bool lock);
 185
 186
 187                                 // GPS
 188   static string getTargetAirport ();
 189   static void setTargetAirport (string targetAirport);
 190
 191   static bool getGPSLock ();
 192   static void setGPSLock (bool lock);
 193
 194   static double getGPSTargetLatitude (); // degrees
 195
 196   static double getGPSTargetLongitude (); // degrees
 197
 198
 199                                 // Weather
 200   static double getVisibility ();// meters
 201   static void setVisibility (double visiblity); // meters
 202   static double getWindNorth (); // feet/second
 203   static void setWindNorth (double speed); // feet/second
 204   static double getWindEast (); // feet/second
 205   static void setWindEast (double speed); // feet/second
 206   static double getWindDown (); // feet/second
 207   static void setWindDown (double speed); // feet/second
 208
 209                                 // View
 210   static void setViewAxisLong (double axis);// -1.0:1.0
 211   static void setViewAxisLat (double axis); // -1.0:1.0
 212
 213
 214                                 // Time (this varies with time) huh, huh
 215   static double getMagVar ();   // degrees
 216   static double getMagDip ();   // degrees
 217
 218
 219 private:
 220                                 // Will cause a linking error if invoked.
 221   FGBFI ();
 222
 223 };
 224
 225 // end of bfi.hxx