/***************************************************************************
*   Copyright (C) 2005-2008 by the FIFE team                              *
*   http://www.fifengine.de                                               *
*   This file is part of FIFE.                                            *
*                                                                         *
*   FIFE is free software; you can redistribute it and/or modify          *
*   it under the terms of the GNU General Public License as published by  *
*   the Free Software Foundation; either version 2 of the License, or     *
*   (at your option) any later version.                                   *
*                                                                         *
*   This program is distributed in the hope that it will be useful,       *
*   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
*   GNU General Public License for more details.                          *
*                                                                         *
*   You should have received a copy of the GNU General Public License     *
*   along with this program; if not, write to the                         *
*   Free Software Foundation, Inc.,                                       *
*   51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA              *
***************************************************************************/

#ifndef FIFE_TIMER_H
#define FIFE_TIMER_H

// Standard C++ library includes

// 3rd party library includes
#include <boost/function.hpp>

// FIFE includes
// These includes are split up in two parts, separated by one empty line
// First block: files included from the FIFE root src directory
// Second block: files included from the same folder
#include "timeevent.h"

namespace FIFE {

	class TimerListener {
	public:
		virtual void onTimer() = 0;
		virtual ~TimerListener() {}
	};

	/** Simple Timer class
	 *
	 *  This is a simple wrapper around the TimeEvent,
	 *  which makes the later usable without having to
	 *  subclass it every time.
	 *
	 *  @example MemberUpdater
	 *  @code
	 *  m_timer.setInterval(1000);
	 *  m_timer.setCallback( boost::bind(&Class::update, this) );
	 *  m_timer.start();
	 *  @endcode
	 *
	 *  @warning Note that the callback must be available
	 *  when it is triggered. If your called function is a
	 *  bound member function and it goes out of scope,
	 *  when the callback is called you'll most likely
	 *  have a segfault. So this is best used as a member
	 *  calling an update function.
	 *
	 *  @note You don't have to call TimeManager::registerEvent @b ever
	 *
	 *  @see Console
	 */
	class Timer : protected TimeEvent {
	public:
		typedef boost::function0<void> type_callback;

		/** Default constructor.
		 *
		 *  Constructs an idle timer, use @see setInterval and @see setCallback
		 *  to set it up for use.
		 */
		Timer();

		/** Destructor.
		 *
		 *  Stops and destroys the timer.
		 */
		virtual ~Timer(); 

		/** Set the interval in milliseconds
		 *
		 *  @param msec The interval
		 *  If you use an intervall 0 the timer will fire every frame.
		 */
		void setInterval(unsigned long msec);

		/** Start the timer
		 *
		 * Without calling this function, nothing will happen.
		 * It is save to call this more than once.
		 */
		void start();

		/** Stop the timer
		 *
		 *  Stops execution of the callback
		 *  It is save to call this more than once.
		 */
		void stop();

		/** Set the callback that will be called
		 *
		 *  @param callback A @c boost::function0 returning void
		 */
		void setCallback(const type_callback& callback);

		/** Set the listener that will be called
		 *
		 */
		void setListener(TimerListener* listener);


	protected:
		bool m_active;
		type_callback m_callback;
		TimerListener* m_listener;
		void updateEvent(unsigned long);
	};

}//FIFE

#endif