@grame/faustwasm 0.10.2 → 0.11.0

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

@@ -432,6 +432,17 @@ export type SensorEventHandlers = {
 	y: SensorEventHandler[];
 	z: SensorEventHandler[];
 };
+/**
+ * Interface for MIDI output handler, used in Faust WebAudio nodes
+ * to handle MIDI events like control changes, pitch wheel changes,
+ * key on and key off events.
+ */
+export interface MidiOutputHandler {
+	ctrlChange(chan: number, ctrl: number, value: number): void;
+	pitchWheel(chan: number, value: number): void;
+	keyOn(channel: number, pitch: number, velocity: number): void;
+	keyOff(channel: number, pitch: number, velocity: number): void;
+}
 /** Definition of the AudioBufferItem type */
 export interface AudioBufferItem {
 	pathName: string;
@@ -555,6 +566,13 @@ export interface IFaustBaseWebAudioDsp {
 	 * @return the current output handler
 	 */
 	getOutputParamHandler(): OutputParamHandler | null;
+	/**
+	 * Call the output 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
+	 */
+	callOutputParamHandler(path: string, value: number): void;
 	/**
 	 * Set the compute handler, to  be called in the 'compute' method with buffer size.
 	 *
@@ -567,6 +585,18 @@ export interface IFaustBaseWebAudioDsp {
 	 * @return the current output handler
 	 */
 	getComputeHandler(): ComputeHandler | null;
+	/**
+	 * Set the MIDI output handler, to  be called in the 'compute' method with MIDI messages.
+	 * @param handler - the MIDI output handler
+	 * @return void
+	 */
+	setMidiOutputHandler(handler: MidiOutputHandler | null): void;
+	/**
+	 * Get the MIDI output handler.
+	 *
+	 * @return the current MIDI output handler
+	 */
+	getMidiOutputHandler(): MidiOutputHandler | null;
 	/**
 	 * Set the plot handler, to  be called in the 'compute' method with various info (see PlotHandler type).
 	 *
@@ -753,6 +783,7 @@ export interface IFaustPolyWebAudioNode extends IFaustPolyWebAudioDsp, AudioNode
 export declare class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
 	protected fOutputHandler: OutputParamHandler | null;
 	protected fComputeHandler: ComputeHandler | null;
+	protected fMidiOutputHandler: MidiOutputHandler | null;
 	protected fPlotHandler: PlotHandler | null;
 	protected fCachedEvents: {
 		type: string;
@@ -848,7 +879,6 @@ export declare class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
 	 * Init soundfiles memory.
 	 *
 	 * @param allocator : the wasm memory allocator
-	 * @param sfReader : the soundfile reader
 	 * @param baseDSP : the DSP struct (either a monophonic DSP of polyphonic voice) base DSP in the wasm memory
 	*/
 	protected initSoundfileMemory(allocator: WasmAllocator, baseDSP: number): void;
@@ -857,8 +887,11 @@ export declare class FaustBaseWebAudioDsp implements IFaustBaseWebAudioDsp {
 	compute(input: Float32Array[], output: Float32Array[]): boolean;
 	setOutputParamHandler(handler: OutputParamHandler | null): void;
 	getOutputParamHandler(): OutputParamHandler | null;
+	callOutputParamHandler(path: string, value: number): void;
 	setComputeHandler(handler: ComputeHandler | null): void;
 	getComputeHandler(): ComputeHandler | null;
+	setMidiOutputHandler(handler: MidiOutputHandler | null): void;
+	getMidiOutputHandler(): MidiOutputHandler | null;
 	setPlotHandler(handler: PlotHandler | null): void;
 	getPlotHandler(): PlotHandler | null;
 	getNumInputs(): number;
@@ -1210,8 +1243,11 @@ export declare class FaustOfflineProcessor<Poly extends boolean = false> {
 	compute(input: Float32Array[], output: Float32Array[]): boolean;
 	setOutputParamHandler(handler: OutputParamHandler): void;
 	getOutputParamHandler(): OutputParamHandler | null;
+	callOutputParamHandler(path: string, value: number): void;
 	setComputeHandler(handler: ComputeHandler): void;
 	getComputeHandler(): ComputeHandler | null;
+	setMidiOutputHandler(handler: MidiOutputHandler | null): void;
+	getMidiOutputHandler(): MidiOutputHandler | null;
 	setPlotHandler(handler: PlotHandler): void;
 	getPlotHandler(): PlotHandler | null;
 	getNumInputs(): number;
@@ -1391,6 +1427,7 @@ export declare class FaustAudioWorkletNode<Poly extends boolean = false> extends
 	protected fInputsItems: string[];
 	protected fOutputHandler: OutputParamHandler | null;
 	protected fComputeHandler: ComputeHandler | null;
+	protected fMidiOutputHandler: MidiOutputHandler | null;
 	protected fPlotHandler: PlotHandler | null;
 	protected fUICallback: UIHandler;
 	protected fDescriptor: FaustUIInputItem[];
@@ -1404,8 +1441,11 @@ export declare class FaustAudioWorkletNode<Poly extends boolean = false> extends
 	stopSensors(): void;
 	setOutputParamHandler(handler: OutputParamHandler | null): void;
 	getOutputParamHandler(): OutputParamHandler | null;
+	callOutputParamHandler(path: string, value: number): void;
 	setComputeHandler(handler: ComputeHandler | null): void;
 	getComputeHandler(): ComputeHandler | null;
+	setMidiOutputHandler(handler: MidiOutputHandler | null): void;
+	getMidiOutputHandler(): MidiOutputHandler | null;
 	setPlotHandler(handler: PlotHandler | null): void;
 	getPlotHandler(): PlotHandler | null;
 	setupWamEventHandler(): void;
@@ -1475,10 +1515,13 @@ export declare class FaustScriptProcessorNode<Poly extends boolean = false> exte
 	compute(input: Float32Array[], output: Float32Array[]): boolean;
 	setOutputParamHandler(handler: OutputParamHandler): void;
 	getOutputParamHandler(): OutputParamHandler | null;
+	callOutputParamHandler(path: string, value: number): void;
 	setComputeHandler(handler: ComputeHandler): void;
 	getComputeHandler(): ComputeHandler | null;
 	setPlotHandler(handler: PlotHandler): void;
 	getPlotHandler(): PlotHandler | null;
+	setMidiOutputHandler(handler: MidiOutputHandler | null): void;
+	getMidiOutputHandler(): MidiOutputHandler | null;
 	getNumInputs(): number;
 	getNumOutputs(): number;
 	metadata(handler: MetadataHandler): void;

package/dist/cjs-bundle/index.js

@@ -8106,6 +8106,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     constructor(sampleSize, bufferSize, soundfiles) {
       this.fOutputHandler = null;
       this.fComputeHandler = null;
+      this.fMidiOutputHandler = null;
       // To handle MIDI events plot
       this.fPlotHandler = null;
       this.fCachedEvents = [];
@@ -8371,7 +8372,6 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
      * Init soundfiles memory.
      * 
      * @param allocator : the wasm memory allocator
-     * @param sfReader : the soundfile reader
      * @param baseDSP : the DSP struct (either a monophonic DSP of polyphonic voice) base DSP in the wasm memory
     */
     initSoundfileMemory(allocator, baseDSP) {
@@ -8404,12 +8404,25 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     getOutputParamHandler() {
       return this.fOutputHandler;
     }
+    callOutputParamHandler(path, value) {
+      if (this.fOutputHandler) {
+        this.fOutputHandler(path, value);
+      } else {
+        console.warn("No OutputParamHandler set for this FaustAudioWorkletNode.");
+      }
+    }
     setComputeHandler(handler) {
       this.fComputeHandler = handler;
     }
     getComputeHandler() {
       return this.fComputeHandler;
     }
+    setMidiOutputHandler(handler) {
+      this.fMidiOutputHandler = handler;
+    }
+    getMidiOutputHandler() {
+      return this.fMidiOutputHandler;
+    }
     setPlotHandler(handler) {
       this.fPlotHandler = handler;
     }
@@ -8548,6 +8561,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
       this.fDestroyed = true;
       this.fOutputHandler = null;
       this.fComputeHandler = null;
+      this.fMidiOutputHandler = null;
       this.fPlotHandler = null;
     }
   };
@@ -9104,12 +9118,21 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     getOutputParamHandler() {
       return this.fDSPCode.getOutputParamHandler();
     }
+    callOutputParamHandler(path, value) {
+      this.fDSPCode.callOutputParamHandler(path, value);
+    }
     setComputeHandler(handler) {
       this.fDSPCode.setComputeHandler(handler);
     }
     getComputeHandler() {
       return this.fDSPCode.getComputeHandler();
     }
+    setMidiOutputHandler(handler) {
+      this.fDSPCode.setMidiOutputHandler(handler);
+    }
+    getMidiOutputHandler() {
+      return this.fDSPCode.getMidiOutputHandler();
+    }
     setPlotHandler(handler) {
       this.fDSPCode.setPlotHandler(handler);
     }
@@ -9952,6 +9975,7 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
         processorOptions: options.processorOptions,
         ...options
       });
+      this.fMidiOutputHandler = null;
       __privateAdd(this, _hasAccInput, false);
       __privateAdd(this, _hasGyrInput, false);
       this.handleMessageAux = (e) => {
@@ -10031,12 +10055,25 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     getOutputParamHandler() {
       return this.fOutputHandler;
     }
+    callOutputParamHandler(path, value) {
+      if (this.fOutputHandler) {
+        this.fOutputHandler(path, value);
+      } else {
+        console.warn("No OutputParamHandler set for this FaustAudioWorkletNode.");
+      }
+    }
     setComputeHandler(handler) {
       this.fComputeHandler = handler;
     }
     getComputeHandler() {
       return this.fComputeHandler;
     }
+    setMidiOutputHandler(handler) {
+      this.fMidiOutputHandler = handler;
+    }
+    getMidiOutputHandler() {
+      return this.fMidiOutputHandler;
+    }
     setPlotHandler(handler) {
       this.fPlotHandler = handler;
       if (this.fPlotHandler) {
@@ -10292,6 +10329,9 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     getOutputParamHandler() {
       return this.fDSPCode.getOutputParamHandler();
     }
+    callOutputParamHandler(path, value) {
+      this.fDSPCode.callOutputParamHandler(path, value);
+    }
     setComputeHandler(handler) {
       this.fDSPCode.setComputeHandler(handler);
     }
@@ -10304,6 +10344,12 @@ export default ${(_b = jsCode.match(jsCodeHead)) == null ? void 0 : _b[1]};
     getPlotHandler() {
       return this.fDSPCode.getPlotHandler();
     }
+    setMidiOutputHandler(handler) {
+      this.fDSPCode.setMidiOutputHandler(handler);
+    }
+    getMidiOutputHandler() {
+      return this.fDSPCode.getMidiOutputHandler();
+    }
     getNumInputs() {
       return this.fDSPCode.getNumInputs();
     }