PlatformTimer Class Reference

#include <PlatformTimer.h>

Inheritance diagram for PlatformTimer:

Public Member Functions
	PlatformTimer ()
	The Standard constructor.
virtual	~PlatformTimer ()
	The Standard destructor.
virtual void	Wait (unsigned long int msecs)
virtual void	Sleep (unsigned long int msecs)
virtual unsigned long int	GetTime () const
virtual void	GetTimeOfDay (unsigned long &secs, unsigned long &msecs)
virtual int	GetState (int iface) const
	PlatformTimer ()
virtual	~PlatformTimer ()
virtual void	Wait (unsigned long int msecs)
virtual void	Sleep (unsigned long int msecs)
virtual unsigned long int	GetTime () const
virtual void	GetTimeOfDay (unsigned long &secs, unsigned long &msecs)
virtual int	GetState (int iface) const
Public Member Functions inherited from PTimer
	PTimer ()
	The Standard constructor.
virtual	~PTimer ()
	The Standard destructor.
virtual PEBL_DEVICE_TYPE	GetDeviceType ()
Public Member Functions inherited from PDevice
	PDevice ()
	The Standard constructor.
virtual	~PDevice ()
	The Standard destructor.

Detailed Description

This device is the SDL-Specific interface for two types of platform functions: Querying the actual time, in msec, since the program started (which will wrap after a while) and waiting a specified period of time. It uses SDL function calls for this. For better accuracy, use system-specific timer calls,

Headless platform timer implementation using C++ chrono library This is a real implementation, not a stub, since timing is platform-independent

Definition at line 41 of file sdl/PlatformTimer.h.

Constructor & Destructor Documentation

PlatformTimer() [1/2]

PlatformTimer::PlatformTimer

(

)

The Standard constructor.

This is the standard PlatformTimer constructor.

Definition at line 57 of file sdl/PlatformTimer.cpp.

{
 
}

~PlatformTimer() [1/2]

PlatformTimer::~PlatformTimer ( )

virtual

The Standard destructor.

This is the standard pNode destructor.

Definition at line 63 of file sdl/PlatformTimer.cpp.

{
    // Standard Destructor
}

PlatformTimer() [2/2]

PlatformTimer::PlatformTimer

(

)

~PlatformTimer() [2/2]

virtual PlatformTimer::~PlatformTimer ( )

virtual

Member Function Documentation

GetState() [1/2]

int PlatformTimer::GetState ( int  iface ) const

virtual

Implements PTimer.

Definition at line 158 of file sdl/PlatformTimer.cpp.

{
    //There is no interface for the timer.
    return SDL_GetTicks();
}

GetState() [2/2]

virtual int PlatformTimer::GetState ( int  iface ) const

virtual

Implements PTimer.

GetTime() [1/2]

unsigned long int PlatformTimer::GetTime ( ) const

virtual

Implements PTimer.

Definition at line 153 of file sdl/PlatformTimer.cpp.

{
    return SDL_GetTicks();
}

Referenced by PEBLEnvironment::GetTime(), PEBLEnvironment::PlayMovie(), PEBLEnvironment::Wait(), PEBLEnvironment::WaitForAnyKeyDownWithTimeout(), PEBLEnvironment::WaitForAnyKeyPressWithTimeout(), PEBLEnvironment::WaitForListKeyPressWithTimeout(), and PEBLEnvironment::WaitForMouseButtonWithTimeout().

GetTime() [2/2]

virtual unsigned long int PlatformTimer::GetTime ( ) const

virtual

Implements PTimer.

GetTimeOfDay() [1/2]

void PlatformTimer::GetTimeOfDay ( unsigned long &  secs, unsigned long &  msecs  )

virtual

Implements PTimer.

Definition at line 171 of file sdl/PlatformTimer.cpp.

{
#if defined( PEBL_UNIX) || defined(PEBL_EMSCRIPTEN)
      struct timeval * tp=NULL;
       gettimeofday(tp,NULL);
 
       time_t        secs1 = tp->tv_sec;
       suseconds_t usecs  = tp->tv_usec;
 
    secs = secs1;
    msecs = usecs/100;
#else
 
   SYSTEMTIME st;
    ::GetSystemTime(&st);
 
 
    std::cerr << std::setw(2) << st.wHour << ':'
              << std::setw(2) << st.wMinute << ':'
              << std::setw(2) << st.wSecond << '.'
              << std::setw(3) << st.wMilliseconds << '\n';
 
//    return timeGetTime();
#endif
}

References NULL.

Referenced by PEBLEnvironment::GetTimeOfDay().

GetTimeOfDay() [2/2]

virtual void PlatformTimer::GetTimeOfDay ( unsigned long &  secs, unsigned long &  msecs  )

virtual

Implements PTimer.

Sleep() [1/2]

void PlatformTimer::Sleep ( unsigned long int  msecs )

virtual

Sleep using OS-specific sleep functions (yields CPU, unlike Wait which busy-waits) This is appropriate for polling loops, avoiding CPU burn

Implements PTimer.

Definition at line 132 of file sdl/PlatformTimer.cpp.

{
#ifdef PEBL_EMSCRIPTEN
    // Emscripten: yield to browser to allow browser events to be processed
    emscripten_sleep(msecs);
#elif defined(PEBL_UNIX)
    // Unix/Linux: nanosleep (high precision, yields CPU)
    struct timespec a, b;
    a.tv_sec = msecs / 1000;
    a.tv_nsec = (msecs % 1000) * 1000000;  // Convert remaining ms to nanoseconds
    nanosleep(&a, &b);
#elif defined(PEBL_WIN32) || defined(PEBL_WINDOWS)
    // Windows: SDL_Delay (yields CPU, ~1ms precision)
    SDL_Delay(msecs);
#else
    // Fallback: use SDL_Delay on unknown platforms
    SDL_Delay(msecs);
#endif
}

Referenced by PEventLoop::Loop(), and PEBLObjects::RecordToBuffer().

Sleep() [2/2]

virtual void PlatformTimer::Sleep ( unsigned long int  msecs )

virtual

Implements PTimer.

Wait() [1/2]

void PlatformTimer::Wait ( unsigned long int  msecs )

virtual

Implements PTimer.

Definition at line 73 of file sdl/PlatformTimer.cpp.

{
 
    //This should check for wrapping at ~49 days.
 
    unsigned long int timeX = SDL_GetTicks() + msecs;
    unsigned long int missedticks = 0;
    unsigned long int missedms = 0;
    unsigned long int lasttime = 0;
 
    unsigned long int time=SDL_GetTicks();
 
    while(true)
        {
            lasttime = time;
 
            time = SDL_GetTicks();
            if((time-lasttime) > 1)
                {
                    missedticks++;
                    missedms += (time-lasttime);
                }
 
 
            if(time > timeX)
                {
 
                    cerr << "Timer missed [" << missedticks << "] ticks, for a total of [" << missedms << "] ms, on a wait of [" << msecs <<"] ms.\n";
                    break;
                }
        }
}
#else
{
    //This does a busy wait; could be augmented with interrupts or RTC calls if necessary.
    //This should check for wrapping at ~49 days.
 
    unsigned long int timeX = SDL_GetTicks() + msecs;
    unsigned long int time;
 
    while(true)
        {
            time = SDL_GetTicks();
            if(time > timeX)
                break;
 
        }
}

Wait() [2/2]

virtual void PlatformTimer::Wait ( unsigned long int  msecs )

virtual

Implements PTimer.

---

The documentation for this class was generated from the following files:

• sdl/PlatformTimer.h
• validator/PlatformTimer.h
• sdl/PlatformTimer.cpp
• validator/PlatformTimer.cpp