1 /* ScummVM - Graphic Adventure Engine
2  *
3  * ScummVM is the legal property of its developers, whose names
4  * are too numerous to list here. Please refer to the COPYRIGHT
5  * file distributed with this source distribution.
6  *
7  * This program is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU General Public License
9  * as published by the Free Software Foundation; either version 2
10  * of the License, or (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
20  *
21  */
22 
23 #ifndef AGS_ENGINE_AC_TIMER_H
24 #define AGS_ENGINE_AC_TIMER_H
25 
26 #include "ags/lib/std/type_traits.h"
27 #include "ags/lib/std/chrono.h"
28 #include "ags/lib/std/xtr1common.h"
29 
30 namespace AGS3 {
31 
32 // use high resolution clock only if we know it is monotonic/steady.
33 // refer to https://stackoverflow.com/a/38253266/84262
34 using AGS_Clock = std::conditional <
35                   std::chrono::high_resolution_clock::is_steady,
36                   std::chrono::high_resolution_clock, std::chrono::steady_clock
37                   >::type;
38 
39 // Sleeps for time remaining until the next game frame, updates next frame timestamp
40 extern void WaitForNextFrame();
41 
42 // Sets real FPS to the given number of frames per second; pass 1000+ for maxed FPS mode
43 extern void setTimerFps(int new_fps);
44 // Tells whether maxed FPS mode is currently set
45 extern bool isTimerFpsMaxed();
46 // If more than N frames, just skip all, start a fresh.
47 extern void skipMissedTicks();
48 
49 } // namespace AGS3
50 
51 #endif
52