Files
openttd/src/timer/timer_manager.h
Jonathan G Rennison 2a31095118 Merge branch 'master' into jgrpp
# Conflicts:
#	regression/regression/result.txt
#	src/aircraft_cmd.cpp
#	src/airport_gui.cpp
#	src/articulated_vehicles.cpp
#	src/console_cmds.cpp
#	src/date_gui.cpp
#	src/engine.cpp
#	src/genworld_gui.cpp
#	src/gfx_layout_fallback.cpp
#	src/group_gui.cpp
#	src/hotkeys.cpp
#	src/network/core/tcp_connect.cpp
#	src/network/core/tcp_listen.h
#	src/newgrf.cpp
#	src/newgrf.h
#	src/newgrf_engine.cpp
#	src/newgrf_gui.cpp
#	src/newgrf_station.cpp
#	src/openttd.cpp
#	src/order_gui.cpp
#	src/os/macosx/osx_main.cpp
#	src/pathfinder/yapf/yapf_node_rail.hpp
#	src/rail_gui.cpp
#	src/saveload/afterload.cpp
#	src/saveload/cargopacket_sl.cpp
#	src/saveload/linkgraph_sl.cpp
#	src/saveload/station_sl.cpp
#	src/script/api/script_industrytype.cpp
#	src/settings.cpp
#	src/settings_gui.cpp
#	src/settings_table.cpp
#	src/settingsgen/settingsgen.cpp
#	src/station.cpp
#	src/station_cmd.cpp
#	src/strings.cpp
#	src/timer/timer_game_calendar.cpp
#	src/timer/timer_game_calendar.h
#	src/timer/timer_manager.h
#	src/timer/timer_window.cpp
#	src/timetable_cmd.cpp
#	src/toolbar_gui.cpp
#	src/town_cmd.cpp
#	src/town_gui.cpp
#	src/train_gui.cpp
#	src/vehicle_cmd.h
#	src/vehicle_gui.cpp
#	src/viewport.cpp
#	src/widgets/dropdown.cpp
#	src/window_func.h
#	src/window_gui.h
2023-11-25 13:30:06 +00:00

105 lines
3.1 KiB
C++

/*
* This file is part of OpenTTD.
* OpenTTD 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, version 2.
* OpenTTD 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 OpenTTD. If not, see <http://www.gnu.org/licenses/>.
*/
/** @file timer_manager.h Definition of the TimerManager */
/** @note don't include this file; include "timer.h". */
#ifndef TIMER_MANAGER_H
#define TIMER_MANAGER_H
#include "../stdafx.h"
#include <set>
template <typename TTimerType>
class BaseTimer;
/**
* The TimerManager manages a single Timer-type.
*
* It allows for automatic registration and unregistration of timers like Interval and OneShot.
*
* Each Timer-type needs to implement the Elapsed() method, and distribute that to the timers if needed.
*/
template <typename TTimerType>
class TimerManager {
public:
using TPeriod = typename TTimerType::TPeriod;
using TElapsed = typename TTimerType::TElapsed;
/* Avoid copying this object; it is a singleton object. */
TimerManager(TimerManager const &) = delete;
TimerManager &operator=(TimerManager const &) = delete;
/**
* Register a timer.
*
* @param timer The timer to register.
*/
static void RegisterTimer(BaseTimer<TTimerType> &timer) {
#ifdef WITH_ASSERT
Validate(timer.period);
#endif /* WITH_ASSERT */
GetTimers().insert(&timer);
}
/**
* Unregister a timer.
*
* @param timer The timer to unregister.
*/
static void UnregisterTimer(BaseTimer<TTimerType> &timer) {
GetTimers().erase(&timer);
}
#ifdef WITH_ASSERT
/**
* Validate that a new period is actually valid.
*
* For most timers this is not an issue, but some want to make sure their
* period is unique, to ensure deterministic game-play.
*
* This is meant purely to protect a developer from making a mistake.
* As such, assert() when validation fails.
*
* @param period The period to validate.
*/
static void Validate(TPeriod period);
#endif /* WITH_ASSERT */
/**
* Called when time for this timer elapsed.
*
* The implementation per type is different, but they all share a similar goal:
* Call the Elapsed() method of all active timers.
*
* @param value The amount of time that has elapsed.
*/
static void Elapsed(TElapsed value);
private:
/**
* Sorter for timers.
*
* It will sort based on the period, smaller first. If the period is the
* same, it will sort based on the pointer value.
*/
struct base_timer_sorter {
bool operator() (BaseTimer<TTimerType> *a, BaseTimer<TTimerType> *b) const {
if (a->period == b->period) return a < b;
return a->period < b->period;
}
};
/** Singleton list, to store all the active timers. */
static std::set<BaseTimer<TTimerType> *, base_timer_sorter> &GetTimers() {
static std::set<BaseTimer<TTimerType> *, base_timer_sorter> timers;
return timers;
}
};
#endif /* TIMER_MANAGER_H */