]> git.sesse.net Git - vlc/blob - src/input/input_internal.h
Small code factorization
[vlc] / src / input / input_internal.h
1 /*****************************************************************************
2  * input_internal.h: Internal input structures
3  *****************************************************************************
4  * Copyright (C) 1998-2006 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Laurent Aimar <fenrir@via.ecp.fr>
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22  *****************************************************************************/
23
24 #if defined(__PLUGIN__) || defined(__BUILTIN__) || !defined(__LIBVLC__)
25 # error This header file can only be included from LibVLC.
26 #endif
27
28 #ifndef _INPUT_INTERNAL_H
29 #define _INPUT_INTERNAL_H 1
30
31 #include <vlc_access.h>
32 #include <vlc_demux.h>
33 #include <vlc_input.h>
34
35 /*****************************************************************************
36  *  Private input fields
37  *****************************************************************************/
38 /* input_source_t: gathers all information per input source */
39 typedef struct
40 {
41     /* Input item description */
42     input_item_t *p_item;
43
44     /* Access/Stream/Demux plugins */
45     access_t *p_access;
46     stream_t *p_stream;
47     demux_t  *p_demux;
48
49     /* Title infos for that input */
50     bool         b_title_demux; /* Titles/Seekpoints provided by demux */
51     int          i_title;
52     input_title_t **title;
53
54     int i_title_offset;
55     int i_seekpoint_offset;
56
57     int i_title_start;
58     int i_title_end;
59     int i_seekpoint_start;
60     int i_seekpoint_end;
61
62     /* Properties */
63     bool b_can_pause;
64     bool b_can_pace_control;
65     bool b_can_rate_control;
66     bool b_rescale_ts;
67
68     bool       b_eof;   /* eof of demuxer */
69     double     f_fps;
70
71     /* Clock average variation */
72     int     i_cr_average;
73
74 } input_source_t;
75
76 /** Private input fields */
77 struct input_thread_private_t
78 {
79     /* Object's event manager */
80     vlc_event_manager_t event_manager;
81
82     /* Global properties */
83     bool        b_can_pause;
84     bool        b_can_rate_control;
85
86     int         i_rate;
87     /* */
88     int64_t     i_start;    /* :start-time,0 by default */
89     int64_t     i_stop;     /* :stop-time, 0 if none */
90     int64_t     i_run;      /* :run-time, 0 if none */
91
92     /* Title infos FIXME multi-input (not easy) ? */
93     int          i_title;
94     input_title_t **title;
95
96     int i_title_offset;
97     int i_seekpoint_offset;
98
99     /* User bookmarks FIXME won't be easy with multiples input */
100     int         i_bookmark;
101     seekpoint_t **bookmark;
102
103     /* Input attachment */
104     int i_attachment;
105     input_attachment_t **attachment;
106
107     /* Output */
108     es_out_t        *p_es_out;
109     sout_instance_t *p_sout;            /* XXX Move it to es_out ? */
110     bool            b_out_pace_control; /*     idem ? */
111
112     /* Main input properties */
113     input_source_t input;
114     /* Slave demuxers (subs, and others) */
115     int            i_slave;
116     input_source_t **slave;
117
118     /* pts delay fixup */
119     struct {
120         int  i_num_faulty;
121         bool to_high;
122         bool auto_adjust;
123     } pts_adjust;
124
125     /* Stats counters */
126     struct {
127         counter_t *p_read_packets;
128         counter_t *p_read_bytes;
129         counter_t *p_input_bitrate;
130         counter_t *p_demux_read;
131         counter_t *p_demux_bitrate;
132         counter_t *p_decoded_audio;
133         counter_t *p_decoded_video;
134         counter_t *p_decoded_sub;
135         counter_t *p_sout_sent_packets;
136         counter_t *p_sout_sent_bytes;
137         counter_t *p_sout_send_bitrate;
138         counter_t *p_played_abuffers;
139         counter_t *p_lost_abuffers;
140         counter_t *p_displayed_pictures;
141         counter_t *p_lost_pictures;
142         vlc_mutex_t counters_lock;
143     } counters;
144
145     /* Buffer of pending actions */
146     vlc_mutex_t lock_control;
147     int i_control;
148     struct
149     {
150         /* XXX for string value you have to allocate it before calling
151          * input_ControlPush */
152         int         i_type;
153         vlc_value_t val;
154     } control[INPUT_CONTROL_FIFO_SIZE];
155 };
156
157 /***************************************************************************
158  * Internal control helpers
159  ***************************************************************************/
160 enum input_control_e
161 {
162     INPUT_CONTROL_SET_DIE,
163
164     INPUT_CONTROL_SET_STATE,
165
166     INPUT_CONTROL_SET_RATE,
167     INPUT_CONTROL_SET_RATE_SLOWER,
168     INPUT_CONTROL_SET_RATE_FASTER,
169
170     INPUT_CONTROL_SET_POSITION,
171     INPUT_CONTROL_SET_POSITION_OFFSET,
172
173     INPUT_CONTROL_SET_TIME,
174     INPUT_CONTROL_SET_TIME_OFFSET,
175
176     INPUT_CONTROL_SET_PROGRAM,
177
178     INPUT_CONTROL_SET_TITLE,
179     INPUT_CONTROL_SET_TITLE_NEXT,
180     INPUT_CONTROL_SET_TITLE_PREV,
181
182     INPUT_CONTROL_SET_SEEKPOINT,
183     INPUT_CONTROL_SET_SEEKPOINT_NEXT,
184     INPUT_CONTROL_SET_SEEKPOINT_PREV,
185
186     INPUT_CONTROL_SET_BOOKMARK,
187
188     INPUT_CONTROL_SET_ES,
189
190     INPUT_CONTROL_SET_AUDIO_DELAY,
191     INPUT_CONTROL_SET_SPU_DELAY,
192
193     INPUT_CONTROL_ADD_SLAVE,
194 };
195
196 /* Internal helpers */
197 static inline void input_ControlPush( input_thread_t *p_input,
198                                       int i_type, vlc_value_t *p_val )
199 {
200     vlc_mutex_lock( &p_input->p->lock_control );
201     if( i_type == INPUT_CONTROL_SET_DIE )
202     {
203         /* Special case, empty the control */
204         p_input->p->i_control = 1;
205         p_input->p->control[0].i_type = i_type;
206         memset( &p_input->p->control[0].val, 0, sizeof( vlc_value_t ) );
207     }
208     else
209     if( p_input->p->i_control >= INPUT_CONTROL_FIFO_SIZE )
210     {
211         msg_Err( p_input, "input control fifo overflow, trashing type=%d",
212                  i_type );
213     }
214     else
215     {
216         p_input->p->control[p_input->p->i_control].i_type = i_type;
217         if( p_val )
218             p_input->p->control[p_input->p->i_control].val = *p_val;
219         else
220             memset( &p_input->p->control[p_input->p->i_control].val, 0,
221                     sizeof( vlc_value_t ) );
222
223         p_input->p->i_control++;
224     }
225     vlc_mutex_unlock( &p_input->p->lock_control );
226 }
227
228 /** Stuff moved out of vlc_input.h -- FIXME: should probably not be inline
229  * anyway. */
230
231 static inline void input_item_SetPreparsed( input_item_t *p_i, bool preparsed )
232 {
233     bool send_event = false;
234
235     if( !p_i->p_meta )
236         p_i->p_meta = vlc_meta_New();
237
238     vlc_mutex_lock( &p_i->lock );
239     int new_status;
240     if( preparsed )
241         new_status = p_i->p_meta->i_status | ITEM_PREPARSED;
242     else
243         new_status = p_i->p_meta->i_status & ~ITEM_PREPARSED;
244     if( p_i->p_meta->i_status != new_status )
245     {
246         p_i->p_meta->i_status = new_status;
247         send_event = true;
248     }
249
250     vlc_mutex_unlock( &p_i->lock );
251
252     if( send_event )
253     {
254         vlc_event_t event;
255         event.type = vlc_InputItemPreparsedChanged;
256         event.u.input_item_preparsed_changed.new_status = new_status;
257         vlc_event_send( &p_i->event_manager, &event );
258     }
259 }
260
261 static inline void input_item_SetArtNotFound( input_item_t *p_i, bool notfound )
262 {
263     if( !p_i->p_meta )
264         p_i->p_meta = vlc_meta_New();
265
266     if( notfound )
267         p_i->p_meta->i_status |= ITEM_ART_NOTFOUND;
268     else
269         p_i->p_meta->i_status &= ~ITEM_ART_NOTFOUND;
270 }
271
272 static inline void input_item_SetArtFetched( input_item_t *p_i, bool artfetched )
273 {
274     if( !p_i->p_meta )
275         p_i->p_meta = vlc_meta_New();
276
277     if( artfetched )
278         p_i->p_meta->i_status |= ITEM_ART_FETCHED;
279     else
280         p_i->p_meta->i_status &= ~ITEM_ART_FETCHED;
281 }
282
283 void input_item_SetHasErrorWhenReading( input_item_t *p_i, bool error );
284
285 /**********************************************************************
286  * Item metadata
287  **********************************************************************/
288 typedef struct playlist_album_t
289 {
290     char *psz_artist;
291     char *psz_album;
292     char *psz_arturl;
293     bool b_found;
294 } playlist_album_t;
295
296 int         input_ArtFind       ( playlist_t *, input_item_t * );
297 int         input_DownloadAndCacheArt ( playlist_t *, input_item_t * );
298
299 /* Becarefull; p_item lock HAS to be taken */
300 void input_ExtractAttachmentAndCacheArt( input_thread_t *p_input );
301
302 /***************************************************************************
303  * Internal prototypes
304  ***************************************************************************/
305
306 /* misc/stats.c */
307 input_stats_t *stats_NewInputStats( input_thread_t *p_input );
308
309 /* input.c */
310 #define input_CreateThreadExtended(a,b,c,d) __input_CreateThreadExtended(VLC_OBJECT(a),b,c,d)
311 input_thread_t *__input_CreateThreadExtended ( vlc_object_t *, input_item_t *, const char *, sout_instance_t * );
312
313 sout_instance_t * input_DetachSout( input_thread_t *p_input );
314
315 /* var.c */
316 void input_ControlVarInit ( input_thread_t * );
317 void input_ControlVarStop( input_thread_t * );
318 void input_ControlVarNavigation( input_thread_t * );
319 void input_ControlVarTitle( input_thread_t *, int i_title );
320
321 void input_ConfigVarInit ( input_thread_t * );
322
323 /* stream.c */
324 stream_t *stream_AccessNew( access_t *p_access, bool );
325 void stream_AccessDelete( stream_t *s );
326 void stream_AccessReset( stream_t *s );
327 void stream_AccessUpdate( stream_t *s );
328
329 /* decoder.c */
330 void       input_DecoderDiscontinuity( decoder_t * p_dec, bool b_flush );
331 bool input_DecoderEmpty( decoder_t * p_dec );
332 int        input_DecoderSetCcState( decoder_t *, bool b_decode, int i_channel );
333 int        input_DecoderGetCcState( decoder_t *, bool *pb_decode, int i_channel );
334 void       input_DecoderIsCcPresent( decoder_t *, bool pb_present[4] );
335
336 /* es_out.c */
337 es_out_t  *input_EsOutNew( input_thread_t *, int i_rate );
338 void       input_EsOutDelete( es_out_t * );
339 es_out_id_t *input_EsOutGetFromID( es_out_t *, int i_id );
340 void       input_EsOutSetDelay( es_out_t *, int i_cat, int64_t );
341 void       input_EsOutChangeRate( es_out_t *, int );
342 void       input_EsOutChangeState( es_out_t * );
343 void       input_EsOutChangePosition( es_out_t * );
344 bool input_EsOutDecodersEmpty( es_out_t * );
345
346 /* clock.c */
347 enum /* Synchro states */
348 {
349     SYNCHRO_OK     = 0,
350     SYNCHRO_START  = 1,
351     SYNCHRO_REINIT = 2,
352 };
353
354 typedef struct
355 {
356     /* Synchronization information */
357     mtime_t                 delta_cr;
358     mtime_t                 cr_ref, sysdate_ref;
359     mtime_t                 last_sysdate;
360     mtime_t                 last_cr; /* reference to detect unexpected stream
361                                       * discontinuities                      */
362     mtime_t                 last_pts;
363     mtime_t                 last_update;
364     int                     i_synchro_state;
365
366     bool                    b_master;
367
368     int                     i_rate;
369
370     /* Config */
371     int                     i_cr_average;
372     int                     i_delta_cr_residue;
373 } input_clock_t;
374
375 void    input_ClockInit( input_clock_t *, bool b_master, int i_cr_average, int i_rate );
376 void    input_ClockSetPCR( input_thread_t *, input_clock_t *, mtime_t );
377 void    input_ClockResetPCR( input_clock_t * );
378 mtime_t input_ClockGetTS( input_thread_t *, input_clock_t *, mtime_t );
379 void    input_ClockSetRate( input_clock_t *cl, int i_rate );
380
381 /* Subtitles */
382 char **subtitles_Detect( input_thread_t *, char* path, const char *fname );
383 int subtitles_Filter( const char *);
384
385 void MRLSplit( char *, const char **, const char **, char ** );
386
387 static inline void input_ChangeStateWithVarCallback( input_thread_t *p_input, int state, bool callback )
388 {
389     const bool changed = p_input->i_state != state;
390
391     p_input->i_state = state;
392
393     input_item_SetHasErrorWhenReading( p_input->p->input.p_item, (state == ERROR_S) );
394
395     if( callback )
396     {
397         var_SetInteger( p_input, "state", state );
398     }
399     else
400     {
401         vlc_value_t val;
402         val.i_int = state;
403         var_Change( p_input, "state", VLC_VAR_SETVALUE, &val, NULL );
404     }
405     if( changed )
406     {
407         vlc_event_t event;
408         event.type = vlc_InputStateChanged;
409         event.u.input_state_changed.new_state = state;
410         vlc_event_send( &p_input->p->event_manager, &event );
411     }
412 }
413
414 static inline void input_ChangeState( input_thread_t *p_input, int state )
415 {
416     input_ChangeStateWithVarCallback( p_input, state, true );
417 }
418
419
420 /* Access */
421
422 #define access_New( a, b, c, d ) __access_New(VLC_OBJECT(a), b, c, d )
423 access_t * __access_New( vlc_object_t *p_obj, const char *psz_access,
424                           const char *psz_demux, const char *psz_path );
425 access_t * access_FilterNew( access_t *p_source,
426                               const char *psz_access_filter );
427 void access_Delete( access_t * );
428
429 /* Demuxer */
430 #include <vlc_demux.h>
431
432 /* stream_t *s could be null and then it mean a access+demux in one */
433 #define demux_New( a, b, c, d, e, f,g ) __demux_New(VLC_OBJECT(a),b,c,d,e,f,g)
434 demux_t *__demux_New(vlc_object_t *p_obj, const char *psz_access, const char *psz_demux, const char *psz_path, stream_t *s, es_out_t *out, bool );
435
436 void demux_Delete(demux_t *);
437
438 static inline int demux_Demux( demux_t *p_demux )
439 {
440     return p_demux->pf_demux( p_demux );
441 }
442 static inline int demux_vaControl( demux_t *p_demux, int i_query, va_list args )
443 {
444     return p_demux->pf_control( p_demux, i_query, args );
445 }
446 static inline int demux_Control( demux_t *p_demux, int i_query, ... )
447 {
448     va_list args;
449     int     i_result;
450
451     va_start( args, i_query );
452     i_result = demux_vaControl( p_demux, i_query, args );
453     va_end( args );
454     return i_result;
455 }
456
457 /* Stream */
458 /**
459  * stream_t definition
460  */
461 struct stream_t
462 {
463     VLC_COMMON_MEMBERS
464
465     /*block_t *(*pf_block)  ( stream_t *, int i_size );*/
466     int      (*pf_read)   ( stream_t *, void *p_read, unsigned int i_read );
467     int      (*pf_peek)   ( stream_t *, const uint8_t **pp_peek, unsigned int i_peek );
468     int      (*pf_control)( stream_t *, int i_query, va_list );
469     void     (*pf_destroy)( stream_t *);
470
471     stream_sys_t *p_sys;
472
473     /* UTF-16 and UTF-32 file reading */
474     vlc_iconv_t     conv;
475     int             i_char_width;
476     bool            b_little_endian;
477 };
478
479 #include <libvlc.h>
480
481 static inline stream_t *vlc_stream_create( vlc_object_t *obj )
482 {
483     return (stream_t *)vlc_custom_create( obj, sizeof(stream_t),
484                                           VLC_OBJECT_GENERIC, "stream" );
485 }
486
487 #endif