X-Git-Url: http://git.tdb.fi/?p=libs%2Fcore.git;a=blobdiff_plain;f=source%2Ftime%2Ftimer.h;h=cfa00bb0d1511f42f09591b04dbc5527ee8deb91;hp=369a78c96e089a1e1413fe2a360b241b43b5f2b7;hb=3d1b0b44b2d75ed7d97b3588eefe61a9b511365c;hpb=e7638f74d3e4869020a19dfa1cc700d52373f01c diff --git a/source/time/timer.h b/source/time/timer.h index 369a78c..cfa00bb 100644 --- a/source/time/timer.h +++ b/source/time/timer.h @@ -3,14 +3,14 @@ This file is part of libmspcore Copyright © 2006 Mikko Rasa, Mikkosoft Productions Distributed under the LGPL */ + #ifndef MSP_TIME_TIMER_H_ #define MSP_TIME_TIMER_H_ -#include +#include #include #include "../core/mutex.h" #include "../core/semaphore.h" -#include "../core/thread.h" #include "timedelta.h" #include "timestamp.h" @@ -18,58 +18,65 @@ namespace Msp { namespace Time { /** -A class for executing functions periodically. Every time the timeout is -reached, signal_timeout will be emitted. If the functor connected to this -signal returns true, the timer is rescheduled by incrementing the timeout -by the interval. Otherwise the timer is canceled. +A class for executing functions in a deferred or periodical fashion. The add a +timer, use one of the add functions and connect a functor to the timeout signal +of the returned slot. -A separate thread is used for running the timers. All signal emissions will -happen in this thread - be careful with your variables. +This class is thread-safe, to allow running timers in a separate thread. */ class Timer { public: - sigc::signal signal_timeout; - - Timer(const Time::TimeDelta &); - const Time::TimeStamp &get_timeout() const { return timeout; } - ~Timer(); -private: - /** - A thread to run the timers independently of the rest of the program. - */ - class Thread: public Msp::Thread + class Slot { public: - Thread(); - void nudge(); - void finish(); + sigc::signal signal_timeout; + private: - bool done; - Semaphore sem; - - void main(); + TimeDelta interval; + TimeStamp timeout; + + public: + Slot(const TimeDelta &); + Slot(const TimeStamp &); + const TimeStamp &get_timeout() const { return timeout; } + bool increment(); + bool operator<(const Slot &) const; }; +private: + typedef bool (*fSlotCompare)(Slot *, Slot *); + + std::priority_queue, fSlotCompare> slots; + Semaphore sem; + Mutex mutex; + +public: + Timer(); + ~Timer(); + /** - Proxy class to handle automatic starting and termination of the thread. + Adds a timer that will be executed periodically as long as the timeout + signal hander returns true. */ - class ThreadProxy - { - public: - ThreadProxy(): thread(0) { } - void nudge(); - ~ThreadProxy(); - private: - Thread *thread; - }; + Slot &add(const TimeDelta &); - Time::TimeDelta interval; - Time::TimeStamp timeout; + /** + Adds a timer that will be executed once at a specific time. The return + value of the timeout signal handler is ignored. + */ + Slot &add(const TimeStamp &); + + /** + Checks all timers, executing any that have timed out. If block is true, + waits until one times out. - static ThreadProxy thread; - static Mutex set_mutex; - static std::set timers; + Note: If there are no active timers when a blocking tick is executed, it + won't return until a timer is added from another thread. + */ + void tick(bool block=true); +private: + static bool slot_compare(Slot *, Slot *); }; } // namespace Time