Time/event.hxx

   1 // event.hxx -- Flight Gear periodic event scheduler
   2 //
   3 // Written by Curtis Olson, started December 1997.
   4 //
   5 // Copyright (C) 1997  Curtis L. Olson  - curt@infoplane.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 // (Log is kept at end of this file)
  23
  24
  25 #ifndef _EVENT_HXX
  26 #define _EVENT_HXX
  27
  28
  29 #ifndef __cplusplus
  30 # error This library requires C++
  31 #endif
  32
  33
  34 #include <Include/compiler.h>
  35 #include <Include/fg_callback.hxx>
  36
  37 #include <deque>        // STL double ended queue
  38 #include <list>         // STL list
  39 #include STL_STRING
  40
  41 #include "fg_time.hxx"
  42 #include "timestamp.hxx"
  43
  44 FG_USING_STD(deque);
  45 FG_USING_STD(list);
  46 FG_USING_STD(string);
  47
  48 #ifdef FG_HAVE_NATIVE_SGI_COMPILERS
  49 FG_USING_NAMESPACE(std);
  50 #endif
  51
  52 class fgEVENT
  53 {
  54 public:
  55     enum EventState
  56     {
  57         FG_EVENT_SUSP   = 0,
  58         FG_EVENT_READY  = 1,
  59         FG_EVENT_QUEUED = 2
  60     };
  61
  62     friend class fgEVENT_MGR;
  63
  64     fgEVENT() {} // Required by deque<>.
  65
  66     fgEVENT( const string& desc,
  67              const fgCallback& cb,
  68              EventState evt_status,
  69              int evt_interval );
  70
  71     ~fgEVENT();
  72
  73     void run();
  74
  75 //     void PrintStats() const;
  76     int PrintStats() const;
  77
  78 private:
  79     // not defined
  80     fgEVENT( const fgEVENT& evt );
  81     fgEVENT& operator= ( const fgEVENT& evt );
  82
  83 private:
  84
  85     string description;
  86
  87     // The callback object.
  88     fgCallback* event_cb;
  89
  90     EventState status;       // status flag
  91
  92     long interval;    // interval in ms between each iteration of this event
  93
  94     FGTimeStamp last_run;
  95     FGTimeStamp current;
  96     FGTimeStamp next_run;
  97
  98     long cum_time;    // cumulative processor time of this event
  99     long min_time;    // time of quickest execution
 100     long max_time;    // time of slowest execution
 101     long count;       // number of times executed
 102 };
 103
 104
 105 class fgEVENT_MGR {
 106
 107     // Event table
 108     typedef deque < fgEVENT* >             EventContainer;
 109     typedef EventContainer::iterator       EventIterator;
 110     typedef EventContainer::const_iterator ConstEventIterator;
 111
 112     EventContainer event_table;
 113
 114     // Run Queue
 115     typedef list < fgEVENT * > RunContainer;
 116
 117     RunContainer run_queue;
 118
 119 public:
 120
 121     // Constructor
 122     fgEVENT_MGR ( void );
 123
 124     // Initialize the scheduling subsystem
 125     void Init( void );
 126
 127     // Register an event with the scheduler
 128     void Register( const string& desc, void (*event)( void ),
 129                    fgEVENT::EventState status, int interval) {
 130         Register( desc, fgFunctionCallback(event), status, interval );
 131     }
 132
 133     void Register( const string& desc,
 134                    const fgCallback& cb,
 135                    fgEVENT::EventState status,
 136                    int interval );
 137
 138     // Update the scheduling parameters for an event
 139     void Update( void );
 140
 141     // Delete a scheduled event
 142     void Delete( void );
 143
 144     // Temporarily suspend scheduling of an event
 145     void Suspend( void );
 146
 147     // Resume scheduling and event
 148     void Resume( void );
 149
 150     // Dump scheduling stats
 151     void PrintStats( void );
 152
 153     // Add pending jobs to the run queue and run the job at the front
 154     // of the queue
 155     void Process( void );
 156
 157     // Destructor
 158     ~fgEVENT_MGR ( void );
 159 };
 160
 161
 162 // Wrapper to dump scheduling stats
 163 void fgEventPrintStats( void );
 164
 165 extern fgEVENT_MGR global_events;
 166
 167
 168 #endif // _EVENT_HXX
 169
 170
 171 // $Log$
 172 // Revision 1.17  1999/02/26 22:10:08  curt
 173 // Added initial support for native SGI compilers.
 174 //
 175 // Revision 1.16  1999/01/09 13:37:43  curt
 176 // Convert fgTIMESTAMP to FGTimeStamp which holds usec instead of ms.
 177 //
 178 // Revision 1.15  1999/01/07 20:25:33  curt
 179 // Portability changes and updates from Bernie Bright.
 180 //
 181 // Revision 1.14  1998/12/05 14:21:28  curt
 182 // Moved struct fg_timestamp to class fgTIMESTAMP and moved it's definition
 183 // to it's own file, timestamp.hxx.
 184 //
 185 // Revision 1.13  1998/12/04 01:32:47  curt
 186 // Converted "struct fg_timestamp" to "class fgTIMESTAMP" and added some
 187 // convenience inline operators.
 188 //
 189 // Revision 1.12  1998/10/16 00:56:08  curt
 190 // Converted to Point3D class.
 191 //
 192 // Revision 1.11  1998/09/15 02:09:30  curt
 193 // Include/fg_callback.hxx
 194 //   Moved code inline to stop g++ 2.7 from complaining.
 195 //
 196 // Simulator/Time/event.[ch]xx
 197 //   Changed return type of fgEVENT::printStat().  void caused g++ 2.7 to
 198 //   complain bitterly.
 199 //
 200 // Minor bugfix and changes.
 201 //
 202 // Simulator/Main/GLUTmain.cxx
 203 //   Added missing type to idle_state definition - eliminates a warning.
 204 //
 205 // Simulator/Main/fg_init.cxx
 206 //   Changes to airport lookup.
 207 //
 208 // Simulator/Main/options.cxx
 209 //   Uses fg_gzifstream when loading config file.
 210 //
 211 // Revision 1.10  1998/09/08 21:41:06  curt
 212 // Added constructor for fgEVENT.
 213 //
 214 // Revision 1.9  1998/09/02 14:37:45  curt
 215 // Renamed struct -> class.
 216 //
 217 // Revision 1.8  1998/08/29 13:11:32  curt
 218 // Bernie Bright writes:
 219 //   I've created some new classes to enable pointers-to-functions and
 220 //   pointers-to-class-methods to be treated like objects.  These objects
 221 //   can be registered with fgEVENT_MGR.
 222 //
 223 //   File "Include/fg_callback.hxx" contains the callback class defns.
 224 //
 225 //   Modified fgEVENT and fgEVENT_MGR to use the callback classes.  Also
 226 //   some minor tweaks to STL usage.
 227 //
 228 //   Added file "Include/fg_stl_config.h" to deal with STL portability
 229 //   issues.  I've added an initial config for egcs (and probably gcc-2.8.x).
 230 //   I don't have access to Visual C++ so I've left that for someone else.
 231 //   This file is influenced by the stl_config.h file delivered with egcs.
 232 //
 233 //   Added "Include/auto_ptr.hxx" which contains an implementation of the
 234 //   STL auto_ptr class which is not provided in all STL implementations
 235 //   and is needed to use the callback classes.
 236 //
 237 //   Deleted fgLightUpdate() which was just a wrapper to call
 238 //   fgLIGHT::Update().
 239 //
 240 //   Modified fg_init.cxx to register two method callbacks in place of the
 241 //   old wrapper functions.
 242 //
 243 // Revision 1.7  1998/07/30 23:48:54  curt
 244 // Sgi build tweaks.
 245 // Pause support.
 246 //
 247 // Revision 1.6  1998/07/24 21:42:25  curt
 248 // Output message tweaks.
 249 //
 250 // Revision 1.5  1998/07/13 21:02:07  curt
 251 // Wrote access functions for current fgOPTIONS.
 252 //
 253 // Revision 1.4  1998/06/12 00:59:52  curt
 254 // Build only static libraries.
 255 // Declare memmove/memset for Sloaris.
 256 // Rewrote fg_time.c routine to get LST start seconds to better handle
 257 //   Solaris, and be easier to port, and understand the GMT vs. local
 258 //   timezone issues.
 259 //
 260 // Revision 1.3  1998/06/03 00:48:12  curt
 261 // No .h for STL includes.
 262 //
 263 // Revision 1.2  1998/05/22 21:14:54  curt
 264 // Rewrote event.cxx in C++ as a class using STL for the internal event list
 265 // and run queue this removes the arbitrary list sizes and makes things much
 266 // more dynamic.  Because this is C++-classified we can now have multiple
 267 // event_tables if we'd ever want them.
 268 //
 269 // Revision 1.1  1998/04/24 00:52:26  curt
 270 // Wrapped "#include <config.h>" in "#ifdef HAVE_CONFIG_H"
 271 // Fog color fixes.
 272 // Separated out lighting calcs into their own file.
 273 //
 274 // Revision 1.4  1998/04/21 17:01:43  curt
 275 // Fixed a problems where a pointer to a function was being passed around.  In
 276 // one place this functions arguments were defined as ( void ) while in another
 277 // place they were defined as ( int ).  The correct answer was ( int ).
 278 //
 279 // Prepairing for C++ integration.
 280 //
 281 // Revision 1.3  1998/01/22 02:59:43  curt
 282 // Changed #ifdef FILE_H to #ifdef _FILE_H
 283 //
 284 // Revision 1.2  1998/01/19 18:40:39  curt
 285 // Tons of little changes to clean up the code and to remove fatal errors
 286 // when building with the c++ compiler.
 287 //
 288 // Revision 1.1  1997/12/30 04:19:22  curt
 289 // Initial revision.
 290