git.sesse.net Git - vlc/blob - src/video_decoder/video_parser.h

   1 /*****************************************************************************
   2  * video_parser.h : video parser thread
   3  *****************************************************************************
   4  * Copyright (C) 1999, 2000 VideoLAN
   5  * $Id: video_parser.h,v 1.8 2001/01/24 19:05:55 massiot Exp $
   6  *
   7  * Authors: Christophe Massiot <massiot@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., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  22  *****************************************************************************/
  23
  24 /*****************************************************************************
  25  * Requires:
  26  *  "config.h"
  27  *  "common.h"
  28  *  "mtime.h"
  29  *  "threads.h"
  30  *  "input.h"
  31  *  "video.h"
  32  *  "video_output.h"
  33  *  "decoder_fifo.h"
  34  *  "video_fifo.h"
  35  *  "vpar_headers.h"
  36  *****************************************************************************/
  37
  38 /*****************************************************************************
  39  * video_fifo_t
  40  *****************************************************************************
  41  * This rotative FIFO contains undecoded macroblocks that are to be decoded
  42  *****************************************************************************/
  43 struct vpar_thread_s;
  44
  45 typedef struct video_fifo_s
  46 {
  47 #ifdef VDEC_SMP
  48     vlc_mutex_t         lock;                              /* fifo data lock */
  49     vlc_cond_t          wait;              /* fifo data conditional variable */
  50
  51     /* buffer is an array of undec_picture_t pointers */
  52     macroblock_t *      buffer[VFIFO_SIZE + 1];
  53     int                 i_start;
  54     int                 i_end;
  55 #else
  56     macroblock_t        buffer;
  57 #endif
  58
  59     struct vpar_thread_s *      p_vpar;
  60 } video_fifo_t;
  61
  62 /*****************************************************************************
  63  * video_buffer_t
  64  *****************************************************************************
  65  * This structure enables the parser to maintain a list of free
  66  * macroblock_t structures
  67  *****************************************************************************/
  68 #ifdef VDEC_SMP
  69 typedef struct video_buffer_s
  70 {
  71     vlc_mutex_t         lock;                            /* buffer data lock */
  72
  73     macroblock_t        p_macroblocks[VFIFO_SIZE + 1];
  74     macroblock_t *      pp_mb_free[VFIFO_SIZE+1];          /* this is a LIFO */
  75     int                 i_index;
  76 } video_buffer_t;
  77 #endif
  78
  79 /*****************************************************************************
  80  * vpar_thread_t: video parser thread descriptor
  81  *****************************************************************************
  82  * XXX??
  83  *****************************************************************************/
  84 typedef struct vpar_thread_s
  85 {
  86     bit_stream_t        bit_stream;
  87
  88     /* Thread properties and locks */
  89     vlc_thread_t        thread_id;                /* id for thread functions */
  90
  91     /* Thread configuration */
  92     /* XXX?? */
  93 //    int *pi_status;
  94
  95
  96     /* Input properties */
  97     decoder_fifo_t *    p_fifo;                            /* PES input fifo */
  98     vdec_config_t *     p_config;
  99
 100     /* Output properties */
 101     vout_thread_t *     p_vout;                       /* video output thread */
 102
 103     /* Decoder properties */
 104     struct vdec_thread_s *      pp_vdec[NB_VDEC];
 105     video_fifo_t                vfifo;
 106 #ifdef VDEC_SMP
 107     video_buffer_t              vbuffer;
 108 #endif
 109
 110     /* Parser properties */
 111     sequence_t              sequence;
 112     picture_parsing_t       picture;
 113     macroblock_parsing_t    mb;
 114     video_synchro_t         synchro;
 115
 116     /* Lookup tables */
 117     lookup_t                pl_mb_addr_inc[2048];    /* for macroblock
 118                                                         address increment */
 119     /* tables for macroblock types 0=P 1=B */
 120     lookup_t                ppl_mb_type[2][64];
 121     /* table for coded_block_pattern */
 122     lookup_t *              pl_coded_pattern;
 123     /* variable length codes for the structure dct_dc_size for intra blocks */
 124     lookup_t *              pppl_dct_dc_size[2][2];
 125     /* Structure to store the tables B14 & B15 (ISO/IEC 13818-2 B.4) */
 126     dct_lookup_t            ppl_dct_coef[2][16384];
 127     /* Scan table */
 128     u8                      ppi_scan[2][64];
 129     /* Default quantization matrices */
 130     u8                      pi_default_intra_quant[64];
 131     u8                      pi_default_nonintra_quant[64];
 132
 133     /* Motion compensation plugin used and shortcuts */
 134     struct module_s *       p_motion_module;
 135     void ( * pppf_motion[4][2][4] )     ( struct macroblock_s * );
 136     void ( * ppf_motion_skipped[4][4] ) ( struct macroblock_s * );
 137
 138     /* IDCT plugin used and shortcuts to access its capabilities */
 139     struct module_s *       p_idct_module;
 140     idct_init_t             pf_init;
 141     f_idct_t                pf_sparse_idct;
 142     f_idct_t                pf_idct;
 143     norm_scan_t             pf_norm_scan;
 144
 145 #ifdef STATS
 146     /* Statistics */
 147     count_t         c_loops;                              /* number of loops */
 148     count_t         c_sequences;                      /* number of sequences */
 149     count_t         pc_pictures[4]; /* number of (coding_type) pictures read */
 150     count_t         pc_decoded_pictures[4];       /* number of (coding_type)
 151                                                    *        pictures decoded */
 152     count_t         pc_malformed_pictures[4];  /* number of pictures trashed
 153                                                 * during parsing             */
 154 #endif
 155 } vpar_thread_t;
 156
 157 /*****************************************************************************
 158  * Prototypes
 159  *****************************************************************************/
 160
 161 /* Thread management functions */
 162 vlc_thread_t vpar_CreateThread       ( vdec_config_t * );
 163
 164 /*****************************************************************************
 165  * NextStartCode : Find the next start code
 166  *****************************************************************************/
 167 static __inline__ void NextStartCode( bit_stream_t * p_bit_stream )
 168 {
 169     /* Re-align the buffer on an 8-bit boundary */
 170     RealignBits( p_bit_stream );
 171
 172     while( ShowBits( p_bit_stream, 24 ) != 0x01L
 173             && !p_bit_stream->p_decoder_fifo->b_die )
 174     {
 175         RemoveBits( p_bit_stream, 8 );
 176     }
 177 }
 178
 179 /*****************************************************************************
 180  * LoadQuantizerScale
 181  *****************************************************************************
 182  * Quantizer scale factor (ISO/IEC 13818-2 7.4.2.2)
 183  *****************************************************************************/
 184 static __inline__ void LoadQuantizerScale( struct vpar_thread_s * p_vpar )
 185 {
 186     /* Quantization coefficient table */
 187     static u8   ppi_quantizer_scale[3][32] =
 188     {
 189         /* MPEG-2 */
 190         {
 191             /* q_scale_type */
 192             /* linear */
 193             0,2,4,6,8,10,12,14,16,18,20,22,24,26,28,30,
 194             32,34,36,38,40,42,44,46,48,50,52,54,56,58,60,62
 195         },
 196         {
 197             /* non-linear */
 198             0, 1, 2, 3, 4, 5, 6, 7, 8, 10,12,14,16,18,20, 22,
 199             24,28,32,36,40,44,48,52,56,64,72,80,88,96,104,112
 200         },
 201         /* MPEG-1 */
 202         {
 203             0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,
 204             16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31
 205         }
 206     };
 207
 208     p_vpar->mb.i_quantizer_scale = ppi_quantizer_scale
 209            [(!p_vpar->sequence.b_mpeg2 << 1) | p_vpar->picture.b_q_scale_type]
 210            [GetBits( &p_vpar->bit_stream, 5 )];
 211 }
 212