X-Git-Url: http://git.localhorst.tv/?a=blobdiff_plain;f=src%2Fapp%2FTimer.h;h=d744fe09966cc203e76982695a1824e05946ed14;hb=7b3710c47f24e64e0d01378a4564730bcb2f6ef2;hp=13f48f3d7d38ec884c38234fc4fdc7355e1f990c;hpb=24369a427910299e6ebf5167279dcb26ae0cdf9a;p=l2e.git

diff --git a/src/app/Timer.h b/src/app/Timer.h
index 13f48f3..d744fe0 100644
--- a/src/app/Timer.h
+++ b/src/app/Timer.h
@@ -1,10 +1,3 @@
-/*
- * Timer.h
- *
- *  Created on: Aug 10, 2012
- *      Author: holy
- */
-
 #ifndef APP_TIMER_H_
 #define APP_TIMER_H_
 
@@ -14,6 +7,8 @@
 
 namespace app {
 
+/// Stores timing information.
+/// For use by app::Timer.
 template<class Time>
 struct TimerData {
 
@@ -29,6 +24,9 @@ struct TimerData {
 };
 
 
+/// Timer handle.
+/// How the various information returned by the const member functions is to be
+/// interpreted highly depends on how the timer was created (by app::Timers).
 template<class Time>
 class Timer {
 
@@ -48,37 +46,62 @@ public:
 	}
 
 public:
+	/// Check if the timer was started (and not cleared) yet.
 	bool Started() const {
 		return data;
 	}
+	/// Check if the timer has reached its target time (only sensible for
+	/// countdown timers).
 	bool Finished() const {
 		return data && data->target != Time() && !data->repeat && data->time >= data->target;
 	}
+	/// Check if the timer was started and has not finished yet (in case it's a
+	/// countdown).
 	bool Running() const {
 		return data && !Finished();
 	}
+	/// Get the elapsed time since the timer started.
 	Time Elapsed() const {
 		return data ? data->time : Time();
 	}
+	/// Get the time remaining for countdowns.
 	Time Remaining() const {
 		return data ? (data->target - data->time) : Time();
 	}
+	/// Time from start to hit.
+	Time TargetTime() const {
+		return data ? data->target : Time();
+	}
+	/// Get the elapsed time since the timer started or last hit.
+	Time IterationElapsed() const {
+		return data ? data->time % data->target : Time();
+	}
+	/// Get the remaining time in this iteration.
+	Time IterationRemaining() const {
+		return TargetTime() - IterationElapsed();
+	}
+	/// Get the iteration index for interval timers.
 	int Iteration() const {
 		return (data && data->target > Time()) ? std::floor(data->time / data->target) : Time();
 	}
+	/// Check if the timer reached its interval or countdown goal this iteration.
 	bool JustHit() const {
 		return data && data->justHit;
 	}
 
+	/// Unset the timer (does not stop other handles for a shared timer).
 	void Clear() {
 		if (data) {
 			--data->refCount;
 			data = 0;
 		}
 	}
+	/// Reset the timer, do not stop it if it's running.
 	void Reset() {
 		if (data) data->time = Time();
 	}
+	/// Restart the timer.
+	/// Only works if the timer was started at least once.
 	void Restart() {
 		if (data) {
 			if (data->target > Time() && data->justHit) {
@@ -95,6 +118,7 @@ private:
 };
 
 
+/// Tracker for timers, responsible for creating and updating them.
 template<class Time>
 class Timers {
 
@@ -102,6 +126,7 @@ public:
 	Timers() { }
 
 public:
+	/// Move all timers forward by delta.
 	void Update(Time delta) {
 		for (typename std::list<TimerData<Time> >::iterator i(data.begin()), end(data.end()); i != end;) {
 			if (i->target > 0) {
@@ -117,14 +142,19 @@ public:
 			}
 		}
 	}
+	/// Start a timer that counts elapsed time until stopped manually.
 	Timer<Time> StartTimer() {
 		data.push_back(TimerData<Time>());
 		return Timer<Time>(&data.back());
 	}
+	/// Start a countdown that hits (JustHit() returing true) when duration
+	/// elapsed.
 	Timer<Time> StartCountdown(Time duration) {
 		data.push_back(TimerData<Time>(duration, false));
 		return Timer<Time>(&data.back());
 	}
+	/// Start an interval timer that hits (JustHit() returning true) each time
+	/// duration has passed.
 	Timer<Time> StartInterval(Time duration) {
 		data.push_back(TimerData<Time>(duration, true));
 		return Timer<Time>(&data.back());
@@ -137,4 +167,4 @@ private:
 
 }
 
-#endif /* APP_TIMER_H_ */
+#endif