git.sesse.net Git - vlc/blob - include/vpar_headers.h

   1 /*****************************************************************************
   2  * vpar_headers.h : video parser : headers parsing
   3  *****************************************************************************
   4  * Copyright (C) 1999, 2000 VideoLAN
   5  *
   6  * Authors:
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  21  *****************************************************************************/
  22
  23 /*****************************************************************************
  24  * Requires:
  25  *  "config.h"
  26  *  "common.h"
  27  *  "mtime.h"
  28  *  "threads.h"
  29  *  "input.h"
  30  *  "video.h"
  31  *  "video_output.h"
  32  *  "decoder_fifo.h"
  33  *  "video_fifo.h"
  34  *****************************************************************************/
  35
  36 /*****************************************************************************
  37  * quant_matrix_t : Quantization Matrix
  38  *****************************************************************************/
  39 typedef struct quant_matrix_s
  40 {
  41     int *       pi_matrix;
  42     boolean_t   b_allocated;
  43                           /* Has the matrix been allocated by vpar_headers ? */
  44 } quant_matrix_t;
  45
  46 /*****************************************************************************
  47  * sequence_t : sequence descriptor
  48  *****************************************************************************
  49  * This structure should only be changed when reading the sequence header,
  50  * or exceptionnally some extension structures (like quant_matrix).
  51  *****************************************************************************/
  52 typedef struct sequence_s
  53 {
  54     u32                 i_height, i_width;      /* height and width of the lum
  55                                                  * comp of the picture       */
  56     u32                 i_size;       /* total number of pel of the lum comp */
  57     u32                 i_mb_height, i_mb_width, i_mb_size;
  58                                             /* the same, in macroblock units */
  59     unsigned int        i_aspect_ratio;        /* height/width display ratio */
  60     unsigned int        i_matrix_coefficients;/* coeffs of the YUV transform */
  61     int                 i_frame_rate;  /* theoritical frame rate in fps*1001 */
  62     boolean_t           b_mpeg2;                                    /* guess */
  63     boolean_t           b_progressive;              /* progressive (ie.
  64                                                      * non-interlaced) frame */
  65     unsigned int        i_scalable_mode; /* scalability ; unsupported, but
  66                                           * modifies the syntax of the binary
  67                                           * stream.                          */
  68     quant_matrix_t      intra_quant, nonintra_quant;
  69     quant_matrix_t      chroma_intra_quant, chroma_nonintra_quant;
  70                                             /* current quantization matrices */
  71
  72     /* Chromatic information */
  73     unsigned int        i_chroma_format;               /* see CHROMA_* below */
  74     int                 i_chroma_nb_blocks;       /* number of chroma blocks */
  75     u32                 i_chroma_width;/* width of a line of the chroma comp */
  76     u32                 i_chroma_mb_width, i_chroma_mb_height;
  77                                  /* size of a macroblock in the chroma buffer
  78                                   * (eg. 8x8 or 8x16 or 16x16)               */
  79
  80     /* Parser context */
  81     picture_t *         p_forward;        /* current forward reference frame */
  82     picture_t *         p_backward;      /* current backward reference frame */
  83
  84     /* Copyright extension */
  85     boolean_t           b_copyright_flag;     /* Whether the following
  86                                                  information is significant
  87                                                  or not. */
  88     u8                  i_copyright_id;
  89     boolean_t           b_original;
  90     u64                 i_copyright_nb;
  91 } sequence_t;
  92
  93 /*****************************************************************************
  94  * picture_parsing_t : parser context descriptor
  95  *****************************************************************************
  96  * This structure should only be changed when reading the picture header.
  97  *****************************************************************************/
  98 typedef struct picture_parsing_s
  99 {
 100     /* ISO/CEI 11172-2 backward compatibility */
 101     boolean_t           pb_full_pel_vector[2];
 102     int                 i_forward_f_code, i_backward_f_code;
 103
 104     /* Values from the picture_coding_extension. Please refer to ISO/IEC
 105      * 13818-2. */
 106     int                 ppi_f_code[2][2];
 107     int                 i_intra_dc_precision;
 108     boolean_t           b_frame_pred_frame_dct, b_q_scale_type;
 109     boolean_t           b_intra_vlc_format;
 110     boolean_t           b_alternate_scan, b_progressive_frame;
 111     boolean_t           b_top_field_first, b_concealment_mv;
 112     boolean_t           b_repeat_first_field;
 113     /* Relative to the current field */
 114     int                 i_coding_type, i_structure;
 115     boolean_t           b_frame_structure; /* i_structure == FRAME_STRUCTURE */
 116
 117     picture_t *         p_picture;               /* picture buffer from vout */
 118     int                 i_current_structure;   /* current parsed structure of
 119                                                 * p_picture (second field ?) */
 120 #ifdef VDEC_SMP
 121     macroblock_t *      pp_mb[MAX_MB];         /* macroblock buffer to
 122                                                 * send to the vdec thread(s) */
 123 #endif
 124     boolean_t           b_error;            /* parsing error, try to recover */
 125
 126     int                 i_l_stride, i_c_stride;
 127                                     /* number of coeffs to jump when changing
 128                                      * lines (different with field pictures) */
 129 } picture_parsing_t;
 130
 131 /*****************************************************************************
 132  * Standard codes
 133  *****************************************************************************/
 134 #define PICTURE_START_CODE      0x100L
 135 #define SLICE_START_CODE_MIN    0x101L
 136 #define SLICE_START_CODE_MAX    0x1AFL
 137 #define USER_DATA_START_CODE    0x1B2L
 138 #define SEQUENCE_HEADER_CODE    0x1B3L
 139 #define SEQUENCE_ERROR_CODE     0x1B4L
 140 #define EXTENSION_START_CODE    0x1B5L
 141 #define SEQUENCE_END_CODE       0x1B7L
 142 #define GROUP_START_CODE        0x1B8L
 143
 144 /* extension start code IDs */
 145 #define SEQUENCE_EXTENSION_ID                    1
 146 #define SEQUENCE_DISPLAY_EXTENSION_ID            2
 147 #define QUANT_MATRIX_EXTENSION_ID                3
 148 #define COPYRIGHT_EXTENSION_ID                   4
 149 #define SEQUENCE_SCALABLE_EXTENSION_ID           5
 150 #define PICTURE_DISPLAY_EXTENSION_ID             7
 151 #define PICTURE_CODING_EXTENSION_ID              8
 152 #define PICTURE_SPATIAL_SCALABLE_EXTENSION_ID    9
 153 #define PICTURE_TEMPORAL_SCALABLE_EXTENSION_ID  10
 154
 155 /* scalable modes */
 156 #define SC_NONE     0
 157 #define SC_DP       1
 158 #define SC_SPAT     2
 159 #define SC_SNR      3
 160 #define SC_TEMP     4
 161
 162 /* Chroma types */
 163 #define CHROMA_420 1
 164 #define CHROMA_422 2
 165 #define CHROMA_444 3
 166
 167 /* Pictures types */
 168 #define I_CODING_TYPE           1
 169 #define P_CODING_TYPE           2
 170 #define B_CODING_TYPE           3
 171 #define D_CODING_TYPE           4 /* MPEG-1 ONLY */
 172 /* other values are reserved */
 173
 174 /* Structures */
 175 #define TOP_FIELD               1
 176 #define BOTTOM_FIELD            2
 177 #define FRAME_STRUCTURE         3
 178
 179 /*****************************************************************************
 180  * Prototypes
 181  *****************************************************************************/
 182 int vpar_NextSequenceHeader( struct vpar_thread_s * p_vpar );
 183 int vpar_ParseHeader( struct vpar_thread_s * p_vpar );