Files
love/src/modules/timer/Timer.h
T
2012-01-09 02:41:11 -06:00

86 lines
2.3 KiB
C++

/**
* Copyright (c) 2006-2012 LOVE Development Team
*
* This software is provided 'as-is', without any express or implied
* warranty. In no event will the authors be held liable for any damages
* arising from the use of this software.
*
* Permission is granted to anyone to use this software for any purpose,
* including commercial applications, and to alter it and redistribute it
* freely, subject to the following restrictions:
*
* 1. The origin of this software must not be misrepresented; you must not
* claim that you wrote the original software. If you use this software
* in a product, an acknowledgment in the product documentation would be
* appreciated but is not required.
* 2. Altered source versions must be plainly marked as such, and must not be
* misrepresented as being the original software.
* 3. This notice may not be removed or altered from any source distribution.
**/
#ifndef LOVE_TIMER_TIMER_H
#define LOVE_TIMER_TIMER_H
// LOVE
#include <common/Module.h>
namespace love
{
namespace timer
{
class Timer : public Module
{
public:
/**
* Destructor.
**/
virtual ~Timer(){}
/**
* Measures the time between this call and the previous call,
* and updates internal values accordinly.
**/
virtual void step() = 0;
/**
* Tries to sleep for the specified amount of time. The precision is
* usually 1ms.
* @param seconds The number of seconds to sleep for.
**/
virtual void sleep(double seconds) = 0;
/**
* Gets the time between the last two frames, assuming step is called
* each frame.
**/
virtual double getDelta() const = 0;
/**
* Gets the average FPS over the last second. Beucase the value is only updated
* once per second, it does not look erratic when displayed on screen.
* @return The "current" FPS.
**/
virtual double getFPS() const = 0;
/**
* Gets the amount of time since the program started. Only useful for timing
* code or measuring intervals.
* @return The time (in seconds) since the program started.
**/
virtual double getTime() const = 0;
/**
* Gets the amount of time passed since an unspecified time. The time is accurate
* to the microsecond, and is limited to 24 hours.
* @return The time (in seconds)
**/
virtual double getMicroTime() const = 0;
}; // Timer
} // timer
} // love
#endif // LOVE_TIMER_TIMER_H