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