@grame/faustwasm 0.10.2 → 0.11.0

package/dist/cjs/index.d.ts

@@ -425,6 +425,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;
@@ -548,6 +559,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.
 	 *
@@ -560,6 +578,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).
 	 *
@@ -746,6 +776,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;
@@ -841,7 +872,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;
@@ -850,8 +880,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;
@@ -1203,8 +1236,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;
@@ -1384,6 +1420,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[];
@@ -1397,8 +1434,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;
@@ -1468,10 +1508,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/index.js

@@ -2137,6 +2137,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 = [];
@@ -2402,7 +2403,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) {
@@ -2435,12 +2435,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;
     }
@@ -2579,6 +2592,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;
     }
   };
@@ -3135,12 +3149,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);
     }
@@ -3983,6 +4006,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) => {
@@ -4062,12 +4086,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) {
@@ -4323,6 +4360,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);
     }
@@ -4335,6 +4375,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();
     }