btQuickprof.h

Go to the documentation of this file.

/***************************************************************************************************
**
** Real-Time Hierarchical Profiling for Game Programming Gems 3
**
** by Greg Hjelstrom & Byon Garrabrant
**
***************************************************************************************************/

// Credits: The Clock class was inspired by the Timer classes in 
// Ogre (www.ogre3d.org).



#ifndef BT_QUICK_PROF_H
#define BT_QUICK_PROF_H

#include "btScalar.h"
#define USE_BT_CLOCK 1

#ifdef USE_BT_CLOCK

class btClock
{
public:
        btClock();

        btClock(const btClock& other);
        btClock& operator=(const btClock& other);

        ~btClock();

        void reset();

        unsigned long long int getTimeMilliseconds();

        unsigned long long int getTimeMicroseconds();
        
        unsigned long long int getTimeNanoseconds();

        btScalar getTimeSeconds();
        
private:
        struct btClockData* m_data;
};

#endif //USE_BT_CLOCK

typedef void (btEnterProfileZoneFunc)(const char* msg);
typedef void (btLeaveProfileZoneFunc)();

btEnterProfileZoneFunc* btGetCurrentEnterProfileZoneFunc();
btLeaveProfileZoneFunc* btGetCurrentLeaveProfileZoneFunc();



void btSetCustomEnterProfileZoneFunc(btEnterProfileZoneFunc* enterFunc);
void btSetCustomLeaveProfileZoneFunc(btLeaveProfileZoneFunc* leaveFunc);

#ifndef BT_NO_PROFILE // FIX redefinition
//To disable built-in profiling, please comment out next line
//#define BT_NO_PROFILE 1
#endif //BT_NO_PROFILE

const unsigned int BT_QUICKPROF_MAX_THREAD_COUNT = 64;

#ifndef BT_NO_PROFILE
//btQuickprofGetCurrentThreadIndex will return -1 if thread index cannot be determined, 
//otherwise returns thread index in range [0..maxThreads]
unsigned int btQuickprofGetCurrentThreadIndex2();

#include <stdio.h>//@todo remove this, backwards compatibility

#include "btAlignedAllocator.h"
#include <new>









class   CProfileNode {

public:
        CProfileNode( const char * name, CProfileNode * parent );
        ~CProfileNode( void );

        CProfileNode * Get_Sub_Node( const char * name );

        CProfileNode * Get_Parent( void )               { return Parent; }
        CProfileNode * Get_Sibling( void )              { return Sibling; }
        CProfileNode * Get_Child( void )                        { return Child; }

        void                            CleanupMemory();
        void                            Reset( void );
        void                            Call( void );
        bool                            Return( void );

        const char *    Get_Name( void )                                { return Name; }
        int                             Get_Total_Calls( void )         { return TotalCalls; }
        float                           Get_Total_Time( void )          { return TotalTime; }
        void*                   GetUserPointer() const {return m_userPtr;}
        void                    SetUserPointer(void* ptr) { m_userPtr = ptr;}
protected:

        const char *    Name;
        int                             TotalCalls;
        float                           TotalTime;
        unsigned long int                       StartTime;
        int                             RecursionCounter;

        CProfileNode *  Parent;
        CProfileNode *  Child;
        CProfileNode *  Sibling;
        void*   m_userPtr;
};

class CProfileIterator
{
public:
        // Access all the children of the current parent
        void                            First(void);
        void                            Next(void);
        bool                            Is_Done(void);
        bool                Is_Root(void) { return (CurrentParent->Get_Parent() == 0); }

        void                            Enter_Child( int index );               // Make the given child the new parent
        void                            Enter_Largest_Child( void );    // Make the largest child the new parent
        void                            Enter_Parent( void );                   // Make the current parent's parent the new parent

        // Access the current child
        const char *    Get_Current_Name( void )                        { return CurrentChild->Get_Name(); }
        int                             Get_Current_Total_Calls( void ) { return CurrentChild->Get_Total_Calls(); }
        float                           Get_Current_Total_Time( void )  { return CurrentChild->Get_Total_Time(); }

        void*   Get_Current_UserPointer( void )                 { return CurrentChild->GetUserPointer(); }
        void    Set_Current_UserPointer(void* ptr) {CurrentChild->SetUserPointer(ptr);}
        // Access the current parent
        const char *    Get_Current_Parent_Name( void )                 { return CurrentParent->Get_Name(); }
        int                             Get_Current_Parent_Total_Calls( void )  { return CurrentParent->Get_Total_Calls(); }
        float                           Get_Current_Parent_Total_Time( void )   { return CurrentParent->Get_Total_Time(); }

        

protected:

        CProfileNode *  CurrentParent;
        CProfileNode *  CurrentChild;
        

        CProfileIterator( CProfileNode * start );
        friend  class           CProfileManager;
};


class   CProfileManager {
public:
        static  void                                            Start_Profile( const char * name );
        static  void                                            Stop_Profile( void );

        static  void                                            CleanupMemory(void);
//      {
//              Root.CleanupMemory();
//      }

        static  void                                            Reset( void );
        static  void                                            Increment_Frame_Counter( void );
        static  int                                             Get_Frame_Count_Since_Reset( void )             { return FrameCounter; }
        static  float                                           Get_Time_Since_Reset( void );

        static  CProfileIterator *      Get_Iterator( void );   
//      { 
//              
//              return new CProfileIterator( &Root ); 
//      }
        static  void                                            Release_Iterator( CProfileIterator * iterator ) { delete ( iterator); }

        static void     dumpRecursive(CProfileIterator* profileIterator, int spacing);

        static void     dumpAll();

private:

        static  int                                             FrameCounter;
        static  unsigned long int                                       ResetTime;
};




#endif //#ifndef BT_NO_PROFILE

class   CProfileSample {
public:
        CProfileSample( const char * name );

        ~CProfileSample( void );
};

#define BT_PROFILE( name )                      CProfileSample __profile( name )



#endif //BT_QUICK_PROF_H