@grame/faustwasm 0.18.1 → 0.18.2

package/README.md

@@ -1,6 +1,6 @@
 # FaustWasm
 
-The FaustWasm library presents a convenient, high-level API that wraps around [Faust](https://faust.grame.fr) compiler. This library's interface is primarily designed for [TypeScript](https://www.typescriptlang.org/) usage, although it also provides API descriptions and documentation for pure JavaScript. The WebAssembly version of the Faust Compiler, compatible with both [Node.js](https://nodejs.org) and web browsers, has been compiled using [Emscripten](https://emscripten.org/) 3.1.31.
+The FaustWasm library presents a convenient, high-level API that wraps around [Faust](https://faust.grame.fr) compiler. This library's interface is primarily designed for [TypeScript](https://www.typescriptlang.org/) usage, although it also provides API descriptions and documentation for pure JavaScript. The WebAssembly version of the Faust Compiler, compatible with both [Node.js](https://nodejs.org) and web browsers, has been compiled using [Emscripten](https://emscripten.org/) 6.0.3.
 
 The library offers functionality for compiling Faust DSP code into WebAssembly, enabling its utilization as WebAudio nodes within a standard WebAudio node graph. Moreover, it supports offline rendering scenarios. Furthermore, supplementary tools can be employed for generating SVGs from Faust DSP programs.
 

package/assets/standalone/faustwasm/index.d.ts

@@ -1099,6 +1099,8 @@ export declare class FaustPolyWebAudioDsp extends FaustBaseWebAudioDsp implement
 	private fAudioMixing;
 	private fAudioMixingHalf;
 	private fMixingBase;
+	/** Float view of the memory, kept from `initMemory` like `fHEAP32`. */
+	private fHEAPF;
 	private fVoiceTable;
 	private fSampleRate;
 	/** Voices whose crossfade this block already rendered in full. */
@@ -1123,14 +1125,29 @@ export declare class FaustPolyWebAudioDsp extends FaustBaseWebAudioDsp implement
 	/**
 	 * Render the stolen voices, each across the whole block.
 	 *
-	 * A steal is a crossfade: the voice plays the note it is losing over the
+	 * A steal is a hand-over: the voice plays the note it is losing over the
 	 * first half of the buffer, that half fades out, and the new note plays
-	 * the second half. The fade has to be half a block -- 64 frames -- rather
-	 * than half a slice, which late in the block would be a frame or two, or
-	 * nothing at all. So this runs before the slicing, and `fRenderSlice`
-	 * skips these voices.
+	 * the second half, faded in. Both fades are needed. `fadeOut` scales the
+	 * buffer, not the voice: after `keyOn` the DSP carries on from its live
+	 * state -- an envelope that never reached silence is still up -- so
+	 * without the fade-in the second half started at full level, a step on
+	 * every stolen note. On a monophonic patch whose voice never falls
+	 * silent that is a click on every note after the first (measured on a
+	 * long-release bass: 0, 0, 0, 0.1485, 0.2618 across the split).
+	 *
+	 * The fades have to be half a block -- 64 frames -- rather than half a
+	 * slice, which late in the block would be a frame or two, or nothing at
+	 * all. So this runs before the slicing, and `fRenderSlice` skips these
+	 * voices.
 	 */
 	private renderStolenVoices;
+	/**
+	 * Scale `count` frames of each channel at `$tables` from 1/count up to 1.
+	 *
+	 * The mixer has `fadeOut` in wasm; this is its counterpart on the JS
+	 * side, over the channel-pointer table the same way the mixer reads it.
+	 */
+	private fadeIn;
 	/**
 	 * Move the mixing tables along with the input and output ones.
 	 *

package/assets/standalone/faustwasm/index.js

@@ -3960,12 +3960,20 @@ var FaustPolyWebAudioDsp = class _FaustPolyWebAudioDsp extends FaustBaseWebAudio
   /**
    * Render the stolen voices, each across the whole block.
    *
-   * A steal is a crossfade: the voice plays the note it is losing over the
+   * A steal is a hand-over: the voice plays the note it is losing over the
    * first half of the buffer, that half fades out, and the new note plays
-   * the second half. The fade has to be half a block -- 64 frames -- rather
-   * than half a slice, which late in the block would be a frame or two, or
-   * nothing at all. So this runs before the slicing, and `fRenderSlice`
-   * skips these voices.
+   * the second half, faded in. Both fades are needed. `fadeOut` scales the
+   * buffer, not the voice: after `keyOn` the DSP carries on from its live
+   * state -- an envelope that never reached silence is still up -- so
+   * without the fade-in the second half started at full level, a step on
+   * every stolen note. On a monophonic patch whose voice never falls
+   * silent that is a click on every note after the first (measured on a
+   * long-release bass: 0, 0, 0, 0.1485, 0.2618 across the split).
+   *
+   * The fades have to be half a block -- 64 frames -- rather than half a
+   * slice, which late in the block would be a frame or two, or nothing at
+   * all. So this runs before the slicing, and `fRenderSlice` skips these
+   * voices.
    */
   renderStolenVoices() {
     const stolen = this.fStolen;
@@ -3984,6 +3992,11 @@ var FaustPolyWebAudioDsp = class _FaustPolyWebAudioDsp extends FaustBaseWebAudio
         this.getNumOutputs(),
         this.fAudioMixing
       );
+      this.fadeIn(
+        this.fBufferSize - (this.fBufferSize >> 1),
+        this.getNumOutputs(),
+        this.fAudioMixingHalf
+      );
       voice.fLevel = this.fInstance.mixerAPI.mixCheckVoice(
         this.fBufferSize,
         this.getNumOutputs(),
@@ -3992,6 +4005,22 @@ var FaustPolyWebAudioDsp = class _FaustPolyWebAudioDsp extends FaustBaseWebAudio
       );
     });
   }
+  /**
+   * Scale `count` frames of each channel at `$tables` from 1/count up to 1.
+   *
+   * The mixer has `fadeOut` in wasm; this is its counterpart on the JS
+   * side, over the channel-pointer table the same way the mixer reads it.
+   */
+  fadeIn(count, chans, $tables) {
+    const shift = Math.log2(this.fSampleSize);
+    const HEAPF = this.fHEAPF;
+    for (let chan = 0; chan < chans; chan++) {
+      const start = this.fHEAP32[($tables >> 2) + chan] >> shift;
+      for (let i = 0; i < count; i++) {
+        HEAPF[start + i] *= (i + 1) / count;
+      }
+    }
+  }
   /**
    * Move the mixing tables along with the input and output ones.
    *
@@ -4090,6 +4119,7 @@ var FaustPolyWebAudioDsp = class _FaustPolyWebAudioDsp extends FaustBaseWebAudio
     for (let chan = 0; chan < this.getNumInputs(); chan++) {
       this.fInBase[chan] = HEAP32[(this.fAudioInputs >> 2) + chan];
     }
+    this.fHEAPF = HEAPF;
     this.fOutBase = [];
     this.fMixingBase = [];
     for (let chan = 0; chan < this.getNumOutputs(); chan++) {