1 /* 2 * Copyright (C) 2010 Google Inc. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions 6 * are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of 14 * its contributors may be used to endorse or promote products derived 15 * from this software without specific prior written permission. 16 * 17 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY 18 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 19 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 20 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY 21 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 22 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 23 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 24 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 */ 28 29 #ifndef FFTFrame_h 30 #define FFTFrame_h 31 32 #include "platform/PlatformExport.h" 33 #include "platform/audio/AudioArray.h" 34 35 #if OS(MACOSX) 36 #include <Accelerate/Accelerate.h> 37 #elif USE(WEBAUDIO_OPENMAX_DL_FFT) 38 #include <dl/sp/api/omxSP.h> 39 #elif USE(WEBAUDIO_FFMPEG) 40 struct RDFTContext; 41 #endif 42 43 #if USE(WEBAUDIO_IPP) 44 #include <ipps.h> 45 #endif // USE(WEBAUDIO_IPP) 46 47 #include "wtf/Forward.h" 48 #include "wtf/PassOwnPtr.h" 49 #include "wtf/Threading.h" 50 51 namespace WebCore { 52 53 // Defines the interface for an "FFT frame", an object which is able to perform a forward 54 // and reverse FFT, internally storing the resultant frequency-domain data. 55 56 class PLATFORM_EXPORT FFTFrame { 57 public: 58 // The constructors, destructor, and methods up to the CROSS-PLATFORM section have platform-dependent implementations. 59 60 FFTFrame(unsigned fftSize); 61 FFTFrame(); // creates a blank/empty frame for later use with createInterpolatedFrame() 62 FFTFrame(const FFTFrame& frame); 63 ~FFTFrame(); 64 65 static void initialize(); 66 static void cleanup(); 67 void doFFT(const float* data); 68 void doInverseFFT(float* data); 69 70 float* realData() const; 71 float* imagData() const; 72 73 void print(); // for debugging 74 75 // CROSS-PLATFORM 76 // The remaining public methods have cross-platform implementations: 77 78 // Interpolates from frame1 -> frame2 as x goes from 0.0 -> 1.0 79 static PassOwnPtr<FFTFrame> createInterpolatedFrame(const FFTFrame& frame1, const FFTFrame& frame2, double x); 80 81 void doPaddedFFT(const float* data, size_t dataSize); // zero-padding with dataSize <= fftSize 82 double extractAverageGroupDelay(); 83 void addConstantGroupDelay(double sampleFrameDelay); 84 void multiply(const FFTFrame&); // multiplies ourself with frame : effectively operator*=() 85 fftSize()86 unsigned fftSize() const { return m_FFTSize; } log2FFTSize()87 unsigned log2FFTSize() const { return m_log2FFTSize; } 88 89 private: 90 unsigned m_FFTSize; 91 unsigned m_log2FFTSize; 92 93 void interpolateFrequencyComponents(const FFTFrame& frame1, const FFTFrame& frame2, double x); 94 95 #if OS(MACOSX) dspSplitComplex()96 DSPSplitComplex& dspSplitComplex() { return m_frame; } dspSplitComplex()97 DSPSplitComplex dspSplitComplex() const { return m_frame; } 98 99 static FFTSetup fftSetupForSize(unsigned fftSize); 100 101 static FFTSetup* fftSetups; 102 103 FFTSetup m_FFTSetup; 104 105 DSPSplitComplex m_frame; 106 AudioFloatArray m_realData; 107 AudioFloatArray m_imagData; 108 #else // !OS(MACOSX) 109 110 #if USE(WEBAUDIO_FFMPEG) 111 static RDFTContext* contextForSize(unsigned fftSize, int trans); 112 113 RDFTContext* m_forwardContext; 114 RDFTContext* m_inverseContext; 115 116 float* getUpToDateComplexData(); 117 AudioFloatArray m_complexData; 118 AudioFloatArray m_realData; 119 AudioFloatArray m_imagData; 120 #endif // USE(WEBAUDIO_FFMPEG) 121 122 #if USE(WEBAUDIO_IPP) 123 Ipp8u* m_buffer; 124 IppsDFTSpec_R_32f* m_DFTSpec; 125 126 float* getUpToDateComplexData(); 127 AudioFloatArray m_complexData; 128 AudioFloatArray m_realData; 129 AudioFloatArray m_imagData; 130 #endif // USE(WEBAUDIO_IPP) 131 132 #if USE(WEBAUDIO_OPENMAX_DL_FFT) 133 static OMXFFTSpec_R_F32* contextForSize(unsigned log2FFTSize); 134 135 OMXFFTSpec_R_F32* m_forwardContext; 136 OMXFFTSpec_R_F32* m_inverseContext; 137 138 AudioFloatArray m_complexData; 139 AudioFloatArray m_realData; 140 AudioFloatArray m_imagData; 141 #endif 142 143 #endif // !OS(MACOSX) 144 }; 145 146 } // namespace WebCore 147 148 #endif // FFTFrame_h 149