@grame/faustwasm 0.14.2 → 0.15.0

package/dist/cjs/index.d.ts

@@ -413,6 +413,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;
@@ -534,6 +535,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 {
@@ -556,6 +558,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.
 	 *
@@ -752,6 +773,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: {
@@ -857,6 +879,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;
@@ -1211,6 +1236,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;
@@ -1397,6 +1425,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;
@@ -1413,6 +1442,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;
@@ -1485,6 +1517,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/cjs/index.js

@@ -310,7 +310,10 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
         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();
       }
@@ -360,7 +363,10 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
         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();
       }
@@ -896,7 +902,10 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
           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();
@@ -2530,6 +2539,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
   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;
@@ -2952,8 +2962,17 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     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) {
@@ -3145,6 +3164,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     destroy() {
       this.fDestroyed = true;
       this.fOutputHandler = null;
+      this.fInputHandler = null;
       this.fComputeHandler = null;
       this.fPlotHandler = null;
     }
@@ -3286,6 +3306,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
         this.fPathTable[path],
         value
       );
+      this.callInputParamHandler(path, this.getParamValue(path));
     }
     getParamValue(path) {
       return this.fInstance.api.getParamValue(
@@ -3701,6 +3722,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
           (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) {
@@ -3852,6 +3874,15 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     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);
     }
@@ -4757,8 +4788,10 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
       __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);
         }
@@ -4782,6 +4815,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
       this.fJSONDsp = JSONObj;
       this.fJSON = factory.json;
       this.fOutputHandler = null;
+      this.fInputHandler = null;
       this.fComputeHandler = null;
       this.fPlotHandler = null;
       this.fDescriptor = [];
@@ -4862,8 +4896,17 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     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) {
@@ -5158,6 +5201,15 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     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);
     }