/*
    *
============================================================================
    *  Name     : CGameTimer.h
    *  Part of  : Example3D
    *  Created  : 12/14/2003 by Forum Nokia
    *  Description:
    *     This is the project specification file for Example3D.
    *     Initial content was generated by Series 60 AppWizard.
    *
    *  Version  : 1.0.0
    *  Copyright: Forum Nokia
    *
============================================================================
    */

#ifndef __CGAMETIMER_H__
#define __CGAMETIMER_H__


// INCLUDES
#include <e32base.h>

   
// FORWARD DECLARATIONS
class MGameTimerObserver;

// CLASS DECLARATION

/**
*  CGameTimer's purpose is to give all possible
*  processing time to CEngine without stalling
*  the operating system
*/

class CGameTimer 
	: public CBase
	{
	public:
		/// Two-phased constructor
		static CGameTimer* NewL( MGameTimerObserver& aObserver );

		/// Two-phased constructor
		/// leaves pointer to cleanup stack
		static CGameTimer* NewLC( MGameTimerObserver& aObserver );

		/// Destructor
		~CGameTimer();

	private:

		/// Second-phase constructor
		void ConstructL();

		/// Default constructor
		CGameTimer( MGameTimerObserver& aObserver );

	public: // New methods:

		/// Starts timer
		void Start();

		/// Cancels timer
		void Cancel();

	private: // Private methods

		/// Callback called by CIdle member
		static TInt IdleCallBack( TAny* aPtr );

		/// Called by IdleCallBack
		/// @return boolean ETrue continues timer, EFalse stops.
		TInt DoCall();

	private: // data

		MGameTimerObserver& iObserver;	// reference to timer observer ( CEngine )
		CIdle*	iIdle;					// CIdle timer

	};

#endif