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 program is free software; you can redistribute it and/or
   8 // modify it under the terms of the GNU General Public License as
   9 // published by the Free Software Foundation; either version 2 of the
  10 // License, or (at your option) any later version.
  11 //
  12 // This program is distributed in the hope that it will be useful, but
  13 // WITHOUT ANY WARRANTY; without even the implied warranty of
  14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 // General Public License for more details.
  16 //
  17 // You should have received a copy of the GNU General Public License
  18 // along with this program; if not, write to the Free Software
  19 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20 //
  21 // $Id$
  22
  23 #include <time.h>
  24 #include <string>
  25
  26 #include <simgear/compiler.h>
  27
  28 FG_USING_NAMESPACE(std);
  29
  30
  31 /**
  32  * Big Flat Interface
  33  *
  34  * This class implements the Facade design pattern (GOF p.185) to provide
  35  * a single, (deceptively) simple flat interface for the FlightGear
  36  * subsystems.
  37  *
  38  * To help cut down on interdependence, subsystems should
  39  * use the BFI whenever possible for inter-system communication.
  40  *
  41  * TODO:
  42  * - add selectors to switch the current plane, throttle, brake, etc.
  43  * - add more autopilot settings
  44  */
  45 class FGBFI
  46 {
  47 public:
  48
  49                                 // Initialize before first use.
  50   static void init ();
  51
  52                                 // Reinit if necessary.
  53   static void update ();
  54
  55                                 // Simulation
  56   static int getFlightModel ();
  57   static const string getAircraft ();
  58   static const string getAircraftDir ();
  59   static time_t getTimeGMT ();
  60   static const string &getGMTString ();
  61   static bool getHUDVisible ();
  62   static bool getPanelVisible ();
  63
  64   static void setFlightModel (int flightModel);
  65   static void setAircraft (const string &aircraft);
  66   static void setAircraftDir (const string &aircraftDir);
  67   static void setTimeGMT (time_t time);
  68   static void setHUDVisible (bool hudVisible);
  69   static void setPanelVisible (bool panelVisible);
  70
  71
  72                                 // Position
  73   static double getLatitude ();
  74   static double getLongitude ();
  75   static double getAltitude ();
  76   static double getAGL ();
  77
  78   static void setLatitude (double latitude);
  79   static void setLongitude (double longitude);
  80   static void setAltitude (double altitude);
  81
  82
  83                                 // Attitude
  84   static double getHeading ();    // true heading
  85   static double getHeadingMag (); // exact magnetic heading
  86   static double getPitch ();
  87   static double getRoll ();
  88
  89   static void setHeading (double heading);
  90   static void setPitch (double pitch);
  91   static void setRoll (double roll);
  92
  93                                 // Engine
  94   static double getRPM ();
  95   static void setRPM ( double rpm );
  96   static double getEGT ();
  97   static double getCHT ();
  98   static double getMP ();
  99
 100                                 // Velocities
 101   static double getAirspeed ();
 102   static double getSideSlip ();
 103   static double getVerticalSpeed ();
 104   static double getSpeedNorth ();
 105   static double getSpeedEast ();
 106   static double getSpeedDown ();
 107
 108   static void setSpeedNorth (double speed);
 109   static void setSpeedEast (double speed);
 110   static void setSpeedDown (double speed);
 111
 112
 113                                 // Controls
 114   static double getThrottle ();
 115   static double getMixture ();
 116   static double getPropAdvance ();
 117   static double getFlaps ();
 118   static double getAileron ();
 119   static double getRudder ();
 120   static double getElevator ();
 121   static double getElevatorTrim ();
 122   static double getBrakes ();
 123   static double getLeftBrake ();
 124   static double getRightBrake ();
 125   static double getCenterBrake ();
 126
 127   static void setThrottle (double throttle);
 128   static void setMixture (double mixture);
 129   static void setPropAdvance (double pitch);
 130   static void setFlaps (double flaps);
 131   static void setAileron (double aileron);
 132   static void setRudder (double rudder);
 133   static void setElevator (double elevator);
 134   static void setElevatorTrim (double trim);
 135   static void setBrakes (double brake);
 136   static void setLeftBrake (double brake);
 137   static void setRightBrake (double brake);
 138   static void setCenterBrake (double brake);
 139
 140
 141                                 // Autopilot
 142   static bool getAPAltitudeLock ();
 143   static double getAPAltitude ();
 144   static bool getAPHeadingLock ();
 145   static double getAPHeading ();
 146   static double getAPHeadingMag ();
 147
 148   static void setAPAltitudeLock (bool lock);
 149   static void setAPAltitude (double altitude);
 150   static void setAPHeadingLock (bool lock);
 151   static void setAPHeading (double heading);
 152   static void setAPHeadingMag (double heading);
 153
 154   static bool getAPNAV1Lock ();
 155   static void setAPNAV1Lock (bool lock);
 156
 157                                 // Radio Navigation
 158   static double getNAV1Freq ();
 159   static double getNAV1AltFreq ();
 160   static double getNAV1Radial ();
 161   static double getNAV1SelRadial ();
 162   static double getNAV1DistDME ();
 163   static bool getNAV1TO ();
 164   static bool getNAV1FROM ();
 165   static bool getNAV1InRange ();
 166   static bool getNAV1DMEInRange ();
 167
 168   static double getNAV2Freq ();
 169   static double getNAV2AltFreq ();
 170   static double getNAV2Radial ();
 171   static double getNAV2SelRadial ();
 172   static double getNAV2DistDME ();
 173   static bool getNAV2TO ();
 174   static bool getNAV2FROM ();
 175   static bool getNAV2InRange ();
 176   static bool getNAV2DMEInRange ();
 177
 178   static double getADFFreq ();
 179   static double getADFAltFreq ();
 180   static double getADFRotation ();
 181
 182   static void setNAV1Freq (double freq);
 183   static void setNAV1AltFreq (double freq);
 184   static void setNAV1SelRadial (double radial);
 185
 186   static void setNAV2Freq (double freq);
 187   static void setNAV2AltFreq (double freq);
 188   static void setNAV2SelRadial (double radial);
 189
 190   static void setADFFreq (double freq);
 191   static void setADFAltFreq (double freq);
 192   static void setADFRotation (double rot);
 193
 194                                 // GPS
 195   static const string &getTargetAirport ();
 196   static bool getGPSLock ();
 197   static double getGPSTargetLatitude ();
 198   static double getGPSTargetLongitude ();
 199
 200   static void setTargetAirport (const string &targetAirport);
 201   static void setGPSLock (bool lock);
 202
 203                                 // Weather
 204   static double getVisibility ();
 205   static bool getClouds ();
 206   static double getCloudsASL ();
 207
 208   static void setVisibility (double visiblity);
 209   static void setClouds (bool clouds);
 210   static void setCloudsASL (double cloudsASL);
 211
 212
 213                                 // Time (this varies with time) huh, huh
 214   static double getMagVar ();
 215   static double getMagDip ();
 216
 217
 218 private:
 219                                 // Will cause a linking error if invoked.
 220   FGBFI ();
 221
 222   static void reinit ();
 223   static void needReinit () { _needReinit = true; }
 224   static bool _needReinit;
 225 };
 226
 227 // end of bfi.hxx