BaseAudioContext: createPeriodicWave()-Methode

real

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

imag

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

Die real- und imag-Arrays müssen die gleiche Länge haben, andernfalls 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 nimmt 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 zeigt die einfache Nutzung von createPeriodicWave(), um ein PeriodicWave-Objekt mit einer einfachen Sinuswelle zu erstellen.

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 Ton, der nur einen Grundton enthält, per Definition eine Sinuswelle ist.

Hier erstellen wir eine PeriodicWave mit zwei Werten. Der erste Wert ist der DC-Versatz, der der Wert ist, 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] beginnt. Die zweiten und nachfolgenden Werte sind Sinus- und Kosinus-Komponenten, ähnlich wie das Ergebnis einer Fourier-Transformation, die Zeitbereichswerte in Frequenzbereichswerte umwandelt. Mit createPeriodicWave() geben Sie die Frequenzen an, und der Browser führt eine inverse Fourier-Transformation durch, um einen Zeitbereichs-Puffer 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, sodass wir eine Sinuswelle erhalten. Beachten Sie, dass der Grundton der Frequenz des Oszillators entspricht (die standardmäßig 440 Hz beträgt). Daher verschiebt sich durch die Änderung der Frequenz des Oszillators auch die Frequenz dieser periodischen Welle.

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

• Verwendung der Web Audio API