1 /*****************************************************************************
2 * vpar_headers.h : video parser : headers parsing
3 *****************************************************************************
4 * Copyright (C) 1999, 2000 VideoLAN
5 * $Id: vpar_headers.h,v 1.26 2001/05/06 04:32:02 sam Exp $
7 * Authors: Christophe Massiot <massiot@via.ecp.fr>
8 * Stéphane Borel <stef@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 *****************************************************************************/
25 /*****************************************************************************
36 *****************************************************************************/
38 /*****************************************************************************
39 * quant_matrix_t : Quantization Matrix
40 *****************************************************************************/
41 typedef struct quant_matrix_s
44 boolean_t b_allocated;
45 /* Has the matrix been allocated by vpar_headers ? */
48 /*****************************************************************************
49 * sequence_t : sequence descriptor
50 *****************************************************************************
51 * This structure should only be changed when reading the sequence header,
52 * or exceptionnally some extension structures (like quant_matrix).
53 *****************************************************************************/
54 typedef struct sequence_s
56 u32 i_height, i_width; /* height and width of the lum
57 * comp of the picture */
58 u32 i_size; /* total number of pel of the lum comp */
59 u32 i_mb_height, i_mb_width, i_mb_size;
60 /* the same, in macroblock units */
61 unsigned int i_aspect_ratio; /* height/width display ratio */
62 unsigned int i_matrix_coefficients;/* coeffs of the YUV transform */
63 int i_frame_rate; /* theoritical frame rate in fps*1001 */
64 boolean_t b_mpeg2; /* guess */
65 boolean_t b_progressive; /* progressive (ie.
66 * non-interlaced) frame */
67 unsigned int i_scalable_mode; /* scalability ; unsupported, but
68 * modifies the syntax of the binary
70 quant_matrix_t intra_quant, nonintra_quant;
71 quant_matrix_t chroma_intra_quant, chroma_nonintra_quant;
72 /* current quantization matrices */
74 /* Chromatic information */
75 unsigned int i_chroma_format; /* see CHROMA_* below */
76 int i_chroma_nb_blocks; /* number of chroma blocks */
77 u32 i_chroma_width;/* width of a line of the chroma comp */
78 u32 i_chroma_mb_width, i_chroma_mb_height;
79 /* size of a macroblock in the chroma buffer
80 * (eg. 8x8 or 8x16 or 16x16) */
83 picture_t * p_forward; /* current forward reference frame */
84 picture_t * p_backward; /* current backward reference frame */
85 mtime_t next_pts, next_dts;
87 boolean_t b_expect_discontinuity; /* reset the frame predictors
88 * after the current frame */
90 /* Copyright extension */
91 boolean_t b_copyright_flag; /* Whether the following
92 information is significant
99 /*****************************************************************************
100 * picture_parsing_t : parser context descriptor
101 *****************************************************************************
102 * This structure should only be changed when reading the picture header.
103 *****************************************************************************/
104 typedef struct picture_parsing_s
106 /* ISO/CEI 11172-2 backward compatibility */
107 boolean_t pb_full_pel_vector[2];
108 int i_forward_f_code, i_backward_f_code;
110 /* Values from the picture_coding_extension. Please refer to ISO/IEC
112 int ppi_f_code[2][2];
113 int i_intra_dc_precision;
114 boolean_t b_frame_pred_frame_dct, b_q_scale_type;
115 boolean_t b_intra_vlc_format;
116 boolean_t b_alternate_scan, b_progressive;
117 boolean_t b_top_field_first, b_concealment_mv;
118 boolean_t b_repeat_first_field;
119 /* Relative to the current field */
120 int i_coding_type, i_structure;
121 boolean_t b_frame_structure; /* i_structure == FRAME_STRUCTURE */
123 picture_t * p_picture; /* picture buffer from vout */
124 int i_current_structure; /* current parsed structure of
125 * p_picture (second field ?) */
127 macroblock_t * pp_mb[MAX_MB]; /* macroblock buffer to
128 * send to the vdec thread(s) */
130 boolean_t b_error; /* parsing error, try to recover */
132 int i_l_stride, i_c_stride;
133 /* number of coeffs to jump when changing
134 * lines (different with field pictures) */
137 /*****************************************************************************
139 *****************************************************************************/
140 #define PICTURE_START_CODE 0x100L
141 #define SLICE_START_CODE_MIN 0x101L
142 #define SLICE_START_CODE_MAX 0x1AFL
143 #define USER_DATA_START_CODE 0x1B2L
144 #define SEQUENCE_HEADER_CODE 0x1B3L
145 #define SEQUENCE_ERROR_CODE 0x1B4L
146 #define EXTENSION_START_CODE 0x1B5L
147 #define SEQUENCE_END_CODE 0x1B7L
148 #define GROUP_START_CODE 0x1B8L
150 /* extension start code IDs */
151 #define SEQUENCE_EXTENSION_ID 1
152 #define SEQUENCE_DISPLAY_EXTENSION_ID 2
153 #define QUANT_MATRIX_EXTENSION_ID 3
154 #define COPYRIGHT_EXTENSION_ID 4
155 #define SEQUENCE_SCALABLE_EXTENSION_ID 5
156 #define PICTURE_DISPLAY_EXTENSION_ID 7
157 #define PICTURE_CODING_EXTENSION_ID 8
158 #define PICTURE_SPATIAL_SCALABLE_EXTENSION_ID 9
159 #define PICTURE_TEMPORAL_SCALABLE_EXTENSION_ID 10
174 #define I_CODING_TYPE 1
175 #define P_CODING_TYPE 2
176 #define B_CODING_TYPE 3
177 #define D_CODING_TYPE 4 /* MPEG-1 ONLY */
178 /* other values are reserved */
182 #define BOTTOM_FIELD 2
183 #define FRAME_STRUCTURE 3
185 /*****************************************************************************
187 *****************************************************************************/
188 int vpar_NextSequenceHeader( struct vpar_thread_s * p_vpar );
189 int vpar_ParseHeader( struct vpar_thread_s * p_vpar );