2 * Spectral Band Replication definitions and structures
3 * Copyright (c) 2008-2009 Robert Swain ( rob opendot cl )
4 * Copyright (c) 2010 Alex Converse <alex.converse@gmail.com>
6 * This file is part of FFmpeg.
8 * FFmpeg is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * FFmpeg is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with FFmpeg; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
25 * Spectral Band Replication definitions and structures
26 * @author Robert Swain ( rob opendot cl )
37 typedef struct AACContext AACContext
;
40 * Spectral Band Replication header - spectrum parameters that invoke a reset if they differ from the previous header.
42 typedef struct SpectrumParameters
{
43 uint8_t bs_start_freq
;
45 uint8_t bs_xover_band
;
48 * @name Variables associated with bs_header_extra_1
51 uint8_t bs_freq_scale
;
52 uint8_t bs_alter_scale
;
53 uint8_t bs_noise_bands
;
57 #define SBR_SYNTHESIS_BUF_SIZE ((1280-128)*2)
60 * Spectral Band Replication per channel data
62 typedef struct SBRData
{
64 * @name Main bitstream data variables
67 unsigned bs_frame_class
;
68 unsigned bs_add_harmonic_flag
;
70 uint8_t bs_freq_res
[7];
71 unsigned bs_num_noise
;
73 uint8_t bs_df_noise
[2];
74 uint8_t bs_invf_mode
[2][5];
75 uint8_t bs_add_harmonic
[48];
80 * @name State variables
83 DECLARE_ALIGNED(32, float, synthesis_filterbank_samples
)[SBR_SYNTHESIS_BUF_SIZE
];
84 DECLARE_ALIGNED(32, float, analysis_filterbank_samples
) [1312];
85 int synthesis_filterbank_samples_offset
;
90 ///QMF values of the original signal
91 float W
[2][32][32][2];
92 ///QMF output of the HF adjustor
94 DECLARE_ALIGNED(16, float, Y
)[2][38][64][2];
95 DECLARE_ALIGNED(16, float, g_temp
)[42][48];
97 uint8_t s_indexmapped
[8][48];
98 ///Envelope scalefactors
99 float env_facs
[6][48];
100 ///Noise scalefactors
101 float noise_facs
[3][5];
102 ///Envelope time borders
104 ///Envelope time border of the last envelope of the previous frame
105 uint8_t t_env_num_env_old
;
106 ///Noise time borders
108 unsigned f_indexnoise
;
109 unsigned f_indexsine
;
113 typedef struct SpectralBandReplication SpectralBandReplication
;
116 * aacsbr functions pointers
118 typedef struct AACSBRContext
{
119 int (*sbr_lf_gen
)(AACContext
*ac
, SpectralBandReplication
*sbr
,
120 float X_low
[32][40][2], const float W
[2][32][32][2],
122 void (*sbr_hf_assemble
)(float Y1
[38][64][2],
123 const float X_high
[64][40][2],
124 SpectralBandReplication
*sbr
, SBRData
*ch_data
,
126 int (*sbr_x_gen
)(SpectralBandReplication
*sbr
, float X
[2][38][64],
127 const float Y0
[38][64][2], const float Y1
[38][64][2],
128 const float X_low
[32][40][2], int ch
);
129 void (*sbr_hf_inverse_filter
)(SBRDSPContext
*dsp
,
130 float (*alpha0
)[2], float (*alpha1
)[2],
131 const float X_low
[32][40][2], int k0
);
135 * Spectral Band Replication
137 struct SpectralBandReplication
{
141 SpectrumParameters spectrum_params
;
142 int bs_amp_res_header
;
144 * @name Variables associated with bs_header_extra_2
147 unsigned bs_limiter_bands
;
148 unsigned bs_limiter_gains
;
149 unsigned bs_interpol_freq
;
150 unsigned bs_smoothing_mode
;
152 unsigned bs_coupling
;
153 unsigned k
[5]; ///< k0, k1, k2
154 ///kx', and kx respectively, kx is the first QMF subband where SBR is used.
155 ///kx' is its value from the previous frame
157 ///M' and M respectively, M is the number of QMF subbands that use SBR.
159 unsigned kx_and_m_pushed
;
160 ///The number of frequency bands in f_master
164 ///N_Low and N_High respectively, the number of frequency bands for low and high resolution
166 ///Number of noise floor bands
168 ///Number of limiter bands
170 ///The master QMF frequency grouping
171 uint16_t f_master
[49];
172 ///Frequency borders for low resolution SBR
173 uint16_t f_tablelow
[25];
174 ///Frequency borders for high resolution SBR
175 uint16_t f_tablehigh
[49];
176 ///Frequency borders for noise floors
177 uint16_t f_tablenoise
[6];
178 ///Frequency borders for the limiter
179 uint16_t f_tablelim
[30];
180 unsigned num_patches
;
181 uint8_t patch_num_subbands
[6];
182 uint8_t patch_start_subband
[6];
183 ///QMF low frequency input to the HF generator
184 DECLARE_ALIGNED(16, float, X_low
)[32][40][2];
185 ///QMF output of the HF generator
186 DECLARE_ALIGNED(16, float, X_high
)[64][40][2];
187 ///QMF values of the reconstructed signal
188 DECLARE_ALIGNED(16, float, X
)[2][2][38][64];
189 ///Zeroth coefficient used to filter the subband signals
190 DECLARE_ALIGNED(16, float, alpha0
)[64][2];
191 ///First coefficient used to filter the subband signals
192 DECLARE_ALIGNED(16, float, alpha1
)[64][2];
193 ///Dequantized envelope scalefactors, remapped
194 float e_origmapped
[7][48];
195 ///Dequantized noise scalefactors, remapped
196 float q_mapped
[7][48];
197 ///Sinusoidal presence, remapped
198 uint8_t s_mapped
[7][48];
199 ///Estimated envelope
201 ///Amplitude adjusted noise scalefactors
206 DECLARE_ALIGNED(32, float, qmf_filter_scratch
)[5][64];
213 #endif /* AVCODEC_SBR_H */