2 * Copyright (c) 2000, 2001, 2002 Fabrice Bellard
3 * Copyright (c) 2002-2004 Michael Niedermayer <michaelni@gmx.at>
5 * This file is part of FFmpeg.
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.
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.
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
27 #include "libavutil/mem.h"
37 int mdct_size; /* size of MDCT (i.e. number of input data * 2) */
38 int mdct_bits; /* n = 2^nbits */
39 /* pre/post rotation tables */
42 void (*fft_permute)(struct FFTContext *s, FFTComplex *z);
43 void (*fft_calc)(struct FFTContext *s, FFTComplex *z);
44 void (*imdct_calc)(struct FFTContext *s, FFTSample *output, const FFTSample *input);
45 void (*imdct_half)(struct FFTContext *s, FFTSample *output, const FFTSample *input);
46 void (*mdct_calc)(struct FFTContext *s, FFTSample *output, const FFTSample *input);
48 #define FF_MDCT_PERM_NONE 0
49 #define FF_MDCT_PERM_INTERLEAVE 1
52 #if CONFIG_HARDCODED_TABLES
53 #define COSTABLE_CONST const
54 #define SINTABLE_CONST const
55 #define SINETABLE_CONST const
57 #define COSTABLE_CONST
58 #define SINTABLE_CONST
59 #define SINETABLE_CONST
62 #define COSTABLE(size) \
63 COSTABLE_CONST DECLARE_ALIGNED(16, FFTSample, ff_cos_##size)[size/2]
64 #define SINTABLE(size) \
65 SINTABLE_CONST DECLARE_ALIGNED(16, FFTSample, ff_sin_##size)[size/2]
66 #define SINETABLE(size) \
67 SINETABLE_CONST DECLARE_ALIGNED(16, float, ff_sine_##size)[size]
74 extern COSTABLE(1024);
75 extern COSTABLE(2048);
76 extern COSTABLE(4096);
77 extern COSTABLE(8192);
78 extern COSTABLE(16384);
79 extern COSTABLE(32768);
80 extern COSTABLE(65536);
81 extern COSTABLE_CONST FFTSample* const ff_cos_tabs[17];
84 * Initialize the cosine table in ff_cos_tabs[index]
85 * \param index index in ff_cos_tabs array of the table to initialize
87 void ff_init_ff_cos_tabs(int index);
95 extern SINTABLE(1024);
96 extern SINTABLE(2048);
97 extern SINTABLE(4096);
98 extern SINTABLE(8192);
99 extern SINTABLE(16384);
100 extern SINTABLE(32768);
101 extern SINTABLE(65536);
104 * Set up a complex FFT.
105 * @param nbits log2 of the length of the input array
106 * @param inverse if 0 perform the forward transform, if 1 perform the inverse
108 int ff_fft_init(FFTContext *s, int nbits, int inverse);
109 void ff_fft_permute_c(FFTContext *s, FFTComplex *z);
110 void ff_fft_calc_c(FFTContext *s, FFTComplex *z);
112 void ff_fft_init_altivec(FFTContext *s);
113 void ff_fft_init_mmx(FFTContext *s);
114 void ff_fft_init_arm(FFTContext *s);
115 void ff_dct_init_mmx(DCTContext *s);
118 * Do the permutation needed BEFORE calling ff_fft_calc().
120 static inline void ff_fft_permute(FFTContext *s, FFTComplex *z)
122 s->fft_permute(s, z);
125 * Do a complex FFT with the parameters defined in ff_fft_init(). The
126 * input data must be permuted before. No 1.0/sqrt(n) normalization is done.
128 static inline void ff_fft_calc(FFTContext *s, FFTComplex *z)
132 void ff_fft_end(FFTContext *s);
134 /* MDCT computation */
136 static inline void ff_imdct_calc(FFTContext *s, FFTSample *output, const FFTSample *input)
138 s->imdct_calc(s, output, input);
140 static inline void ff_imdct_half(FFTContext *s, FFTSample *output, const FFTSample *input)
142 s->imdct_half(s, output, input);
145 static inline void ff_mdct_calc(FFTContext *s, FFTSample *output,
146 const FFTSample *input)
148 s->mdct_calc(s, output, input);
152 * Maximum window size for ff_kbd_window_init.
154 #define FF_KBD_WINDOW_MAX 1024
157 * Generate a Kaiser-Bessel Derived Window.
158 * @param window pointer to half window
159 * @param alpha determines window shape
160 * @param n size of half window, max FF_KBD_WINDOW_MAX
162 void ff_kbd_window_init(float *window, float alpha, int n);
165 * Generate a sine window.
166 * @param window pointer to half window
167 * @param n size of half window
169 void ff_sine_window_init(float *window, int n);
172 * initialize the specified entry of ff_sine_windows
174 void ff_init_ff_sine_windows(int index);
175 extern SINETABLE( 32);
176 extern SINETABLE( 64);
177 extern SINETABLE( 128);
178 extern SINETABLE( 256);
179 extern SINETABLE( 512);
180 extern SINETABLE(1024);
181 extern SINETABLE(2048);
182 extern SINETABLE(4096);
183 extern SINETABLE_CONST float * const ff_sine_windows[13];
185 int ff_mdct_init(FFTContext *s, int nbits, int inverse, double scale);
186 void ff_imdct_calc_c(FFTContext *s, FFTSample *output, const FFTSample *input);
187 void ff_imdct_half_c(FFTContext *s, FFTSample *output, const FFTSample *input);
188 void ff_mdct_calc_c(FFTContext *s, FFTSample *output, const FFTSample *input);
189 void ff_mdct_end(FFTContext *s);
191 /* Real Discrete Fourier Transform */
198 /* pre/post rotation tables */
199 const FFTSample *tcos;
200 SINTABLE_CONST FFTSample *tsin;
202 void (*rdft_calc)(struct RDFTContext *s, FFTSample *z);
207 * @param nbits log2 of the length of the input array
208 * @param trans the type of transform
210 int ff_rdft_init(RDFTContext *s, int nbits, enum RDFTransformType trans);
211 void ff_rdft_end(RDFTContext *s);
213 void ff_rdft_init_arm(RDFTContext *s);
215 static av_always_inline void ff_rdft_calc(RDFTContext *s, FFTSample *data)
217 s->rdft_calc(s, data);
220 /* Discrete Cosine Transform */
228 void (*dct_calc)(struct DCTContext *s, FFTSample *data);
229 void (*dct32)(FFTSample *out, const FFTSample *in);
234 * @param nbits size of the input array:
235 * (1 << nbits) for DCT-II, DCT-III and DST-I
236 * (1 << nbits) + 1 for DCT-I
238 * @note the first element of the input of DST-I is ignored
240 int ff_dct_init(DCTContext *s, int nbits, enum DCTTransformType type);
241 void ff_dct_calc(DCTContext *s, FFTSample *data);
242 void ff_dct_end (DCTContext *s);
244 #endif /* AVCODEC_FFT_H */