diff options
Diffstat (limited to 'src/libac3/ac3_internal.h')
| -rw-r--r-- | src/libac3/ac3_internal.h | 359 |
1 files changed, 359 insertions, 0 deletions
diff --git a/src/libac3/ac3_internal.h b/src/libac3/ac3_internal.h new file mode 100644 index 000000000..cac0c7940 --- /dev/null +++ b/src/libac3/ac3_internal.h @@ -0,0 +1,359 @@ +/* + * ac3_internal.h + * + * Copyright (C) Aaron Holtzman - May 1999 + * + * This file is part of ac3dec, a free Dolby AC-3 stream decoder. + * + * ac3dec is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2, or (at your option) + * any later version. + * + * ac3dec is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with GNU Make; see the file COPYING. If not, write to + * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ + +#ifndef __GNUC__ +#define inline +#endif + +#define FAST_ERROR +#ifdef FAST_ERROR +#include <setjmp.h> +#endif + +/* Exponent strategy constants */ +#define EXP_REUSE (0) +#define EXP_D15 (1) +#define EXP_D25 (2) +#define EXP_D45 (3) + +/* Delta bit allocation constants */ +#define DELTA_BIT_REUSE (0) +#define DELTA_BIT_NEW (1) +#define DELTA_BIT_NONE (2) +#define DELTA_BIT_RESERVED (3) + +/* samples work structure */ +typedef float stream_samples_t[6][256]; + +/* global config structure */ +extern ac3_config_t ac3_config; +/* global error flag */ +#ifdef FAST_ERROR +extern jmp_buf error_jmp_mark; +#define HANDLE_ERROR() longjmp (error_jmp_mark, -1) +#else +extern uint32_t error_flag; +#endif + +/* Everything you wanted to know about band structure */ +/* + * The entire frequency domain is represented by 256 real + * floating point fourier coefficients. Only the lower 253 + * coefficients are actually utilized however. We use arrays + * of 256 to be efficient in some cases. + * + * The 5 full bandwidth channels (fbw) can have their higher + * frequencies coupled together. These coupled channels then + * share their high frequency components. + * + * This coupling band is broken up into 18 sub-bands starting + * at mantissa number 37. Each sub-band is 12 bins wide. + * + * There are 50 bit allocation sub-bands which cover the entire + * frequency range. The sub-bands are of non-uniform width, and + * approximate a 1/6 octave scale. + */ + +/* The following structures are filled in by their corresponding parse_* + * functions. See http://www.atsc.org/Standards/A52/a_52.pdf for + * full details on each field. Indented fields are used to denote + * conditional fields. + */ + +typedef struct syncinfo_s +{ + uint32_t magic; + /* Sync word == 0x0B77 */ + uint16_t syncword; + /* crc for the first 5/8 of the sync block */ + /* uint16_t crc1; */ + /* Stream Sampling Rate (kHz) 0 = 48, 1 = 44.1, 2 = 32, 3 = reserved */ + uint16_t fscod; + /* Frame size code */ + uint16_t frmsizecod; + + /* Information not in the AC-3 bitstream, but derived */ + /* Frame size in 16 bit words */ + uint16_t frame_size; + /* Bit rate in kilobits */ + uint16_t bit_rate; + /* sampling rate in hertz */ + uint32_t sampling_rate; +} syncinfo_t; + +typedef struct bsi_s +{ + uint32_t magic; + /* Bit stream identification == 0x8 */ + uint16_t bsid; + /* Bit stream mode */ + uint16_t bsmod; + /* Audio coding mode */ + uint16_t acmod; + /* If we're using the centre channel then */ + /* centre mix level */ + uint16_t cmixlev; + /* If we're using the surround channel then */ + /* surround mix level */ + uint16_t surmixlev; + /* If we're in 2/0 mode then */ + /* Dolby surround mix level - NOT USED - */ + uint16_t dsurmod; + /* Low frequency effects on */ + uint16_t lfeon; + /* Dialogue Normalization level */ + uint16_t dialnorm; + /* Compression exists */ + uint16_t compre; + /* Compression level */ + uint16_t compr; + /* Language code exists */ + uint16_t langcode; + /* Language code */ + uint16_t langcod; + /* Audio production info exists*/ + uint16_t audprodie; + uint16_t mixlevel; + uint16_t roomtyp; + /* If we're in dual mono mode (acmod == 0) then extra stuff */ + uint16_t dialnorm2; + uint16_t compr2e; + uint16_t compr2; + uint16_t langcod2e; + uint16_t langcod2; + uint16_t audprodi2e; + uint16_t mixlevel2; + uint16_t roomtyp2; + /* Copyright bit */ + uint16_t copyrightb; + /* Original bit */ + uint16_t origbs; + /* Timecode 1 exists */ + uint16_t timecod1e; + /* Timecode 1 */ + uint16_t timecod1; + /* Timecode 2 exists */ + uint16_t timecod2e; + /* Timecode 2 */ + uint16_t timecod2; + /* Additional bit stream info exists */ + uint16_t addbsie; + /* Additional bit stream length - 1 (in bytes) */ + uint16_t addbsil; + /* Additional bit stream information (max 64 bytes) */ + uint8_t addbsi[64]; + + /* Information not in the AC-3 bitstream, but derived */ + /* Number of channels (excluding LFE) + * Derived from acmod */ + uint16_t nfchans; +} bsi_t; + + +/* more pain */ +typedef struct audblk_s +{ + uint32_t magic1; + /* block switch bit indexed by channel num */ + uint16_t blksw[5]; + /* dither enable bit indexed by channel num */ + uint16_t dithflag[5]; + /* dynamic range gain exists */ + uint16_t dynrnge; + /* dynamic range gain */ + uint16_t dynrng; + /* if acmod==0 then */ + /* dynamic range 2 gain exists */ + uint16_t dynrng2e; + /* dynamic range 2 gain */ + uint16_t dynrng2; + /* coupling strategy exists */ + uint16_t cplstre; + /* coupling in use */ + uint16_t cplinu; + /* channel coupled */ + uint16_t chincpl[5]; + /* if acmod==2 then */ + /* Phase flags in use */ + uint16_t phsflginu; + /* coupling begin frequency code */ + uint16_t cplbegf; + /* coupling end frequency code */ + uint16_t cplendf; + /* coupling band structure bits */ + uint16_t cplbndstrc[18]; + /* Do coupling co-ords exist for this channel? */ + uint16_t cplcoe[5]; + /* Master coupling co-ordinate */ + uint16_t mstrcplco[5]; + /* Per coupling band coupling co-ordinates */ + uint16_t cplcoexp[5][18]; + uint16_t cplcomant[5][18]; + /* Phase flags for dual mono */ + uint16_t phsflg[18]; + /* Is there a rematrixing strategy */ + uint16_t rematstr; + /* Rematrixing bits */ + uint16_t rematflg[4]; + /* Coupling exponent strategy */ + uint16_t cplexpstr; + /* Exponent strategy for full bandwidth channels */ + uint16_t chexpstr[5]; + /* Exponent strategy for lfe channel */ + uint16_t lfeexpstr; + /* Channel bandwidth for independent channels */ + uint16_t chbwcod[5]; + /* The absolute coupling exponent */ + uint16_t cplabsexp; + /* Coupling channel exponents (D15 mode gives 18 * 12 /3 encoded exponents */ + uint16_t cplexps[18 * 12 / 3]; + /* Sanity checking constant */ + uint32_t magic2; + /* fbw channel exponents */ + uint16_t exps[5][252 / 3]; + /* channel gain range */ + uint16_t gainrng[5]; + /* low frequency exponents */ + uint16_t lfeexps[3]; + + /* Bit allocation info */ + uint16_t baie; + /* Slow decay code */ + uint16_t sdcycod; + /* Fast decay code */ + uint16_t fdcycod; + /* Slow gain code */ + uint16_t sgaincod; + /* dB per bit code */ + uint16_t dbpbcod; + /* masking floor code */ + uint16_t floorcod; + + /* SNR offset info */ + uint16_t snroffste; + /* coarse SNR offset */ + uint16_t csnroffst; + /* coupling fine SNR offset */ + uint16_t cplfsnroffst; + /* coupling fast gain code */ + uint16_t cplfgaincod; + /* fbw fine SNR offset */ + uint16_t fsnroffst[5]; + /* fbw fast gain code */ + uint16_t fgaincod[5]; + /* lfe fine SNR offset */ + uint16_t lfefsnroffst; + /* lfe fast gain code */ + uint16_t lfefgaincod; + + /* Coupling leak info */ + uint16_t cplleake; + /* coupling fast leak initialization */ + uint16_t cplfleak; + /* coupling slow leak initialization */ + uint16_t cplsleak; + + /* delta bit allocation info */ + uint16_t deltbaie; + /* coupling delta bit allocation exists */ + uint16_t cpldeltbae; + /* fbw delta bit allocation exists */ + uint16_t deltbae[5]; + /* number of cpl delta bit segments */ + uint16_t cpldeltnseg; + /* coupling delta bit allocation offset */ + uint16_t cpldeltoffst[8]; + /* coupling delta bit allocation length */ + uint16_t cpldeltlen[8]; + /* coupling delta bit allocation length */ + uint16_t cpldeltba[8]; + /* number of delta bit segments */ + uint16_t deltnseg[5]; + /* fbw delta bit allocation offset */ + uint16_t deltoffst[5][8]; + /* fbw delta bit allocation length */ + uint16_t deltlen[5][8]; + /* fbw delta bit allocation length */ + uint16_t deltba[5][8]; + + /* skip length exists */ + uint16_t skiple; + /* skip length */ + uint16_t skipl; + + //Removed Feb 2000 -ah + //added Jul 2000 ++dent + /* channel mantissas */ + uint16_t chmant[5][256]; + + /* coupling mantissas */ +// uint16_t cplmant[256]; + + //Added Jun 2000 -MaXX + /* coupling floats */ + float cpl_flt[ 256 ]; + + //Removed Feb 2000 -ah + //added Jul 2000 ++dent + /* coupling mantissas */ + uint16_t lfemant[7]; + + + /* -- Information not in the bitstream, but derived thereof -- */ + + /* Number of coupling sub-bands */ + uint16_t ncplsubnd; + + /* Number of combined coupling sub-bands + * Derived from ncplsubnd and cplbndstrc */ + uint16_t ncplbnd; + + /* Number of exponent groups by channel + * Derived from strmant, endmant */ + uint16_t nchgrps[5]; + + /* Number of coupling exponent groups + * Derived from cplbegf, cplendf, cplexpstr */ + uint16_t ncplgrps; + + /* End mantissa numbers of fbw channels */ + uint16_t endmant[5]; + + /* Start and end mantissa numbers for the coupling channel */ + uint16_t cplstrtmant; + uint16_t cplendmant; + + /* Decoded exponent info */ + uint16_t fbw_exp[5][256]; + uint16_t cpl_exp[256]; + uint16_t lfe_exp[7]; + + /* Bit allocation pointer results */ + uint16_t fbw_bap[5][256]; + uint16_t cpl_bap[256]; + uint16_t lfe_bap[7]; + + uint32_t magic3; +} audblk_t; + + |