gavl
gavltime.h
1 /*****************************************************************
2  * gavl - a general purpose audio/video processing library
3  *
4  * Copyright (c) 2001 - 2012 Members of the Gmerlin project
5  * gmerlin-general@lists.sourceforge.net
6  * http://gmerlin.sourceforge.net
7  *
8  * This program is free software: you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation, either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program. If not, see <http://www.gnu.org/licenses/>.
20  * *****************************************************************/
21 
22 #ifndef GAVLTIME_H_INCLUDED
23 #define GAVLTIME_H_INCLUDED
24 
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 #include <inttypes.h>
30 #include <gavl/gavldefs.h>
31 
38 #define GAVL_TIME_SCALE 1000000
43 #define GAVL_TIME_UNDEFINED 0x8000000000000000LL
46 #define GAVL_TIME_MAX 0x7fffffffffffffffLL
53 typedef int64_t gavl_time_t;
54 
55 /* Utility functions */
56 
61 GAVL_PUBLIC
62 gavl_time_t gavl_samples_to_time(int samplerate, int64_t samples);
63 
71 GAVL_PUBLIC
72 int64_t gavl_time_to_samples(int samplerate, gavl_time_t time);
73 
78 GAVL_PUBLIC
79 gavl_time_t gavl_frames_to_time(int rate_num, int rate_den, int64_t frames);
80 
81 
90 GAVL_PUBLIC
91 int64_t gavl_time_to_frames(int rate_num, int rate_den, gavl_time_t time);
92 
100 GAVL_PUBLIC
101 int64_t gavl_time_scale(int scale, gavl_time_t time);
102 
110 GAVL_PUBLIC
111 gavl_time_t gavl_time_unscale(int scale, int64_t time);
112 
121 GAVL_PUBLIC
122 int64_t gavl_time_rescale(int scale1, int scale2, int64_t time);
123 
130 #define gavl_seconds_to_time(s) (gavl_time_t)((s)*(double)(GAVL_TIME_SCALE))
131 
138 #define gavl_time_to_seconds(t) ((double)(t)/(double)(GAVL_TIME_SCALE))
139 
145 GAVL_PUBLIC
147 
152 #define GAVL_TIME_STRING_LEN 11
153 
163 GAVL_PUBLIC void
165 
170 #define GAVL_TIME_STRING_LEN_MS 15
171 
183 GAVL_PUBLIC void
185 
186 GAVL_PUBLIC void
187 gavl_time_prettyprint_ms_full(gavl_time_t time, char str[GAVL_TIME_STRING_LEN_MS]);
188 
189 
190 /* Scan time: format is hhh:mm:ss with hh: hours, mm: minutes, ss: seconds. Seconds can be a fractional
191  value (i.e. with decimal point) */
192 
193 GAVL_PUBLIC
194 int gavl_time_parse(const char * str, gavl_time_t * ret);
195 
196 
197 /* Simple software timer */
198 
213 typedef struct gavl_timer_s gavl_timer_t;
214 
220 GAVL_PUBLIC
222 
230 GAVL_PUBLIC
232 
238 GAVL_PUBLIC
240 
246 GAVL_PUBLIC
248 
255 GAVL_PUBLIC
257 
264 GAVL_PUBLIC
266 
267 
274 GAVL_PUBLIC
276 
288 GAVL_PUBLIC
289 uint64_t gavl_benchmark_get_time(int flags);
290 
299 GAVL_PUBLIC
300 const char * gavl_benchmark_get_desc(int flags);
301 
302 
303 #ifdef __cplusplus
304 }
305 #endif
306 
307 #endif /* GAVLTIME_H_INCLUDED */
308 
#define GAVL_TIME_STRING_LEN_MS
Length of the string passed to gavl_time_prettyprint_ms.
Definition: gavltime.h:170
GAVL_PUBLIC int64_t gavl_time_to_frames(int rate_num, int rate_den, gavl_time_t time)
Convert a time to a number of video frames for a given framerate.
GAVL_PUBLIC void gavl_time_delay(gavl_time_t *time)
Sleep for a specified time.
#define GAVL_TIME_STRING_LEN
Length of the string passed to gavl_time_prettyprint.
Definition: gavltime.h:152
GAVL_PUBLIC gavl_time_t gavl_time_unscale(int scale, int64_t time)
Convert a time scaled by another base to a gavl time.
GAVL_PUBLIC gavl_time_t gavl_frames_to_time(int rate_num, int rate_den, int64_t frames)
Convert a number of video frames to a time for a given framerate.
GAVL_PUBLIC void gavl_time_prettyprint_ms(gavl_time_t time, char str[GAVL_TIME_STRING_LEN_MS])
Convert a time to a string with millisecond precision.
GAVL_PUBLIC gavl_time_t gavl_samples_to_time(int samplerate, int64_t samples)
Convert a number of samples to a time for a given samplerate.
GAVL_PUBLIC int64_t gavl_time_scale(int scale, gavl_time_t time)
Convert a gavl time to a time scaled by another base.
GAVL_PUBLIC int64_t gavl_time_rescale(int scale1, int scale2, int64_t time)
Convert a time scaled by one base to a time scaled by another base.
GAVL_PUBLIC int64_t gavl_time_to_samples(int samplerate, gavl_time_t time)
Convert a time to a number of audio samples for a given samplerate.
int64_t gavl_time_t
Times in gavl are 64 bit signed integers.
Definition: gavltime.h:53
GAVL_PUBLIC void gavl_time_prettyprint(gavl_time_t time, char str[GAVL_TIME_STRING_LEN])
Convert a time to a string.
GAVL_PUBLIC gavl_timer_t * gavl_timer_create()
Create a timer.
GAVL_PUBLIC int gavl_timer_is_running(gavl_timer_t *timer)
Check if a timer is running.
GAVL_PUBLIC void gavl_timer_stop(gavl_timer_t *timer)
Stop a timer.
GAVL_PUBLIC const char * gavl_benchmark_get_desc(int flags)
Get a description about the value returned by gavl_benchmark_get_time.
GAVL_PUBLIC void gavl_timer_destroy(gavl_timer_t *timer)
Destroy a timer.
GAVL_PUBLIC void gavl_timer_start(gavl_timer_t *timer)
Start a timer.
GAVL_PUBLIC uint64_t gavl_benchmark_get_time(int flags)
Get the current time for benchmarking.
GAVL_PUBLIC gavl_time_t gavl_timer_get(gavl_timer_t *timer)
Get the current time of the timer.
struct gavl_timer_s gavl_timer_t
Opaque timer structure.
Definition: gavltime.h:213
GAVL_PUBLIC void gavl_timer_set(gavl_timer_t *timer, gavl_time_t t)
Set the current time of the timer.