BansheeEngine/CamelotUtility/Include/CmTime.h

#pragma once

#include "CmPrerequisitesUtil.h"
#include "CmModule.h"

namespace CamelotFramework
{
	/**
	 * @brief	Manages all time related functionality
	 */
	class CM_UTILITY_EXPORT Time : public Module<Time>
	{
	public:
		Time();
		~Time();

		/**
		 * @brief	Gets the time elapsed since application start.
		 * 			Only gets updated once per frame.
		 *
		 * @return	The time since application start, in seconds.
		 */
		float getTime() const { return mTimeSinceStart; }

		/**
		 * @brief	Gets the time elapsed since application start.
		 * 			Only gets updated once per frame.
		 *
		 * @return	The time since application start, in miliseconds.
		 */
		UINT64 getTimeMs() const { return mTimeSinceStartMs; }

		/**
		 * @brief	Gets the time since last frame was executed.
		 * 			Only gets updated once per frame.
		 *
		 * @return	Time since last frame was executed, in seconds.
		 */
		float getFrameDelta() const { return mFrameDelta; }

		/**
		 * @brief	Returns the number of the current frame. First frame is 0.
		 *
		 * @return	The current frame.
		 */
		unsigned long getCurrentFrameNumber() const { return mCurrentFrame; }

		/**
		 * @brief	Returns the precise time since application start, in microseconds.
		 * 			Unlike other getTime methods this time is not only updated every frame,
		 * 			but will return exact time at the moment it is called.
		 * 			
		 * @note	You will generally only want to use this for performance measurements and similar.
		 * 			Use non-precise methods in majority of code as it is useful to keep the time value equal
		 * 			in all methods during a single frame.
		 *
		 * @return	Time in microseconds.
		 */
		UINT64 getTimePrecise() const;

		/**
		 * @brief	Gets the time at which the application was started, counting
		 * 			from system start.
		 *
		 * @return	The time since system to application start, in milliseconds.
		 */
		UINT64 getStartTimeMs() const { return mAppStartTime; }

		/**
		 * @brief	Called every frame. Should only be called by Application.
		 */
		void update();

	private:
		float mFrameDelta; // Frame delta in seconds
		float mTimeSinceStart; // Time since start in seconds
		UINT64 mTimeSinceStartMs;

		UINT64 mAppStartTime; // Time the application started, in microseconds
		unsigned long mLastFrameTime; // Time since last runOneFrame call, In microseconds
		unsigned long mCurrentFrame;

		Timer* mTimer;

		static const double MICROSEC_TO_SEC;
	};

	CM_UTILITY_EXPORT Time& gTime();
}