@grame/faustwasm 0.10.2 → 0.11.0

package/assets/standalone/faustwasm/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/assets/standalone/faustwasm/index.js

@@ -2107,6 +2107,7 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
   constructor(sampleSize, bufferSize, soundfiles) {
     this.fOutputHandler = null;
     this.fComputeHandler = null;
+    this.fMidiOutputHandler = null;
     // To handle MIDI events plot
     this.fPlotHandler = null;
     this.fCachedEvents = [];
@@ -2372,7 +2373,6 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
    * 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) {
@@ -2405,12 +2405,25 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
   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;
   }
@@ -2549,6 +2562,7 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
     this.fDestroyed = true;
     this.fOutputHandler = null;
     this.fComputeHandler = null;
+    this.fMidiOutputHandler = null;
     this.fPlotHandler = null;
   }
 };
@@ -3105,12 +3119,21 @@ var FaustOfflineProcessor = class {
   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);
   }
@@ -3953,6 +3976,7 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
       processorOptions: options.processorOptions,
       ...options
     });
+    this.fMidiOutputHandler = null;
     __privateAdd(this, _hasAccInput, false);
     __privateAdd(this, _hasGyrInput, false);
     this.handleMessageAux = (e) => {
@@ -4032,12 +4056,25 @@ var FaustAudioWorkletNode = class extends (globalThis.AudioWorkletNode || null)
   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) {
@@ -4293,6 +4330,9 @@ var FaustScriptProcessorNode = class extends (globalThis.ScriptProcessorNode ||
   getOutputParamHandler() {
     return this.fDSPCode.getOutputParamHandler();
   }
+  callOutputParamHandler(path, value) {
+    this.fDSPCode.callOutputParamHandler(path, value);
+  }
   setComputeHandler(handler) {
     this.fDSPCode.setComputeHandler(handler);
   }
@@ -4305,6 +4345,12 @@ var FaustScriptProcessorNode = class extends (globalThis.ScriptProcessorNode ||
   getPlotHandler() {
     return this.fDSPCode.getPlotHandler();
   }
+  setMidiOutputHandler(handler) {
+    this.fDSPCode.setMidiOutputHandler(handler);
+  }
+  getMidiOutputHandler() {
+    return this.fDSPCode.getMidiOutputHandler();
+  }
   getNumInputs() {
     return this.fDSPCode.getNumInputs();
   }