1 /*****************************************************************************
2 * mtime.c: high resolution time management functions
3 * Functions are prototyped in vlc_mtime.h.
4 *****************************************************************************
5 * Copyright (C) 1998-2007 VLC authors and VideoLAN
6 * Copyright © 2006-2007 Rémi Denis-Courmont
9 * Authors: Vincent Seguin <seguin@via.ecp.fr>
10 * Rémi Denis-Courmont <rem$videolan,org>
13 * This program is free software; you can redistribute it and/or modify it
14 * under the terms of the GNU Lesser General Public License as published by
15 * the Free Software Foundation; either version 2.1 of the License, or
16 * (at your option) any later version.
18 * This program is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU Lesser General Public License for more details.
23 * You should have received a copy of the GNU Lesser General Public License
24 * along with this program; if not, write to the Free Software Foundation,
25 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
26 *****************************************************************************/
28 /*****************************************************************************
30 *****************************************************************************/
36 #include <vlc_common.h>
42 #if !defined (_POSIX_TIMERS)
43 # define _POSIX_TIMERS (-1)
45 #if (_POSIX_TIMERS > 0)
46 # include <time.h> /* clock_gettime() */
48 # include <sys/time.h>
52 * Return a date in a readable format
54 * This function converts a mtime date into a string.
55 * psz_buffer should be a buffer long enough to store the formatted
57 * \param date to be converted
58 * \param psz_buffer should be a buffer at least MSTRTIME_MAX_SIZE characters
59 * \return psz_buffer is returned so this can be used as printf parameter.
61 char *mstrtime( char *psz_buffer
, mtime_t date
)
63 static const mtime_t ll1000
= 1000, ll60
= 60, ll24
= 24;
65 snprintf( psz_buffer
, MSTRTIME_MAX_SIZE
, "%02d:%02d:%02d-%03d.%03d",
66 (int) (date
/ (ll1000
* ll1000
* ll60
* ll60
) % ll24
),
67 (int) (date
/ (ll1000
* ll1000
* ll60
) % ll60
),
68 (int) (date
/ (ll1000
* ll1000
) % ll60
),
69 (int) (date
/ ll1000
% ll1000
),
70 (int) (date
% ll1000
) );
75 * Convert seconds to a time in the format h:mm:ss.
77 * This function is provided for any interface function which need to print a
78 * time string in the format h:mm:ss
80 * \param secs the date to be converted
81 * \param psz_buffer should be a buffer at least MSTRTIME_MAX_SIZE characters
82 * \return psz_buffer is returned so this can be used as printf parameter.
84 char *secstotimestr( char *psz_buffer
, int32_t i_seconds
)
86 if( unlikely(i_seconds
< 0) )
88 secstotimestr( psz_buffer
+ 1, -i_seconds
);
95 d
= div( i_seconds
, 60 );
97 d
= div( d
.quot
, 60 );
100 snprintf( psz_buffer
, MSTRTIME_MAX_SIZE
, "%u:%02u:%02u",
101 d
.quot
, d
.rem
, i_seconds
);
103 snprintf( psz_buffer
, MSTRTIME_MAX_SIZE
, "%02u:%02u",
109 * Date management (internal and external)
113 * Initialize a date_t.
115 * \param date to initialize
116 * \param divider (sample rate) numerator
117 * \param divider (sample rate) denominator
120 void date_Init( date_t
*p_date
, uint32_t i_divider_n
, uint32_t i_divider_d
)
123 p_date
->i_divider_num
= i_divider_n
;
124 p_date
->i_divider_den
= i_divider_d
;
125 p_date
->i_remainder
= 0;
131 * \param date to change
132 * \param divider (sample rate) numerator
133 * \param divider (sample rate) denominator
136 void date_Change( date_t
*p_date
, uint32_t i_divider_n
, uint32_t i_divider_d
)
138 /* change time scale of remainder */
139 p_date
->i_remainder
= p_date
->i_remainder
* i_divider_n
/ p_date
->i_divider_num
;
140 p_date
->i_divider_num
= i_divider_n
;
141 p_date
->i_divider_den
= i_divider_d
;
145 * Set the date value of a date_t.
150 void date_Set( date_t
*p_date
, mtime_t i_new_date
)
152 p_date
->date
= i_new_date
;
153 p_date
->i_remainder
= 0;
157 * Get the date of a date_t
162 mtime_t
date_Get( const date_t
*p_date
)
168 * Move forwards or backwards the date of a date_t.
170 * \param date to move
171 * \param difference value
173 void date_Move( date_t
*p_date
, mtime_t i_difference
)
175 p_date
->date
+= i_difference
;
179 * Increment the date and return the result, taking into account
182 * \param date to increment
183 * \param incrementation in number of samples
186 mtime_t
date_Increment( date_t
*p_date
, uint32_t i_nb_samples
)
188 mtime_t i_dividend
= i_nb_samples
* CLOCK_FREQ
* p_date
->i_divider_den
;
189 lldiv_t d
= lldiv( i_dividend
, p_date
->i_divider_num
);
191 p_date
->date
+= d
.quot
;
192 p_date
->i_remainder
+= (int)d
.rem
;
194 if( p_date
->i_remainder
>= p_date
->i_divider_num
)
196 /* This is Bresenham algorithm. */
197 assert( p_date
->i_remainder
< 2*p_date
->i_divider_num
);
199 p_date
->i_remainder
-= p_date
->i_divider_num
;
206 * Decrement the date and return the result, taking into account
209 * \param date to decrement
210 * \param decrementation in number of samples
213 mtime_t
date_Decrement( date_t
*p_date
, uint32_t i_nb_samples
)
215 mtime_t i_dividend
= (mtime_t
)i_nb_samples
* 1000000 * p_date
->i_divider_den
;
216 p_date
->date
-= i_dividend
/ p_date
->i_divider_num
;
217 unsigned i_rem_adjust
= i_dividend
% p_date
->i_divider_num
;
219 if( p_date
->i_remainder
< i_rem_adjust
)
221 /* This is Bresenham algorithm. */
222 assert( p_date
->i_remainder
> -p_date
->i_divider_num
);
224 p_date
->i_remainder
+= p_date
->i_divider_num
;
227 p_date
->i_remainder
-= i_rem_adjust
;
233 * @return NTP 64-bits timestamp in host byte order.
235 uint64_t NTPtime64 (void)
237 #if (_POSIX_TIMERS > 0)
240 clock_gettime (CLOCK_REALTIME
, &ts
);
249 gettimeofday (&tv
, NULL
);
250 ts
.tv_sec
= tv
.tv_sec
;
251 ts
.tv_nsec
= tv
.tv_usec
* 1000;
254 /* Convert nanoseconds to 32-bits fraction (232 picosecond units) */
255 uint64_t t
= (uint64_t)(ts
.tv_nsec
) << 32;
259 /* There is 70 years (incl. 17 leap ones) offset to the Unix Epoch.
260 * No leap seconds during that period since they were not invented yet.
262 assert (t
< 0x100000000);
263 t
|= ((70LL * 365 + 17) * 24 * 60 * 60 + ts
.tv_sec
) << 32;