coder.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:11k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. /**************************************************************************************
  36.  * Fixed-point MP3 decoder
  37.  * Jon Recker (jrecker@real.com), Ken Cooke (kenc@real.com)
  38.  * June 2003
  39.  *
  40.  * coder.h - private, implementation-specific header file
  41.  **************************************************************************************/
  42. #ifndef _CODER_H
  43. #define _CODER_H
  44. #include "mp3common.h"
  45. #if defined(_WIN32) && defined(_M_IX86) && (defined (_DEBUG) || defined (REL_ENABLE_ASSERTS))
  46. #define ASSERT(x) if (!(x)) __asm int 3;
  47. #else
  48. #define ASSERT(x) /* do nothing */
  49. #endif
  50. #ifndef MAX
  51. #define MAX(a,b) ((a) > (b) ? (a) : (b))
  52. #endif
  53. #ifndef MIN
  54. #define MIN(a,b) ((a) < (b) ? (a) : (b))
  55. #endif
  56. /* clip to range [-2^n, 2^n - 1] */
  57. #define CLIP_2N(y, n) { 
  58. int sign = (y) >> 31;  
  59. if (sign != (y) >> (n))  { 
  60. (y) = sign ^ ((1 << (n)) - 1); 
  61. }
  62. #define SIBYTES_MPEG1_MONO 17
  63. #define SIBYTES_MPEG1_STEREO 32
  64. #define SIBYTES_MPEG2_MONO  9
  65. #define SIBYTES_MPEG2_STEREO 17
  66. /* number of fraction bits for pow43Tab (see comments there) */
  67. #define POW43_FRACBITS_LOW 22
  68. #define POW43_FRACBITS_HIGH 12
  69. #define DQ_FRACBITS_OUT 25 /* number of fraction bits in output of dequant */
  70. #define IMDCT_SCALE 2 /* additional scaling (by sqrt(2)) for fast IMDCT36 */
  71. #define HUFF_PAIRTABS 32
  72. #define BLOCK_SIZE 18
  73. #define NBANDS 32
  74. #define MAX_REORDER_SAMPS ((192-126)*3) /* largest critical band for short blocks (see sfBandTable) */
  75. #define VBUF_LENGTH (17 * 2 * NBANDS) /* for double-sized vbuf FIFO */
  76. /* additional external symbols to name-mangle for static linking */
  77. #define SetBitstreamPointer STATNAME(SetBitstreamPointer)
  78. #define GetBits STATNAME(GetBits)
  79. #define CalcBitsUsed STATNAME(CalcBitsUsed)
  80. #define DequantChannel STATNAME(DequantChannel)
  81. #define MidSideProc STATNAME(MidSideProc)
  82. #define IntensityProcMPEG1 STATNAME(IntensityProcMPEG1)
  83. #define IntensityProcMPEG2 STATNAME(IntensityProcMPEG2)
  84. #define PolyphaseMono STATNAME(PolyphaseMono)
  85. #define PolyphaseStereo STATNAME(PolyphaseStereo)
  86. #define FDCT32 STATNAME(FDCT32)
  87. #define ISFMpeg1 STATNAME(ISFMpeg1)
  88. #define ISFMpeg2 STATNAME(ISFMpeg2)
  89. #define ISFIIP STATNAME(ISFIIP)
  90. #define uniqueIDTab STATNAME(uniqueIDTab)
  91. #define coef32 STATNAME(coef32)
  92. #define polyCoef STATNAME(polyCoef)
  93. #define csa STATNAME(csa)
  94. #define imdctWin STATNAME(imdctWin)
  95. #define huffTable STATNAME(huffTable)
  96. #define huffTabOffset STATNAME(huffTabOffset)
  97. #define huffTabLookup STATNAME(huffTabLookup)
  98. #define quadTable STATNAME(quadTable)
  99. #define quadTabOffset STATNAME(quadTabOffset)
  100. #define quadTabMaxBits STATNAME(quadTabMaxBits)
  101. /* map these to the corresponding 2-bit values in the frame header */
  102. typedef enum {
  103. Stereo = 0x00, /* two independent channels, but L and R frames might have different # of bits */
  104. Joint = 0x01, /* coupled channels - layer III: mix of M-S and intensity, Layers I/II: intensity and direct coding only */
  105. Dual = 0x02, /* two independent channels, L and R always have exactly 1/2 the total bitrate */
  106. Mono = 0x03 /* one channel */
  107. } StereoMode;
  108. typedef struct _BitStreamInfo {
  109. unsigned char *bytePtr;
  110. unsigned int iCache;
  111. int cachedBits;
  112. int nBytes;
  113. } BitStreamInfo;
  114. typedef struct _FrameHeader {
  115.     MPEGVersion ver; /* version ID */
  116.     int layer; /* layer index (1, 2, or 3) */
  117.     int crc; /* CRC flag: 0 = disabled, 1 = enabled */
  118.     int brIdx; /* bitrate index (0 - 15) */
  119.     int srIdx; /* sample rate index (0 - 2) */
  120.     int paddingBit; /* padding flag: 0 = no padding, 1 = single pad byte */
  121.     int privateBit; /* unused */
  122.     StereoMode sMode; /* mono/stereo mode */
  123.     int modeExt; /* used to decipher joint stereo mode */
  124.     int copyFlag; /* copyright flag: 0 = no, 1 = yes */
  125.     int origFlag; /* original flag: 0 = copy, 1 = original */
  126.     int emphasis; /* deemphasis mode */
  127.     int CRCWord; /* CRC word (16 bits, 0 if crc not enabled) */
  128. const SFBandTable *sfBand;
  129. } FrameHeader;
  130. typedef struct _SideInfoSub {
  131.     int part23Length; /* number of bits in main data */ 
  132.     int nBigvals; /* 2x this = first set of Huffman cw's (maximum amplitude can be > 1) */
  133.     int globalGain; /* overall gain for dequantizer */
  134.     int sfCompress; /* unpacked to figure out number of bits in scale factors */
  135.     int winSwitchFlag; /* window switching flag */
  136.     int blockType; /* block type */
  137.     int mixedBlock; /* 0 = regular block (all short or long), 1 = mixed block */
  138.     int tableSelect[3]; /* index of Huffman tables for the big values regions */
  139.     int subBlockGain[3]; /* subblock gain offset, relative to global gain */
  140.     int region0Count; /* 1+region0Count = num scale factor bands in first region of bigvals */
  141.     int region1Count; /* 1+region1Count = num scale factor bands in second region of bigvals */
  142.     int preFlag; /* for optional high frequency boost */
  143.     int sfactScale; /* scaling of the scalefactors */
  144.     int count1TableSelect; /* index of Huffman table for quad codewords */
  145. } SideInfoSub;
  146. typedef struct _SideInfo {
  147. int mainDataBegin;
  148. int privateBits;
  149. int scfsi[MAX_NCHAN][MAX_SCFBD]; /* 4 scalefactor bands per channel */
  150. SideInfoSub sis[MAX_NGRAN][MAX_NCHAN];
  151. } SideInfo;
  152. typedef struct {
  153.     int cbType; /* pure long = 0, pure short = 1, mixed = 2 */
  154.     int cbEndS[3]; /* number nonzero short cb's, per subbblock */
  155. int cbEndSMax; /* max of cbEndS[] */
  156.     int cbEndL; /* number nonzero long cb's  */
  157. } CriticalBandInfo;
  158. typedef struct _DequantInfo {
  159. int workBuf[MAX_REORDER_SAMPS]; /* workbuf for reordering short blocks */
  160. CriticalBandInfo cbi[MAX_NCHAN]; /* filled in dequantizer, used in joint stereo reconstruction */
  161. } DequantInfo;
  162. typedef struct _HuffmanInfo {
  163. int huffDecBuf[MAX_NCHAN][MAX_NSAMP]; /* used both for decoded Huffman values and dequantized coefficients */
  164. int nonZeroBound[MAX_NCHAN]; /* number of coeffs in huffDecBuf[ch] which can be > 0 */
  165. int gb[MAX_NCHAN]; /* minimum number of guard bits in huffDecBuf[ch] */
  166. } HuffmanInfo;
  167. typedef enum _HuffTabType {
  168. noBits,
  169. oneShot,
  170. loopNoLinbits,
  171. loopLinbits,
  172. quadA,
  173. quadB,
  174. invalidTab
  175. } HuffTabType;
  176. typedef struct _HuffTabLookup {
  177. int linBits;
  178. HuffTabType tabType;
  179. } HuffTabLookup;
  180. typedef struct _IMDCTInfo {
  181. int outBuf[MAX_NCHAN][BLOCK_SIZE][NBANDS]; /* output of IMDCT */
  182. int overBuf[MAX_NCHAN][MAX_NSAMP / 2]; /* overlap-add buffer (by symmetry, only need 1/2 size) */
  183. int numPrevIMDCT[MAX_NCHAN]; /* how many IMDCT's calculated in this channel on prev. granule */
  184. int prevType[MAX_NCHAN];
  185. int prevWinSwitch[MAX_NCHAN];
  186. int gb[MAX_NCHAN];
  187. } IMDCTInfo;
  188. typedef struct _BlockCount {
  189. int nBlocksLong;
  190. int nBlocksTotal;
  191. int nBlocksPrev; 
  192. int prevType;
  193. int prevWinSwitch;
  194. int currWinSwitch;
  195. int gbIn;
  196. int gbOut;
  197. } BlockCount;
  198. /* max bits in scalefactors = 5, so use char's to save space */
  199. typedef struct _ScaleFactorInfoSub {
  200. char l[23];            /* [band] */
  201. char s[13][3];         /* [band][window] */
  202. } ScaleFactorInfoSub;  
  203. /* used in MPEG 2, 2.5 intensity (joint) stereo only */
  204. typedef struct _ScaleFactorJS {
  205. int intensityScale;
  206. int slen[4];
  207. int nr[4];
  208. } ScaleFactorJS;
  209. typedef struct _ScaleFactorInfo {
  210. ScaleFactorInfoSub sfis[MAX_NGRAN][MAX_NCHAN];
  211. ScaleFactorJS sfjs;
  212. } ScaleFactorInfo;
  213. /* NOTE - could get by with smaller vbuf if memory is more important than speed
  214.  *  (in Subband, instead of replicating each block in FDCT32 you would do a memmove on the
  215.  *   last 15 blocks to shift them down one, a hardware style FIFO)
  216.  */ 
  217. typedef struct _SubbandInfo {
  218. int vbuf[MAX_NCHAN * VBUF_LENGTH]; /* vbuf for fast DCT-based synthesis PQMF - double size for speed (no modulo indexing) */
  219. int vindex; /* internal index for tracking position in vbuf */
  220. } SubbandInfo;
  221. /* bitstream.c */
  222. void SetBitstreamPointer(BitStreamInfo *bsi, int nBytes, unsigned char *buf);
  223. unsigned int GetBits(BitStreamInfo *bsi, int nBits);
  224. int CalcBitsUsed(BitStreamInfo *bsi, unsigned char *startBuf, int startOffset);
  225. /* dequant.c, dqchan.c, stproc.c */
  226. int DequantChannel(int *sampleBuf, int *workBuf, int *nonZeroBound, FrameHeader *fh, SideInfoSub *sis, 
  227. ScaleFactorInfoSub *sfis, CriticalBandInfo *cbi);
  228. void MidSideProc(int x[MAX_NCHAN][MAX_NSAMP], int nSamps, int mOut[2]);
  229. void IntensityProcMPEG1(int x[MAX_NCHAN][MAX_NSAMP], int nSamps, FrameHeader *fh, ScaleFactorInfoSub *sfis, 
  230. CriticalBandInfo *cbi, int midSideFlag, int mixFlag, int mOut[2]);
  231. void IntensityProcMPEG2(int x[MAX_NCHAN][MAX_NSAMP], int nSamps, FrameHeader *fh, ScaleFactorInfoSub *sfis, 
  232. CriticalBandInfo *cbi, ScaleFactorJS *sfjs, int midSideFlag, int mixFlag, int mOut[2]);
  233. /* dct32.c */
  234. void FDCT32(int *x, int *d, int offset, int oddBlock, int gb);
  235. /* hufftabs.c */
  236. extern const HuffTabLookup huffTabLookup[HUFF_PAIRTABS];
  237. extern const int huffTabOffset[HUFF_PAIRTABS];
  238. extern const unsigned short huffTable[];
  239. extern const unsigned char quadTable[64+16];
  240. extern const int quadTabOffset[2];
  241. extern const int quadTabMaxBits[2];
  242. /* polyphase.c (or asmpoly.s)
  243.  * some platforms require a C++ compile of all source files,
  244.  * so if we're compiling C as C++ and using native assembly
  245.  * for these functions we need to prevent C++ name mangling.
  246.  */
  247. #ifdef __cplusplus
  248. extern "C" {
  249. #endif
  250. void PolyphaseMono(short *pcm, int *vbuf, const int *coefBase);
  251. void PolyphaseStereo(short *pcm, int *vbuf, const int *coefBase);
  252. #ifdef __cplusplus
  253. }
  254. #endif
  255. /* trigtabs.c */
  256. extern const int imdctWin[4][36];
  257. extern const int ISFMpeg1[2][7];
  258. extern const int ISFMpeg2[2][2][16];
  259. extern const int ISFIIP[2][2];
  260. extern const int csa[8][2];
  261. extern const int coef32[31];
  262. extern const int polyCoef[264];
  263. #endif /* _CODER_H */