src/Main/globals.hxx

   1 // globals.hxx -- Global state that needs to be shared among the sim modules
   2 //
   3 // Written by Curtis Olson, started July 2000.
   4 //
   5 // Copyright (C) 2000  Curtis L. Olson - http://www.flightgear.org/~curt
   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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  20 //
  21 // $Id$
  22
  23
  24 #ifndef _GLOBALS_HXX
  25 #define _GLOBALS_HXX
  26
  27 #include <simgear/compiler.h>
  28 #include <simgear/props/props.hxx>
  29 #include <simgear/structure/subsystem_mgr.hxx>
  30 #include <simgear/misc/sg_path.hxx>
  31
  32 #include <vector>
  33 #include <string>
  34
  35 typedef std::vector<std::string> string_list;
  36 typedef std::vector<SGPath> PathList;
  37
  38 // Forward declarations
  39
  40 // This file is included, directly or indirectly, almost everywhere in
  41 // FlightGear, so if any of its dependencies changes, most of the sim
  42 // has to be recompiled.  Using these forward declarations helps us to
  43 // avoid including a lot of header files (and thus, a lot of
  44 // dependencies).  Since Most of the methods simply set or return
  45 // pointers, we don't need to know anything about the class details
  46 // anyway.
  47
  48 class SGEphemeris;
  49 class SGCommandMgr;
  50 class SGMaterialLib;
  51 class SGPropertyNode;
  52 class SGTime;
  53 class SGEventMgr;
  54 class SGSubsystemMgr;
  55 class SGSubsystem;
  56 class SGSoundMgr;
  57
  58 class FGATISMgr;
  59 class FGControls;
  60 class FGTACANList;
  61 class FGLocale;
  62 class FGRouteMgr;
  63 class FGScenery;
  64 class FGTileMgr;
  65 class FGViewMgr;
  66 class FGViewer;
  67 class FGRenderer;
  68 class FGFontCache;
  69
  70
  71 /**
  72  * Bucket for subsystem pointers representing the sim's state.
  73  */
  74
  75 class FGGlobals
  76 {
  77
  78 private:
  79
  80     // properties, destroy last
  81     SGPropertyNode_ptr props;
  82     SGPropertyNode_ptr initial_state;
  83
  84     // localization
  85     FGLocale* locale;
  86
  87     FGRenderer *renderer;
  88     SGSubsystemMgr *subsystem_mgr;
  89     SGEventMgr *event_mgr;
  90
  91     // Number of milliseconds elapsed since the start of the program.
  92     double sim_time_sec;
  93
  94     // Root of FlightGear data tree
  95     std::string fg_root;
  96
  97     /**
  98      * locations to search for (non-scenery) data.
  99      */
 100     PathList additional_data_paths;
 101
 102     // Users home directory for data
 103     std::string fg_home;
 104
 105     // Roots of FlightGear scenery tree
 106     string_list fg_scenery;
 107
 108     std::string browser;
 109
 110     // Time structure
 111     SGTime *time_params;
 112
 113     // Sky structures
 114     SGEphemeris *ephem;
 115
 116     // Material properties library
 117     SGMaterialLib *matlib;
 118
 119     // Global autopilot "route"
 120     FGRouteMgr *route_mgr;
 121
 122     // ATC manager
 123     FGATISMgr *ATIS_mgr;
 124
 125     // control input state
 126     FGControls *controls;
 127
 128     // viewer manager
 129     FGViewMgr *viewmgr;
 130
 131     SGCommandMgr *commands;
 132
 133     // list of serial port-like configurations
 134     string_list *channel_options_list;
 135
 136     // A list of initial waypoints that are read from the command line
 137     // and or flight-plan file during initialization
 138     string_list *initial_waypoints;
 139
 140     // FlightGear scenery manager
 141     FGScenery *scenery;
 142
 143     // Tile manager
 144     FGTileMgr *tile_mgr;
 145
 146     FGFontCache *fontcache;
 147
 148     // Navigational Aids
 149     FGTACANList *channellist;
 150
 151     /// roots of Aircraft trees
 152     string_list fg_aircraft_dirs;
 153
 154     bool haveUserSettings;
 155
 156     SGPropertyNode_ptr positionLon, positionLat, positionAlt;
 157     SGPropertyNode_ptr viewLon, viewLat, viewAlt;
 158     SGPropertyNode_ptr orientHeading, orientPitch, orientRoll;
 159 public:
 160
 161     FGGlobals();
 162     virtual ~FGGlobals();
 163
 164     virtual FGRenderer *get_renderer () const;
 165
 166     virtual SGSubsystemMgr *get_subsystem_mgr () const;
 167
 168     virtual SGSubsystem *get_subsystem (const char * name);
 169
 170     virtual void add_subsystem (const char * name,
 171                                 SGSubsystem * subsystem,
 172                                 SGSubsystemMgr::GroupType
 173                                 type = SGSubsystemMgr::GENERAL,
 174                                 double min_time_sec = 0);
 175
 176     virtual SGEventMgr *get_event_mgr () const;
 177
 178     virtual SGSoundMgr *get_soundmgr () const;
 179
 180     inline double get_sim_time_sec () const { return sim_time_sec; }
 181     inline void inc_sim_time_sec (double dt) { sim_time_sec += dt; }
 182     inline void set_sim_time_sec (double t) { sim_time_sec = t; }
 183
 184     inline const std::string &get_fg_root () const { return fg_root; }
 185     void set_fg_root (const std::string &root);
 186
 187     /**
 188      * Get list of data locations. fg_root is always the final item in the
 189      * result.
 190      */
 191     PathList get_data_paths() const;
 192
 193     /**
 194      * Get data locations which contain the file path suffix. Eg pass ing
 195      * 'AI/Traffic' to get all data paths which define <path>/AI/Traffic subdir
 196      */
 197     PathList get_data_paths(const std::string& suffix) const;
 198
 199     void append_data_path(const SGPath& path);
 200
 201     /**
 202      * Given a path suffix (eg 'Textures' or 'AI/Traffic'), find the
 203      * first data directory which defines it.
 204      */
 205     SGPath find_data_dir(const std::string& pathSuffix) const;
 206
 207     inline const std::string &get_fg_home () const { return fg_home; }
 208     void set_fg_home (const std::string &home);
 209
 210     inline const string_list &get_fg_scenery () const { return fg_scenery; }
 211     void append_fg_scenery (const std::string &scenery);
 212
 213     const string_list& get_aircraft_paths() const { return fg_aircraft_dirs; }
 214     void append_aircraft_path(const std::string& path);
 215     void append_aircraft_paths(const std::string& path);
 216
 217     /**
 218      * Given a path to an aircraft-related resource file, resolve it
 219      * against the appropriate root. This means looking at the location
 220      * defined by /sim/aircraft-dir, and then aircraft_path in turn,
 221      * finishing with fg_root/Aircraft.
 222      *
 223      * if the path could not be resolved, an empty path is returned.
 224      */
 225     SGPath resolve_aircraft_path(const std::string& branch) const;
 226
 227     /**
 228      * Same as above, but test for non 'Aircraft/' branch paths, and
 229      * always resolve them against fg_root.
 230      */
 231     SGPath resolve_maybe_aircraft_path(const std::string& branch) const;
 232
 233     /**
 234      * Search in the following directories:
 235      *
 236      *  1. Root directory of current aircraft (defined by /sim/aircraft-dir)
 237      *  2. All aircraft directories if branch starts with Aircraft/
 238      *  3. fg_data directory
 239      */
 240     SGPath resolve_resource_path(const std::string& branch) const;
 241
 242     inline const std::string &get_browser () const { return browser; }
 243     void set_browser (const std::string &b) { browser = b; }
 244
 245     long int get_warp() const;
 246     void set_warp( long int w );
 247
 248     long int get_warp_delta() const;
 249     void set_warp_delta( long int d );
 250
 251     inline SGTime *get_time_params() const { return time_params; }
 252     inline void set_time_params( SGTime *t ) { time_params = t; }
 253
 254     inline SGEphemeris *get_ephem() const { return ephem; }
 255     inline void set_ephem( SGEphemeris *e ) { ephem = e; }
 256
 257     inline SGMaterialLib *get_matlib() const { return matlib; }
 258     inline void set_matlib( SGMaterialLib *m ) { matlib = m; }
 259
 260     inline FGATISMgr *get_ATIS_mgr() const { return ATIS_mgr; }
 261     inline void set_ATIS_mgr( FGATISMgr *a ) {ATIS_mgr = a; }
 262
 263     inline FGControls *get_controls() const { return controls; }
 264     inline void set_controls( FGControls *c ) { controls = c; }
 265
 266     inline FGViewMgr *get_viewmgr() const { return viewmgr; }
 267     inline void set_viewmgr( FGViewMgr *vm ) { viewmgr = vm; }
 268     FGViewer *get_current_view() const;
 269
 270     inline SGPropertyNode *get_props () { return props; }
 271     inline void set_props( SGPropertyNode *n ) { props = n; }
 272
 273     inline FGLocale* get_locale () { return locale; }
 274
 275     inline SGCommandMgr *get_commands () { return commands; }
 276
 277     SGGeod get_aircraft_position() const;
 278
 279     SGVec3d get_aircraft_position_cart() const;
 280
 281     void get_aircraft_orientation(double& heading, double& pitch, double& roll);
 282
 283     SGGeod get_view_position() const;
 284
 285     SGVec3d get_view_position_cart() const;
 286
 287     inline string_list *get_channel_options_list () {
 288         return channel_options_list;
 289     }
 290     inline void set_channel_options_list( string_list *l ) {
 291         channel_options_list = l;
 292     }
 293
 294     inline string_list *get_initial_waypoints () {
 295         return initial_waypoints;
 296     }
 297
 298     inline void set_initial_waypoints (string_list *list) {
 299         initial_waypoints = list;
 300     }
 301
 302     inline FGScenery * get_scenery () const { return scenery; }
 303     inline void set_scenery ( FGScenery *s ) { scenery = s; }
 304
 305     inline FGTileMgr * get_tile_mgr () const { return tile_mgr; }
 306     inline void set_tile_mgr ( FGTileMgr *t ) { tile_mgr = t; }
 307
 308     inline FGFontCache *get_fontcache() const { return fontcache; }
 309
 310     inline FGTACANList *get_channellist() const { return channellist; }
 311     inline void set_channellist( FGTACANList *c ) { channellist = c; }
 312
 313    /**
 314      * Save the current state as the initial state.
 315      */
 316     void saveInitialState ();
 317
 318
 319     /**
 320      * Restore the saved initial state, if any.
 321      */
 322     void restoreInitialState ();
 323
 324     /**
 325      * Load user settings from autosave.xml
 326      */
 327     void loadUserSettings(const SGPath& datapath);
 328
 329     /**
 330      * Save user settings in autosave.xml
 331      */
 332     void saveUserSettings();
 333 };
 334
 335
 336 extern FGGlobals *globals;
 337
 338
 339 #endif // _GLOBALS_HXX