]> git.sesse.net Git - vlc/blob - modules/codec/xvmc/mpeg2.h
Support for UDP-Lite (with full checksum coverage only atm)
[vlc] / modules / codec / xvmc / mpeg2.h
1 /* $Id$
2  * mpeg2.h
3  * Copyright (C) 2000-2003 Michel Lespinasse <walken@zoy.org>
4  * Copyright (C) 1999-2000 Aaron Holtzman <aholtzma@ess.engr.uvic.ca>
5  *
6  * This file is part of mpeg2dec, a free MPEG-2 video stream decoder.
7  * See http://libmpeg2.sourceforge.net/ for updates.
8  *
9  * mpeg2dec 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  * mpeg2dec 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-1307  USA
22  */
23
24 #ifndef MPEG2_H
25 #define MPEG2_H
26
27 #define MPEG2_VERSION(a,b,c) (((a)<<16)|((b)<<8)|(c))
28 #define MPEG2_RELEASE MPEG2_VERSION (0, 4, 0)   /* 0.4.0 */
29
30 #define SEQ_FLAG_MPEG2 1
31 #define SEQ_FLAG_CONSTRAINED_PARAMETERS 2
32 #define SEQ_FLAG_PROGRESSIVE_SEQUENCE 4
33 #define SEQ_FLAG_LOW_DELAY 8
34 #define SEQ_FLAG_COLOUR_DESCRIPTION 16
35
36 #define SEQ_MASK_VIDEO_FORMAT 0xe0
37 #define SEQ_VIDEO_FORMAT_COMPONENT 0
38 #define SEQ_VIDEO_FORMAT_PAL 0x20
39 #define SEQ_VIDEO_FORMAT_NTSC 0x40
40 #define SEQ_VIDEO_FORMAT_SECAM 0x60
41 #define SEQ_VIDEO_FORMAT_MAC 0x80
42 #define SEQ_VIDEO_FORMAT_UNSPECIFIED 0xa0
43
44 typedef struct mpeg2_sequence_s
45 {
46     unsigned int width, height;
47     unsigned int chroma_width, chroma_height;
48     unsigned int byte_rate;
49     unsigned int vbv_buffer_size;
50     uint32_t flags;
51
52     unsigned int picture_width, picture_height;
53     unsigned int display_width, display_height;
54     unsigned int pixel_width, pixel_height;
55     unsigned int frame_period;
56
57     uint8_t profile_level_id;
58     uint8_t colour_primaries;
59     uint8_t transfer_characteristics;
60     uint8_t matrix_coefficients;
61     int aspect_ratio_information;
62 } mpeg2_sequence_t;
63
64 #define GOP_FLAG_DROP_FRAME 1
65 #define GOP_FLAG_BROKEN_LINK 2
66 #define GOP_FLAG_CLOSED_GOP 4
67
68 typedef struct mpeg2_gop_s
69 {
70     uint8_t hours;
71     uint8_t minutes;
72     uint8_t seconds;
73     uint8_t pictures;
74     uint32_t flags;
75 } mpeg2_gop_t;
76
77 #define PIC_MASK_CODING_TYPE 7
78 #define PIC_FLAG_CODING_TYPE_I 1
79 #define PIC_FLAG_CODING_TYPE_P 2
80 #define PIC_FLAG_CODING_TYPE_B 3
81 #define PIC_FLAG_CODING_TYPE_D 4
82
83 #define PIC_FLAG_TOP_FIELD_FIRST 8
84 #define PIC_FLAG_PROGRESSIVE_FRAME 16
85 #define PIC_FLAG_COMPOSITE_DISPLAY 32
86 #define PIC_FLAG_SKIP 64
87 #define PIC_FLAG_TAGS 128
88 #define PIC_MASK_COMPOSITE_DISPLAY 0xfffff000
89
90 typedef struct mpeg2_picture_s
91 {
92     unsigned int temporal_reference;
93     unsigned int nb_fields;
94     uint32_t tag, tag2;
95     uint32_t flags;
96     struct {
97         int x, y;
98     } display_offset[3];
99 } mpeg2_picture_t;
100
101 typedef struct mpeg2_fbuf_s
102 {
103     uint8_t * buf[3];
104     void * id;
105 } mpeg2_fbuf_t;
106
107 typedef struct mpeg2_info_s
108 {
109     const mpeg2_sequence_t * sequence;
110     const mpeg2_gop_t * gop;
111     const mpeg2_picture_t * current_picture;
112     const mpeg2_picture_t * current_picture_2nd;
113     const mpeg2_fbuf_t * current_fbuf;
114     const mpeg2_picture_t * display_picture;
115     const mpeg2_picture_t * display_picture_2nd;
116     const mpeg2_fbuf_t * display_fbuf;
117     const mpeg2_fbuf_t * discard_fbuf;
118     const uint8_t * user_data;
119     unsigned int user_data_len;
120 } mpeg2_info_t;
121
122 typedef struct mpeg2dec_s mpeg2dec_t;
123 typedef struct mpeg2_decoder_s mpeg2_decoder_t;
124
125 typedef enum
126 {
127     STATE_BUFFER = 0,
128     STATE_SEQUENCE = 1,
129     STATE_SEQUENCE_REPEATED = 2,
130     STATE_GOP = 3,
131     STATE_PICTURE = 4,
132     STATE_SLICE_1ST = 5,
133     STATE_PICTURE_2ND = 6,
134     STATE_SLICE = 7,
135     STATE_END = 8,
136     STATE_INVALID = 9,
137     STATE_INVALID_END = 10
138 } mpeg2_state_t;
139
140 typedef struct mpeg2_convert_init_s
141 {
142     unsigned int id_size;
143     unsigned int buf_size[3];
144     void (* start) (void * id, const mpeg2_fbuf_t * fbuf,
145                     const mpeg2_picture_t * picture, const mpeg2_gop_t * gop);
146     void (* copy) (void * id, uint8_t * const * src, unsigned int v_offset);
147 } mpeg2_convert_init_t;
148
149 typedef enum
150 {
151     MPEG2_CONVERT_SET = 0,
152     MPEG2_CONVERT_STRIDE = 1,
153     MPEG2_CONVERT_START = 2
154 } mpeg2_convert_stage_t;
155
156 typedef int mpeg2_convert_t (int stage, void * id,
157                              const mpeg2_sequence_t * sequence, int stride,
158                              uint32_t accel, void * arg,
159                              mpeg2_convert_init_t * result);
160 int mpeg2_convert (mpeg2dec_t * mpeg2dec, mpeg2_convert_t convert, void * arg);
161 int mpeg2_stride (mpeg2dec_t * mpeg2dec, int stride);
162 void mpeg2_set_buf (mpeg2dec_t * mpeg2dec, uint8_t * buf[3], void * id);
163 void mpeg2_custom_fbuf (mpeg2dec_t * mpeg2dec, int custom_fbuf);
164
165 #define MPEG2_ACCEL_X86_MMX 1
166 #define MPEG2_ACCEL_X86_3DNOW 2
167 #define MPEG2_ACCEL_X86_MMXEXT 4
168 #define MPEG2_ACCEL_PPC_ALTIVEC 1
169 #define MPEG2_ACCEL_ALPHA 1
170 #define MPEG2_ACCEL_ALPHA_MVI 2
171 #define MPEG2_ACCEL_SPARC_VIS 1
172 #define MPEG2_ACCEL_SPARC_VIS2 2
173 #define MPEG2_ACCEL_DETECT 0x80000000
174
175 uint32_t mpeg2_accel (uint32_t accel);
176 mpeg2dec_t * mpeg2_init (void);
177 const mpeg2_info_t * mpeg2_info (mpeg2dec_t * mpeg2dec);
178 void mpeg2_close (mpeg2dec_t * mpeg2dec);
179
180 void mpeg2_buffer (mpeg2dec_t * mpeg2dec, uint8_t * start, uint8_t * end);
181 int mpeg2_getpos (mpeg2dec_t * mpeg2dec);
182 mpeg2_state_t mpeg2_parse (mpeg2dec_t * mpeg2dec);
183
184 void mpeg2_reset (mpeg2dec_t * mpeg2dec, int full_reset);
185 void mpeg2_skip (mpeg2dec_t * mpeg2dec, int skip);
186 void mpeg2_slice_region (mpeg2dec_t * mpeg2dec, int start, int end);
187
188 void mpeg2_tag_picture (mpeg2dec_t * mpeg2dec, uint32_t tag, uint32_t tag2);
189
190 void mpeg2_init_fbuf (mpeg2_decoder_t * decoder, uint8_t * current_fbuf[3],
191                       uint8_t * forward_fbuf[3], uint8_t * backward_fbuf[3]);
192
193 typedef enum
194 {
195     MPEG2_ALLOC_MPEG2DEC = 0,
196     MPEG2_ALLOC_CHUNK = 1,
197     MPEG2_ALLOC_YUV = 2,
198     MPEG2_ALLOC_CONVERT_ID = 3,
199     MPEG2_ALLOC_CONVERTED = 4
200 } mpeg2_alloc_t;
201
202 void * mpeg2_malloc (unsigned size, mpeg2_alloc_t reason);
203 void mpeg2_free (void * buf);
204 void mpeg2_malloc_hooks (void * malloc (unsigned, mpeg2_alloc_t),
205                          int free (void *));
206
207 #endif /* MPEG2_H */