BaseAudioContext: Methode createPeriodicWave()

real

Ein Array von Kosinus-Terms (traditionell die A-Terme).

imag

Ein Array von Sinus-Terms (traditionell die B-Terme).

Die Arrays real und imag müssen die gleiche Länge haben, sonst wird ein Fehler ausgelöst.

constraints Optional

Ein Wörterbuchobjekt, das angibt, ob die Normalisierung deaktiviert werden soll. Wenn nicht angegeben, ist die Normalisierung standardmäßig aktiviert. Es enthält eine Eigenschaft:

disableNormalization

Wenn auf true gesetzt, wird die Normalisierung für die periodische Welle deaktiviert. Der Standardwert ist false.

Eine PeriodicWave.

Das folgende Beispiel veranschaulicht die einfache Verwendung von createPeriodicWave(), um ein PeriodicWave-Objekt zu erstellen, das eine einfache Sinuswelle enthält.

const real = new Float32Array(2);
const imag = new Float32Array(2);
const ac = new AudioContext();
const osc = ac.createOscillator();

real[0] = 0;
imag[0] = 0;
real[1] = 1;
imag[1] = 0;

const wave = ac.createPeriodicWave(real, imag, { disableNormalization: true });

osc.setPeriodicWave(wave);

osc.connect(ac.destination);

osc.start();
osc.stop(2);

Dies funktioniert, weil ein Klang, der nur einen Grundton enthält, definitionsgemäß eine Sinuswelle ist.

Hier erstellen wir eine PeriodicWave mit zwei Werten. Der erste Wert ist der DC-Offset, der den Wert angibt, bei dem der Oszillator startet. Ein Wert von 0 ist hier gut, da er die Kurve in der Mitte des Bereichs [-1.0; 1.0] startet. Die zweiten und nachfolgenden Werte sind Sinus- und Kosinuskomponenten, ähnlich dem Ergebnis einer Fourier-Transformation, die Zeitbereichswerte in Frequenzbereichswerte umwandelt. Hiermit spezifizieren Sie mit createPeriodicWave() die Frequenzen, und der Browser führt eine inverse Fourier-Transformation aus, um einen Zeitbereichspuffer für die Frequenz des Oszillators zu erhalten. In diesem Beispiel setzen wir nur eine Komponente mit voller Lautstärke (1.0) auf den Grundton, wodurch wir eine Sinuswelle erhalten. Beachten Sie, dass der Grundton der Frequenz des Oszillators entspricht (die standardmäßig 440 Hz beträgt). Daher verschiebt sich die Frequenz dieser periodischen Welle in entsprechender Weise, wenn die Frequenz des Oszillators geändert wird.

Die Koeffizienten der Fourier-Transformation sollten in aufsteigender Reihenfolge angegeben werden (z.B. $\left(a+bi\right)e^{i} , \left(c+di\right)e^{2i} ,\left(f+gi\right)e^{3i}$ etc.) und können positiv oder negativ sein. Ein einfacher, aber nicht der beste Weg, um solchene Koeffizienten manuell zu erhalten, ist die Verwendung eines Grafikrechners.

• Verwendung der Web Audio API