X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=simgear%2Fstructure%2Fsubsystem_mgr.hxx;h=a751d30699426c14561447c1acbd741e78421384;hb=f1f0fa0aa95c2f1562fa9c09365baf8b2b55bfc7;hp=cd612335b97e43a0ff2cd9da9ead7cdf19d9923d;hpb=d22640ef4e938b523bdc30cd83370977d30de856;p=simgear.git diff --git a/simgear/structure/subsystem_mgr.hxx b/simgear/structure/subsystem_mgr.hxx index cd612335..a751d306 100644 --- a/simgear/structure/subsystem_mgr.hxx +++ b/simgear/structure/subsystem_mgr.hxx @@ -14,7 +14,7 @@ // // 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., 675 Mass Ave, Cambridge, MA 02139, USA. +// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. // // $Id$ @@ -25,23 +25,35 @@ #include -#if 0 -#ifdef HAVE_WINDOWS_H -# include -# include -#endif - -#include STL_STRING -SG_USING_STD(string); - +#include +#include #include -SG_USING_STD(vector); -#endif -#include -SG_USING_STD(map); +using std::map; +using std::vector; +using std::string; #include +#include +#include "SGSmplstat.hxx" + + +class TimingInfo +{ +private: + string eventName; + SGTimeStamp time; + +public: + TimingInfo(const string& name, const SGTimeStamp &t) : + eventName(name), time(t) + { } + const string& getName() const { return eventName; } + const SGTimeStamp& getTime() const { return time; } +}; + +typedef vector eventTimeVec; +typedef vector::iterator eventTimeVecIterator; @@ -113,7 +125,7 @@ SG_USING_STD(map); * subsystems may also override the suspend() and resume() methods to * take different actions.

*/ -class SGSubsystem +class SGSubsystem : public SGReferenced { public: @@ -140,6 +152,18 @@ public: virtual void init (); + /** + * Initialize parts that depend on other subsystems having been initialized. + * + *

This method should set up all parts that depend on other + * subsystems. One example is the scripting/Nasal subsystem, which + * is initialized last. So, if a subsystem wants to execute Nasal + * code in subsystem-specific configuration files, it has to do that + * in its postinit() method.

+ */ + virtual void postinit (); + + /** * Reinitialize the subsystem. * @@ -224,10 +248,42 @@ public: virtual bool is_suspended () const; + /** + * Keep track of execution time. + * + *

This method keeps track of timing statistics for each subsystem.

+ * + * @param time execution time in ms of last call. + */ + void updateExecutionTime(double time); + + /** + * Print details of execution time. + * + *

For debugging purposes, developers can place stamp() calls + * at strategic points in the update() function of each subsystem, which + * record the time between the successive calls to stamp. This method, + * printExecutionTime() is called after exectution of the subsystem + * update function itself to conduct a post-hoc analysis of excecution + * time

+ */ + void printTimingInformation(); + + /** + * Place time stamps at strategic points in the execution of subsystems + * update() member functions. Predominantly for debugging purposes. + */ + void stamp(const string& name); + + + protected: bool _suspended; + eventTimeVec timingInfo; + //int test; + }; @@ -243,6 +299,7 @@ public: virtual ~SGSubsystemGroup (); virtual void init (); + virtual void postinit (); virtual void reinit (); virtual void bind (); virtual void unbind (); @@ -258,20 +315,31 @@ public: virtual void remove_subsystem (const string &name); virtual bool has_subsystem (const string &name) const; + void collectDebugTiming(bool collect); + private: - struct Member { + class Member { - Member (); + private: Member (const Member &member); + public: + Member (); virtual ~Member (); virtual void update (double delta_time_sec); + void printTimingInformation(double time); + void printTimingStatistics(); + void updateExecutionTime(double time); + double getTimeWarningThreshold(); + void collectDebugTiming (bool collect) { collectTimeStats = collect; }; + SampleStatistic timeStat; string name; SGSubsystem * subsystem; double min_step_sec; double elapsed_sec; + bool collectTimeStats; }; Member * get_member (const string &name, bool create = false); @@ -315,6 +383,7 @@ public: virtual ~SGSubsystemMgr (); virtual void init (); + virtual void postinit (); virtual void reinit (); virtual void bind (); virtual void unbind (); @@ -332,6 +401,8 @@ public: virtual SGSubsystem * get_subsystem(const string &name); + void collectDebugTiming(bool collect); + private: SGSubsystemGroup _groups[MAX_GROUPS];