1 /*****************************************************************************
2 * input_ext-plugins.h: structures of the input not exported to other modules,
3 * but exported to plug-ins
4 *****************************************************************************
5 * Copyright (C) 1999, 2000, 2001 VideoLAN
6 * $Id: input_ext-plugins.h,v 1.3 2001/11/11 01:32:03 stef Exp $
8 * Authors: Christophe Massiot <massiot@via.ecp.fr>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
23 *****************************************************************************/
26 * Communication plugin -> input
29 /* FIXME: you've gotta move this move this, you've gotta move this move this */
30 #define INPUT_READ_ONCE 7 /* We live in a world dominated by Ethernet. *
31 * Ethernet MTU is 1500 bytes, so in a UDP *
32 * packet we can put : 1500/188 = 7 TS *
33 * packets. Have a nice day and merry Xmas. */
34 #define PADDING_PACKET_SIZE 188 /* Size of the NULL packet inserted in case
35 * of data loss (this should be < 188). */
36 #define PADDING_PACKET_NUMBER 10 /* Number of padding packets top insert to
37 * escape a decoder. */
40 /*****************************************************************************
41 * Prototypes from input_ext-dec.c
42 *****************************************************************************/
43 void InitBitstream ( struct bit_stream_s *, struct decoder_fifo_s *,
44 void (* pf_bitstream_callback)( struct bit_stream_s *,
46 void * p_callback_arg );
47 void NextDataPacket ( struct bit_stream_s * );
49 /*****************************************************************************
50 * Prototypes from input_programs.c
51 *****************************************************************************/
52 int input_InitStream( struct input_thread_s *, size_t );
53 void input_EndStream ( struct input_thread_s * );
54 struct pgrm_descriptor_s * input_FindProgram( struct input_thread_s *, u16 );
55 struct pgrm_descriptor_s * input_AddProgram ( struct input_thread_s *,
57 void input_DelProgram( struct input_thread_s *, struct pgrm_descriptor_s * );
58 struct input_area_s * input_AddArea( struct input_thread_s * );
59 void input_DelArea ( struct input_thread_s *, struct input_area_s * );
60 struct es_descriptor_s * input_FindES( struct input_thread_s *, u16 );
61 struct es_descriptor_s * input_AddES ( struct input_thread_s *,
62 struct pgrm_descriptor_s *, u16,
64 void input_DelES ( struct input_thread_s *, struct es_descriptor_s * );
65 int input_SelectES ( struct input_thread_s *, struct es_descriptor_s * );
66 int input_UnselectES( struct input_thread_s *, struct es_descriptor_s * );
68 /*****************************************************************************
69 * Prototypes from input_dec.c
70 *****************************************************************************/
71 //decoder_capabilities_s * input_ProbeDecoder( void );
72 vlc_thread_t input_RunDecoder( struct decoder_capabilities_s *, void * );
73 void input_EndDecoder( struct input_thread_s *, struct es_descriptor_s * );
74 void input_DecodePES ( struct decoder_fifo_s *, struct pes_packet_s * );
75 void input_EscapeDiscontinuity( struct input_thread_s *,
76 struct pgrm_descriptor_s * );
77 void input_EscapeAudioDiscontinuity( struct input_thread_s * );
79 /*****************************************************************************
80 * Prototypes from input_clock.c
81 *****************************************************************************/
82 void input_ClockInit( struct pgrm_descriptor_s * );
83 int input_ClockManageControl( struct input_thread_s *,
84 struct pgrm_descriptor_s *, mtime_t );
85 void input_ClockManageRef( struct input_thread_s *,
86 struct pgrm_descriptor_s *, mtime_t );
87 mtime_t input_ClockGetTS( struct input_thread_s *,
88 struct pgrm_descriptor_s *, mtime_t );
90 /*****************************************************************************
91 * Create a NULL packet for padding in case of a data loss
92 *****************************************************************************/
93 static __inline__ void input_NullPacket( input_thread_t * p_input,
94 es_descriptor_t * p_es )
96 data_packet_t * p_pad_data;
99 if( (p_pad_data = p_input->pf_new_packet(
100 p_input->p_method_data,
101 PADDING_PACKET_SIZE )) == NULL )
103 intf_ErrMsg("Out of memory");
104 p_input->b_error = 1;
108 memset( p_pad_data->p_buffer, 0, PADDING_PACKET_SIZE );
109 p_pad_data->b_discard_payload = 1;
114 p_pes->b_discontinuity = 1;
115 p_es->p_last->p_next = p_pad_data;
116 p_es->p_last = p_pad_data;
120 if( (p_pes = p_input->pf_new_pes( p_input->p_method_data )) == NULL )
122 intf_ErrMsg("Out of memory");
123 p_input->b_error = 1;
127 p_pes->i_rate = p_input->stream.control.i_rate;
128 p_pes->p_first = p_pad_data;
129 p_pes->b_discontinuity = 1;
130 input_DecodePES( p_es->p_decoder_fifo, p_pes );
136 * Optional netlist management
139 /*****************************************************************************
140 * netlist_t: structure to manage a netlist
141 *****************************************************************************/
142 typedef struct netlist_s
146 size_t i_buffer_size;
149 byte_t * p_buffers; /* Big malloc'ed area */
150 data_packet_t * p_data; /* malloc'ed area */
151 pes_packet_t * p_pes; /* malloc'ed area */
153 /* FIFOs of free packets */
154 data_packet_t ** pp_free_data;
155 pes_packet_t ** pp_free_pes;
156 struct iovec * p_free_iovec;
159 unsigned int i_nb_iovec;
160 unsigned int i_nb_pes;
161 unsigned int i_nb_data;
164 unsigned int i_iovec_start, i_iovec_end;
165 unsigned int i_data_start, i_data_end;
166 unsigned int i_pes_start, i_pes_end;
168 /* Reference counters for iovec */
169 unsigned int * pi_refcount;
171 /* Number of blocs read once by readv */
172 unsigned int i_read_once;
175 /*****************************************************************************
177 *****************************************************************************/
178 int input_NetlistInit( struct input_thread_s *,
182 size_t i_buffer_size,
185 struct iovec * input_NetlistGetiovec( void * p_method_data );
186 void input_NetlistMviovec( void * , int,
187 struct data_packet_s **);
188 struct data_packet_s * input_NetlistNewPtr( void * );
189 struct data_packet_s * input_NetlistNewPacket( void *, size_t );
190 struct pes_packet_s * input_NetlistNewPES( void * );
191 void input_NetlistDeletePacket( void *,
192 struct data_packet_s * );
193 void input_NetlistDeletePES( void *,
194 struct pes_packet_s * );
195 void input_NetlistEnd( struct input_thread_s * );
199 * Optional MPEG demultiplexing
202 /*****************************************************************************
204 *****************************************************************************/
205 #define TS_PACKET_SIZE 188 /* Size of a TS packet */
206 #define PSI_SECTION_SIZE 4096 /* Maximum size of a PSI section */
208 #define PAT_UNINITIALIZED (1 << 6)
209 #define PMT_UNINITIALIZED (1 << 6)
211 #define PSI_IS_PAT 0x00
212 #define PSI_IS_PMT 0x01
213 #define UNKNOWN_PSI 0xff
215 /*****************************************************************************
217 *****************************************************************************
218 * Describes a PSI section. Beware, it doesn't contain pointers to the TS
219 * packets that contain it as for a PES, but the data themselves
220 *****************************************************************************/
221 typedef struct psi_section_s
223 byte_t buffer[PSI_SECTION_SIZE];
226 u8 i_last_section_number;
228 u16 i_section_length;
229 u16 i_read_in_section;
231 /* the PSI is complete */
232 boolean_t b_is_complete;
234 /* packet missed up ? */
238 boolean_t b_section_complete;
240 /* where are we currently ? */
245 /*****************************************************************************
246 * es_ts_data_t: extension of es_descriptor_t
247 *****************************************************************************/
248 typedef struct es_ts_data_s
250 boolean_t b_psi; /* Does the stream have to be handled by
251 * the PSI decoder ? */
253 int i_psi_type; /* There are different types of PSI */
255 psi_section_t * p_psi_section; /* PSI packets */
258 int i_continuity_counter;
261 /*****************************************************************************
262 * pgrm_ts_data_t: extension of pgrm_descriptor_t
263 *****************************************************************************/
264 typedef struct pgrm_ts_data_s
266 u16 i_pcr_pid; /* PCR ES, for TS streams */
270 /*****************************************************************************
271 * stream_ts_data_t: extension of stream_descriptor_t
272 *****************************************************************************/
273 typedef struct stream_ts_data_s
275 int i_pat_version; /* Current version of the PAT */
278 /*****************************************************************************
279 * stream_ps_data_t: extension of stream_descriptor_t
280 *****************************************************************************/
281 typedef struct stream_ps_data_s
283 boolean_t b_has_PSM; /* very rare, in fact */
288 /* PSM version is 5 bits, so -1 is not a valid value */
289 #define EMPTY_PSM_VERSION -1
292 /*****************************************************************************
294 *****************************************************************************/
295 void input_ParsePES ( struct input_thread_s *, struct es_descriptor_s * );
296 void input_GatherPES ( struct input_thread_s *, struct data_packet_s *,
297 struct es_descriptor_s *, boolean_t, boolean_t );
298 es_descriptor_t * input_ParsePS( struct input_thread_s *,
299 struct data_packet_s * );
300 void input_DemuxPS ( struct input_thread_s *, struct data_packet_s * );
301 void input_DemuxTS ( struct input_thread_s *, struct data_packet_s * );
302 void input_DemuxPSI ( struct input_thread_s *, struct data_packet_s *,
303 struct es_descriptor_s *, boolean_t, boolean_t );