4 // Copyright (C) 2004 Tobias Glaesser <tobi.web@gmx.de>
6 // This program is free software; you can redistribute it and/or
7 // modify it under the terms of the GNU General Public License
8 // as published by the Free Software Foundation; either version 2
9 // of the License, or (at your option) any later version.
11 // This program is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 // GNU General Public License for more details.
16 // You should have received a copy of the GNU General Public License
17 // along with this program; if not, write to the Free Software
18 // Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
21 #ifndef SUPERTUX_TIMER_H
22 #define SUPERTUX_TIMER_H
27 extern unsigned int st_pause_ticks, st_pause_count;
29 /// Time a game is running. (Non-pause mode, etc.)
30 unsigned int st_get_ticks(void);
32 void st_pause_ticks_init(void);
33 void st_pause_ticks_start(void);
34 void st_pause_ticks_stop(void);
35 bool st_pause_ticks_started(void);
38 /** This class can be used as stop watch
39 for example. It's also possible to calculate
40 frames per seconds and things like that with it.
41 It's a general timing class, but it
42 can esspecially be used together with st_get_ticks(). */
48 unsigned int (*get_ticks) (void);
53 /// Initialize the timer.
54 /** @param st_ticks: If true internally st_get_ticks() is used, else SDL_GetTicks() is used. */
55 void init(bool st_ticks);
57 /// Start the timer with the given period (in ms).
58 void start(unsigned int period);
63 /// Check if the timer is started and within its period.
64 /** If one of these requirements isn't the case the timer
65 is automatically reseted. */
68 /// Is the timer started?
71 /// Get time left until the last timing period is finished.
72 /** The returned value can be negative. */
75 /// Get the gone time, since last timer start.
76 /** The returned value can be negative. */
79 /// Write the timer value to a file (For save games in example).
80 void fwrite(FILE* fi);
81 /// Read a timer value from a file (From save games in example).
85 } //namespace SuperTux
87 #endif /*SUPERTUX_TIMER_H*/
89 /* Local Variables: */