spessasynth_lib 4.1.5 → 4.2.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { MIDIPatch, KeyModifier, SoundBankManagerListEntry, SynthProcessorEventData, BasicMIDI, MIDITrack, SequencerEvent, MIDIMessage, SpessaSynthProcessor, SpessaSynthSequencer, SynthProcessorOptions, BasicSoundBank, SoundFont2WriteOptions, DLSWriteOptions, RMIDIWriteOptions, SynthesizerSnapshot, SynthMethodOptions, CustomController, MIDIController, MasterParameterType, SynthProcessorEvent, ChannelSnapshot, ChannelProperty, PresetList, WaveWriteOptions } from 'spessasynth_core';
+import { MIDIPatch, KeyModifier, SoundBankManagerListEntry, SynthProcessorEventData, BasicMIDI, MIDITrack, SequencerEvent, MIDIMessage, SpessaSynthProcessor, SpessaSynthSequencer, SynthProcessorOptions, BasicSoundBank, SoundFont2WriteOptions, DLSWriteOptions, RMIDIWriteOptions, SynthesizerSnapshot, SynthMethodOptions, CustomController, MIDIController, MasterParameterType, SynthProcessorEvent, ChannelProperty, PresetList, WaveWriteOptions } from 'spessasynth_core';
 
 declare class WorkletKeyModifierManagerWrapper {
     private keyModifiers;
@@ -245,7 +245,7 @@ declare abstract class BasicSynthesizerCore {
      * @protected
      */
     protected alive: boolean;
-    protected constructor(sampleRate: number, options: SynthProcessorOptions, postMessage: PostMessageSynthCore);
+    protected constructor(sampleRate: number, options: Omit<SynthProcessorOptions, "reverbProcessor" | "chorusProcessor" | "delayProcessor">, postMessage: PostMessageSynthCore);
     protected createNewSequencer(): void;
     protected postReady<K extends keyof SynthesizerReturn>(type: K, data: SynthesizerReturn[K], transferable?: Transferable[]): void;
     protected postProgress<K extends keyof SynthesizerProgress>(type: K, data: SynthesizerProgress[K]): void;
@@ -431,11 +431,6 @@ interface BasicSynthesizerMessageData {
         options: SynthMethodOptions;
     };
     ccReset: null;
-    setChannelVibrato: {
-        rate: number;
-        depth: number;
-        delay: number;
-    };
     stopAll: number;
     muteChannel: boolean;
     addNewChannel: null;
@@ -518,8 +513,7 @@ interface SynthesizerReturn {
     startOfflineRender: null;
     synthesizerSnapshot: SynthesizerSnapshot;
     renderAudio: {
-        reverb: [Float32Array, Float32Array];
-        chorus: [Float32Array, Float32Array];
+        effects: [Float32Array, Float32Array];
         dry: [Float32Array, Float32Array][];
     };
     workerSynthWriteFile: {
@@ -540,17 +534,13 @@ interface SynthConfig {
      */
     oneOutput: boolean;
     /**
-     * If the chorus processor should be initialized during creation.
-     * Note that setting this to false will not allow it to be used later.
-     * If you want to enable it at some point, set this to true and set the chorus gain to 0.
+     * @deprecated Deprecated parameter, does nothing.
      */
-    initializeChorusProcessor: boolean;
+    initializeChorusProcessor?: boolean;
     /**
-     * If the reverb processor should be initialized during creation.
-     * Note that setting this to false will not allow it to be used later.
-     * If you want to enable it at some point, set this to true and set the reverb gain to 0.
+     * @deprecated Deprecated parameter, does nothing.
      */
-    initializeReverbProcessor: boolean;
+    initializeReverbProcessor?: boolean;
     /**
      * Custom audio node creation functions for Web Audio wrappers, such as standardized-audio-context.
      * Pass undefined to use the Web Audio API.
@@ -561,9 +551,6 @@ interface SynthConfig {
      */
     enableEventSystem: boolean;
 }
-interface BasicEffectConfig {
-    null?: null;
-}
 interface AudioNodeCreators {
     /**
      * A custom creator for an AudioWorkletNode.
@@ -575,133 +562,6 @@ interface AudioNodeCreators {
         processorOptions: PassedProcessorParameters;
     }) => AudioWorkletNode;
 }
-interface ReverbConfig extends BasicEffectConfig {
-    /**
-     * The impulse response for the reverb. Pass undefined to use default one.
-     */
-    impulseResponse?: AudioBuffer;
-}
-interface ChorusConfig extends BasicEffectConfig {
-    /**
-     * The amount of delay nodes (for each channel) and the corresponding oscillators.
-     */
-    nodesAmount: number;
-    /**
-     * The initial delay, in seconds.
-     */
-    defaultDelay: number;
-    /**
-     * The difference between delays in the delay nodes.
-     */
-    delayVariation: number;
-    /**
-     * The difference of delays between two channels (added to the right channel).
-     */
-    stereoDifference: number;
-    /**
-     * The initial delay time oscillator frequency, in Hz.
-     */
-    oscillatorFrequency: number;
-    /**
-     * The difference between frequencies of oscillators, in Hz.
-     */
-    oscillatorFrequencyVariation: number;
-    /**
-     * How much will oscillator alter the delay in delay nodes, in seconds.
-     */
-    oscillatorGain: number;
-}
-
-declare abstract class BasicEffectsProcessor {
-    readonly input: AudioNode;
-    protected readonly output: AudioNode;
-    protected constructor(input: AudioNode, output: AudioNode);
-    abstract get config(): BasicEffectConfig;
-    abstract update(config: BasicEffectConfig): void;
-    /**
-     * Connects the processor to a given node.
-     * @param destinationNode The node to connect to.
-     */
-    connect(destinationNode: AudioNode): AudioNode;
-    /**
-     * Disconnects the processor from a given node.
-     * @param destinationNode The node to disconnect from.
-     */
-    disconnect(destinationNode?: AudioNode): void;
-    /**
-     * Disconnects the effect processor.
-     */
-    delete(): void;
-}
-
-/**
- * Fancy_chorus.js
- * purpose: creates a simple chorus effect node
- */
-
-declare class ChorusProcessor extends BasicEffectsProcessor {
-    private readonly chorusLeft;
-    private readonly chorusRight;
-    /**
-     * Creates a fancy chorus effect.
-     * @param context The audio context.
-     * @param config The configuration for the chorus.
-     */
-    constructor(context: BaseAudioContext, config?: Partial<ChorusConfig>);
-    private _config;
-    get config(): ChorusConfig;
-    /**
-     * Updates the chorus with a given config.
-     * @param chorusConfig The config to use.
-     */
-    update(chorusConfig: Partial<ChorusConfig>): void;
-    /**
-     * Disconnects and deletes the chorus effect.
-     */
-    delete(): void;
-    private deleteNodes;
-    private createChorusNode;
-}
-
-declare class ReverbProcessor extends BasicEffectsProcessor {
-    /**
-     * Indicates that the reverb is ready.
-     */
-    readonly isReady: Promise<AudioBuffer>;
-    private conv;
-    /**
-     * Creates a new reverb processor.
-     * @param context The context to use.
-     * @param config The reverb configuration.
-     */
-    constructor(context: BaseAudioContext, config?: Partial<ReverbConfig>);
-    private _config;
-    get config(): ReverbConfig;
-    /**
-     * Updates the reverb with a given config.
-     * @param config The config to use.
-     */
-    update(config: Partial<ReverbConfig>): void;
-}
-
-/**
- * Extended synthesizer snapshot to contain effects
- */
-declare class LibSynthesizerSnapshot extends SynthesizerSnapshot {
-    /**
-     * Chorus configuration of this synthesizer.
-     */
-    chorusConfig: ChorusConfig;
-    /**
-     * Reverb configuration of this synthesizer.
-     */
-    reverbConfig: ReverbConfig;
-    constructor(channelSnapshots: ChannelSnapshot[], masterParameters: MasterParameterType, keyMappings: (KeyModifier | undefined)[][], chorusConfig?: ChorusConfig, reverbConfig?: ReverbConfig);
-    /**
-     * Retrieves the SynthesizerSnapshot from the lib snapshot.
-     */
-    getCoreSnapshot(): SynthesizerSnapshot;
-}
 
 declare abstract class BasicSynthesizer {
     /**
@@ -739,15 +599,15 @@ declare abstract class BasicSynthesizer {
      */
     readonly isReady: Promise<unknown>;
     /**
-     * Synthesizer's reverb processor.
-     * Undefined if reverb is disabled.
+     * Legacy parameter.
+     * @deprecated
      */
-    readonly reverbProcessor?: ReverbProcessor;
+    readonly reverbProcessor: undefined;
     /**
-     * Synthesizer's chorus processor.
-     * Undefined if chorus is disabled.
+     * Legacy parameter.
+     * @deprecated
      */
-    readonly chorusProcessor?: ChorusProcessor;
+    readonly chorusProcessor: undefined;
     /**
      * INTERNAL USE ONLY!
      * @internal
@@ -822,15 +682,14 @@ declare abstract class BasicSynthesizer {
     /**
      * Gets a complete snapshot of the synthesizer, effects.
      */
-    getSnapshot(): Promise<LibSynthesizerSnapshot>;
+    getSnapshot(): Promise<SynthesizerSnapshot>;
     /**
      * Adds a new channel to the synthesizer.
      */
     addNewChannel(): void;
     /**
-     * Sets custom vibrato for the channel.
-     * @param channel The channel number.
-     * @param value The vibrato parameters.
+     * DEPRECATED, please don't use it!
+     * @deprecated
      */
     setVibrato(channel: number, value: {
         delay: number;
@@ -849,6 +708,7 @@ declare abstract class BasicSynthesizer {
     disconnectIndividualOutputs(audioNodes: AudioNode[]): void;
     /**
      * Disables the GS NRPN parameters like vibrato or drum key tuning.
+     * @deprecated Deprecated! Please use master parameters
      */
     disableGSNPRNParams(): void;
     /**
@@ -1377,4 +1237,4 @@ declare class WebMIDILinkHandler {
 
 declare const DEFAULT_SYNTH_CONFIG: SynthConfig;
 
-export { BasicSynthesizer, ChorusProcessor, DEFAULT_SYNTH_CONFIG, MIDIDeviceHandler, ReverbProcessor, Sequencer, WebMIDILinkHandler, WorkerSynthesizer, WorkerSynthesizerCore, WorkletSynthesizer, audioBufferToWav };
+export { BasicSynthesizer, DEFAULT_SYNTH_CONFIG, MIDIDeviceHandler, Sequencer, WebMIDILinkHandler, WorkerSynthesizer, WorkerSynthesizerCore, WorkletSynthesizer, audioBufferToWav };