@grame/faustwasm 0.15.7 → 0.16.1

package/dist/esm-bundle/index.d.ts

@@ -736,6 +736,26 @@ export interface IFaustBaseWebAudioDsp {
 	 * event: Pick<DeviceOrientationEvent, "alpha" | "beta" | "gamma">
 	 */
 	propagateGyr(event: Pick<DeviceOrientationEvent, "alpha" | "beta" | "gamma">): void;
+	/**
+	 * Reinitialize the DSP using its configured sample rate.
+	 */
+	init(): void;
+	/**
+	 * Reinitialize the DSP instance state using its configured sample rate.
+	 */
+	instanceInit(): void;
+	/**
+	 * Clear the DSP instance state.
+	 */
+	instanceClear(): void;
+	/**
+	 * Reinitialize the DSP instance constants using its configured sample rate.
+	 */
+	instanceConstants(): void;
+	/**
+	 * Reset DSP user interface parameters to their default values.
+	 */
+	instanceResetUserInterface(): void;
 	/**
 	 * Start the DSP audio processing.
 	 */
@@ -910,6 +930,11 @@ export declare class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
 	hasSoundfiles(): boolean;
 	startSensors(): void;
 	stopSensors(): void;
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	start(): void;
 	stop(): void;
 	destroy(): void;
@@ -917,7 +942,13 @@ export declare class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
 export declare class FaustMonoWebAudioDsp extends FaustBaseWebAudioDsp implements IFaustMonoWebAudioDsp {
 	private fInstance;
 	private fDSP;
+	private fSampleRate;
 	constructor(instance: FaustMonoDspInstance, sampleRate: number, sampleSize: number, bufferSize: number, soundfiles: LooseFaustDspFactory["soundfiles"]);
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	private initMemory;
 	toString(): string;
 	compute(input: Float32Array[] | ((input: Float32Array[] | Float64Array[]) => any), output: Float32Array[] | ((output: Float32Array[] | Float64Array[]) => any)): boolean;
@@ -945,6 +976,7 @@ export declare class FaustWebAudioDspVoice {
 	private fVelLabel;
 	private fDSP;
 	private fAPI;
+	private fSampleRate;
 	fCurNote: number;
 	fNextNote: number;
 	fNextVel: number;
@@ -955,6 +987,11 @@ export declare class FaustWebAudioDspVoice {
 	}, sampleRate: number);
 	static midiToFreq(note: number): number;
 	static normalizeVelocity(velocity: number): number;
+	init(sampleRate: number): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	private extractPaths;
 	keyOn(pitch: number, velocity: number, legato?: boolean): void;
 	keyOff(hard?: boolean): void;
@@ -970,7 +1007,13 @@ export declare class FaustPolyWebAudioDsp extends FaustBaseWebAudioDsp implement
 	private fAudioMixing;
 	private fAudioMixingHalf;
 	private fVoiceTable;
+	private fSampleRate;
 	constructor(instance: FaustPolyDspInstance, sampleRate: number, sampleSize: number, bufferSize: number, soundfiles: LooseFaustDspFactory["soundfiles"]);
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	private initMemory;
 	toString(): string;
 	private allocVoice;
@@ -1265,6 +1308,11 @@ export declare class FaustOfflineProcessor<Poly extends boolean = false> {
 	getJSON(): string;
 	getDescriptors(): FaustUIInputItem[];
 	getUI(): FaustUIDescriptor;
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	start(): void;
 	stop(): void;
 	destroy(): void;
@@ -1470,6 +1518,11 @@ export declare class FaustAudioWorkletNode<Poly extends boolean = false> extends
 	getJSON(): string;
 	getUI(): FaustUIDescriptor;
 	getDescriptors(): FaustUIInputItem[];
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	start(): void;
 	stop(): void;
 	destroy(): void;
@@ -1508,7 +1561,12 @@ export declare class FaustScriptProcessorNode<Poly extends boolean = false> exte
 	protected fOutputs: Float32Array[];
 	protected handleDeviceMotion: any;
 	protected handleDeviceOrientation: any;
-	init(instance: Poly extends true ? FaustPolyWebAudioDsp : FaustMonoWebAudioDsp): void;
+	setupNode(instance: Poly extends true ? FaustPolyWebAudioDsp : FaustMonoWebAudioDsp): void;
+	init(): void;
+	instanceInit(): void;
+	instanceClear(): void;
+	instanceConstants(): void;
+	instanceResetUserInterface(): void;
 	/** Start accelerometer and gyroscope handlers */
 	startSensors(): Promise<void>;
 	/** Stop accelerometer and gyroscope handlers */

package/dist/esm-bundle/index.js

@@ -6007,6 +6007,26 @@ var getFaustAudioWorkletProcessor = (dependencies, faustData, register = true) =
           this.setupWamEventHandler();
           break;
         }
+        case "init": {
+          this.fDSPCode.init();
+          break;
+        }
+        case "instanceInit": {
+          this.fDSPCode.instanceInit();
+          break;
+        }
+        case "instanceClear": {
+          this.fDSPCode.instanceClear();
+          break;
+        }
+        case "instanceConstants": {
+          this.fDSPCode.instanceConstants();
+          break;
+        }
+        case "instanceResetUserInterface": {
+          this.fDSPCode.instanceResetUserInterface();
+          break;
+        }
         case "start": {
           this.fDSPCode.start();
           break;
@@ -8914,6 +8934,16 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
   stopSensors() {
     this.stopSensors();
   }
+  init() {
+  }
+  instanceInit() {
+  }
+  instanceClear() {
+  }
+  instanceConstants() {
+  }
+  instanceResetUserInterface() {
+  }
   start() {
     this.fProcessing = true;
   }
@@ -8932,6 +8962,7 @@ var FaustMonoWebAudioDsp = class extends FaustBaseWebAudioDsp {
   constructor(instance, sampleRate, sampleSize, bufferSize, soundfiles) {
     super(sampleSize, bufferSize, soundfiles);
     this.fInstance = instance;
+    this.fSampleRate = sampleRate;
     console.log(`sampleSize: ${sampleSize} bufferSize: ${bufferSize}`);
     this.fJSONDsp = JSON.parse(this.fInstance.json);
     FaustBaseWebAudioDsp.parseUI(this.fJSONDsp.ui, this.fUICallback);
@@ -8945,6 +8976,21 @@ var FaustMonoWebAudioDsp = class extends FaustBaseWebAudioDsp {
       this.initSoundfileMemory(allocator, this.fDSP);
     }
   }
+  init() {
+    this.fInstance.api.init(this.fDSP, this.fSampleRate);
+  }
+  instanceInit() {
+    this.fInstance.api.instanceInit(this.fDSP, this.fSampleRate);
+  }
+  instanceClear() {
+    this.fInstance.api.instanceClear(this.fDSP);
+  }
+  instanceConstants() {
+    this.fInstance.api.instanceConstants(this.fDSP, this.fSampleRate);
+  }
+  instanceResetUserInterface() {
+    this.fInstance.api.instanceResetUserInterface(this.fDSP);
+  }
   initMemory() {
     this.fDSP = 0;
     const $audio = this.fJSONDsp.size;
@@ -9094,7 +9140,6 @@ var FaustWebAudioDspVoice = class _FaustWebAudioDspVoice {
     this.fGainLabel = [];
     this.fKeyLabel = [];
     this.fVelLabel = [];
-    // Voice DSP code
     // Accessed by PolyDSPImp class
     this.fCurNote = _FaustWebAudioDspVoice.kFreeVoice;
     this.fNextNote = -1;
@@ -9103,7 +9148,8 @@ var FaustWebAudioDspVoice = class _FaustWebAudioDspVoice {
     this.fLevel = 0;
     this.fDSP = $dsp;
     this.fAPI = api;
-    this.fAPI.init(this.fDSP, sampleRate);
+    this.fSampleRate = sampleRate;
+    this.init(sampleRate);
     this.extractPaths(inputItems, pathTable);
   }
   // Voice state
@@ -9131,6 +9177,21 @@ var FaustWebAudioDspVoice = class _FaustWebAudioDspVoice {
   static normalizeVelocity(velocity) {
     return velocity / 127;
   }
+  init(sampleRate) {
+    this.fAPI.init(this.fDSP, sampleRate);
+  }
+  instanceInit() {
+    this.fAPI.instanceInit(this.fDSP, this.fSampleRate);
+  }
+  instanceClear() {
+    this.fAPI.instanceClear(this.fDSP);
+  }
+  instanceConstants() {
+    this.fAPI.instanceConstants(this.fDSP, this.fSampleRate);
+  }
+  instanceResetUserInterface() {
+    this.fAPI.instanceResetUserInterface(this.fDSP);
+  }
   extractPaths(inputItems, pathTable) {
     inputItems.forEach((item) => {
       if (item.endsWith("/gate")) {
@@ -9211,6 +9272,7 @@ var FaustPolyWebAudioDsp = class _FaustPolyWebAudioDsp extends FaustBaseWebAudio
   constructor(instance, sampleRate, sampleSize, bufferSize, soundfiles) {
     super(sampleSize, bufferSize, soundfiles);
     this.fInstance = instance;
+    this.fSampleRate = sampleRate;
     console.log(`sampleSize: ${sampleSize} bufferSize: ${bufferSize}`);
     this.fJSONDsp = JSON.parse(this.fInstance.voiceJSON);
     this.fJSONEffect = this.fInstance.effectAPI && this.fInstance.effectJSON ? JSON.parse(this.fInstance.effectJSON) : null;
@@ -9242,6 +9304,37 @@ var FaustPolyWebAudioDsp = class _FaustPolyWebAudioDsp extends FaustBaseWebAudio
       }
     }
   }
+  init() {
+    this.fVoiceTable.forEach((voice) => voice.init(this.fSampleRate));
+    if (this.fInstance.effectAPI)
+      this.fInstance.effectAPI.init(this.fEffect, this.fSampleRate);
+  }
+  instanceInit() {
+    this.fVoiceTable.forEach((voice) => voice.instanceInit());
+    if (this.fInstance.effectAPI)
+      this.fInstance.effectAPI.instanceInit(
+        this.fEffect,
+        this.fSampleRate
+      );
+  }
+  instanceClear() {
+    this.fVoiceTable.forEach((voice) => voice.instanceClear());
+    if (this.fInstance.effectAPI)
+      this.fInstance.effectAPI.instanceClear(this.fEffect);
+  }
+  instanceConstants() {
+    this.fVoiceTable.forEach((voice) => voice.instanceConstants());
+    if (this.fInstance.effectAPI)
+      this.fInstance.effectAPI.instanceConstants(
+        this.fEffect,
+        this.fSampleRate
+      );
+  }
+  instanceResetUserInterface() {
+    this.fVoiceTable.forEach((voice) => voice.instanceResetUserInterface());
+    if (this.fInstance.effectAPI)
+      this.fInstance.effectAPI.instanceResetUserInterface(this.fEffect);
+  }
   initMemory() {
     this.fEffect = this.fJSONDsp.size * this.fInstance.voices;
     const $audio = this.fEffect + (this.fJSONEffect ? this.fJSONEffect.size : 0);
@@ -9698,6 +9791,21 @@ var FaustOfflineProcessor = class {
   getUI() {
     return this.fDSPCode.getUI();
   }
+  init() {
+    this.fDSPCode.init();
+  }
+  instanceInit() {
+    this.fDSPCode.instanceInit();
+  }
+  instanceClear() {
+    this.fDSPCode.instanceClear();
+  }
+  instanceConstants() {
+    this.fDSPCode.instanceConstants();
+  }
+  instanceResetUserInterface() {
+    this.fDSPCode.instanceResetUserInterface();
+  }
   start() {
     this.fDSPCode.start();
   }
@@ -10741,7 +10849,10 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
   }
   setParamValue(path, value) {
     const resolved = this.fParamAliases[path] || path;
-    this.port.postMessage({ type: "param", data: { path: resolved, value } });
+    this.port.postMessage({
+      type: "param",
+      data: { path: resolved, value }
+    });
     const param = this.parameters.get(resolved);
     if (param) param.setValueAtTime(value, this.context.currentTime);
   }
@@ -10765,6 +10876,21 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
   getDescriptors() {
     return this.fDescriptor;
   }
+  init() {
+    this.port.postMessage({ type: "init" });
+  }
+  instanceInit() {
+    this.port.postMessage({ type: "instanceInit" });
+  }
+  instanceClear() {
+    this.port.postMessage({ type: "instanceClear" });
+  }
+  instanceConstants() {
+    this.port.postMessage({ type: "instanceConstants" });
+  }
+  instanceResetUserInterface() {
+    this.port.postMessage({ type: "instanceResetUserInterface" });
+  }
   start() {
     this.port.postMessage({ type: "start" });
   }
@@ -10861,7 +10987,7 @@ var FaustScriptProcessorNode = class extends (globalThis.ScriptProcessorNode ||
     this.handleDeviceMotion = void 0;
     this.handleDeviceOrientation = void 0;
   }
-  init(instance) {
+  setupNode(instance) {
     this.fDSPCode = instance;
     this.fInputs = new Array(this.fDSPCode.getNumInputs());
     this.fOutputs = new Array(this.fDSPCode.getNumOutputs());
@@ -10891,6 +11017,21 @@ var FaustScriptProcessorNode = class extends (globalThis.ScriptProcessorNode ||
     };
     this.start();
   }
+  init() {
+    this.fDSPCode.init();
+  }
+  instanceInit() {
+    this.fDSPCode.instanceInit();
+  }
+  instanceClear() {
+    this.fDSPCode.instanceClear();
+  }
+  instanceConstants() {
+    this.fDSPCode.instanceConstants();
+  }
+  instanceResetUserInterface() {
+    this.fDSPCode.instanceResetUserInterface();
+  }
   // Public API
   /** Start accelerometer and gyroscope handlers */
   async startSensors() {
@@ -11108,7 +11249,7 @@ var _FaustMonoDspGenerator = class _FaustMonoDspGenerator {
         monoDsp.getNumOutputs()
       );
       Object.setPrototypeOf(sp2, FaustMonoScriptProcessorNode.prototype);
-      sp2.init(monoDsp);
+      sp2.setupNode(monoDsp);
       return sp2;
     } else {
       if (!_FaustMonoDspGenerator.gWorkletProcessors.has(context))
@@ -11492,7 +11633,7 @@ process = adaptorIns(dsp_code.process) : dsp_code.effect : adaptorOuts;
         polyDsp.getNumOutputs()
       );
       Object.setPrototypeOf(sp2, FaustPolyScriptProcessorNode.prototype);
-      sp2.init(polyDsp);
+      sp2.setupNode(polyDsp);
       return sp2;
     } else {
       if (!_FaustPolyDspGenerator.gWorkletProcessors.has(context))