FFmpeg
fft.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2000, 2001, 2002 Fabrice Bellard
3  * Copyright (c) 2002-2004 Michael Niedermayer <michaelni@gmx.at>
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 #ifndef AVCODEC_FFT_H
23 #define AVCODEC_FFT_H
24 
25 #ifndef FFT_FLOAT
26 #define FFT_FLOAT 1
27 #endif
28 
29 #ifndef FFT_FIXED_32
30 #define FFT_FIXED_32 0
31 #endif
32 
33 #include <stdint.h>
34 #include "config.h"
35 
36 #include "libavutil/mem_internal.h"
37 
38 #if FFT_FLOAT
39 
40 #include "avfft.h"
41 
42 #define FFT_NAME(x) x
43 
44 typedef float FFTDouble;
45 
46 #else
47 
48 #if FFT_FIXED_32
49 
50 #define Q31(x) (int)((x)*2147483648.0 + 0.5)
51 #define FFT_NAME(x) x ## _fixed_32
52 
53 typedef int32_t FFTSample;
54 
55 #endif /* FFT_FIXED_32 */
56 
57 typedef struct FFTComplex {
58  FFTSample re, im;
59 } FFTComplex;
60 
61 typedef int FFTDouble;
62 typedef struct FFTContext FFTContext;
63 
64 #endif /* FFT_FLOAT */
65 
66 typedef struct FFTDComplex {
68 } FFTDComplex;
69 
70 /* FFT computation */
71 
76 };
77 
81 };
82 
83 struct FFTContext {
84  int nbits;
85  int inverse;
86  uint16_t *revtab;
88  int mdct_size; /* size of MDCT (i.e. number of input data * 2) */
89  int mdct_bits; /* n = 2^nbits */
90  /* pre/post rotation tables */
93  /**
94  * Do the permutation needed BEFORE calling fft_calc().
95  */
96  void (*fft_permute)(struct FFTContext *s, FFTComplex *z);
97  /**
98  * Do a complex FFT with the parameters defined in ff_fft_init(). The
99  * input data must be permuted before. No 1.0/sqrt(n) normalization is done.
100  */
101  void (*fft_calc)(struct FFTContext *s, FFTComplex *z);
102  void (*imdct_calc)(struct FFTContext *s, FFTSample *output, const FFTSample *input);
103  void (*imdct_half)(struct FFTContext *s, FFTSample *output, const FFTSample *input);
104  void (*mdct_calc)(struct FFTContext *s, FFTSample *output, const FFTSample *input);
107  uint32_t *revtab32;
108 };
109 
110 #if CONFIG_HARDCODED_TABLES
111 #define COSTABLE_CONST const
112 #else
113 #define COSTABLE_CONST
114 #endif
115 
116 #define COSTABLE(size) \
117  COSTABLE_CONST DECLARE_ALIGNED(32, FFTSample, FFT_NAME(ff_cos_##size))[size/2]
118 
119 extern COSTABLE(16);
120 extern COSTABLE(32);
121 extern COSTABLE(64);
122 extern COSTABLE(128);
123 extern COSTABLE(256);
124 extern COSTABLE(512);
125 extern COSTABLE(1024);
126 extern COSTABLE(2048);
127 extern COSTABLE(4096);
128 extern COSTABLE(8192);
129 extern COSTABLE(16384);
130 extern COSTABLE(32768);
131 extern COSTABLE(65536);
132 extern COSTABLE(131072);
133 extern COSTABLE_CONST FFTSample* const FFT_NAME(ff_cos_tabs)[18];
134 
135 #define ff_init_ff_cos_tabs FFT_NAME(ff_init_ff_cos_tabs)
136 
137 /**
138  * Initialize the cosine table in ff_cos_tabs[index]
139  * @param index index in ff_cos_tabs array of the table to initialize
140  */
141 void ff_init_ff_cos_tabs(int index);
142 
143 #define ff_fft_init FFT_NAME(ff_fft_init)
144 #define ff_fft_end FFT_NAME(ff_fft_end)
145 
146 /**
147  * Set up a complex FFT.
148  * @param nbits log2 of the length of the input array
149  * @param inverse if 0 perform the forward transform, if 1 perform the inverse
150  */
151 int ff_fft_init(FFTContext *s, int nbits, int inverse);
152 
153 void ff_fft_init_aarch64(FFTContext *s);
154 void ff_fft_init_x86(FFTContext *s);
155 void ff_fft_init_arm(FFTContext *s);
156 void ff_fft_init_mips(FFTContext *s);
157 void ff_fft_init_ppc(FFTContext *s);
158 
159 void ff_fft_end(FFTContext *s);
160 
161 #define ff_mdct_init FFT_NAME(ff_mdct_init)
162 #define ff_mdct_end FFT_NAME(ff_mdct_end)
163 
164 int ff_mdct_init(FFTContext *s, int nbits, int inverse, double scale);
165 void ff_mdct_end(FFTContext *s);
166 
167 #endif /* AVCODEC_FFT_H */
float FFTDouble
Definition: fft.h:44
mdct_permutation_type
Definition: fft.h:78
void ff_fft_init_arm(FFTContext *s)
Definition: fft_init_arm.c:38
FFTSample re
Definition: avfft.h:38
void FFTComplex
Definition: tx_priv.h:46
#define COSTABLE(size)
Definition: fft.h:116
filter_frame For filters that do not use the this method is called when a frame is pushed to the filter s input It can be called at any time except in a reentrant way If the input frame is enough to produce output
static void fft_permute(FFTContext *s, FFTComplex *z)
Definition: fft.c:259
void ff_fft_init_ppc(FFTContext *s)
Definition: fft_init.c:151
FFTDouble re
Definition: fft.h:67
#define FFT_NAME(x)
Definition: fft.h:42
#define ff_mdct_init
Definition: fft.h:161
float FFTSample
Definition: avfft.h:35
Definition: fft.h:83
FFTSample * tsin
Definition: fft.h:92
uint32_t * revtab32
Definition: fft.h:107
typedef void(APIENTRY *FF_PFNGLACTIVETEXTUREPROC)(GLenum texture)
int nbits
Definition: fft.h:84
#define ff_fft_init
Definition: fft.h:143
int inverse
Definition: fft.h:85
int32_t
#define s(width, name)
Definition: cbs_vp9.c:257
enum fft_permutation_type fft_permutation
Definition: fft.h:105
static void mdct_calc(FFTContext *s, FFTSample *output, const FFTSample *input)
Definition: fft.c:241
FFT functions.
int index
Definition: gxfenc.c:89
static void fft_calc(FFTContext *s, FFTComplex *z)
Definition: fft.c:268
int mdct_bits
Definition: fft.h:89
and forward the test the status of outputs and forward it to the corresponding return FFERROR_NOT_READY If the filters stores internally one or a few frame for some input
fft_permutation_type
Definition: fft.h:72
void(* imdct_half)(struct FFTContext *s, FFTSample *output, const FFTSample *input)
Definition: fft.h:103
#define ff_init_ff_cos_tabs
Definition: fft.h:135
void ff_fft_init_aarch64(FFTContext *s)
FFTSample im
Definition: avfft.h:38
#define ff_mdct_end
Definition: fft.h:162
#define COSTABLE_CONST
Definition: fft.h:113
static void imdct_calc(DBEContext *s, DBEGroup *g, float *result, float *values)
Definition: dolby_e.c:498
#define ff_fft_end
Definition: fft.h:144
FFTSample * tcos
Definition: fft.h:91
void ff_fft_init_mips(FFTContext *s)
FFT transform.
Definition: fft_mips.c:501
uint16_t * revtab
Definition: fft.h:86
static uint32_t inverse(uint32_t v)
find multiplicative inverse modulo 2 ^ 32
Definition: asfcrypt.c:35
int mdct_size
Definition: fft.h:88
enum mdct_permutation_type mdct_permutation
Definition: fft.h:106
void ff_fft_init_x86(FFTContext *s)
Definition: fft_init.c:27
FFTComplex * tmp_buf
Definition: fft.h:87