@grame/faustwasm 0.14.2 → 0.15.0

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

@@ -420,6 +420,7 @@ export declare class FaustWasmInstantiator {
 	static createSyncPolyDSPInstance(voiceFactory: LooseFaustDspFactory, mixerModule: WebAssembly.Module, voices: number, effectFactory?: LooseFaustDspFactory): FaustPolyDspInstance;
 }
 export type OutputParamHandler = (path: string, value: number) => void;
+export type InputParamHandler = (path: string, value: number) => void;
 export type ComputeHandler = (buffer_size: number) => void;
 export type PlotHandler = (plotted: Float32Array[] | Float64Array[], index: number, events?: {
 	type: string;
@@ -541,6 +542,7 @@ export declare class Soundfile {
  * DSP implementation that mimic the C++ 'dsp' class:
  * - adding MIDI control: metadata are decoded and incoming MIDI messages will control the associated controllers
  * - an output handler can be set to treat produced output controllers (like 'bargraph')
+ * - an input handler can be set to follow control parameter changes (like sliders)
  * - regular controllers are handled using setParamValue/getParamValue and getParams methods
  */
 export interface IFaustBaseWebAudioDsp {
@@ -563,6 +565,25 @@ export interface IFaustBaseWebAudioDsp {
 	 * @param value - the float value for the wanted control
 	 */
 	callOutputParamHandler(path: string, value: number): void;
+	/**
+	 * Set the parameter input handler, to be called when input parameters change (like sliders).
+	 *
+	 * @param handler - the input handler
+	 */
+	setInputParamHandler(handler: InputParamHandler | null): void;
+	/**
+	 * Get the parameter input handler.
+	 *
+	 * @return the current input handler
+	 */
+	getInputParamHandler(): InputParamHandler | null;
+	/**
+	 * Call the input parameter handler with a path and value.
+	 *
+	 * @param path - the path to the wanted parameter (retrieved using 'getParams' method)
+	 * @param value - the float value for the wanted control
+	 */
+	callInputParamHandler(path: string, value: number): void;
 	/**
 	 * Set the compute handler, to  be called in the 'compute' method with buffer size.
 	 *
@@ -759,6 +780,7 @@ export interface IFaustPolyWebAudioNode extends IFaustPolyWebAudioDsp, AudioNode
 }
 export declare class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
 	protected fOutputHandler: OutputParamHandler | null;
+	protected fInputHandler: InputParamHandler | null;
 	protected fComputeHandler: ComputeHandler | null;
 	protected fPlotHandler: PlotHandler | null;
 	protected fCachedEvents: {
@@ -864,6 +886,9 @@ export declare class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
 	setOutputParamHandler(handler: OutputParamHandler | null): void;
 	getOutputParamHandler(): OutputParamHandler | null;
 	callOutputParamHandler(path: string, value: number): void;
+	setInputParamHandler(handler: InputParamHandler | null): void;
+	getInputParamHandler(): InputParamHandler | null;
+	callInputParamHandler(path: string, value: number): void;
 	setComputeHandler(handler: ComputeHandler | null): void;
 	getComputeHandler(): ComputeHandler | null;
 	setPlotHandler(handler: PlotHandler | null): void;
@@ -1218,6 +1243,9 @@ export declare class FaustOfflineProcessor<Poly extends boolean = false> {
 	setOutputParamHandler(handler: OutputParamHandler): void;
 	getOutputParamHandler(): OutputParamHandler | null;
 	callOutputParamHandler(path: string, value: number): void;
+	setInputParamHandler(handler: InputParamHandler): void;
+	getInputParamHandler(): InputParamHandler | null;
+	callInputParamHandler(path: string, value: number): void;
 	setComputeHandler(handler: ComputeHandler): void;
 	getComputeHandler(): ComputeHandler | null;
 	setPlotHandler(handler: PlotHandler): void;
@@ -1404,6 +1432,7 @@ export declare class FaustAudioWorkletNode<Poly extends boolean = false> extends
 	protected fJSON: string;
 	protected fInputsItems: string[];
 	protected fOutputHandler: OutputParamHandler | null;
+	protected fInputHandler: InputParamHandler | null;
 	protected fComputeHandler: ComputeHandler | null;
 	protected fPlotHandler: PlotHandler | null;
 	protected fUICallback: UIHandler;
@@ -1420,6 +1449,9 @@ export declare class FaustAudioWorkletNode<Poly extends boolean = false> extends
 	setOutputParamHandler(handler: OutputParamHandler | null): void;
 	getOutputParamHandler(): OutputParamHandler | null;
 	callOutputParamHandler(path: string, value: number): void;
+	setInputParamHandler(handler: InputParamHandler | null): void;
+	getInputParamHandler(): InputParamHandler | null;
+	callInputParamHandler(path: string, value: number): void;
 	setComputeHandler(handler: ComputeHandler | null): void;
 	getComputeHandler(): ComputeHandler | null;
 	setPlotHandler(handler: PlotHandler | null): void;
@@ -1492,6 +1524,9 @@ export declare class FaustScriptProcessorNode<Poly extends boolean = false> exte
 	setOutputParamHandler(handler: OutputParamHandler): void;
 	getOutputParamHandler(): OutputParamHandler | null;
 	callOutputParamHandler(path: string, value: number): void;
+	setInputParamHandler(handler: InputParamHandler): void;
+	getInputParamHandler(): InputParamHandler | null;
+	callInputParamHandler(path: string, value: number): void;
 	setComputeHandler(handler: ComputeHandler): void;
 	getComputeHandler(): ComputeHandler | null;
 	setPlotHandler(handler: PlotHandler): void;

package/dist/esm-bundle/index.js

@@ -6069,7 +6069,10 @@ var getFaustAudioWorkletProcessor = (dependencies, faustData, register = true) =
       this.port.addEventListener("message", this.handleMessageAux);
       this.port.start();
       this.fDSPCode.setOutputParamHandler(
-        (path, value) => this.port.postMessage({ path, value, type: "param" })
+        (path, value) => this.port.postMessage({ path, value, type: "out-param" })
+      );
+      this.fDSPCode.setInputParamHandler(
+        (path, value) => this.port.postMessage({ path, value, type: "in-param" })
       );
       this.fDSPCode.start();
     }
@@ -6119,7 +6122,10 @@ var getFaustAudioWorkletProcessor = (dependencies, faustData, register = true) =
       this.port.addEventListener("message", this.handleMessageAux);
       this.port.start();
       this.fDSPCode.setOutputParamHandler(
-        (path, value) => this.port.postMessage({ path, value, type: "param" })
+        (path, value) => this.port.postMessage({ path, value, type: "out-param" })
+      );
+      this.fDSPCode.setInputParamHandler(
+        (path, value) => this.port.postMessage({ path, value, type: "in-param" })
       );
       this.fDSPCode.start();
     }
@@ -6655,7 +6661,10 @@ var getFaustFFTAudioWorkletProcessor = (dependencies, faustData, register = true
         this.soundfiles
       );
       this.fDSPCode.setOutputParamHandler(
-        (path, value) => this.port.postMessage({ path, value, type: "param" })
+        (path, value) => this.port.postMessage({ path, value, type: "out-param" })
+      );
+      this.fDSPCode.setInputParamHandler(
+        (path, value) => this.port.postMessage({ path, value, type: "in-param" })
       );
       this.fDSPCode.setPlotHandler(this.fPlotHandler);
       const params = this.fDSPCode.getParams();
@@ -8289,6 +8298,7 @@ var Soundfile = class _Soundfile {
 var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
   constructor(sampleSize, bufferSize, soundfiles) {
     this.fOutputHandler = null;
+    this.fInputHandler = null;
     this.fComputeHandler = null;
     // To handle MIDI events plot
     this.fPlotHandler = null;
@@ -8711,8 +8721,17 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
   callOutputParamHandler(path, value) {
     if (this.fOutputHandler) {
       this.fOutputHandler(path, value);
-    } else {
-      console.warn("No OutputParamHandler set for this Faust node.");
+    }
+  }
+  setInputParamHandler(handler) {
+    this.fInputHandler = handler;
+  }
+  getInputParamHandler() {
+    return this.fInputHandler;
+  }
+  callInputParamHandler(path, value) {
+    if (this.fInputHandler) {
+      this.fInputHandler(path, value);
     }
   }
   setComputeHandler(handler) {
@@ -8904,6 +8923,7 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
   destroy() {
     this.fDestroyed = true;
     this.fOutputHandler = null;
+    this.fInputHandler = null;
     this.fComputeHandler = null;
     this.fPlotHandler = null;
   }
@@ -9045,6 +9065,7 @@ var FaustMonoWebAudioDsp = class extends FaustBaseWebAudioDsp {
       this.fPathTable[path],
       value
     );
+    this.callInputParamHandler(path, this.getParamValue(path));
   }
   getParamValue(path) {
     return this.fInstance.api.getParamValue(
@@ -9460,6 +9481,7 @@ var FaustPolyWebAudioDsp = class _FaustPolyWebAudioDsp extends FaustBaseWebAudio
         (voice) => voice.setParamValue(this.fPathTable[path], value)
       );
     }
+    this.callInputParamHandler(path, this.getParamValue(path));
   }
   getParamValue(path) {
     if (this.fJSONEffect && _FaustPolyWebAudioDsp.findPath(this.fJSONEffect.ui, path) && this.fInstance.effectAPI) {
@@ -9611,6 +9633,15 @@ var FaustOfflineProcessor = class {
   callOutputParamHandler(path, value) {
     this.fDSPCode.callOutputParamHandler(path, value);
   }
+  setInputParamHandler(handler) {
+    this.fDSPCode.setInputParamHandler(handler);
+  }
+  getInputParamHandler() {
+    return this.fDSPCode.getInputParamHandler();
+  }
+  callInputParamHandler(path, value) {
+    this.fDSPCode.callInputParamHandler(path, value);
+  }
   setComputeHandler(handler) {
     this.fDSPCode.setComputeHandler(handler);
   }
@@ -10516,8 +10547,10 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
     __privateAdd(this, _hasAccInput, false);
     __privateAdd(this, _hasGyrInput, false);
     this.handleMessageAux = (e) => {
-      if (e.data.type === "param" && this.fOutputHandler) {
+      if (e.data.type === "out-param" && this.fOutputHandler) {
         this.fOutputHandler(e.data.path, e.data.value);
+      } else if (e.data.type === "in-param" && this.fInputHandler) {
+        this.fInputHandler(e.data.path, e.data.value);
       } else if (e.data.type === "plot" && this.fPlotHandler) {
         this.fPlotHandler(e.data.value, e.data.index, e.data.events);
       }
@@ -10541,6 +10574,7 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
     this.fJSONDsp = JSONObj;
     this.fJSON = factory.json;
     this.fOutputHandler = null;
+    this.fInputHandler = null;
     this.fComputeHandler = null;
     this.fPlotHandler = null;
     this.fDescriptor = [];
@@ -10621,8 +10655,17 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
   callOutputParamHandler(path, value) {
     if (this.fOutputHandler) {
       this.fOutputHandler(path, value);
-    } else {
-      console.warn("No OutputParamHandler set for this Faust node.");
+    }
+  }
+  setInputParamHandler(handler) {
+    this.fInputHandler = handler;
+  }
+  getInputParamHandler() {
+    return this.fInputHandler;
+  }
+  callInputParamHandler(path, value) {
+    if (this.fInputHandler) {
+      this.fInputHandler(path, value);
     }
   }
   setComputeHandler(handler) {
@@ -10917,6 +10960,15 @@ var FaustScriptProcessorNode = class extends (globalThis.ScriptProcessorNode ||
   callOutputParamHandler(path, value) {
     this.fDSPCode.callOutputParamHandler(path, value);
   }
+  setInputParamHandler(handler) {
+    this.fDSPCode.setInputParamHandler(handler);
+  }
+  getInputParamHandler() {
+    return this.fDSPCode.getInputParamHandler();
+  }
+  callInputParamHandler(path, value) {
+    this.fDSPCode.callInputParamHandler(path, value);
+  }
   setComputeHandler(handler) {
     this.fDSPCode.setComputeHandler(handler);
   }