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 #include <stdint.h>
30 #include "config.h"
31 
33 #include "libavutil/mem_internal.h"
34 
35 #if FFT_FLOAT
36 
37 #include "avfft.h"
38 
39 #define FFT_NAME(x) x
40 
41 typedef float FFTDouble;
42 
43 #else
44 
45 #define Q31(x) (int)((x)*2147483648.0 + 0.5)
46 #define FFT_NAME(x) x ## _fixed_32
47 
48 typedef int32_t FFTSample;
49 
50 typedef struct FFTComplex {
51  FFTSample re, im;
52 } FFTComplex;
53 
54 typedef int FFTDouble;
55 typedef struct FFTContext FFTContext;
56 
57 #endif /* FFT_FLOAT */
58 
59 typedef struct FFTDComplex {
61 } FFTDComplex;
62 
63 /* FFT computation */
64 
69 };
70 
74 };
75 
76 struct FFTContext {
77  int nbits;
78  int inverse;
79  uint16_t *revtab;
81  int mdct_size; /* size of MDCT (i.e. number of input data * 2) */
82  int mdct_bits; /* n = 2^nbits */
83  /* pre/post rotation tables */
86  /**
87  * Do the permutation needed BEFORE calling fft_calc().
88  */
89  void (*fft_permute)(struct FFTContext *s, FFTComplex *z);
90  /**
91  * Do a complex FFT with the parameters defined in ff_fft_init(). The
92  * input data must be permuted before. No 1.0/sqrt(n) normalization is done.
93  */
94  void (*fft_calc)(struct FFTContext *s, FFTComplex *z);
95  void (*imdct_calc)(struct FFTContext *s, FFTSample *output, const FFTSample *input);
96  void (*imdct_half)(struct FFTContext *s, FFTSample *output, const FFTSample *input);
97  void (*mdct_calc)(struct FFTContext *s, FFTSample *output, const FFTSample *input);
100  uint32_t *revtab32;
101 };
102 
103 #if CONFIG_HARDCODED_TABLES
104 #define COSTABLE_CONST const
105 #define ff_init_ff_cos_tabs(index)
106 #else
107 #define COSTABLE_CONST
108 #define ff_init_ff_cos_tabs FFT_NAME(ff_init_ff_cos_tabs)
109 
110 /**
111  * Initialize the cosine table in ff_cos_tabs[index]
112  * @param index index in ff_cos_tabs array of the table to initialize
113  */
114 void ff_init_ff_cos_tabs(int index);
115 #endif
116 
117 #define COSTABLE(size) \
118  COSTABLE_CONST attribute_visibility_hidden DECLARE_ALIGNED(32, FFTSample, FFT_NAME(ff_cos_##size))[size/2]
119 
120 extern COSTABLE(16);
121 extern COSTABLE(32);
122 extern COSTABLE(64);
123 extern COSTABLE(128);
124 extern COSTABLE(256);
125 extern COSTABLE(512);
126 extern COSTABLE(1024);
127 extern COSTABLE(2048);
128 extern COSTABLE(4096);
129 extern COSTABLE(8192);
130 extern COSTABLE(16384);
131 extern COSTABLE(32768);
132 extern COSTABLE(65536);
133 extern COSTABLE(131072);
134 extern COSTABLE_CONST FFTSample* const FFT_NAME(ff_cos_tabs)[18];
135 
136 #define ff_fft_init FFT_NAME(ff_fft_init)
137 #define ff_fft_end FFT_NAME(ff_fft_end)
138 
139 /**
140  * Set up a complex FFT.
141  * @param nbits log2 of the length of the input array
142  * @param inverse if 0 perform the forward transform, if 1 perform the inverse
143  */
144 int ff_fft_init(FFTContext *s, int nbits, int inverse);
145 
151 
152 void ff_fft_end(FFTContext *s);
153 
154 #define ff_mdct_init FFT_NAME(ff_mdct_init)
155 #define ff_mdct_end FFT_NAME(ff_mdct_end)
156 
157 int ff_mdct_init(FFTContext *s, int nbits, int inverse, double scale);
158 void ff_mdct_end(FFTContext *s);
159 
160 #endif /* AVCODEC_FFT_H */
FFTContext::revtab
uint16_t * revtab
Definition: fft.h:79
ff_fft_init
#define ff_fft_init
Definition: fft.h:136
ff_fft_init_ppc
void ff_fft_init_ppc(FFTContext *s)
Definition: fft_init.c:152
ff_init_ff_cos_tabs
#define ff_init_ff_cos_tabs
Definition: fft.h:108
FFTContext::tcos
FFTSample * tcos
Definition: fft.h:84
mem_internal.h
inverse
inverse
Definition: af_crystalizer.c:121
output
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
Definition: filter_design.txt:225
FFTContext::mdct_calc
void(* mdct_calc)(struct FFTContext *s, FFTSample *output, const FFTSample *input)
Definition: fft.h:97
FFTDComplex
Definition: fft.h:59
ff_mdct_init
#define ff_mdct_init
Definition: fft.h:154
FFTContext::inverse
int inverse
Definition: fft.h:78
FF_FFT_PERM_SWAP_LSBS
@ FF_FFT_PERM_SWAP_LSBS
Definition: fft.h:67
FF_FFT_PERM_DEFAULT
@ FF_FFT_PERM_DEFAULT
Definition: fft.h:66
FFTContext::tmp_buf
FFTComplex * tmp_buf
Definition: fft.h:80
FFT_NAME
#define FFT_NAME(x)
Definition: fft.h:39
scale
static av_always_inline float scale(float x, float s)
Definition: vf_v360.c:1389
FFTContext::revtab32
uint32_t * revtab32
Definition: fft.h:100
attributes_internal.h
s
#define s(width, name)
Definition: cbs_vp9.c:198
ff_fft_init_x86
void ff_fft_init_x86(FFTContext *s)
Definition: fft_init.c:27
FFTContext::fft_permutation
enum fft_permutation_type fft_permutation
Definition: fft.h:98
mdct_permutation_type
mdct_permutation_type
Definition: fft.h:71
ff_fft_end
#define ff_fft_end
Definition: fft.h:137
FFTContext::mdct_permutation
enum mdct_permutation_type mdct_permutation
Definition: fft.h:99
COSTABLE_CONST
#define COSTABLE_CONST
Definition: fft.h:107
FFTDComplex::re
FFTDouble re
Definition: fft.h:60
FFTSample
float FFTSample
Definition: avfft.h:39
avfft.h
index
int index
Definition: gxfenc.c:89
FFTContext::imdct_half
void(* imdct_half)(struct FFTContext *s, FFTSample *output, const FFTSample *input)
Definition: fft.h:96
FFTContext::imdct_calc
void(* imdct_calc)(struct FFTContext *s, FFTSample *output, const FFTSample *input)
Definition: fft.h:95
FFTContext::nbits
int nbits
Definition: fft.h:77
COSTABLE
#define COSTABLE(size)
Definition: fft.h:117
ff_mdct_end
#define ff_mdct_end
Definition: fft.h:155
FFTContext::fft_permute
void(* fft_permute)(struct FFTContext *s, FFTComplex *z)
Do the permutation needed BEFORE calling fft_calc().
Definition: fft.h:89
FFTComplex::im
FFTSample im
Definition: avfft.h:42
ff_fft_init_mips
void ff_fft_init_mips(FFTContext *s)
FFT transform.
Definition: fft_mips.c:502
FFTComplex::re
FFTSample re
Definition: avfft.h:42
FFTDouble
float FFTDouble
Definition: fft.h:41
FFTContext::fft_calc
void(* fft_calc)(struct FFTContext *s, FFTComplex *z)
Do a complex FFT with the parameters defined in ff_fft_init().
Definition: fft.h:94
input
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
Definition: filter_design.txt:172
FFTContext::mdct_size
int mdct_size
Definition: fft.h:81
FFTContext
Definition: fft.h:76
FF_MDCT_PERM_INTERLEAVE
@ FF_MDCT_PERM_INTERLEAVE
Definition: fft.h:73
ff_fft_init_arm
void ff_fft_init_arm(FFTContext *s)
Definition: fft_init_arm.c:38
fft_permutation_type
fft_permutation_type
Definition: fft.h:65
FFTContext::tsin
FFTSample * tsin
Definition: fft.h:85
ff_fft_init_aarch64
void ff_fft_init_aarch64(FFTContext *s)
Definition: fft_init_aarch64.c:36
FF_MDCT_PERM_NONE
@ FF_MDCT_PERM_NONE
Definition: fft.h:72
FFTContext::mdct_bits
int mdct_bits
Definition: fft.h:82
int32_t
int32_t
Definition: audioconvert.c:56
FFTDComplex::im
FFTDouble im
Definition: fft.h:60
FF_FFT_PERM_AVX
@ FF_FFT_PERM_AVX
Definition: fft.h:68
FFTComplex
Definition: avfft.h:41