vdr/ac3dec/ac3_internal.h

354 lines
9.2 KiB
C

/*
* 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 <setjmp.h>
/* 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;