1 |
/***************************************************************************** |
/****************************************************************************** |
2 |
* |
* * |
3 |
* XVID MPEG-4 VIDEO CODEC |
* This file is part of XviD, a free MPEG-4 video encoder/decoder * |
4 |
* - Bitstream reader/writer inlined functions and constants- |
* * |
5 |
* |
* XviD is an implementation of a part of one or more MPEG-4 Video tools * |
6 |
* Copyright (C) 2001-2002 - Peter Ross <pross@xvid.org> |
* as specified in ISO/IEC 14496-2 standard. Those intending to use this * |
7 |
* |
* software module in hardware or software products are advised that its * |
8 |
* This file is part of XviD, a free MPEG-4 video encoder/decoder |
* use may infringe existing patents or copyrights, and any such use * |
9 |
* |
* would be at such party's own risk. The original developer of this * |
10 |
* XviD is free software; you can redistribute it and/or modify it |
* software module and his/her company, and subsequent editors and their * |
11 |
* under the terms of the GNU General Public License as published by |
* companies, will have no liability for use of this software or * |
12 |
* the Free Software Foundation; either version 2 of the License, or |
* modifications or derivatives thereof. * |
13 |
* (at your option) any later version. |
* * |
14 |
* |
* XviD is free software; you can redistribute it and/or modify it * |
15 |
* This program is distributed in the hope that it will be useful, |
* under the terms of the GNU General Public License as published by * |
16 |
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
* the Free Software Foundation; either version 2 of the License, or * |
17 |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
* (at your option) any later version. * |
18 |
* GNU General Public License for more details. |
* * |
19 |
* |
* XviD is distributed in the hope that it will be useful, but * |
20 |
* You should have received a copy of the GNU General Public License |
* WITHOUT ANY WARRANTY; without even the implied warranty of * |
21 |
* along with this program; if not, write to the Free Software |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * |
22 |
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
* GNU General Public License for more details. * |
23 |
* |
* * |
24 |
* Under section 8 of the GNU General Public License, the copyright |
* You should have received a copy of the GNU General Public License * |
25 |
* holders of XVID explicitly forbid distribution in the following |
* along with this program; if not, write to the Free Software * |
26 |
* countries: |
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA * |
27 |
* |
* * |
28 |
* - Japan |
******************************************************************************/ |
29 |
* - United States of America |
|
30 |
* |
/****************************************************************************** |
31 |
* Linking XviD statically or dynamically with other modules is making a |
* * |
32 |
* combined work based on XviD. Thus, the terms and conditions of the |
* bitstream.h * |
33 |
* GNU General Public License cover the whole combination. |
* * |
34 |
* |
* Copyright (C) 2001 - Peter Ross <pross@cs.rmit.edu.au> * |
35 |
* As a special exception, the copyright holders of XviD give you |
* * |
36 |
* permission to link XviD with independent modules that communicate with |
* For more information visit the XviD homepage: http://www.xvid.org * |
37 |
* XviD solely through the VFW1.1 and DShow interfaces, regardless of the |
* * |
38 |
* license terms of these independent modules, and to copy and distribute |
******************************************************************************/ |
39 |
* the resulting combined work under terms of your choice, provided that |
|
40 |
* every copy of the combined work is accompanied by a complete copy of |
/****************************************************************************** |
41 |
* the source code of XviD (the version of XviD used to produce the |
* * |
42 |
* combined work), being distributed under the terms of the GNU General |
* Revision history: * |
43 |
* Public License plus this exception. An independent module is a module |
* * |
44 |
* which is not derived from or based on XviD. |
* 28.06.2002 addded BitstreamNumBitsToByteAlign() * |
45 |
* |
* BitstreamShowBitsFromByteAlign() * |
46 |
* Note that people who make modified versions of XviD are not obligated |
* 26.03.2002 interlacing support - modified putvol/vopheaders paramters * |
47 |
* to grant this special exception for their modified versions; it is |
* 04.03.2002 putbits speedup (Isibaar) * |
48 |
* their choice whether to do so. The GNU General Public License gives |
* 03.03.2002 merged BITREADER and BITWRITER (Isibaar) * |
49 |
* permission to release a modified version without this exception; this |
* 16.12.2001 inital version * |
50 |
* exception also makes it possible to release a modified version which |
* * |
51 |
* carries forward this exception. |
******************************************************************************/ |
|
* |
|
|
* $Id: bitstream.h,v 1.16 2003-02-09 19:32:52 edgomez Exp $ |
|
|
* |
|
|
****************************************************************************/ |
|
52 |
|
|
53 |
#ifndef _BITSTREAM_H_ |
#ifndef _BITSTREAM_H_ |
54 |
#define _BITSTREAM_H_ |
#define _BITSTREAM_H_ |
57 |
#include "../decoder.h" |
#include "../decoder.h" |
58 |
#include "../encoder.h" |
#include "../encoder.h" |
59 |
|
|
60 |
|
// comment any #defs we dont use |
61 |
|
|
62 |
/***************************************************************************** |
/* start codes */ |
|
* Constants |
|
|
****************************************************************************/ |
|
|
|
|
|
/* comment any #defs we dont use */ |
|
63 |
|
|
64 |
#define VIDOBJ_START_CODE 0x00000100 /* ..0x0000011f */ |
#define VIDOBJ_START_CODE 0x00000100 /* ..0x0000011f */ |
65 |
#define VIDOBJLAY_START_CODE 0x00000120 /* ..0x0000012f */ |
#define VIDOBJLAY_START_CODE 0x00000120 /* ..0x0000012f */ |
67 |
#define VISOBJSEQ_STOP_CODE 0x000001b1 /* ??? */ |
#define VISOBJSEQ_STOP_CODE 0x000001b1 /* ??? */ |
68 |
#define USERDATA_START_CODE 0x000001b2 |
#define USERDATA_START_CODE 0x000001b2 |
69 |
#define GRPOFVOP_START_CODE 0x000001b3 |
#define GRPOFVOP_START_CODE 0x000001b3 |
70 |
/*#define VIDSESERR_ERROR_CODE 0x000001b4 */ |
//#define VIDSESERR_ERROR_CODE 0x000001b4 |
71 |
#define VISOBJ_START_CODE 0x000001b5 |
#define VISOBJ_START_CODE 0x000001b5 |
72 |
/*#define SLICE_START_CODE 0x000001b7 */ |
#define VOP_START_CODE 0x000001b6 |
73 |
/*#define EXT_START_CODE 0x000001b8 */ |
//#define STUFFING_START_CODE 0x000001c3 |
74 |
|
|
75 |
|
|
76 |
#define VISOBJ_TYPE_VIDEO 1 |
#define VISOBJ_TYPE_VIDEO 1 |
77 |
/*#define VISOBJ_TYPE_STILLTEXTURE 2 */ |
//#define VISOBJ_TYPE_STILLTEXTURE 2 |
78 |
/*#define VISOBJ_TYPE_MESH 3 */ |
//#define VISOBJ_TYPE_MESH 3 |
79 |
/*#define VISOBJ_TYPE_FBA 4 */ |
//#define VISOBJ_TYPE_FBA 4 |
80 |
/*#define VISOBJ_TYPE_3DMESH 5 */ |
//#define VISOBJ_TYPE_3DMESH 5 |
81 |
|
|
82 |
|
|
83 |
#define VIDOBJLAY_TYPE_SIMPLE 1 |
#define VIDOBJLAY_TYPE_SIMPLE 1 |
84 |
/*#define VIDOBJLAY_TYPE_SIMPLE_SCALABLE 2 */ |
//#define VIDOBJLAY_TYPE_SIMPLE_SCALABLE 2 |
85 |
#define VIDOBJLAY_TYPE_CORE 3 |
#define VIDOBJLAY_TYPE_CORE 3 |
86 |
#define VIDOBJLAY_TYPE_MAIN 4 |
#define VIDOBJLAY_TYPE_MAIN 4 |
87 |
|
//#define VIDOBJLAY_TYPE_NBIT 5 |
88 |
|
//#define VIDOBJLAY_TYPE_ANIM_TEXT 6 |
89 |
/*#define VIDOBJLAY_AR_SQUARE 1 */ |
//#define VIDOBJLAY_TYPE_ANIM_MESH 7 |
90 |
/*#define VIDOBJLAY_AR_625TYPE_43 2 */ |
//#define VIDOBJLAY_TYPE_SIMPLE_FACE 8 |
91 |
/*#define VIDOBJLAY_AR_525TYPE_43 3 */ |
//#define VIDOBJLAY_TYPE_STILL_SCALABLE 9 |
92 |
/*#define VIDOBJLAY_AR_625TYPE_169 8 */ |
#define VIDOBJLAY_TYPE_ART_SIMPLE 10 |
93 |
/*#define VIDOBJLAY_AR_525TYPE_169 9 */ |
//#define VIDOBJLAY_TYPE_CORE_SCALABLE 11 |
94 |
|
#define VIDOBJLAY_TYPE_ACE 12 |
95 |
|
//#define VIDOBJLAY_TYPE_SIMPLE_FBA 13 |
96 |
|
|
97 |
|
|
98 |
|
//#define VIDOBJLAY_AR_SQUARE 1 |
99 |
|
//#define VIDOBJLAY_AR_625TYPE_43 2 |
100 |
|
//#define VIDOBJLAY_AR_525TYPE_43 3 |
101 |
|
//#define VIDOBJLAY_AR_625TYPE_169 8 |
102 |
|
//#define VIDOBJLAY_AR_525TYPE_169 9 |
103 |
#define VIDOBJLAY_AR_EXTPAR 15 |
#define VIDOBJLAY_AR_EXTPAR 15 |
104 |
|
|
105 |
|
|
108 |
#define VIDOBJLAY_SHAPE_BINARY_ONLY 2 |
#define VIDOBJLAY_SHAPE_BINARY_ONLY 2 |
109 |
#define VIDOBJLAY_SHAPE_GRAYSCALE 3 |
#define VIDOBJLAY_SHAPE_GRAYSCALE 3 |
110 |
|
|
111 |
#define VO_START_CODE 0x8 |
|
112 |
#define VOL_START_CODE 0x12 |
#define SPRITE_NONE 0 |
113 |
#define VOP_START_CODE 0x1b6 |
#define SPRITE_STATIC 1 |
114 |
|
#define SPRITE_GMC 2 |
115 |
|
|
116 |
|
|
117 |
|
|
118 |
#define READ_MARKER() BitstreamSkip(bs, 1) |
#define READ_MARKER() BitstreamSkip(bs, 1) |
119 |
#define WRITE_MARKER() BitstreamPutBit(bs, 1) |
#define WRITE_MARKER() BitstreamPutBit(bs, 1) |
120 |
|
|
121 |
/* vop coding types */ |
// vop coding types |
122 |
/* intra, prediction, backward, sprite, not_coded */ |
// intra, prediction, backward, sprite, not_coded |
123 |
#define I_VOP 0 |
#define I_VOP 0 |
124 |
#define P_VOP 1 |
#define P_VOP 1 |
125 |
#define B_VOP 2 |
#define B_VOP 2 |
126 |
#define S_VOP 3 |
#define S_VOP 3 |
127 |
#define N_VOP 4 |
#define N_VOP 4 |
128 |
|
|
129 |
/* resync-specific */ |
// resync-specific |
130 |
#define NUMBITS_VP_RESYNC_MARKER 17 |
#define NUMBITS_VP_RESYNC_MARKER 17 |
131 |
#define RESYNC_MARKER 1 |
#define RESYNC_MARKER 1 |
132 |
|
|
133 |
|
|
134 |
/***************************************************************************** |
int read_video_packet_header(Bitstream *bs, |
135 |
* Prototypes |
DECODER * dec, |
136 |
****************************************************************************/ |
const int addbits, |
137 |
|
int * quant, |
138 |
int |
int * fcode_forward, |
139 |
read_video_packet_header(Bitstream *bs, const int addbits, int * quant); |
int * fcode_backward, |
140 |
|
int * intra_dc_threshold); |
141 |
|
|
142 |
|
|
143 |
/* header stuff */ |
// header stuff |
144 |
int BitstreamReadHeaders(Bitstream * bs, |
int BitstreamReadHeaders(Bitstream * bs, |
145 |
DECODER * dec, |
DECODER * dec, |
146 |
uint32_t * rounding, |
uint32_t * rounding, |
147 |
|
uint32_t * reduced_resolution, |
148 |
uint32_t * quant, |
uint32_t * quant, |
149 |
uint32_t * fcode_forward, |
uint32_t * fcode_forward, |
150 |
uint32_t * fcode_backward, |
uint32_t * fcode_backward, |
151 |
uint32_t * intra_dc_threshold); |
uint32_t * intra_dc_threshold, |
152 |
|
WARPPOINTS * gmc_warp); |
153 |
|
|
154 |
|
|
155 |
void BitstreamWriteVolHeader(Bitstream * const bs, |
void BitstreamWriteVolHeader(Bitstream * const bs, |
156 |
const MBParam * pParam, |
const MBParam * pParam, |
157 |
const FRAMEINFO * frame); |
const FRAMEINFO * const frame); |
158 |
|
|
159 |
void BitstreamWriteVopHeader(Bitstream * const bs, |
void BitstreamWriteVopHeader(Bitstream * const bs, |
160 |
const MBParam * pParam, |
const MBParam * pParam, |
161 |
const FRAMEINFO * frame, |
const FRAMEINFO * const frame, |
162 |
int vop_coded); |
int vop_coded); |
163 |
|
|
164 |
/***************************************************************************** |
void BitstreamWriteUserData(Bitstream * const bs, |
165 |
* Inlined functions |
uint8_t * data, |
166 |
****************************************************************************/ |
const int length); |
167 |
|
|
168 |
/* initialise bitstream structure */ |
/* initialise bitstream structure */ |
169 |
|
|
240 |
|
|
241 |
/* skip n bits forward in bitstream */ |
/* skip n bits forward in bitstream */ |
242 |
|
|
243 |
static void __inline |
static __inline void |
244 |
BitstreamSkip(Bitstream * const bs, |
BitstreamSkip(Bitstream * const bs, |
245 |
const uint32_t bits) |
const uint32_t bits) |
246 |
{ |
{ |
261 |
} |
} |
262 |
|
|
263 |
|
|
264 |
/* number of bits to next byte alignment */ |
// number of bits to next byte alignment |
265 |
static uint32_t __inline |
static __inline uint32_t |
266 |
BitstreamNumBitsToByteAlign(Bitstream *bs) |
BitstreamNumBitsToByteAlign(Bitstream *bs) |
267 |
{ |
{ |
268 |
uint32_t n = (32 - bs->pos) % 8; |
uint32_t n = (32 - bs->pos) % 8; |
270 |
} |
} |
271 |
|
|
272 |
|
|
273 |
/* show nbits from next byte alignment */ |
// show nbits from next byte alignment |
274 |
static uint32_t __inline |
static __inline uint32_t |
275 |
BitstreamShowBitsFromByteAlign(Bitstream *bs, int bits) |
BitstreamShowBitsFromByteAlign(Bitstream *bs, int bits) |
276 |
{ |
{ |
277 |
int bspos = bs->pos + BitstreamNumBitsToByteAlign(bs); |
int bspos = bs->pos + BitstreamNumBitsToByteAlign(bs); |
293 |
|
|
294 |
/* move forward to the next byte boundary */ |
/* move forward to the next byte boundary */ |
295 |
|
|
296 |
static void __inline |
static __inline void |
297 |
BitstreamByteAlign(Bitstream * const bs) |
BitstreamByteAlign(Bitstream * const bs) |
298 |
{ |
{ |
299 |
uint32_t remainder = bs->pos % 8; |
uint32_t remainder = bs->pos % 8; |
309 |
static uint32_t __inline |
static uint32_t __inline |
310 |
BitstreamPos(const Bitstream * const bs) |
BitstreamPos(const Bitstream * const bs) |
311 |
{ |
{ |
312 |
return((uint32_t)(8*((ptr_t)bs->tail - (ptr_t)bs->start) + bs->pos)); |
return 8 * ((ptr_t)bs->tail - (ptr_t)bs->start) + bs->pos; |
313 |
} |
} |
314 |
|
|
315 |
|
|
320 |
static uint32_t __inline |
static uint32_t __inline |
321 |
BitstreamLength(Bitstream * const bs) |
BitstreamLength(Bitstream * const bs) |
322 |
{ |
{ |
323 |
uint32_t len = (uint32_t)((ptr_t)bs->tail - (ptr_t)bs->start); |
uint32_t len = (ptr_t) bs->tail - (ptr_t) bs->start; |
324 |
|
|
325 |
if (bs->pos) { |
if (bs->pos) { |
326 |
uint32_t b = bs->buf; |
uint32_t b = bs->buf; |
358 |
} |
} |
359 |
|
|
360 |
|
|
|
/* pad bitstream to the next byte boundary */ |
|
|
|
|
|
static void __inline |
|
|
BitstreamPad(Bitstream * const bs) |
|
|
{ |
|
|
uint32_t remainder = bs->pos % 8; |
|
|
|
|
|
if (remainder) { |
|
|
BitstreamForward(bs, 8 - remainder); |
|
|
} |
|
|
} |
|
|
|
|
|
|
|
361 |
/* read n bits from bitstream */ |
/* read n bits from bitstream */ |
362 |
|
|
363 |
static uint32_t __inline |
static uint32_t __inline |
420 |
} |
} |
421 |
} |
} |
422 |
|
|
423 |
|
|
424 |
|
static const int stuffing_codes[8] = |
425 |
|
{ |
426 |
|
/* nbits stuffing code */ |
427 |
|
0, /* 1 0 */ |
428 |
|
1, /* 2 01 */ |
429 |
|
3, /* 3 011 */ |
430 |
|
7, /* 4 0111 */ |
431 |
|
0xf, /* 5 01111 */ |
432 |
|
0x1f, /* 6 011111 */ |
433 |
|
0x3f, /* 7 0111111 */ |
434 |
|
0x7f, /* 8 01111111 */ |
435 |
|
}; |
436 |
|
|
437 |
|
/* pad bitstream to the next byte boundary */ |
438 |
|
|
439 |
|
static void __inline |
440 |
|
BitstreamPad(Bitstream * const bs) |
441 |
|
{ |
442 |
|
int bits = 8 - (bs->pos % 8); |
443 |
|
if (bits < 8) |
444 |
|
{ |
445 |
|
BitstreamPutBits(bs, stuffing_codes[bits - 1], bits); |
446 |
|
} |
447 |
|
} |
448 |
|
|
449 |
|
|
450 |
|
/* pad bitstream to the next byte boundary |
451 |
|
alway pad: even if currently at the byte boundary */ |
452 |
|
|
453 |
|
static void __inline |
454 |
|
BitstreamPadAlways(Bitstream * const bs) |
455 |
|
{ |
456 |
|
int bits = 8 - (bs->pos % 8); |
457 |
|
BitstreamPutBits(bs, stuffing_codes[bits - 1], bits); |
458 |
|
} |
459 |
|
|
460 |
|
|
461 |
#endif /* _BITSTREAM_H_ */ |
#endif /* _BITSTREAM_H_ */ |