3 |
* XVID MPEG-4 VIDEO CODEC |
* XVID MPEG-4 VIDEO CODEC |
4 |
* - Bitstream reader/writer inlined functions and constants- |
* - Bitstream reader/writer inlined functions and constants- |
5 |
* |
* |
6 |
* Copyright (C) 2001-2002 - Peter Ross <pross@xvid.org> |
* Copyright (C) 2001-2003 Peter Ross <pross@xvid.org> |
7 |
* |
* |
8 |
* This file is part of XviD, a free MPEG-4 video encoder/decoder |
* 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 |
|
* XviD is free software; you can redistribute it and/or modify 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 |
* the Free Software Foundation; either version 2 of the License, or |
11 |
* (at your option) any later version. |
* (at your option) any later version. |
12 |
* |
* |
19 |
* along with this program; if not, write to the Free Software |
* along with this program; if not, write to the Free Software |
20 |
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
21 |
* |
* |
22 |
* Under section 8 of the GNU General Public License, the copyright |
* $Id: bitstream.h,v 1.17.2.5 2003-06-09 13:51:46 edgomez Exp $ |
|
* holders of XVID explicitly forbid distribution in the following |
|
|
* countries: |
|
|
* |
|
|
* - Japan |
|
|
* - United States of America |
|
|
* |
|
|
* Linking XviD statically or dynamically with other modules is making a |
|
|
* combined work based on XviD. Thus, the terms and conditions of the |
|
|
* GNU General Public License cover the whole combination. |
|
|
* |
|
|
* As a special exception, the copyright holders of XviD give you |
|
|
* permission to link XviD with independent modules that communicate with |
|
|
* XviD solely through the VFW1.1 and DShow interfaces, regardless of the |
|
|
* license terms of these independent modules, and to copy and distribute |
|
|
* the resulting combined work under terms of your choice, provided that |
|
|
* every copy of the combined work is accompanied by a complete copy of |
|
|
* the source code of XviD (the version of XviD used to produce the |
|
|
* combined work), being distributed under the terms of the GNU General |
|
|
* Public License plus this exception. An independent module is a module |
|
|
* which is not derived from or based on XviD. |
|
|
* |
|
|
* Note that people who make modified versions of XviD are not obligated |
|
|
* to grant this special exception for their modified versions; it is |
|
|
* their choice whether to do so. The GNU General Public License gives |
|
|
* permission to release a modified version without this exception; this |
|
|
* exception also makes it possible to release a modified version which |
|
|
* carries forward this exception. |
|
|
* |
|
|
* $Id: bitstream.h,v 1.15 2002-11-26 23:44:10 edgomez Exp $ |
|
23 |
* |
* |
24 |
****************************************************************************/ |
****************************************************************************/ |
25 |
|
|
45 |
#define GRPOFVOP_START_CODE 0x000001b3 |
#define GRPOFVOP_START_CODE 0x000001b3 |
46 |
/*#define VIDSESERR_ERROR_CODE 0x000001b4 */ |
/*#define VIDSESERR_ERROR_CODE 0x000001b4 */ |
47 |
#define VISOBJ_START_CODE 0x000001b5 |
#define VISOBJ_START_CODE 0x000001b5 |
48 |
/*#define SLICE_START_CODE 0x000001b7 */ |
#define VOP_START_CODE 0x000001b6 |
49 |
/*#define EXT_START_CODE 0x000001b8 */ |
/*#define STUFFING_START_CODE 0x000001c3 */ |
50 |
|
|
51 |
|
|
52 |
#define VISOBJ_TYPE_VIDEO 1 |
#define VISOBJ_TYPE_VIDEO 1 |
58 |
|
|
59 |
#define VIDOBJLAY_TYPE_SIMPLE 1 |
#define VIDOBJLAY_TYPE_SIMPLE 1 |
60 |
/*#define VIDOBJLAY_TYPE_SIMPLE_SCALABLE 2 */ |
/*#define VIDOBJLAY_TYPE_SIMPLE_SCALABLE 2 */ |
61 |
#define VIDOBJLAY_TYPE_CORE 3 |
/*#define VIDOBJLAY_TYPE_CORE 3 */ |
62 |
#define VIDOBJLAY_TYPE_MAIN 4 |
/*#define VIDOBJLAY_TYPE_MAIN 4 */ |
63 |
|
/*#define VIDOBJLAY_TYPE_NBIT 5 */ |
64 |
|
/*#define VIDOBJLAY_TYPE_ANIM_TEXT 6 */ |
65 |
|
/*#define VIDOBJLAY_TYPE_ANIM_MESH 7 */ |
66 |
|
/*#define VIDOBJLAY_TYPE_SIMPLE_FACE 8 */ |
67 |
|
/*#define VIDOBJLAY_TYPE_STILL_SCALABLE 9 */ |
68 |
|
#define VIDOBJLAY_TYPE_ART_SIMPLE 10 |
69 |
|
/*#define VIDOBJLAY_TYPE_CORE_SCALABLE 11 */ |
70 |
|
/*#define VIDOBJLAY_TYPE_ACE 12 */ |
71 |
|
/*#define VIDOBJLAY_TYPE_ADVANCED_SCALABLE_TEXTURE 13 */ |
72 |
|
/*#define VIDOBJLAY_TYPE_SIMPLE_FBA 14 */ |
73 |
|
/*#define VIDEOJLAY_TYPE_SIMPLE_STUDIO 15*/ |
74 |
|
/*#define VIDEOJLAY_TYPE_CORE_STUDIO 16*/ |
75 |
|
#define VIDOBJLAY_TYPE_ASP 17 |
76 |
|
/*#define VIDOBJLAY_TYPE_FGS 18*/ |
77 |
|
|
78 |
|
|
79 |
/*#define VIDOBJLAY_AR_SQUARE 1 */ |
/*#define VIDOBJLAY_AR_SQUARE 1 */ |
89 |
#define VIDOBJLAY_SHAPE_BINARY_ONLY 2 |
#define VIDOBJLAY_SHAPE_BINARY_ONLY 2 |
90 |
#define VIDOBJLAY_SHAPE_GRAYSCALE 3 |
#define VIDOBJLAY_SHAPE_GRAYSCALE 3 |
91 |
|
|
92 |
#define VO_START_CODE 0x8 |
|
93 |
#define VOL_START_CODE 0x12 |
#define SPRITE_NONE 0 |
94 |
#define VOP_START_CODE 0x1b6 |
#define SPRITE_STATIC 1 |
95 |
|
#define SPRITE_GMC 2 |
96 |
|
|
97 |
|
|
98 |
|
|
99 |
#define READ_MARKER() BitstreamSkip(bs, 1) |
#define READ_MARKER() BitstreamSkip(bs, 1) |
100 |
#define WRITE_MARKER() BitstreamPutBit(bs, 1) |
#define WRITE_MARKER() BitstreamPutBit(bs, 1) |
116 |
* Prototypes |
* Prototypes |
117 |
****************************************************************************/ |
****************************************************************************/ |
118 |
|
|
119 |
int |
int read_video_packet_header(Bitstream *bs, |
120 |
read_video_packet_header(Bitstream *bs, const int addbits, int * quant); |
DECODER * dec, |
121 |
|
const int addbits, |
122 |
|
int *quant, |
123 |
|
int *fcode_forward, |
124 |
|
int *fcode_backward, |
125 |
|
int *intra_dc_threshold); |
126 |
|
|
127 |
/* header stuff */ |
/* header stuff */ |
128 |
int BitstreamReadHeaders(Bitstream * bs, |
int BitstreamReadHeaders(Bitstream * bs, |
129 |
DECODER * dec, |
DECODER * dec, |
130 |
uint32_t * rounding, |
uint32_t * rounding, |
131 |
|
uint32_t * reduced_resolution, |
132 |
uint32_t * quant, |
uint32_t * quant, |
133 |
uint32_t * fcode_forward, |
uint32_t * fcode_forward, |
134 |
uint32_t * fcode_backward, |
uint32_t * fcode_backward, |
135 |
uint32_t * intra_dc_threshold); |
uint32_t * intra_dc_threshold, |
136 |
|
WARPPOINTS * gmc_warp); |
137 |
|
|
138 |
|
|
139 |
void BitstreamWriteVolHeader(Bitstream * const bs, |
void BitstreamWriteVolHeader(Bitstream * const bs, |
140 |
const MBParam * pParam, |
const MBParam * pParam); |
|
const FRAMEINFO * frame); |
|
141 |
|
|
142 |
void BitstreamWriteVopHeader(Bitstream * const bs, |
void BitstreamWriteVopHeader(Bitstream * const bs, |
143 |
const MBParam * pParam, |
const MBParam * pParam, |
144 |
const FRAMEINFO * frame, |
const FRAMEINFO * const frame, |
145 |
int vop_coded); |
int vop_coded); |
146 |
|
|
147 |
/***************************************************************************** |
void BitstreamWriteUserData(Bitstream * const bs, |
148 |
* Inlined functions |
uint8_t * data, |
149 |
****************************************************************************/ |
const int length); |
150 |
|
|
151 |
/* initialise bitstream structure */ |
/* initialise bitstream structure */ |
152 |
|
|
156 |
uint32_t length) |
uint32_t length) |
157 |
{ |
{ |
158 |
uint32_t tmp; |
uint32_t tmp; |
159 |
|
size_t bitpos; |
160 |
|
ptr_t adjbitstream = (ptr_t)bitstream; |
161 |
|
|
162 |
bs->start = bs->tail = (uint32_t *) bitstream; |
/* |
163 |
|
* Start the stream on a uint32_t boundary, by rounding down to the |
164 |
|
* previous uint32_t and skipping the intervening bytes. |
165 |
|
*/ |
166 |
|
bitpos = ((sizeof(uint32_t)-1) & (size_t)bitstream); |
167 |
|
adjbitstream = adjbitstream - bitpos; |
168 |
|
bs->start = bs->tail = (uint32_t *) adjbitstream; |
169 |
|
|
170 |
tmp = *(uint32_t *) bitstream; |
tmp = *bs->start; |
171 |
#ifndef ARCH_IS_BIG_ENDIAN |
#ifndef ARCH_IS_BIG_ENDIAN |
172 |
BSWAP(tmp); |
BSWAP(tmp); |
173 |
#endif |
#endif |
174 |
bs->bufa = tmp; |
bs->bufa = tmp; |
175 |
|
|
176 |
tmp = *((uint32_t *) bitstream + 1); |
tmp = *(bs->start + 1); |
177 |
#ifndef ARCH_IS_BIG_ENDIAN |
#ifndef ARCH_IS_BIG_ENDIAN |
178 |
BSWAP(tmp); |
BSWAP(tmp); |
179 |
#endif |
#endif |
180 |
bs->bufb = tmp; |
bs->bufb = tmp; |
181 |
|
|
182 |
bs->buf = 0; |
bs->buf = 0; |
183 |
bs->pos = 0; |
bs->pos = bs->initpos = bitpos*8; |
184 |
bs->length = length; |
bs->length = length; |
185 |
} |
} |
186 |
|
|
207 |
bs->bufb = tmp; |
bs->bufb = tmp; |
208 |
|
|
209 |
bs->buf = 0; |
bs->buf = 0; |
210 |
bs->pos = 0; |
bs->pos = bs->initpos; |
211 |
} |
} |
212 |
|
|
213 |
|
|
231 |
|
|
232 |
/* skip n bits forward in bitstream */ |
/* skip n bits forward in bitstream */ |
233 |
|
|
234 |
static void __inline |
static __inline void |
235 |
BitstreamSkip(Bitstream * const bs, |
BitstreamSkip(Bitstream * const bs, |
236 |
const uint32_t bits) |
const uint32_t bits) |
237 |
{ |
{ |
253 |
|
|
254 |
|
|
255 |
/* number of bits to next byte alignment */ |
/* number of bits to next byte alignment */ |
256 |
static uint32_t __inline |
static __inline uint32_t |
257 |
BitstreamNumBitsToByteAlign(Bitstream *bs) |
BitstreamNumBitsToByteAlign(Bitstream *bs) |
258 |
{ |
{ |
259 |
uint32_t n = (32 - bs->pos) % 8; |
uint32_t n = (32 - bs->pos) % 8; |
262 |
|
|
263 |
|
|
264 |
/* show nbits from next byte alignment */ |
/* show nbits from next byte alignment */ |
265 |
static uint32_t __inline |
static __inline uint32_t |
266 |
BitstreamShowBitsFromByteAlign(Bitstream *bs, int bits) |
BitstreamShowBitsFromByteAlign(Bitstream *bs, int bits) |
267 |
{ |
{ |
268 |
int bspos = bs->pos + BitstreamNumBitsToByteAlign(bs); |
int bspos = bs->pos + BitstreamNumBitsToByteAlign(bs); |
284 |
|
|
285 |
/* move forward to the next byte boundary */ |
/* move forward to the next byte boundary */ |
286 |
|
|
287 |
static void __inline |
static __inline void |
288 |
BitstreamByteAlign(Bitstream * const bs) |
BitstreamByteAlign(Bitstream * const bs) |
289 |
{ |
{ |
290 |
uint32_t remainder = bs->pos % 8; |
uint32_t remainder = bs->pos % 8; |
300 |
static uint32_t __inline |
static uint32_t __inline |
301 |
BitstreamPos(const Bitstream * const bs) |
BitstreamPos(const Bitstream * const bs) |
302 |
{ |
{ |
303 |
return 8 * ((ptr_t)bs->tail - (ptr_t)bs->start) + bs->pos; |
return((uint32_t)(8*((ptr_t)bs->tail - (ptr_t)bs->start) + bs->pos - bs->initpos)); |
304 |
} |
} |
305 |
|
|
306 |
|
|
307 |
/* flush the bitstream & return length (unit bytes) |
/* |
308 |
NOTE: assumes no futher bitstream functions will be called. |
* flush the bitstream & return length (unit bytes) |
309 |
|
* NOTE: assumes no futher bitstream functions will be called. |
310 |
*/ |
*/ |
311 |
|
|
312 |
static uint32_t __inline |
static uint32_t __inline |
313 |
BitstreamLength(Bitstream * const bs) |
BitstreamLength(Bitstream * const bs) |
314 |
{ |
{ |
315 |
uint32_t len = (ptr_t) bs->tail - (ptr_t) bs->start; |
uint32_t len = (uint32_t)((ptr_t)bs->tail - (ptr_t)bs->start); |
316 |
|
|
317 |
if (bs->pos) { |
if (bs->pos) { |
318 |
uint32_t b = bs->buf; |
uint32_t b = bs->buf; |
325 |
len += (bs->pos + 7) / 8; |
len += (bs->pos + 7) / 8; |
326 |
} |
} |
327 |
|
|
328 |
|
/* initpos is always on a byte boundary */ |
329 |
|
if (bs->initpos) |
330 |
|
len -= bs->initpos/8; |
331 |
|
|
332 |
return len; |
return len; |
333 |
} |
} |
334 |
|
|
353 |
} |
} |
354 |
} |
} |
355 |
|
|
|
|
|
|
/* 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); |
|
|
} |
|
|
} |
|
|
|
|
|
|
|
356 |
/* read n bits from bitstream */ |
/* read n bits from bitstream */ |
357 |
|
|
358 |
static uint32_t __inline |
static uint32_t __inline |
415 |
} |
} |
416 |
} |
} |
417 |
|
|
418 |
|
static const int stuffing_codes[8] = |
419 |
|
{ |
420 |
|
/* nbits stuffing code */ |
421 |
|
0, /* 1 0 */ |
422 |
|
1, /* 2 01 */ |
423 |
|
3, /* 3 011 */ |
424 |
|
7, /* 4 0111 */ |
425 |
|
0xf, /* 5 01111 */ |
426 |
|
0x1f, /* 6 011111 */ |
427 |
|
0x3f, /* 7 0111111 */ |
428 |
|
0x7f, /* 8 01111111 */ |
429 |
|
}; |
430 |
|
|
431 |
|
/* pad bitstream to the next byte boundary */ |
432 |
|
|
433 |
|
static void __inline |
434 |
|
BitstreamPad(Bitstream * const bs) |
435 |
|
{ |
436 |
|
int bits = 8 - (bs->pos % 8); |
437 |
|
if (bits < 8) |
438 |
|
BitstreamPutBits(bs, stuffing_codes[bits - 1], bits); |
439 |
|
} |
440 |
|
|
441 |
|
|
442 |
|
/* |
443 |
|
* pad bitstream to the next byte boundary |
444 |
|
* alway pad: even if currently at the byte boundary |
445 |
|
*/ |
446 |
|
|
447 |
|
static void __inline |
448 |
|
BitstreamPadAlways(Bitstream * const bs) |
449 |
|
{ |
450 |
|
int bits = 8 - (bs->pos % 8); |
451 |
|
BitstreamPutBits(bs, stuffing_codes[bits - 1], bits); |
452 |
|
} |
453 |
|
|
454 |
#endif /* _BITSTREAM_H_ */ |
#endif /* _BITSTREAM_H_ */ |