1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
|
/*
* Copyright (C) 2000-2001 the xine project
*
* This file is part of xine, a unix video player.
*
* xine 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; either version 2 of the License, or
* (at your option) any later version.
*
* xine 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 this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
*
* $Id: metronom.h,v 1.12 2001/10/18 18:50:53 guenter Exp $
*
* metronom: general pts => virtual calculation/assoc
*
* virtual pts: unit 1/90000 sec, always increasing
* can be used for synchronization
* video/audio frame with same pts also have same vpts
* but pts is likely to differ from vpts
*
*/
#ifndef HAVE_METRONOM_H
#define HAVE_METRONOM_H
#ifdef __cplusplus
extern "C" {
#endif
#include <inttypes.h>
#include <sys/time.h>
#include <pthread.h>
typedef struct metronom_s metronom_t ;
typedef struct scr_plugin_s scr_plugin_t;
struct metronom_s {
/*
* this is called to tell metronom to prepare for a new video stream
*/
void (*video_stream_start) (metronom_t *this);
void (*video_stream_end) (metronom_t *this);
/*
* this is called to tell metronom to prepare for a new audio stream
*/
void (*audio_stream_start) (metronom_t *this);
void (*audio_stream_end) (metronom_t *this);
/*
* called by video output driver to inform metronom about current framerate
*
* parameter pts_per_frame : frame display duration in 1/90000 sec
*/
void (*set_video_rate) (metronom_t *this, uint32_t pts_per_frame);
/*
* return current video rate (including delta corrections)
*/
uint32_t (*get_video_rate) (metronom_t *this);
/*
* called by audio output driver to inform metronom about current audio
* bitrate
*
* parameter pts_per_smpls : 1/90000 sec per 65536 samples
*/
void (*set_audio_rate) (metronom_t *this, uint32_t pts_per_smpls);
/*
* called by video output driver for *every* frame
*
* parameter pts: pts for frame if known, 0 otherwise
*
* return value: virtual pts for frame
*
*/
uint32_t (*got_video_frame) (metronom_t *this, uint32_t pts);
/*
* called by audio output driver whenever audio samples are delivered to it
*
* parameter pts : pts for audio data if known, 0 otherwise
* nsamples : number of samples delivered
*
* return value: virtual pts for audio data
*
*/
uint32_t (*got_audio_samples) (metronom_t *this, uint32_t pts, uint32_t nsamples);
/*
* inform metronom that there was a still image with no audio
*/
void (*got_audio_still) (metronom_t *this);
/*
* called by SPU decoder whenever a packet is delivered to it
*
* parameter pts : pts for SPU packet if known, 0 otherwise
*
* return value: virtual pts for SPU packet
*
*/
uint32_t (*got_spu_packet) (metronom_t *this, uint32_t pts, uint32_t duration);
/*
* manually correct audio <-> video sync
*/
void (*set_av_offset) (metronom_t *this, int32_t pts);
int32_t (*get_av_offset) (metronom_t *this);
/*
* tell metronom to expect a pts discontinuity
*/
void (*expect_audio_discontinuity) (metronom_t *this);
void (*expect_video_discontinuity) (metronom_t *this);
/*
* system clock reference (SCR) functions
*/
/*
* start metronom clock (no clock reset)
* at given pts
*/
void (*start_clock) (metronom_t *this, uint32_t pts);
/*
* stop metronom clock
*/
void (*stop_clock) (metronom_t *this);
/*
* resume clock from where it was stopped
*/
void (*resume_clock) (metronom_t *this);
/*
* get current clock value in vpts
*/
uint32_t (*get_current_time) (metronom_t *this);
/*
* adjust master clock to external timer (e.g. audio hardware)
*/
void (*adjust_clock) (metronom_t *this, uint32_t desired_pts);
/*
* set clock speed
* for constants see xine_internal.h
*/
int (*set_speed) (metronom_t *this, int speed);
/*
* (un)register a System Clock Reference provider at the metronom
*/
int (*register_scr) (metronom_t *this, scr_plugin_t *scr);
void (*unregister_scr) (metronom_t *this, scr_plugin_t *scr);
/*
* metronom internal stuff
*/
uint32_t pts_per_frame;
uint32_t pts_per_smpls;
int32_t audio_pts_delta;
uint32_t video_vpts;
uint32_t spu_vpts;
uint32_t audio_vpts;
int32_t video_wrap_offset;
int32_t audio_wrap_offset;
int wrap_diff_counter;
uint32_t last_video_pts;
int num_video_vpts_guessed;
int32_t video_pts_delta;
uint32_t last_audio_pts;
int num_audio_samples_guessed;
int32_t av_offset;
scr_plugin_t* scr_master;
scr_plugin_t** scr_list;
pthread_t sync_thread;
pthread_mutex_t lock;
int have_audio;
int video_stream_starting;
int video_stream_running;
int audio_stream_starting;
int audio_stream_running;
int video_discontinuity;
int audio_discontinuity;
pthread_cond_t video_started;
pthread_cond_t audio_started;
pthread_cond_t video_ended;
pthread_cond_t audio_ended;
};
metronom_t *metronom_init (int have_audio);
/*
* SCR plugins
*/
struct scr_plugin_s
{
int interface_version;
int (*get_priority) (scr_plugin_t *this);
/*
* set/get clock speed
*
* for speed constants see xine_internal.h
* returns actual speed
*/
int (*set_speed) (scr_plugin_t *this, int speed);
void (*adjust) (scr_plugin_t *this, uint32_t vpts);
void (*start) (scr_plugin_t *this, uint32_t start_vpts);
uint32_t (*get_current) (scr_plugin_t *this);
metronom_t *metronom;
};
#ifdef __cplusplus
}
#endif
#endif
|
