Version 2.3.0

- Create synths, generate noise with Superpowered! Generator with sine wave, triangle, sawtooth, pulse wave (PWM), pink noise and white noise output. Synchronization of multiple generators, optional FM oscillator.

- AdvancedAudioPlayer and Decoder can understand both compressed and raw PCM AudioInMemory formats.

Author: gaborszanto

Diff for: docs.html

@@ -1224,7 +1224,7 @@ <h3>Filter</h3>
 <pre><code class="language-js">
 // Constructor. Enabled is false by default.
 let filter = new Superpowered.Filter(
-    Superpowered.FilterType.Resonant_Lowpass, // The initial filter type.
+    Superpowered.Filter.Resonant_Lowpass, // The initial filter type.
     44100                                     // The initial sample rate in Hz.
 );
 
@@ -1240,17 +1240,17 @@ <h3>Filter</h3>
 filter.octave = 1;       // Width in octave for bandlimited and parametric filters. Limit: 0.05 to 5.
 filter.slope = 0.5;      // Slope value for shelving filters. Limit: 0.001 to 1.
 
-filter.type = Superpowered.FilterType.Parametric; // Filter type. Changing the filter type often involves changing other parameters as well. Therefore in a real-time context change the parameters and the type in the same thread with the process() call.
+filter.type = Superpowered.Filter.Parametric; // Filter type. Changing the filter type often involves changing other parameters as well. Therefore in a real-time context change the parameters and the type in the same thread with the process() call.
 
 // Superpowered filter types and their effective parameters:
-Superpowered.FilterType.Resonant_Lowpass     // frequency, resonance
-Superpowered.FilterType.Resonant_Highpass    // frequency, resonance
-Superpowered.FilterType.Bandlimited_Bandpass // frequency, octave
-Superpowered.FilterType.Bandlimited_Notch    // frequency, octave
-Superpowered.FilterType.LowShelf             // frequency, slope, decibel
-Superpowered.FilterType.HighShelf            // frequency, slope, decibel
-Superpowered.FilterType.Parametric           // frequency, octave, decibel
-Superpowered.FilterType.CustomCoefficients
+Superpowered.Filter.Resonant_Lowpass     // frequency, resonance
+Superpowered.Filter.Resonant_Highpass    // frequency, resonance
+Superpowered.Filter.Bandlimited_Bandpass // frequency, octave
+Superpowered.Filter.Bandlimited_Notch    // frequency, octave
+Superpowered.Filter.LowShelf             // frequency, slope, decibel
+Superpowered.Filter.HighShelf            // frequency, slope, decibel
+Superpowered.Filter.Parametric           // frequency, octave, decibel
+Superpowered.Filter.CustomCoefficients
 
 // For advanced use. Set custom coefficients for the filter. Changes will be smoothly handled to prevent audio artifacts. Do not call this concurrently with process().
 filter.setCustomCoefficients(
@@ -1558,6 +1558,93 @@ <h3>TimeStretching</h3>
 ts.destruct();
 </code></pre>
 
+<p>Using the time stretcher is more complex than using other effects, because it changes time and therefore buffering as well. It's fully integrated into the AdvancedAudioPlayer class, which is recommended for simple use. But if the time-stretcher has to be used alone, the logic could look like this:</p>
+
+<pre><code class="language-js">
+while (ts.getOutputLengthFrames() < numberOfFramesNeeded) {
+    let timestretcherNeedsThisAmountOfFramesToProduceAudio = ts.getNumberOfInputFramesNeeded();
+    if (timestretcherNeedsThisAmountOfFramesToProduceAudio can not be acquired) break;
+    acquire timestretcherNeedsThisAmountOfFramesToProduceAudio into some Superpowered.Float32Buffer;
+    ts.addInput(some Superpowered.Float32Buffer pointer, number_of_frames_acquired);
+}
+
+if (ts.getOutputLengthFrames() >= numberOfFramesNeeded) {
+    // success, get output
+    ts.getOutput(output buffer pointer, numberOfFramesNeeded);
+} else {
+    // could not produce enough audio
+    // return with silence
+}
+</code></pre>
+
+<h2>Generating Audio</h2>
+
+<h3>Generator</h3>
+
+<p>Generator for various waveform shapes.</p>
+
+<pre><code class="language-js">
+// Constructor.
+let g = new Superpowered.Generator(
+     44100,                      // The initial sample rate in Hz.
+     Superpowered.Generator.Sine // The initial shape.
+);
+
+// Superpowered generator shapes
+Superpowered.Generator.Sine       // sine
+Superpowered.Generator.Triangle   // triangle
+Superpowered.Generator.Sawtooth   // sawtooth
+Superpowered.Generator.PWM        // pulse wave with adjustable width
+Superpowered.Generator.PinkNoise  // pink noise
+Superpowered.Generator.WhiteNoise // white noise
+Superpowered.Generator.SyncMaster // generates no sound, but sync data to use with generateSyncMaster
+
+g.frequency = 1000;   // Frequency of generator output in Hz. Minimum is > 0.0001, maximum is limited to sample rate / 2.
+g.pulsewidth = 0.3;   // Pulse Width for PWM shape. 0.5 results in a square wave. Limited between 0.0001 and 0.9999.
+g.samplerate = 48000; // Sample rate in Hz.
+g.shape = Superpowered.Generator.Triangle; // Shape.
+
+// Generates (outputs) audio.
+// It's never blocking for real-time usage. You can change all properties on any thread, concurrently with this function.
+g.generate(
+    output, // Pointer to floating point numbers. 32-bit MONO output.
+    512     // Number of samples to produce.
+);
+
+// Generates (outputs) audio for a frequency modulated (FM) oscillator.
+// It's never blocking for real-time usage. You can change all properties on any thread, concurrently with this function.
+g.generateFM(
+    output,   // Pointer to floating point numbers. 32-bit MONO output.
+    512,      // Number of samples to produce.
+    fmsource, // Pointer to floating point numbers. Source for FM modulation containing numberOfSamples samples, usually from a previous call to generate().
+    100       // Frequency modulation depth. 0 means no modulation, 1000 is a reasonable upper limit.
+);
+
+// Generates audio for an oscillator that also serves as synchronization source for another oscillator.
+// It's never blocking for real-time usage. You can change all properties on any thread, concurrently with this function.
+g.generateAndCreateSync(
+    output,   // Pointer to floating point numbers. 32-bit MONO output.
+    syncdata, // Pointer to a buffer to receive hard sync information for syncing oscillators. Should be numberOfSamples + 1 floats big minimum.
+    512,      // Number of samples to produce.
+);
+
+// Generates audio for an oscillator that is hard-synced to another oscillator.
+// It's never blocking for real-time usage. You can change all properties on any thread, concurrently with this function.
+g.generateSynchronized(
+    output,   // Pointer to floating point numbers. 32-bit MONO output.
+    syncdata, // Pointer to floating point numbers. Input sync data, previously produced by a call to generateAndCreateSync() with same numberOfSamples.
+    512       // Number of samples to produce.
+);
+
+// Start oscillator with given phase angle. In a synthesizer, this should be called whenever a voice starts.
+g.reset(
+    0.5 // Start phase of the oscillator between 0.0 (0 degree) and 1.0 (180 degrees).
+);
+
+// Destructor (to free up memory).
+g.destruct();
+</code></pre>
+
 <h2>Loading Audio</h2>
 
 <p>Due to the nature of most JavaScript runtimes (such as no control over thread scheduling or no direct disk access), loading audio with Superpowered is a little bit different vs. native. <em>The entire audio file must be loaded into the WebAssembly Linear Memory memory</em> first, then the Superpowered Decoder can read and decode it.</p>

Diff for: example_effects/superpowered/SuperpoweredWebAudio.js

@@ -4,8 +4,9 @@ import { SuperpoweredTrackLoader } from './SuperpoweredTrackLoaderModule.js';
 var AudioWorkletHasBrokenModuleImplementation = false;
 
 class SuperpoweredWebAudio {
-    constructor(minimumSamplerate, superpowered) { console.log(navigator.userAgent);
+    constructor(minimumSamplerate, superpowered) { 
         AudioWorkletHasBrokenModuleImplementation = (navigator.userAgent.indexOf('AppleWebKit') > -1) || (navigator.userAgent.indexOf('Firefox') > -1);
+        if (AudioWorkletHasBrokenModuleImplementation && (navigator.userAgent.indexOf('Chrome') > -1)) AudioWorkletHasBrokenModuleImplementation = false;
         this.Superpowered = superpowered;
         this.audioContext = null;
         let AudioContext = window.AudioContext || window.webkitAudioContext || false;

Diff for: example_effects/superpowered/superpowered.wasm

@@ -4,8 +4,9 @@ import { SuperpoweredTrackLoader } from './SuperpoweredTrackLoaderModule.js';
 var AudioWorkletHasBrokenModuleImplementation = false;
 
 class SuperpoweredWebAudio {
-    constructor(minimumSamplerate, superpowered) { console.log(navigator.userAgent);
+    constructor(minimumSamplerate, superpowered) { 
         AudioWorkletHasBrokenModuleImplementation = (navigator.userAgent.indexOf('AppleWebKit') > -1) || (navigator.userAgent.indexOf('Firefox') > -1);
+        if (AudioWorkletHasBrokenModuleImplementation && (navigator.userAgent.indexOf('Chrome') > -1)) AudioWorkletHasBrokenModuleImplementation = false;
         this.Superpowered = superpowered;
         this.audioContext = null;
         let AudioContext = window.AudioContext || window.webkitAudioContext || false;

Diff for: example_guitardistortion/superpowered/SuperpoweredWebAudio.js

@@ -4,8 +4,9 @@ import { SuperpoweredTrackLoader } from './SuperpoweredTrackLoaderModule.js';
 var AudioWorkletHasBrokenModuleImplementation = false;
 
 class SuperpoweredWebAudio {
-    constructor(minimumSamplerate, superpowered) { console.log(navigator.userAgent);
+    constructor(minimumSamplerate, superpowered) { 
         AudioWorkletHasBrokenModuleImplementation = (navigator.userAgent.indexOf('AppleWebKit') > -1) || (navigator.userAgent.indexOf('Firefox') > -1);
+        if (AudioWorkletHasBrokenModuleImplementation && (navigator.userAgent.indexOf('Chrome') > -1)) AudioWorkletHasBrokenModuleImplementation = false;
         this.Superpowered = superpowered;
         this.audioContext = null;
         let AudioContext = window.AudioContext || window.webkitAudioContext || false;

Diff for: example_guitardistortion/superpowered/superpowered.wasm

@@ -4,8 +4,9 @@ import { SuperpoweredTrackLoader } from './SuperpoweredTrackLoaderModule.js';
 var AudioWorkletHasBrokenModuleImplementation = false;
 
 class SuperpoweredWebAudio {
-    constructor(minimumSamplerate, superpowered) { console.log(navigator.userAgent);
+    constructor(minimumSamplerate, superpowered) { 
         AudioWorkletHasBrokenModuleImplementation = (navigator.userAgent.indexOf('AppleWebKit') > -1) || (navigator.userAgent.indexOf('Firefox') > -1);
+        if (AudioWorkletHasBrokenModuleImplementation && (navigator.userAgent.indexOf('Chrome') > -1)) AudioWorkletHasBrokenModuleImplementation = false;
         this.Superpowered = superpowered;
         this.audioContext = null;
         let AudioContext = window.AudioContext || window.webkitAudioContext || false;