libfaad2/sbr_dec.h

   1 /*
   2 ** FAAD2 - Freeware Advanced Audio (AAC) Decoder including SBR decoding
   3 ** Copyright (C) 2003-2004 M. Bakker, Ahead Software AG, http://www.nero.com
   4 **
   5 ** This program is free software; you can redistribute it and/or modify
   6 ** it under the terms of the GNU General Public License as published by
   7 ** the Free Software Foundation; either version 2 of the License, or
   8 ** (at your option) any later version.
   9 **
  10 ** This program is distributed in the hope that it will be useful,
  11 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 ** GNU General Public License for more details.
  14 **
  15 ** You should have received a copy of the GNU General Public License
  16 ** along with this program; if not, write to the Free Software
  17 ** Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  18 **
  19 ** Any non-GPL usage of this software or parts of this software is strictly
  20 ** forbidden.
  21 **
  22 ** Commercial non-GPL licensing of this software is possible.
  23 ** For more info contact Ahead Software through Mpeg4AAClicense@nero.com.
  24 **
  25 ** $Id: sbr_dec.h,v 1.35 2004/09/04 14:56:28 menno Exp $
  26 **/
  27
  28 #ifndef __SBR_DEC_H__
  29 #define __SBR_DEC_H__
  30
  31 #ifdef __cplusplus
  32 extern "C" {
  33 #endif
  34
  35 #ifdef PS_DEC
  36 #include "ps_dec.h"
  37 #endif
  38 #ifdef DRM_PS
  39 #include "drm_dec.h"
  40 #endif
  41
  42 /* MAX_NTSRHFG: maximum of number_time_slots * rate + HFGen. 16*2+8 */
  43 #define MAX_NTSRHFG 40
  44 #define MAX_NTSR    32 /* max number_time_slots * rate, ok for DRM and not DRM mode */
  45
  46 /* MAX_M: maximum value for M */
  47 #define MAX_M       49
  48 /* MAX_L_E: maximum value for L_E */
  49 #define MAX_L_E      5
  50
  51 typedef struct {
  52     real_t *x;
  53     int16_t x_index;
  54     uint8_t channels;
  55 } qmfa_info;
  56
  57 typedef struct {
  58     real_t *v;
  59     int16_t v_index;
  60     uint8_t channels;
  61 } qmfs_info;
  62
  63 typedef struct
  64 {
  65     uint32_t sample_rate;
  66     uint32_t maxAACLine;
  67
  68     uint8_t rate;
  69     uint8_t just_seeked;
  70     uint8_t ret;
  71
  72     uint8_t amp_res[2];
  73
  74     uint8_t k0;
  75     uint8_t kx;
  76     uint8_t M;
  77     uint8_t N_master;
  78     uint8_t N_high;
  79     uint8_t N_low;
  80     uint8_t N_Q;
  81     uint8_t N_L[4];
  82     uint8_t n[2];
  83
  84     uint8_t f_master[64];
  85     uint8_t f_table_res[2][64];
  86     uint8_t f_table_noise[64];
  87     uint8_t f_table_lim[4][64];
  88 #ifdef SBR_LOW_POWER
  89     uint8_t f_group[5][64];
  90     uint8_t N_G[5];
  91 #endif
  92
  93     uint8_t table_map_k_to_g[64];
  94
  95     uint8_t abs_bord_lead[2];
  96     uint8_t abs_bord_trail[2];
  97     uint8_t n_rel_lead[2];
  98     uint8_t n_rel_trail[2];
  99
 100     uint8_t L_E[2];
 101     uint8_t L_E_prev[2];
 102     uint8_t L_Q[2];
 103
 104     uint8_t t_E[2][MAX_L_E+1];
 105     uint8_t t_Q[2][3];
 106     uint8_t f[2][MAX_L_E+1];
 107     uint8_t f_prev[2];
 108
 109     real_t *G_temp_prev[2][5];
 110     real_t *Q_temp_prev[2][5];
 111     int8_t GQ_ringbuf_index[2];
 112
 113     int16_t E[2][64][MAX_L_E];
 114     int16_t E_prev[2][64];
 115 #ifndef FIXED_POINT
 116     real_t E_orig[2][64][MAX_L_E];
 117 #endif
 118     real_t E_curr[2][64][MAX_L_E];
 119     int32_t Q[2][64][2];
 120 #ifndef FIXED_POINT
 121     real_t Q_div[2][64][2];
 122     real_t Q_div2[2][64][2];
 123 #endif
 124     int32_t Q_prev[2][64];
 125
 126     int8_t l_A[2];
 127     int8_t l_A_prev[2];
 128
 129     uint8_t bs_invf_mode[2][MAX_L_E];
 130     uint8_t bs_invf_mode_prev[2][MAX_L_E];
 131     real_t bwArray[2][64];
 132     real_t bwArray_prev[2][64];
 133
 134     uint8_t noPatches;
 135     uint8_t patchNoSubbands[64];
 136     uint8_t patchStartSubband[64];
 137
 138     uint8_t bs_add_harmonic[2][64];
 139     uint8_t bs_add_harmonic_prev[2][64];
 140
 141     uint16_t index_noise_prev[2];
 142     uint8_t psi_is_prev[2];
 143
 144     uint8_t bs_start_freq_prev;
 145     uint8_t bs_stop_freq_prev;
 146     uint8_t bs_xover_band_prev;
 147     uint8_t bs_freq_scale_prev;
 148     uint8_t bs_alter_scale_prev;
 149     uint8_t bs_noise_bands_prev;
 150
 151     int8_t prevEnvIsShort[2];
 152
 153     int8_t kx_prev;
 154     uint8_t bsco;
 155     uint8_t bsco_prev;
 156     uint8_t M_prev;
 157     uint16_t frame_len;
 158
 159     uint8_t Reset;
 160     uint32_t frame;
 161     uint32_t header_count;
 162
 163     uint8_t id_aac;
 164     qmfa_info *qmfa[2];
 165     qmfs_info *qmfs[2];
 166
 167     qmf_t Xsbr[2][MAX_NTSRHFG][64];
 168
 169 #ifdef DRM
 170     uint8_t Is_DRM_SBR;
 171 #ifdef DRM_PS
 172     drm_ps_info *drm_ps;
 173 #endif
 174 #endif
 175
 176     uint8_t numTimeSlotsRate;
 177     uint8_t numTimeSlots;
 178     uint8_t tHFGen;
 179     uint8_t tHFAdj;
 180
 181 #ifdef PS_DEC
 182     ps_info *ps;
 183 #endif
 184 #if (defined(PS_DEC) || defined(DRM_PS))
 185     uint8_t ps_used;
 186 #endif
 187
 188     /* to get it compiling */
 189     /* we'll see during the coding of all the tools, whether
 190        these are all used or not.
 191     */
 192     uint8_t bs_header_flag;
 193     uint8_t bs_crc_flag;
 194     uint16_t bs_sbr_crc_bits;
 195     uint8_t bs_protocol_version;
 196     uint8_t bs_amp_res;
 197     uint8_t bs_start_freq;
 198     uint8_t bs_stop_freq;
 199     uint8_t bs_xover_band;
 200     uint8_t bs_freq_scale;
 201     uint8_t bs_alter_scale;
 202     uint8_t bs_noise_bands;
 203     uint8_t bs_limiter_bands;
 204     uint8_t bs_limiter_gains;
 205     uint8_t bs_interpol_freq;
 206     uint8_t bs_smoothing_mode;
 207     uint8_t bs_samplerate_mode;
 208     uint8_t bs_add_harmonic_flag[2];
 209     uint8_t bs_add_harmonic_flag_prev[2];
 210     uint8_t bs_extended_data;
 211     uint8_t bs_extension_id;
 212     uint8_t bs_extension_data;
 213     uint8_t bs_coupling;
 214     uint8_t bs_frame_class[2];
 215     uint8_t bs_rel_bord[2][9];
 216     uint8_t bs_rel_bord_0[2][9];
 217     uint8_t bs_rel_bord_1[2][9];
 218     uint8_t bs_pointer[2];
 219     uint8_t bs_abs_bord_0[2];
 220     uint8_t bs_abs_bord_1[2];
 221     uint8_t bs_num_rel_0[2];
 222     uint8_t bs_num_rel_1[2];
 223     uint8_t bs_df_env[2][9];
 224     uint8_t bs_df_noise[2][3];
 225 } sbr_info;
 226
 227 sbr_info *sbrDecodeInit(uint16_t framelength, uint8_t id_aac,
 228                         uint32_t sample_rate, uint8_t downSampledSBR
 229 #ifdef DRM
 230                         , uint8_t IsDRM
 231 #endif
 232                         );
 233 void sbrDecodeEnd(sbr_info *sbr);
 234
 235 uint8_t sbrDecodeCoupleFrame(sbr_info *sbr, real_t *left_chan, real_t *right_chan,
 236                              const uint8_t just_seeked, const uint8_t downSampledSBR);
 237 uint8_t sbrDecodeSingleFrame(sbr_info *sbr, real_t *channel,
 238                              const uint8_t just_seeked, const uint8_t downSampledSBR);
 239 #if (defined(PS_DEC) || defined(DRM_PS))
 240 uint8_t sbrDecodeSingleFramePS(sbr_info *sbr, real_t *left_channel, real_t *right_channel,
 241                                const uint8_t just_seeked, const uint8_t downSampledSBR);
 242 #endif
 243
 244
 245 #ifdef __cplusplus
 246 }
 247 #endif
 248 #endif
 249