globals.hxx

Go to the documentation of this file.

// globals.hxx -- Global state that needs to be shared among the sim modules
//
// Written by Curtis Olson, started July 2000.
//
// Copyright (C) 2000  Curtis L. Olson - http://www.flightgear.org/~curt
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License as
// published by the Free Software Foundation; either version 2 of the
// License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful, but
// WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
//
// $Id$
 
 
#ifndef _GLOBALS_HXX
#define _GLOBALS_HXX
 
#include <simgear/compiler.h>
#include <simgear/props/props.hxx>
#include <simgear/structure/subsystem_mgr.hxx>
#include <simgear/misc/sg_path.hxx>
 
#include <vector>
#include <string>
#include <memory>
 
typedef std::vector<std::string> string_list;
typedef std::vector<SGPath> PathList;
 
// Forward declarations
 
// This file is included, directly or indirectly, almost everywhere in
// FlightGear, so if any of its dependencies changes, most of the sim
// has to be recompiled.  Using these forward declarations helps us to
// avoid including a lot of header files (and thus, a lot of
// dependencies).  Since Most of the methods simply set or return
// pointers, we don't need to know anything about the class details
// anyway.
 
class SGCommandMgr;
class SGMaterialLib;
class SGPropertyNode;
class SGTime;
class SGEventMgr;
class SGSubsystemMgr;
class SGSubsystem;
 
class FGControls;
class FGTACANList;
class FGLocale;
class FGRouteMgr;
class FGScenery;
class FGViewMgr;
class FGRenderer;
 
namespace simgear { namespace pkg {
  class Root;
}}
 
namespace flightgear
{
    class View;
}

 
class FGGlobals
{
 
private:
 
    // properties, destroy last
    SGPropertyNode_ptr props;
 
    // localization
    FGLocale* locale;
 
    FGRenderer *renderer;
    SGSubsystemMgr *subsystem_mgr;
    SGEventMgr *event_mgr;
 
    // Number of milliseconds elapsed since the start of the program.
    double sim_time_sec;
 
    // Root of FlightGear data tree
    SGPath fg_root;

    PathList additional_data_paths;
 
    PathList _dataPathsAfterFGRoot; 
 
    // Users home directory for data
    SGPath fg_home;
 
    SGPath texture_cache_dir;
    // Download directory
    SGPath download_dir;
    // Terrasync directory
    SGPath terrasync_dir;
 
    // Roots of FlightGear scenery tree
    PathList fg_scenery;
    // Paths Nasal is allowed to read
    PathList extra_read_allowed_paths;
 
    std::string browser;
 
    // Time structure
    SGTime *time_params;
 
    // Material properties library
    SGSharedPtr<SGMaterialLib> matlib;
 
    SGCommandMgr *commands;
 
    // list of serial port-like configurations
    string_list *channel_options_list;
 
    // A list of initial waypoints that are read from the command line
    // and or flight-plan file during initialization
    string_list *initial_waypoints;
 
    // Navigational Aids
    FGTACANList *channellist;

    PathList fg_aircraft_dirs;
    SGPath catalog_aircraft_dir;
 
    bool haveUserSettings;
 
    SGPropertyNode_ptr positionLon, positionLat, positionAlt;
    SGPropertyNode_ptr viewLon, viewLat, viewAlt;
    SGPropertyNode_ptr orientHeading, orientPitch, orientRoll;
 
    SGPropertyNode_ptr referenceOffsetX, referenceOffsetY, referenceOffsetZ;

    void initProperties();
 
    void cleanupListeners();
 
    typedef std::vector<SGPropertyChangeListener*> SGPropertyChangeListenerVec;
    SGPropertyChangeListenerVec _listeners_to_cleanup;
 
    SGSharedPtr<simgear::pkg::Root> _packageRoot;
 
    SGSubsystem *get_subsystem (const char * name) const;
 
public:
 
    FGGlobals();
    virtual ~FGGlobals();
 
    virtual FGRenderer *get_renderer () const;
    void set_renderer(FGRenderer* render);
 
    SGSubsystemMgr *get_subsystem_mgr () const;
 
    template<class T>
    T* get_subsystem() const
    {
        return dynamic_cast<T*>(get_subsystem(T::staticSubsystemClassId()));
    }
 
 
    SGEventMgr *get_event_mgr () const;
 
    inline double get_sim_time_sec () const { return sim_time_sec; }
    inline void inc_sim_time_sec (double dt) { sim_time_sec += dt; }
    inline void set_sim_time_sec (double t) { sim_time_sec = t; }
 
    const SGPath &get_fg_root () const { return fg_root; }
    void set_fg_root(const SGPath&root);
    void set_texture_cache_dir(const SGPath&textureCache);

    PathList get_data_paths() const;

    PathList get_data_paths(const std::string& suffix) const;
 
    void append_data_path(const SGPath& path, bool afterFGRoot = false);

    SGPath findDataPath(const std::string& pathSuffix) const;
 
    const SGPath &get_fg_home () const { return fg_home; }
    void set_fg_home (const SGPath &home);
 
    const SGPath &get_download_dir () const { return download_dir; }
    // The 'path' argument to set_download_dir() must come from trustworthy
    // code, because the method grants read permissions to Nasal code for many
    // files beneath 'path'. In particular, don't call this method with a
    // 'path' value taken from the property tree or any other Nasal-writable
    // place.
    void set_download_dir (const SGPath &path);
 
    const SGPath &get_texture_cache_dir() const { return texture_cache_dir; }
 
    const SGPath &get_terrasync_dir () const { return terrasync_dir; }
    // The 'path' argument to set_terrasync_dir() must come from trustworthy
    // code, because the method grants read permissions to Nasal code for all
    // files beneath 'path'. In particular, don't call this method with a
    // 'path' value taken from the property tree or any other Nasal-writable
    // place.
    void set_terrasync_dir (const SGPath &path);
 
    const PathList &get_fg_scenery () const { return fg_scenery; }
    const PathList &get_extra_read_allowed_paths () const { return extra_read_allowed_paths; }
    void append_fg_scenery (const SGPath &scenery);
 
    void append_fg_scenery (const PathList &scenery);
 
    void clear_fg_scenery();

    void append_read_allowed_paths (const SGPath &path);

    void set_catalog_aircraft_path(const SGPath& path);
 
    PathList get_aircraft_paths() const;
    void append_aircraft_path(const SGPath& path);
    void append_aircraft_paths(const PathList& path);

    SGPath resolve_aircraft_path(const std::string& branch) const;

    SGPath resolve_maybe_aircraft_path(const std::string& branch) const;

    SGPath resolve_resource_path(const std::string& branch) const;
 
    inline const std::string &get_browser () const { return browser; }
    void set_browser (const std::string &b) { browser = b; }
 
    long int get_warp() const;
    void set_warp( long int w );
 
    long int get_warp_delta() const;
    void set_warp_delta( long int d );
 
    inline SGTime *get_time_params() const { return time_params; }
    inline void set_time_params( SGTime *t ) { time_params = t; }
 
    inline SGMaterialLib *get_matlib() const
    {
      return matlib;
    }
    void set_matlib( SGMaterialLib *m );
 
    inline SGPropertyNode *get_props () { return props; }

    void resetPropertyRoot();
 
    inline FGLocale* get_locale () { return locale; }
 
    inline SGCommandMgr *get_commands () { return commands; }
 
    SGGeod get_aircraft_position() const;
 
    SGVec3d get_aircraft_position_cart() const;
 
    void get_aircraft_orientation(double& heading, double& pitch, double& roll);
 
    SGGeod get_view_position() const;
 
    SGVec3d get_view_position_cart() const;
 
    SGVec3d get_ownship_reference_position_cart() const;
 
    inline string_list *get_channel_options_list () {
        return channel_options_list;
    }
    inline void set_channel_options_list( string_list *l ) {
        channel_options_list = l;
    }
 
    inline string_list *get_initial_waypoints () {
        return initial_waypoints;
    }
 
    inline void set_initial_waypoints (string_list *list) {
        initial_waypoints = list;
    }
 
    FGViewMgr *get_viewmgr() const;
    flightgear::View *get_current_view() const;
 
    FGControls *get_controls() const;
 
    FGScenery * get_scenery () const;
 
    inline FGTACANList *get_channellist() const { return channellist; }
    inline void set_channellist( FGTACANList *c ) { channellist = c; }

    SGPath autosaveFilePath(SGPath userDataPath = SGPath()) const;
    void loadUserSettings(SGPath userDatapath = SGPath());

    void saveUserSettings(SGPath userDatapath = SGPath());
 
    void addListenerToCleanup(SGPropertyChangeListener* l);
 
    simgear::pkg::Root* packageRoot();
    void setPackageRoot(const SGSharedPtr<simgear::pkg::Root>& p);

    bool is_headless();
    void set_headless(bool mode);
};
 
 
extern FGGlobals *globals;
 
 
#endif // _GLOBALS_HXX