summaryrefslogtreecommitdiffstats
path: root/dom/media/webaudio/blink/IIRFilter.h
blob: 87522add0656332f5b6b3fdf7e2b0314ad42bec6 (plain)
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
// Copyright 2016 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef IIRFilter_h
#define IIRFilter_h

#include "nsTArray.h"

typedef nsTArray<double> AudioDoubleArray;

namespace blink {

class IIRFilter final {
 public:
  // The maximum IIR filter order.  This also limits the number of feedforward
  // coefficients.  The maximum number of coefficients is 20 according to the
  // spec.
  const static size_t kMaxOrder = 19;
  IIRFilter(const AudioDoubleArray* feedforwardCoef,
            const AudioDoubleArray* feedbackCoef);
  ~IIRFilter();

  void process(const float* sourceP, float* destP, size_t framesToProcess);

  void reset();

  void getFrequencyResponse(int nFrequencies, const float* frequency,
                            float* magResponse, float* phaseResponse);

  bool buffersAreZero();

 private:
  // Filter memory
  //
  // For simplicity, we assume |m_xBuffer| and |m_yBuffer| have the same length,
  // and the length is a power of two.  Since the number of coefficients has a
  // fixed upper length, the size of xBuffer and yBuffer is fixed. |m_xBuffer|
  // holds the old input values and |m_yBuffer| holds the old output values
  // needed to compute the new output value.
  //
  // m_yBuffer[m_bufferIndex] holds the most recent output value, say, y[n].
  // Then m_yBuffer[m_bufferIndex - k] is y[n - k].  Similarly for m_xBuffer.
  //
  // To minimize roundoff, these arrays are double's instead of floats.
  AudioDoubleArray m_xBuffer;
  AudioDoubleArray m_yBuffer;

  // Index into the xBuffer and yBuffer arrays where the most current x and y
  // values should be stored.  xBuffer[bufferIndex] corresponds to x[n], the
  // current x input value and yBuffer[bufferIndex] is where y[n], the current
  // output value.
  int m_bufferIndex;

  // Coefficients of the IIR filter.
  const AudioDoubleArray* m_feedback;
  const AudioDoubleArray* m_feedforward;
};

}  // namespace blink

#endif  // IIRFilter_h