# include <config.h>
#endif
-#ifdef SG_MATH_EXCEPTION_CLASH
-# include <math.h>
-#endif
+#include <simgear/compiler.h>
+
+// #ifdef SG_MATH_EXCEPTION_CLASH
+// # include <math.h>
+// #endif
#ifdef HAVE_WINDOWS_H
# include <windows.h>
# include <float.h>
#endif
-#include <simgear/misc/props.hxx>
+#include STL_STRING
+SG_USING_STD(string);
+
+#include <vector>
+SG_USING_STD(vector);
+
+#include <map>
+SG_USING_STD(map);
+
+#include <simgear/props/props.hxx>
\f
* <pre>
* void MySubsystem::bind ()
* {
- * fgTie("/controls/elevator", &_elevator);
- * fgSetArchivable("/controls/elevator");
+ * fgTie("/controls/flight/elevator", &_elevator);
+ * fgSetArchivable("/controls/flight/elevator");
* }
*
* void MySubsystem::unbind ()
* {
- * fgUntie("/controls/elevator");
+ * fgUntie("/controls/flight/elevator");
* }
* </pre>
*
* in the constructor, so that FlightGear can control the
* initialization order.</p>
*/
- virtual void init () = 0;
+ virtual void init ();
+
+
+ /**
+ * Reinitialize the subsystem.
+ *
+ * <p>This method should cause the subsystem to reinitialize itself,
+ * and (normally) to reload any configuration files.</p>
+ */
+ virtual void reinit ();
/**
* publishes. It will be invoked after init, but before any
* invocations of update.</p>
*/
- virtual void bind () = 0;
+ virtual void bind ();
/**
* publishes. It will be invoked by FlightGear (not the destructor)
* just before the subsystem is removed.</p>
*/
- virtual void unbind () = 0;
+ virtual void unbind ();
/**
};
+\f
+/**
+ * A group of FlightGear subsystems.
+ */
+class FGSubsystemGroup : public FGSubsystem
+{
+public:
+
+ FGSubsystemGroup ();
+ virtual ~FGSubsystemGroup ();
+
+ virtual void init ();
+ virtual void reinit ();
+ virtual void bind ();
+ virtual void unbind ();
+ virtual void update (double delta_time_sec);
+ virtual void suspend ();
+ virtual void resume ();
+ virtual bool is_suspended () const;
+
+ virtual void set_subsystem (const string &name,
+ FGSubsystem * subsystem,
+ double min_step_sec = 0);
+ virtual FGSubsystem * get_subsystem (const string &name);
+ virtual void remove_subsystem (const string &name);
+ virtual bool has_subsystem (const string &name) const;
+
+private:
+
+ struct Member {
+
+ Member ();
+ Member (const Member &member);
+ virtual ~Member ();
+
+ virtual void update (double delta_time_sec);
+
+ string name;
+ FGSubsystem * subsystem;
+ double min_step_sec;
+ double elapsed_sec;
+ };
+
+ Member * get_member (const string &name, bool create = false);
+
+ vector<Member *> _members;
+};
+
+
+\f
+/**
+ * Manage subsystems for FlightGear.
+ *
+ * This top-level subsystem will eventually manage all of the
+ * subsystems in FlightGear: it broadcasts its life-cycle events
+ * (init, bind, etc.) to all of the subsystems it manages. Subsystems
+ * are grouped to guarantee order of initialization and execution --
+ * currently, the only two groups are INIT and GENERAL, but others
+ * will appear in the future.
+ *
+ * All subsystems are named as well as grouped, and subsystems can be
+ * looked up by name and cast to the appropriate subtype when another
+ * subsystem needs to invoke specialized methods.
+ *
+ * The subsystem manager owns the pointers to all the subsystems in
+ * it.
+ */
+class FGSubsystemMgr : public FGSubsystem
+{
+public:
+
+ /**
+ * Types of subsystem groups.
+ */
+ enum GroupType {
+ INIT = 0,
+ GENERAL,
+ MAX_GROUPS
+ };
+
+ FGSubsystemMgr ();
+ virtual ~FGSubsystemMgr ();
+
+ virtual void init ();
+ virtual void reinit ();
+ virtual void bind ();
+ virtual void unbind ();
+ virtual void update (double delta_time_sec);
+ virtual void suspend ();
+ virtual void resume ();
+ virtual bool is_suspended () const;
+
+ virtual void add (const char * name,
+ FGSubsystem * subsystem,
+ GroupType group = GENERAL,
+ double min_time_sec = 0);
+
+ virtual FGSubsystemGroup * get_group (GroupType group);
+
+ virtual FGSubsystem * get_subsystem(const string &name);
+
+private:
+
+ FGSubsystemGroup _groups[MAX_GROUPS];
+ map<string,FGSubsystem *> _subsystem_map;
+
+};
+
+
+
#endif // __FGFS_HXX
// end of fgfs.hxx