1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111
|
/*
* Copyright (C) 2010, Google Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
#ifndef THIRD_PARTY_BLINK_RENDERER_MODULES_WEBAUDIO_BIQUAD_DSP_KERNEL_H_
#define THIRD_PARTY_BLINK_RENDERER_MODULES_WEBAUDIO_BIQUAD_DSP_KERNEL_H_
#include "base/synchronization/lock.h"
#include "third_party/blink/renderer/modules/webaudio/biquad_processor.h"
#include "third_party/blink/renderer/platform/audio/biquad.h"
namespace blink {
// BiquadDSPKernel is is responsible for filtering one channel of a
// BiquadProcessor using a Biquad object.
class BiquadDSPKernel final {
public:
explicit BiquadDSPKernel(BiquadProcessor* processor)
: biquad_(processor->RenderQuantumFrames()),
tail_time_(std::numeric_limits<double>::infinity()),
kernel_processor_(processor),
sample_rate_(processor->SampleRate()),
render_quantum_frames_(processor->RenderQuantumFrames()) {}
// AudioDSPKernel
void Process(const float* source, float* dest, uint32_t frames_to_process);
void ProcessOnlyAudioParams(uint32_t frames_to_process) {}
void Reset() { biquad_.Reset(); }
float SampleRate() const { return sample_rate_; }
unsigned RenderQuantumFrames() const { return render_quantum_frames_; }
double Nyquist() const { return 0.5 * SampleRate(); }
BiquadProcessor* Processor() { return kernel_processor_; }
const BiquadProcessor* Processor() const { return kernel_processor_; }
// Get the magnitude and phase response of the given BiquadDSPKernel at the
// given set of frequencies (in Hz). The phase response is in radians. This
// must be called from the main thread.
static void GetFrequencyResponse(BiquadDSPKernel& kernel,
int n_frequencies,
const float* frequency_hz,
float* mag_response,
float* phase_response);
bool RequiresTailProcessing() const;
double TailTime() const;
double LatencyTime() const;
// Update the biquad coefficients with the given parameters
void UpdateCoefficients(int number_of_frames,
const float* frequency,
const float* q,
const float* gain,
const float* detune);
// Expose HasConstantValues for unit testing
MODULES_EXPORT static bool HasConstantValuesForTesting(float* values,
int frames_to_process);
protected:
Biquad biquad_;
BiquadProcessor* GetBiquadProcessor() {
return static_cast<BiquadProcessor*>(Processor());
}
void UpdateCoefficientsIfNecessary(int)
EXCLUSIVE_LOCKS_REQUIRED(process_lock_);
private:
// Compute the tail time using the BiquadFilter coefficients at
// index `coef_index`.
void UpdateTailTime(int coef_index);
// Synchronize process() with getting and setting the filter coefficients.
mutable base::Lock process_lock_;
// The current tail time for biquad filter.
double tail_time_;
// This raw pointer is safe because the AudioDSPKernelProcessor object is
// guaranteed to be kept alive while the AudioDSPKernel object is alive.
raw_ptr<BiquadProcessor> kernel_processor_;
float sample_rate_;
unsigned render_quantum_frames_;
};
} // namespace blink
#endif // THIRD_PARTY_BLINK_RENDERER_MODULES_WEBAUDIO_BIQUAD_DSP_KERNEL_H_
|