COMMON.H
上传用户:njqiyou
上传日期:2007-01-08
资源大小:574k
文件大小:20k
源码类别:

mpeg/mp3

开发平台:

C/C++

  1. /**********************************************************************
  2.  * ISO MPEG Audio Subgroup Software Simulation Group (1996)
  3.  * ISO 13818-3 MPEG-2 Audio Decoder - Lower Sampling Frequency Extension
  4.  *
  5.  * $Id: common.h,v 1.3 1996/03/28 03:13:37 rowlands Exp $
  6.  *
  7.  * $Log: common.h,v $
  8.  * Revision 1.3  1996/03/28 03:13:37  rowlands
  9.  * Merged layers 1-2 and layer 3 revisions
  10.  *
  11.  * Revision 1.2  1996/02/14 05:18:36  rowlands
  12.  * Cleanups.
  13.  *
  14.  * Revision 1.1  1996/02/14 03:45:52  rowlands
  15.  * Initial revision
  16.  *
  17.  * Received from FhG
  18.  **********************************************************************/
  19. /**********************************************************************
  20.  *   date   programmers         comment                               *
  21.  * 2/25/91  Doulas Wong,        start of version 1.0 records          *
  22.  *          Davis Pan                                                 *
  23.  * 5/10/91  W. Joseph Carter    Reorganized & renamed all ".h" files  *
  24.  *                              into "common.h" and "encoder.h".      *
  25.  *                              Ported to Macintosh and Unix.         *
  26.  *                              Added additional type definitions for *
  27.  *                              AIFF, double/SANE and "bitstream.c".  *
  28.  *                              Added function prototypes for more    *
  29.  *                              rigorous type checking.               *
  30.  * 27jun91  dpwe (Aware)        Added "alloc_*" defs & prototypes     *
  31.  *                              Defined new struct 'frame_params'.    *
  32.  *                              Changed info.stereo to info.mode_ext  *
  33.  *                              #define constants for mode types      *
  34.  *                              Prototype arguments if PROTO_ARGS     *
  35.  * 5/28/91  Earle Jennings      added MS_DOS definition               *
  36.  *                              MsDos function prototype declarations *
  37.  * 7/10/91  Earle Jennings      added FLOAT definition as double      *
  38.  *10/ 3/91  Don H. Lee          implemented CRC-16 error protection   *
  39.  * 2/11/92  W. Joseph Carter    Ported new code to Macintosh.  Most   *
  40.  *                              important fixes involved changing     *
  41.  *                              16-bit ints to long or unsigned in    *
  42.  *                              bit alloc routines for quant of 65535 *
  43.  *                              and passing proper function args.     *
  44.  *                              Removed "Other Joint Stereo" option   *
  45.  *                              and made bitrate be total channel     *
  46.  *                              bitrate, irrespective of the mode.    *
  47.  *                              Fixed many small bugs & reorganized.  *
  48.  *                              Modified some function prototypes.    *
  49.  *                              Changed BUFFER_SIZE back to 4096.     *
  50.  * 7/27/92  Michael Li          (re-)Ported to MS-DOS                 *
  51.  * 7/27/92  Masahiro Iwadare    Ported to Convex                      *
  52.  * 8/07/92  mc@tv.tek.com                                             *
  53.  * 8/10/92  Amit Gulati         Ported to the AIX Platform (RS6000)   *
  54.  *                              AIFF string constants redefined       *
  55.  * 8/27/93 Seymour Shlien,      Fixes in Unix and MSDOS ports,        *
  56.  *         Daniel Lauzon, and                                         *
  57.  *         Bill Truerniet                                             *
  58.  *--------------------------------------------------------------------*
  59.  * 4/23/92  J. Pineda           Added code for Layer III.             *
  60.  * 11/9/92  Amit Gulati         Added defines for layerIII stereo     *
  61.  *                              modes.                                *
  62.  *  8/24/93 Masahiro Iwadare    Included IS modification in Layer III.*
  63.  *                              Changed for 1 pass decoding.          *
  64.  *  9/07/93 Toshiyuki Ishino    Integrated Layer III with Ver 3.9.    *
  65.  *--------------------------------------------------------------------*
  66.  * 11/20/93 Masahiro Iwadare    Integrated Layer III with Ver 4.0.    *
  67.  *--------------------------------------------------------------------*
  68.  *  7/14/94 Juergen Koller      Fix for HPUX an IRIX in AIFF-Strings  *
  69.  *--------------------------------------------------------------------*
  70.  *  6/12/95 Soeren H. Nielsen   Bug fix in new_ext().                 *
  71.  *  7/11/95 Soeren H. Nielsen   Added defs. for MPEG-2 LSF            *
  72.  *--------------------------------------------------------------------*
  73.  *          Roland Bitto Adapted to MPEG2 low sampling rate    *
  74.  **********************************************************************/
  75. #ifndef COMMON_H
  76. #define COMMON_H
  77. /***********************************************************************
  78. *
  79. *  Global Conditional Compile Switches
  80. *
  81. ***********************************************************************/
  82. /* #define      UNIX            /* Unix conditional compile switch */
  83. /* #define      MACINTOSH       /* Macintosh conditional compile switch */
  84. /* #define      MS_DOS          /* IBM PC conditional compile switch */
  85. /* #define      MSC60           /* Compiled for MS_DOS with MSC v6.0 */
  86. /* #define      AIX             /* AIX conditional compile switch    */
  87. /* #define      CONVEX          /* CONVEX conditional compile switch */
  88. #if defined(MSC60) 
  89. #ifndef MS_DOS
  90. #define MS_DOS
  91. #endif
  92. #ifndef PROTO_ARGS
  93. #define PROTO_ARGS
  94. #endif
  95. #endif
  96. #ifdef  UNIX
  97. #define         TABLES_PATH     "tables"  /* to find data files */
  98. /* name of environment variable holding path of table files */
  99. #define         MPEGTABENV      "MPEGTABLES"
  100. #define         PATH_SEPARATOR  "/"        /* how to build paths */
  101. #endif  /* UNIX */
  102. #ifdef  MACINTOSH
  103. #define      TABLES_PATH ":tables:"  /* where to find data files */
  104. #endif  /* MACINTOSH */
  105. /* 
  106.  * Don't define FAR to far unless you're willing to clean up the 
  107.  * prototypes
  108.  */
  109. #define FAR /*far*/
  110. #ifdef __STDC__
  111. #ifndef PROTO_ARGS
  112. #define PROTO_ARGS 
  113. #endif
  114. #endif
  115. #ifdef CONVEX
  116. #define SEEK_SET        0
  117. #define SEEK_CUR        1
  118. #define SEEK_END        2
  119. #endif
  120. /* MS_DOS and VMS do not define TABLES_PATH, so OpenTableFile will default
  121.    to finding the data files in the default directory */
  122. /***********************************************************************
  123. *
  124. *  Global Include Files
  125. *
  126. ***********************************************************************/
  127. #include        <stdio.h>
  128. #include        <string.h>
  129. #include        <math.h>
  130. #include "ieeefloat.h"
  131. #include "portableio.h"
  132. #ifdef  UNIX
  133. #include        <unistd.h>
  134. #endif  /* UNIX */
  135. #ifdef __sgi
  136. #include <stdlib.h>
  137. #endif
  138. #ifdef  MACINTOSH
  139. #include        <stdlib.h>
  140. #include        <console.h>
  141. #endif  /* MACINTOSH */
  142. #ifdef  MS_DOS
  143. #include        <stdlib.h>
  144. #ifdef MSC60
  145. #include        <memory.h>
  146. #else
  147. #include        <alloc.h>
  148. #include        <mem.h>
  149. #endif  /* MSC60 */
  150. #endif  /* MS_DOS */
  151. /***********************************************************************
  152. *
  153. *  Global Definitions
  154. *
  155. ***********************************************************************/
  156. /* General Definitions */
  157. #ifdef  MS_DOS
  158. #define         FLOAT                   double
  159. #else
  160. #define         FLOAT                   float
  161. #endif
  162. #define         FALSE                   0
  163. #define         TRUE                    1
  164. #define         NULL_CHAR               ''
  165. #define         MAX_U_32_NUM            0xFFFFFFFF
  166. #ifndef PI
  167. #define         PI                      3.14159265358979
  168. #endif
  169. #define         PI4                     PI/4
  170. #define         PI64                    PI/64
  171. #define         LN_TO_LOG10             0.2302585093
  172. #define         VOL_REF_NUM             0
  173. #define         MAC_WINDOW_SIZE         24
  174. #define         MONO                    1
  175. #define         STEREO                  2
  176. #define         BITS_IN_A_BYTE          8
  177. #define         WORD                    16
  178. #define         MAX_NAME_SIZE           81
  179. #define         SBLIMIT                 32
  180. #define         SSLIMIT                 18
  181. #define         FFT_SIZE                1024
  182. #define         HAN_SIZE                512
  183. #define         SCALE_BLOCK             12
  184. #define         SCALE_RANGE             64
  185. #define         SCALE                   32768
  186. #define         CRC16_POLYNOMIAL        0x8005
  187. /* MPEG Header Definitions - ID Bit Values */
  188. #define         MPEG_AUDIO_ID           1
  189. #define MPEG_PHASE2_LSF 0 /* 1995-07-11 SHN */
  190. /* MPEG Header Definitions - Mode Values */
  191. #define         MPG_MD_STEREO           0
  192. #define         MPG_MD_JOINT_STEREO     1
  193. #define         MPG_MD_DUAL_CHANNEL     2
  194. #define         MPG_MD_MONO             3
  195. /* Mode Extention */
  196. #define         MPG_MD_LR_LR             0
  197. #define         MPG_MD_LR_I              1
  198. #define         MPG_MD_MS_LR             2
  199. #define         MPG_MD_MS_I              3
  200. /* AIFF Definitions */
  201. #define IFF_ID_FORM 0x464f524d /* "FORM" */
  202. #define IFF_ID_AIFF 0x41494646 /* "AIFF" */
  203. #define IFF_ID_COMM 0x434f4d4d /* "COMM" */
  204. #define IFF_ID_SSND 0x53534e44 /* "SSND" */
  205. #define IFF_ID_MPEG 0x4d504547 /* "MPEG" */
  206. #define AIFF_FORM_HEADER_SIZE 12
  207. #define AIFF_SSND_HEADER_SIZE 16
  208. typedef struct  blockAlign_struct {
  209.     unsigned long   offset;
  210.     unsigned long   blockSize;
  211. } blockAlign;
  212. typedef struct  IFF_AIFF_struct {
  213.     short           numChannels;
  214.     unsigned long   numSampleFrames;
  215.     short           sampleSize;
  216.     double          sampleRate;
  217.     unsigned long   sampleType;
  218.     blockAlign      blkAlgn;
  219. } IFF_AIFF;
  220. enum byte_order { order_unknown, order_bigEndian, order_littleEndian };
  221. extern enum byte_order NativeByteOrder;
  222. /* "bit_stream.h" Definitions */
  223. #define         MINIMUM         4    /* Minimum size of the buffer in bytes */
  224. #define         MAX_LENGTH      32   /* Maximum length of word written or
  225.                                         read from bit stream */
  226. #define         READ_MODE       0
  227. #define         WRITE_MODE      1
  228. #define         ALIGNING        8
  229. #define         BINARY          0
  230. #define         ASCII           1
  231. #ifndef BS_FORMAT
  232. #define         BS_FORMAT       ASCII /* BINARY or ASCII = 2x bytes */
  233. #endif
  234. #define         BUFFER_SIZE     4096
  235. #define         MIN(A, B)       ((A) < (B) ? (A) : (B))
  236. #define         MAX(A, B)       ((A) > (B) ? (A) : (B))
  237. /***********************************************************************
  238. *
  239. *  Global Type Definitions
  240. *
  241. ***********************************************************************/
  242. typedef struct {
  243.             char    encoded_file_name[MAX_NAME_SIZE];
  244.             char    decoded_file_name[MAX_NAME_SIZE];
  245.             int  need_aiff;
  246.             int  need_esps;
  247.             int  topSb;
  248.               }Arguments_t;
  249. /* Structure for Reading Layer II Allocation Tables from File */
  250. typedef struct {
  251.     unsigned int    steps;
  252.     unsigned int    bits;
  253.     unsigned int    group;
  254.     unsigned int    quant;
  255. } sb_alloc, *alloc_ptr;
  256. typedef sb_alloc        al_table[SBLIMIT][16];
  257. /* Header Information Structure */
  258. typedef struct {
  259.     int version;
  260.     int lay;
  261.     int error_protection;
  262.     int bitrate_index;
  263.     int sampling_frequency;
  264.     int padding;
  265.     int extension;
  266.     int mode;
  267.     int mode_ext;
  268.     int copyright;
  269.     int original;
  270.     int emphasis;
  271. } layer, *the_layer;
  272. /* Parent Structure Interpreting some Frame Parameters in Header */
  273. typedef struct {
  274.     layer       *header;        /* raw header information */
  275.     int         actual_mode;    /* when writing IS, may forget if 0 chs */
  276.     al_table    *alloc;         /* bit allocation table read in */
  277.     int         tab_num;        /* number of table as loaded */
  278.     int         stereo;         /* 1 for mono, 2 for stereo */
  279.     int         jsbound;        /* first band of joint stereo coding */
  280.     int         sblimit;        /* total number of sub bands */
  281. } frame_params;
  282. /* Double and SANE Floating Point Type Definitions */
  283. typedef struct  IEEE_DBL_struct {
  284.     unsigned long   hi;
  285.     unsigned long   lo;
  286. } IEEE_DBL;
  287. typedef struct  SANE_EXT_struct {
  288.     unsigned long   l1;
  289.     unsigned long   l2;
  290.     unsigned short  s1;
  291. } SANE_EXT;
  292. /* "bit_stream.h" Type Definitions */
  293. typedef struct  bit_stream_struc {
  294.     FILE        *pt;            /* pointer to bit stream device */
  295.     unsigned char *buf;         /* bit stream buffer */
  296.     int         buf_size;       /* size of buffer (in number of bytes) */
  297.     long        totbit;         /* bit counter of bit stream */
  298.     int         buf_byte_idx;   /* pointer to top byte in buffer */
  299.     int         buf_bit_idx;    /* pointer to top bit of top byte in buffer */
  300.     int         mode;           /* bit stream open in read or write mode */
  301.     int         eob;            /* end of buffer index */
  302.     int         eobs;           /* end of bit stream flag */
  303.     char        format;
  304.     
  305.     /* format of file in rd mode (BINARY/ASCII) */
  306. } Bit_stream_struc;
  307. /* Layer III side information. */
  308. typedef struct {
  309. unsigned part2_3_length;
  310. unsigned big_values;
  311. unsigned global_gain;
  312. unsigned scalefac_compress;
  313. unsigned window_switching_flag;
  314. unsigned block_type;
  315. unsigned mixed_block_flag;
  316. unsigned table_select[3];
  317. unsigned subblock_gain[3];
  318. unsigned region0_count;
  319. unsigned region1_count;
  320. unsigned preflag;
  321. unsigned scalefac_scale;
  322. unsigned count1table_select;
  323. } my_gr_info ;
  324. typedef struct {
  325. unsigned main_data_begin;
  326. unsigned private_bits;
  327. struct {
  328.     unsigned scfsi[4];
  329. struct gr_info_s {
  330. unsigned part2_3_length;
  331. unsigned big_values;
  332. unsigned global_gain;
  333. unsigned scalefac_compress;
  334. unsigned window_switching_flag;
  335. unsigned block_type;
  336. unsigned mixed_block_flag;
  337. unsigned table_select[3];
  338. unsigned subblock_gain[3];
  339. unsigned region0_count;
  340. unsigned region1_count;
  341. unsigned preflag;
  342. unsigned scalefac_scale;
  343. unsigned count1table_select;
  344. } gr[2];
  345. } ch[2];
  346. } III_side_info_t;
  347. /* Layer III scale factors. */
  348. typedef struct {
  349. int l[23];            /* [cb] */
  350. int s[3][13];         /* [window][cb] */
  351. } III_scalefac_t[2];  /* [ch] */
  352. /***********************************************************************
  353. *
  354. *  Global Variable External Declarations
  355. *
  356. ***********************************************************************/
  357. extern char     *mode_names[5];
  358. extern char     *layer_names[3];
  359. extern char *version_names[2];
  360. extern double   s_freq[2][4];
  361. extern int      bitrate[2][3][15];
  362. extern double FAR multiple[64];
  363. /***********************************************************************
  364. *
  365. *  Global Function Prototype Declarations
  366. *
  367. ***********************************************************************/
  368. /* The following functions are in the file "common.c" */
  369. #ifdef  PROTO_ARGS
  370. extern FILE           *OpenTableFile(char*);
  371. extern int            read_bit_alloc(int, al_table*);
  372. extern int            pick_table(frame_params*);
  373. extern int            js_bound(int, int);
  374. extern void           hdr_to_frps(frame_params*);
  375. extern void           WriteHdr(frame_params*, FILE*);
  376. extern void           WriteBitAlloc(unsigned int[2][SBLIMIT], frame_params*,
  377.                         FILE*);
  378. extern void           WriteScale(unsigned int[2][SBLIMIT],
  379.                         unsigned int[2][SBLIMIT], unsigned int[2][3][SBLIMIT],
  380.                         frame_params*, FILE*);
  381. extern void           WriteSamples(int, unsigned int FAR [SBLIMIT],
  382.                         unsigned int[SBLIMIT], frame_params*, FILE*);
  383. extern int            NumericQ(char*);
  384. extern int            BitrateIndex(int, int, int);
  385. extern int            SmpFrqIndex(long, int*);
  386. extern int            memcheck(char*, int, int);
  387. extern void           FAR *mem_alloc(unsigned long, char*);
  388. extern void           mem_free(void**);
  389. extern void           double_to_extended(double*, char[10]);
  390. extern void           extended_to_double(char[10], double*);
  391. extern int            aiff_read_headers(FILE*, IFF_AIFF*);
  392. extern int            aiff_seek_to_sound_data(FILE*);
  393. extern int            aiff_write_headers(FILE*, IFF_AIFF*);
  394. extern int            refill_buffer(Bit_stream_struc*);
  395. extern void           empty_buffer(Bit_stream_struc*, int);
  396. extern void           open_bit_stream_w(Bit_stream_struc*, char*, int);
  397. extern void           open_bit_stream_r(Bit_stream_struc*, char*, int);
  398. extern void           close_bit_stream_r(Bit_stream_struc*);
  399. extern void           close_bit_stream_w(Bit_stream_struc*);
  400. extern void           alloc_buffer(Bit_stream_struc*, int);
  401. extern void           desalloc_buffer(Bit_stream_struc*);
  402. extern void           back_track_buffer(Bit_stream_struc*, int);
  403. extern unsigned int   get1bit(Bit_stream_struc*);
  404. extern void           put1bit(Bit_stream_struc*, int);
  405. extern unsigned long  look_ahead(Bit_stream_struc*, int);
  406. extern unsigned long  getbits(Bit_stream_struc*, int);
  407. extern void           putbits(Bit_stream_struc*, unsigned int, int);
  408. extern void           byte_ali_putbits(Bit_stream_struc*, unsigned int, int);
  409. extern unsigned long  byte_ali_getbits(Bit_stream_struc*, int);
  410. extern unsigned long  sstell(Bit_stream_struc*);
  411. extern int            end_bs(Bit_stream_struc*);
  412. extern int            seek_sync(Bit_stream_struc*, long, int);
  413. extern void           I_CRC_calc(frame_params*, unsigned int[2][SBLIMIT],
  414.                         unsigned int*);
  415. extern void           II_CRC_calc(frame_params*, unsigned int[2][SBLIMIT],
  416.                         unsigned int[2][SBLIMIT], unsigned int*);
  417. extern void           update_CRC(unsigned int, unsigned int, unsigned int*);
  418. extern void           read_absthr(FLOAT*, int);
  419. extern unsigned int   hget1bit(); /* MI */
  420. extern unsigned long  hgetbits(int);
  421. extern unsigned long  hsstell();
  422. extern void           hputbuf(unsigned int,int);
  423. extern void           rewindNbytes( int );
  424. enum byte_order DetermineByteOrder();
  425. void SwapBytesInWords( short *loc, int words );
  426. #ifdef  MACINTOSH
  427. extern void           set_mac_file_attr(char[MAX_NAME_SIZE], short, OsType,
  428.                         OsType);
  429. #endif
  430. #ifdef MS_DOS
  431. extern char           *new_ext(char *filename, char *extname); 
  432. #endif
  433. #else
  434. extern FILE           *OpenTableFile();
  435. extern int            read_bit_alloc();
  436. extern int            pick_table();
  437. extern int            js_bound();
  438. extern void           hdr_to_frps();
  439. extern void           WriteHdr();
  440. extern void           WriteBitAlloc();
  441. extern void           WriteScale();
  442. extern void           WriteSamples();
  443. extern int            NumericQ();
  444. extern int            BitrateIndex();
  445. extern int            SmpFrqIndex();
  446. extern int            memcheck();
  447. extern void           FAR *mem_alloc();
  448. extern void           mem_free();
  449. extern void           double_to_extended();
  450. extern void           extended_to_double();
  451. extern int            aiff_read_headers();
  452. extern int            aiff_seek_to_sound_data();
  453. extern int            aiff_write_headers();
  454. extern int            refill_buffer();
  455. extern void           empty_buffer();
  456. extern void           open_bit_stream_w();
  457. extern void           open_bit_stream_r();
  458. extern void           close_bit_stream_r();
  459. extern void           close_bit_stream_w();
  460. extern void           alloc_buffer();
  461. extern void           desalloc_buffer();
  462. extern void           back_track_buffer();
  463. extern unsigned int   get1bit();
  464. extern void           put1bit();
  465. extern unsigned long  look_ahead();
  466. extern unsigned long  getbits();
  467. extern void           putbits();
  468. extern void           byte_ali_putbits();
  469. extern unsigned long  byte_ali_getbits();
  470. extern unsigned long  sstell();
  471. extern int            end_bs();
  472. extern int            seek_sync();
  473. extern void           I_CRC_calc();
  474. extern void           II_CRC_calc();
  475. extern void           update_CRC();
  476. extern void           read_absthr();
  477. extern unsigned int   hget1bit();
  478. extern unsigned long  hgetbits();
  479. extern unsigned long  hsstell();
  480. extern void           hputbuf();
  481. extern void           rewindNbytes();
  482. #ifdef MS_DOS
  483. extern char           *new_ext(); 
  484. #endif
  485. #endif
  486. #endif