@grame/faustwasm 0.18.0 → 0.18.2

package/dist/cjs/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/dist/cjs/index.js

@@ -3989,12 +3989,20 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     /**
      * 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;
@@ -4013,6 +4021,11 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
           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(),
@@ -4021,6 +4034,22 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
         );
       });
     }
+    /**
+     * 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.
      *
@@ -4119,6 +4148,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
       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++) {