/* * 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 #include /* 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 */ extern jmp_buf error_jmp_mark; #define HANDLE_ERROR() longjmp (error_jmp_mark, -1) /* 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;