git.sesse.net Git - vlc/blob - include/input_ext-plugins.h

   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.1 2001/07/17 09:48:07 massiot Exp $
   7  *
   8  * Authors: Christophe Massiot <massiot@via.ecp.fr>
   9  *
  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.
  14  *
  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.
  19  *
  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  *****************************************************************************/
  24
  25 /*
  26  * Communication plugin -> input
  27  */
  28
  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.                        */
  38 #define NO_SEEK             -1
  39
  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 *,
  45                                                       boolean_t ),
  46                       void * p_callback_arg );
  47 void NextDataPacket ( struct bit_stream_s * );
  48
  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 *,
  56                                               u16, size_t );
  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,
  63                                        size_t );
  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 * );
  67
  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 *,
  78                                      struct pgrm_descriptor_s * );
  79
  80 /*****************************************************************************
  81  * Prototypes from input_clock.c
  82  *****************************************************************************/
  83 void input_ClockInit( struct pgrm_descriptor_s * );
  84 int  input_ClockManageControl( struct input_thread_s *,
  85                                struct pgrm_descriptor_s *, mtime_t );
  86 void input_ClockManageRef( struct input_thread_s *,
  87                            struct pgrm_descriptor_s *, mtime_t );
  88 mtime_t input_ClockGetTS( struct input_thread_s *,
  89                           struct pgrm_descriptor_s *, mtime_t );
  90
  91 /*****************************************************************************
  92  * Create a NULL packet for padding in case of a data loss
  93  *****************************************************************************/
  94 static __inline__ void input_NullPacket( input_thread_t * p_input,
  95                                          es_descriptor_t * p_es )
  96 {
  97     data_packet_t *             p_pad_data;
  98     pes_packet_t *              p_pes;
  99
 100     if( (p_pad_data = p_input->pf_new_packet(
 101                     p_input->p_method_data,
 102                     PADDING_PACKET_SIZE )) == NULL )
 103     {
 104         intf_ErrMsg("Out of memory");
 105         p_input->b_error = 1;
 106         return;
 107     }
 108
 109     memset( p_pad_data->p_buffer, 0, PADDING_PACKET_SIZE );
 110     p_pad_data->b_discard_payload = 1;
 111     p_pes = p_es->p_pes;
 112
 113     if( p_pes != NULL )
 114     {
 115         p_pes->b_discontinuity = 1;
 116         p_es->p_last->p_next = p_pad_data;
 117         p_es->p_last = p_pad_data;
 118     }
 119     else
 120     {
 121         if( (p_pes = p_input->pf_new_pes( p_input->p_method_data )) == NULL )
 122         {
 123             intf_ErrMsg("Out of memory");
 124             p_input->b_error = 1;
 125             return;
 126         }
 127
 128         p_pes->i_rate = p_input->stream.control.i_rate;
 129         p_pes->p_first = p_pad_data;
 130         p_pes->b_discontinuity = 1;
 131         input_DecodePES( p_es->p_decoder_fifo, p_pes );
 132     }
 133 }
 134
 135
 136 /*
 137  * Optional netlist management
 138  */
 139
 140 /*****************************************************************************
 141  * netlist_t: structure to manage a netlist
 142  *****************************************************************************/
 143 typedef struct netlist_s
 144 {
 145     vlc_mutex_t             lock;
 146
 147     size_t                  i_buffer_size;
 148
 149     /* Buffers */
 150     byte_t *                p_buffers;                 /* Big malloc'ed area */
 151     data_packet_t *         p_data;                        /* malloc'ed area */
 152     pes_packet_t *          p_pes;                         /* malloc'ed area */
 153
 154     /* FIFOs of free packets */
 155     data_packet_t **        pp_free_data;
 156     pes_packet_t **         pp_free_pes;
 157     struct iovec *          p_free_iovec;
 158
 159     /* FIFO size */
 160     unsigned int            i_nb_pes;
 161     unsigned int            i_nb_data;
 162
 163     /* Index */
 164     unsigned int            i_data_start, i_data_end;
 165     unsigned int            i_pes_start, i_pes_end;
 166
 167     /* Number of blocs read once by readv */
 168     unsigned int            i_read_once;
 169 } netlist_t;
 170
 171 /*****************************************************************************
 172  * Prototypes
 173  *****************************************************************************/
 174 int                     input_NetlistInit( struct input_thread_s *,
 175                                            int i_nb_data, int i_nb_pes,
 176                                            size_t i_buffer_size,
 177                                            int i_read_once );
 178
 179 struct iovec * input_NetlistGetiovec( void * p_method_data );
 180 void input_NetlistMviovec( void * , size_t, struct data_packet_s **);
 181 struct data_packet_s *  input_NetlistNewPacket( void *, size_t );
 182 struct pes_packet_s *   input_NetlistNewPES( void * );
 183 void            input_NetlistDeletePacket( void *, struct data_packet_s * );
 184 void            input_NetlistDeletePES( void *, struct pes_packet_s * );
 185 void            input_NetlistEnd( struct input_thread_s * );
 186
 187
 188 /*
 189  * Optional MPEG demultiplexing
 190  */
 191
 192 /*****************************************************************************
 193  * Constants
 194  *****************************************************************************/
 195 #define TS_PACKET_SIZE      188                       /* Size of a TS packet */
 196 #define PSI_SECTION_SIZE    4096            /* Maximum size of a PSI section */
 197
 198 #define PAT_UNINITIALIZED    (1 << 6)
 199 #define PMT_UNINITIALIZED    (1 << 6)
 200
 201 #define PSI_IS_PAT          0x00
 202 #define PSI_IS_PMT          0x01
 203 #define UNKNOWN_PSI         0xff
 204
 205 /*****************************************************************************
 206  * psi_section_t
 207  *****************************************************************************
 208  * Describes a PSI section. Beware, it doesn't contain pointers to the TS
 209  * packets that contain it as for a PES, but the data themselves
 210  *****************************************************************************/
 211 typedef struct psi_section_s
 212 {
 213     byte_t                  buffer[PSI_SECTION_SIZE];
 214
 215     u8                      i_section_number;
 216     u8                      i_last_section_number;
 217     u8                      i_version_number;
 218     u16                     i_section_length;
 219     u16                     i_read_in_section;
 220
 221     /* the PSI is complete */
 222     boolean_t               b_is_complete;
 223
 224     /* packet missed up ? */
 225     boolean_t               b_trash;
 226
 227     /*about sections  */
 228     boolean_t               b_section_complete;
 229
 230     /* where are we currently ? */
 231     byte_t                * p_current;
 232
 233 } psi_section_t;
 234
 235 /*****************************************************************************
 236  * es_ts_data_t: extension of es_descriptor_t
 237  *****************************************************************************/
 238 typedef struct es_ts_data_s
 239 {
 240     boolean_t               b_psi;   /* Does the stream have to be handled by
 241                                       *                    the PSI decoder ? */
 242
 243     int                     i_psi_type;  /* There are different types of PSI */
 244
 245     psi_section_t *         p_psi_section;                    /* PSI packets */
 246
 247     /* Markers */
 248     int                     i_continuity_counter;
 249 } es_ts_data_t;
 250
 251 /*****************************************************************************
 252  * pgrm_ts_data_t: extension of pgrm_descriptor_t
 253  *****************************************************************************/
 254 typedef struct pgrm_ts_data_s
 255 {
 256     u16                     i_pcr_pid;             /* PCR ES, for TS streams */
 257     int                     i_pmt_version;
 258 } pgrm_ts_data_t;
 259
 260 /*****************************************************************************
 261  * stream_ts_data_t: extension of stream_descriptor_t
 262  *****************************************************************************/
 263 typedef struct stream_ts_data_s
 264 {
 265     int i_pat_version;          /* Current version of the PAT */
 266 } stream_ts_data_t;
 267
 268 /*****************************************************************************
 269  * stream_ps_data_t: extension of stream_descriptor_t
 270  *****************************************************************************/
 271 typedef struct stream_ps_data_s
 272 {
 273     boolean_t               b_has_PSM;                 /* very rare, in fact */
 274
 275     u8                      i_PSM_version;
 276 } stream_ps_data_t;
 277
 278 /* PSM version is 5 bits, so -1 is not a valid value */
 279 #define EMPTY_PSM_VERSION   -1
 280
 281
 282 /*****************************************************************************
 283  * Prototypes
 284  *****************************************************************************/
 285 void input_ParsePES  ( struct input_thread_s *, struct es_descriptor_s * );
 286 void input_GatherPES ( struct input_thread_s *, struct data_packet_s *,
 287                        struct es_descriptor_s *, boolean_t, boolean_t );
 288 es_descriptor_t * input_ParsePS( struct input_thread_s *,
 289                                  struct data_packet_s * );
 290 void input_DemuxPS   ( struct input_thread_s *, struct data_packet_s * );
 291 void input_DemuxTS   ( struct input_thread_s *, struct data_packet_s * );
 292 void input_DemuxPSI  ( struct input_thread_s *, struct data_packet_s *,
 293                        struct es_descriptor_s *, boolean_t, boolean_t );
 294