@grame/faustwasm 0.10.2 → 0.11.0

package/dist/esm-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/esm-bundle/index.js

@@ -8061,6 +8061,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 = [];
@@ -8326,7 +8327,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) {
@@ -8359,12 +8359,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;
   }
@@ -8503,6 +8516,7 @@ var FaustBaseWebAudioDsp = class _FaustBaseWebAudioDsp {
     this.fDestroyed = true;
     this.fOutputHandler = null;
     this.fComputeHandler = null;
+    this.fMidiOutputHandler = null;
     this.fPlotHandler = null;
   }
 };
@@ -9059,12 +9073,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);
   }
@@ -9907,6 +9930,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) => {
@@ -9986,12 +10010,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) {
@@ -10247,6 +10284,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);
   }
@@ -10259,6 +10299,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();
   }