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 #if defined ( __sun__ ) || defined ( __sgi )
  35 extern "C" void *memmove(void *, const void *, size_t);
  36 extern "C" void *memset(void *, int, size_t);
  37 #endif
  38
  39
  40 #include <deque>        // STL double ended queue
  41 #include <list>         // STL list
  42
  43 #ifdef NEEDNAMESPACESTD
  44 using namespace std;
  45 #endif
  46
  47 #include "fg_time.hxx"
  48
  49
  50 #define FG_EVENT_SUSP 0
  51 #define FG_EVENT_READY 1
  52 #define FG_EVENT_QUEUED 2
  53
  54
  55 typedef struct {
  56     char description[256];
  57
  58     void (*event)( void );  // pointer to function
  59     int status;       // status flag
  60
  61     long interval;    // interval in ms between each iteration of this event
  62
  63     fg_timestamp last_run;
  64     fg_timestamp current;
  65     fg_timestamp next_run;
  66
  67     long cum_time;    // cumulative processor time of this event
  68     long min_time;    // time of quickest execution
  69     long max_time;    // time of slowest execution
  70     long count;       // number of times executed
  71 } fgEVENT;
  72
  73
  74 class fgEVENT_MGR {
  75
  76     // Event table
  77     deque < fgEVENT > event_table;
  78
  79     // Run Queue
  80     list < fgEVENT * > run_queue;
  81
  82 public:
  83
  84     // Constructor
  85     fgEVENT_MGR ( void );
  86
  87     // Initialize the scheduling subsystem
  88     void Init( void );
  89
  90     // Register an event with the scheduler
  91     void Register(char *desc, void (*event)( void ), int status,
  92                          int interval);
  93
  94     // Update the scheduling parameters for an event
  95     void Update( void );
  96
  97     // Delete a scheduled event
  98     void Delete( void );
  99
 100     // Temporarily suspend scheduling of an event
 101     void Suspend( void );
 102
 103     // Resume scheduling and event
 104     void Resume( void );
 105
 106     // Dump scheduling stats
 107     void PrintStats( void );
 108
 109     // Add pending jobs to the run queue and run the job at the front
 110     // of the queue
 111     void Process( void );
 112
 113     // Destructor
 114     ~fgEVENT_MGR ( void );
 115 };
 116
 117
 118 // Wrapper to dump scheduling stats
 119 void fgEventPrintStats( void );
 120
 121 extern fgEVENT_MGR global_events;
 122
 123
 124 #endif // _EVENT_HXX
 125
 126
 127 // $Log$
 128 // Revision 1.7  1998/07/30 23:48:54  curt
 129 // Sgi build tweaks.
 130 // Pause support.
 131 //
 132 // Revision 1.6  1998/07/24 21:42:25  curt
 133 // Output message tweaks.
 134 //
 135 // Revision 1.5  1998/07/13 21:02:07  curt
 136 // Wrote access functions for current fgOPTIONS.
 137 //
 138 // Revision 1.4  1998/06/12 00:59:52  curt
 139 // Build only static libraries.
 140 // Declare memmove/memset for Sloaris.
 141 // Rewrote fg_time.c routine to get LST start seconds to better handle
 142 //   Solaris, and be easier to port, and understand the GMT vs. local
 143 //   timezone issues.
 144 //
 145 // Revision 1.3  1998/06/03 00:48:12  curt
 146 // No .h for STL includes.
 147 //
 148 // Revision 1.2  1998/05/22 21:14:54  curt
 149 // Rewrote event.cxx in C++ as a class using STL for the internal event list
 150 // and run queue this removes the arbitrary list sizes and makes things much
 151 // more dynamic.  Because this is C++-classified we can now have multiple
 152 // event_tables if we'd ever want them.
 153 //
 154 // Revision 1.1  1998/04/24 00:52:26  curt
 155 // Wrapped "#include <config.h>" in "#ifdef HAVE_CONFIG_H"
 156 // Fog color fixes.
 157 // Separated out lighting calcs into their own file.
 158 //
 159 // Revision 1.4  1998/04/21 17:01:43  curt
 160 // Fixed a problems where a pointer to a function was being passed around.  In
 161 // one place this functions arguments were defined as ( void ) while in another
 162 // place they were defined as ( int ).  The correct answer was ( int ).
 163 //
 164 // Prepairing for C++ integration.
 165 //
 166 // Revision 1.3  1998/01/22 02:59:43  curt
 167 // Changed #ifdef FILE_H to #ifdef _FILE_H
 168 //
 169 // Revision 1.2  1998/01/19 18:40:39  curt
 170 // Tons of little changes to clean up the code and to remove fatal errors
 171 // when building with the c++ compiler.
 172 //
 173 // Revision 1.1  1997/12/30 04:19:22  curt
 174 // Initial revision.
 175