IIRFilterNode: getFrequencyResponse()-Methode

frequencyArray

Ein Float32Array, das ein Array von Frequenzen in Hertz enthält, die gefiltert werden sollen.

magResponseOutput

Ein Float32Array, um die berechneten Magnituden der Frequenzantwort für jeden Frequenzwert im frequencyArray zu empfangen.

phaseResponseOutput

Ein Float32Array, um die berechneten Phasenantwortwerte in Radiant für jeden Frequenzwert im Eingabearray frequencyArray zu empfangen.

Keiner (undefined).

NotSupportedError DOMException

Wird ausgelöst, wenn die drei bereitgestellten Arrays nicht alle die gleiche Länge haben.

Im folgenden Beispiel verwenden wir einen IIR-Filter auf einem Medienstream (für eine vollständige Demo siehe unser stream-source-buffer Demo live oder lesen Sie den Quellcode). Als Teil dieser Demo erhalten wir die Frequenzantworten für diesen IIR-Filter für fünf Beispiel-Frequenzen. Wir erstellen zuerst die benötigten Float32Array-Objekte, eines mit den Eingabefrequenzen und zwei, um die Ausgaben der Magnituden- und Phasenwerte zu empfangen:

const myFrequencyArray = new Float32Array(5);
myFrequencyArray[0] = 1000;
myFrequencyArray[1] = 2000;
myFrequencyArray[2] = 3000;
myFrequencyArray[3] = 4000;
myFrequencyArray[4] = 5000;

const magResponseOutput = new Float32Array(5);
const phaseResponseOutput = new Float32Array(5);

Als nächstes erstellen wir ein <ul>-Element in unserem HTML, um unsere Ergebnisse zu enthalten, und holen eine Referenz darauf in unserem JavaScript:

<p>IIR filter frequency response for:</p>
<ul class="freq-response-output"></ul>

const freqResponseOutput = document.querySelector(".freq-response-output");

Schließlich, nach der Erstellung unseres Filters, verwenden wir getFrequencyResponse(), um die Antwortdaten zu erzeugen und in unsere Arrays zu setzen, durchlaufen dann jedes Datenset und geben sie in einer leicht lesbaren Liste am unteren Rand der Seite aus:

const feedforwardCoefficients = [0.1, 0.2, 0.3, 0.4, 0.5];
const feedbackCoefficients = [0.5, 0.4, 0.3, 0.2, 0.1];

const iirFilter = audioCtx.createIIRFilter(
  feedforwardCoefficients,
  feedbackCoefficients,
);

// …

function calcFrequencyResponse() {
  iirFilter.getFrequencyResponse(
    myFrequencyArray,
    magResponseOutput,
    phaseResponseOutput,
  );

  for (let i = 0; i < myFrequencyArray.length; i++) {
    const listItem = document.createElement("li");
    listItem.textContent = `${myFrequencyArray[i]}Hz: Magnitude ${magResponseOutput[i]}, Phase ${phaseResponseOutput[i]} radians.`;
    freqResponseOutput.appendChild(listItem);
  }
}

calcFrequencyResponse();

• Verwendung der Web Audio API
• IIRFilterNode
• AudioNode