You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

155 lines
7.6KB

  1. /*
  2. * Common code between AC3 and E-AC3 decoder
  3. * Copyright (c) 2007 Bartlomiej Wolowiec <bartek.wolowiec@gmail.com>
  4. *
  5. * This file is part of FFmpeg.
  6. *
  7. * FFmpeg is free software; you can redistribute it and/or
  8. * modify it under the terms of the GNU Lesser General Public
  9. * License as published by the Free Software Foundation; either
  10. * version 2.1 of the License, or (at your option) any later version.
  11. *
  12. * FFmpeg is distributed in the hope that it will be useful,
  13. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15. * Lesser General Public License for more details.
  16. *
  17. * You should have received a copy of the GNU Lesser General Public
  18. * License along with FFmpeg; if not, write to the Free Software
  19. * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  20. */
  21. /**
  22. * @file ac3.h
  23. * Common code between AC3 and E-AC3 decoder.
  24. */
  25. #ifndef FFMPEG_AC3DEC_H
  26. #define FFMPEG_AC3DEC_H
  27. #include "libavutil/random.h"
  28. #include "ac3tab.h"
  29. #include "ac3.h"
  30. #include "bitstream.h"
  31. #include "dsputil.h"
  32. /* override ac3.h to include coupling channel */
  33. #undef AC3_MAX_CHANNELS
  34. #define AC3_MAX_CHANNELS 7
  35. #define CPL_CH 0
  36. #define AC3_OUTPUT_LFEON 8
  37. #define AC3_MAX_COEFS 256
  38. #define AC3_BLOCK_SIZE 256
  39. #define MAX_BLOCKS 6
  40. typedef struct {
  41. AVCodecContext *avctx; ///< parent context
  42. GetBitContext gbc; ///< bitstream reader
  43. uint8_t *input_buffer; ///< temp buffer to prevent overread
  44. ///@defgroup bsi bit stream information
  45. ///@{
  46. int frame_type; ///< frame type (strmtyp)
  47. int substreamid; ///< substream identification
  48. int frame_size; ///< current frame size, in bytes
  49. int bit_rate; ///< stream bit rate, in bits-per-second
  50. int sample_rate; ///< sample frequency, in Hz
  51. int num_blocks; ///< number of audio blocks
  52. int channel_mode; ///< channel mode (acmod)
  53. int lfe_on; ///< lfe channel in use
  54. int center_mix_level; ///< Center mix level index
  55. int surround_mix_level; ///< Surround mix level index
  56. ///@}
  57. ///@defgroup cpl standard coupling
  58. int cpl_in_use[MAX_BLOCKS]; ///< coupling in use (cplinu)
  59. int channel_in_cpl[AC3_MAX_CHANNELS]; ///< channel in coupling (chincpl)
  60. int phase_flags_in_use; ///< phase flags in use (phsflginu)
  61. int phase_flags[18]; ///< phase flags (phsflg)
  62. int num_cpl_subbands; ///< number of coupling sub bands (ncplsubnd)
  63. int num_cpl_bands; ///< number of coupling bands (ncplbnd)
  64. int cpl_band_struct[18]; ///< coupling band structure (cplbndstrc)
  65. int cpl_coords[AC3_MAX_CHANNELS][18]; ///< coupling coordinates (cplco)
  66. ///@}
  67. ///@defgroup channel channel
  68. int fbw_channels; ///< number of full-bandwidth channels
  69. int channels; ///< number of total channels
  70. int lfe_ch; ///< index of LFE channel
  71. float downmix_coeffs[AC3_MAX_CHANNELS][2]; ///< stereo downmix coefficients
  72. float downmix_coeff_adjust[2]; ///< adjustment needed for each output channel when downmixing
  73. int downmixed; ///< indicates if coeffs are currently downmixed
  74. int output_mode; ///< output channel configuration
  75. int out_channels; ///< number of output channels
  76. ///@}
  77. ///@defgroup dynrng dynamic range
  78. float dynamic_range[2]; ///< dynamic range
  79. ///@}
  80. ///@defgroup bandwidth bandwidth
  81. int start_freq[AC3_MAX_CHANNELS]; ///< start frequency bin (strtmant)
  82. int end_freq[AC3_MAX_CHANNELS]; ///< end frequency bin (endmant)
  83. ///@}
  84. ///@defgroup rematrixing rematrixing
  85. int num_rematrixing_bands; ///< number of rematrixing bands (nrematbnd)
  86. int rematrixing_flags[4]; ///< rematrixing flags (rematflg)
  87. ///@}
  88. ///@defgroup exponents exponents
  89. int num_exp_groups[AC3_MAX_CHANNELS]; ///< Number of exponent groups (nexpgrp)
  90. int8_t dexps[AC3_MAX_CHANNELS][AC3_MAX_COEFS]; ///< decoded exponents
  91. int exp_strategy[MAX_BLOCKS][AC3_MAX_CHANNELS]; ///< exponent strategies (expstr)
  92. ///@}
  93. ///@defgroup bitalloc bit allocation
  94. AC3BitAllocParameters bit_alloc_params; ///< bit allocation parameters
  95. int snr_offset[AC3_MAX_CHANNELS]; ///< signal-to-noise ratio offsets (snroffst)
  96. int fast_gain[AC3_MAX_CHANNELS]; ///< fast gain values/SMR's (fgain)
  97. uint8_t bap[AC3_MAX_CHANNELS][AC3_MAX_COEFS]; ///< bit allocation pointers
  98. int16_t psd[AC3_MAX_CHANNELS][AC3_MAX_COEFS]; ///< scaled exponents
  99. int16_t band_psd[AC3_MAX_CHANNELS][50]; ///< interpolated exponents
  100. int16_t mask[AC3_MAX_CHANNELS][50]; ///< masking curve values
  101. int dba_mode[AC3_MAX_CHANNELS]; ///< delta bit allocation mode
  102. int dba_nsegs[AC3_MAX_CHANNELS]; ///< number of delta segments
  103. uint8_t dba_offsets[AC3_MAX_CHANNELS][8]; ///< delta segment offsets
  104. uint8_t dba_lengths[AC3_MAX_CHANNELS][8]; ///< delta segment lengths
  105. uint8_t dba_values[AC3_MAX_CHANNELS][8]; ///< delta values for each segment
  106. ///@}
  107. ///@defgroup dithering zero-mantissa dithering
  108. int dither_all; ///< true if all channels are dithered
  109. int dither_flag[AC3_MAX_CHANNELS]; ///< dither flags (dithflg)
  110. AVRandomState dith_state; ///< for dither generation
  111. ///@}
  112. ///@defgroup imdct IMDCT
  113. int block_switch[AC3_MAX_CHANNELS]; ///< block switch flags (blksw)
  114. MDCTContext imdct_512; ///< for 512 sample IMDCT
  115. MDCTContext imdct_256; ///< for 256 sample IMDCT
  116. ///@}
  117. ///@defgroup opt optimization
  118. DSPContext dsp; ///< for optimization
  119. float add_bias; ///< offset for float_to_int16 conversion
  120. float mul_bias; ///< scaling for float_to_int16 conversion
  121. ///@}
  122. int fixed_coeffs[AC3_MAX_CHANNELS][AC3_MAX_COEFS]; ///> fixed-point transform coefficients
  123. ///@defgroup arrays aligned arrays
  124. DECLARE_ALIGNED_16(float, transform_coeffs[AC3_MAX_CHANNELS][AC3_MAX_COEFS]); ///< transform coefficients
  125. DECLARE_ALIGNED_16(float, delay[AC3_MAX_CHANNELS][AC3_BLOCK_SIZE]); ///< delay - added to the next block
  126. DECLARE_ALIGNED_16(float, window[AC3_BLOCK_SIZE]); ///< window coefficients
  127. DECLARE_ALIGNED_16(float, tmp_output[AC3_BLOCK_SIZE*2]); ///< temporary storage for output before windowing
  128. DECLARE_ALIGNED_16(float, tmp_imdct[AC3_BLOCK_SIZE]); ///< temporary storage for imdct transform
  129. DECLARE_ALIGNED_16(float, output[AC3_MAX_CHANNELS][AC3_BLOCK_SIZE]); ///< output after imdct transform and windowing
  130. DECLARE_ALIGNED_16(short, int_output[AC3_MAX_CHANNELS-1][AC3_BLOCK_SIZE]); ///< final 16-bit integer output
  131. ///@}
  132. } AC3DecodeContext;
  133. #endif /* FFMPEG_AC3DEC_H */