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 are 6 * met: 7 * 8 * * Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * * Redistributions in binary form must reproduce the above 11 * copyright notice, this list of conditions and the following disclaimer 12 * in the documentation and/or other materials provided with the 13 * distribution. 14 * * Neither the name of Google Inc. nor the names of its 15 * contributors may be used to endorse or promote products derived from 16 * this software without specific prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 23 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 24 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 */ 30 31#ifndef AudioDSPKernelProcessor_h 32#define AudioDSPKernelProcessor_h 33 34#include "AudioBus.h" 35#include "AudioProcessor.h" 36#include <wtf/Vector.h> 37 38namespace WebCore { 39 40class AudioBus; 41class AudioDSPKernel; 42class AudioProcessor; 43 44// AudioDSPKernelProcessor processes one input -> one output (N channels each) 45// It uses one AudioDSPKernel object per channel to do the processing, thus there is no cross-channel processing. 46// Despite this limitation it turns out to be a very common and useful type of processor. 47 48class AudioDSPKernelProcessor : public AudioProcessor { 49public: 50 // numberOfChannels may be later changed if object is not yet in an "initialized" state 51 AudioDSPKernelProcessor(float sampleRate, unsigned numberOfChannels); 52 53 // Subclasses create the appropriate type of processing kernel here. 54 // We'll call this to create a kernel for each channel. 55 virtual std::unique_ptr<AudioDSPKernel> createKernel() = 0; 56 57 // AudioProcessor methods 58 virtual void initialize() override; 59 virtual void uninitialize() override; 60 virtual void process(const AudioBus* source, AudioBus* destination, size_t framesToProcess) override; 61 virtual void reset() override; 62 virtual void setNumberOfChannels(unsigned) override; 63 virtual unsigned numberOfChannels() const override { return m_numberOfChannels; } 64 65 virtual double tailTime() const override; 66 virtual double latencyTime() const override; 67 68protected: 69 Vector<std::unique_ptr<AudioDSPKernel>> m_kernels; 70 bool m_hasJustReset; 71}; 72 73} // namespace WebCore 74 75#endif // AudioDSPKernelProcessor_h 76