spessasynth_core 3.26.0 → 3.26.2

package/README.md

@@ -1,4 +1,7 @@
-# spessasynth_core
+<!--suppress HtmlDeprecatedAttribute, HtmlRequiredAltAttribute, HtmlExtraClosingTag -->
+<p align='center'>
+<img src='https://raw.githubusercontent.com/spessasus/SpessaSynth/refs/heads/master/src/website/spessasynth_logo_rounded.png' width='300' alt='SpessaSynth logo'>
+</p>
 
 **A powerful SF2/DLS/MIDI JavaScript library. It works with any modern JS environment that supports WebAssembly.**
 
@@ -11,82 +14,20 @@ npm install --save spessasynth_core
 
 ### [Project site (consider giving it a star!)](https://github.com/spessasus/SpessaSynth)
 
-### [Demo (using the spessasynth_lib wrapper)](https://spessasus.github.io/spessasynth_core)
+### [Demo (using the spessasynth_lib wrapper)](https://spessasus.github.io/SpessaSynth)
 
 ### [Documentation (in progress!)](https://github.com/spessasus/spessasynth_core/wiki/Home)
 
 
-> Note: This is the new heart of the spessasynth_core library, after the repository has been split.
-
-### 
-```js
-import * as fs from "node:fs";
-import { MIDI } from "../../src/midi/midi_loader.js";
-import { SpessaSynthProcessor } from "../../src/synthetizer/audio_engine/main_processor.js";
-import { SpessaSynthSequencer } from "../../src/sequencer/sequencer_engine.js";
-import { audioToWav } from "../../src/utils/buffer_to_wav.js";
-
-// process arguments
-const args = process.argv.slice(2);
-if (args.length !== 3)
-{
-    console.log("Usage: node index.js <soundfont path> <midi path> <wav output path>");
-    process.exit();
-}
-// load the files
-const sf = fs.readFileSync(args[0]);
-const mid = fs.readFileSync(args[1]);
-
-const midi = new MIDI(mid);
-const sampleRate = 44100;
-const sampleCount = 44100 * (midi.duration + 2);
-
-const synth = new SpessaSynthProcessor(
-    sf,
-    sampleRate,
-    {},
-    false,
-    false
-);
-await synth.processorInitialized;
-
-const seq = new SpessaSynthSequencer(synth);
-seq.loadNewSongList([midi]);
-seq.loop = false;
-
-const outLeft = new Float32Array(sampleCount);
-const outRight = new Float32Array(sampleCount);
-const start = performance.now();
-let filledSamples = 0;
-
-const bufSize = 128;
-while (filledSamples + bufSize < sampleCount)
-{
-    const bufLeft = new Float32Array(bufSize);
-    const bufRight = new Float32Array(bufSize);
-    seq.processTick();
-    const arr = [bufLeft, bufRight];
-    synth.renderAudio(arr, arr, arr);
-    outLeft.set(bufLeft, filledSamples);
-    outRight.set(bufRight, filledSamples);
-    filledSamples += bufSize;
-}
-const wave = audioToWav({
-    leftChannel: outLeft,
-    rightChannel: outRight,
-    sampleRate: sampleRate
-});
-fs.writeFileSync(args[2], new Buffer(wave));
-process.exit();
-```
+> Note: This is the new heart of the SpessaSynth library, after the repository has been split.
 
 ## Current Features
 
 ### Easy Integration
 - **Modular design:** *Easy integration into other projects (load what you need)*
-- **[Detailed documentation:](https://github.com/spessasus/spessasynth_core/wiki/Home)** *With [examples!](https://github.com/spessasus/spessasynth_core/wiki/Usage-As-Library#examples)*
+- **[Detailed documentation:](https://github.com/spessasus/spessasynth_core/wiki/Home)** *With [examples!](https://github.com/spessasus/spessasynth_core/wiki/Getting-Started#examples)*
 - **Flexible:** *It's not just a MIDI player!*
-- **Easy to Use:** *Basic setup is just [two lines of code!](https://github.com/spessasus/spessasynth_core/wiki/Usage-As-Library#minimal-setup)*
+- **Easy to Use:** *Basic setup is just [two lines of code!](https://github.com/spessasus/spessasynth_core/wiki/Getting-Started#minimal-setup)*
 - **No dependencies:** *Batteries included!*
 
 ### Powerful MIDI Synthesizer
@@ -205,6 +146,69 @@ process.exit();
 
 **If you like this project, consider giving it a star. It really helps out!**
 
+### Short example: MIDI to wav converter
+```js
+import * as fs from "node:fs";
+import { MIDI, SpessaSynthProcessor, SpessaSynthSequencer, audioToWav, loadSoundFont } from "spessasynth_core";
+
+// process arguments
+const args = process.argv.slice(2);
+if (args.length !== 3)
+{
+    console.log("Usage: node index.js <soundfont path> <midi path> <wav output path>");
+    process.exit();
+}
+const sf = fs.readFileSync(args[0]);
+const mid = fs.readFileSync(args[1]);
+const midi = new MIDI(mid);
+const sampleRate = 44100;
+const sampleCount = 44100 * (midi.duration + 2);
+const synth = new SpessaSynthProcessor(sampleRate, {
+    enableEventSystem: false,
+    effectsEnabled: false
+});
+synth.soundfontManager.reloadManager(loadSoundFont(sf));
+await synth.processorInitialized;
+const seq = new SpessaSynthSequencer(synth);
+seq.loadNewSongList([midi]);
+seq.loop = false;
+const outLeft = new Float32Array(sampleCount);
+const outRight = new Float32Array(sampleCount);
+const start = performance.now();
+let filledSamples = 0;
+// note: buffer size is recommended to be very small, as this is the interval between modulator updates and LFO updates
+const bufSize = 128;
+let i = 0;
+while (filledSamples + bufSize < sampleCount)
+{
+    const bufLeft = new Float32Array(bufSize);
+    const bufRight = new Float32Array(bufSize);
+    // process sequencer
+    seq.processTick();
+    const arr = [bufLeft, bufRight];
+    // render
+    synth.renderAudio(arr, arr, arr);
+    // write out
+    outLeft.set(bufLeft, filledSamples);
+    outRight.set(bufRight, filledSamples);
+    filledSamples += bufSize;
+    i++;
+    // log progress
+    if (i % 100 === 0)
+    {
+        console.log("Rendered", seq.currentTime, "/", midi.duration);
+    }
+}
+console.log("Rendered in", Math.floor(performance.now() - start), "ms");
+const wave = audioToWav({
+    leftChannel: outLeft,
+    rightChannel: outRight,
+    sampleRate: sampleRate
+});
+fs.writeFileSync(args[2], new Buffer(wave));
+process.exit();
+```
+
 # License
 Copyright © 2025 Spessasus
 Licensed under the Apache-2.0 License.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spessasynth_core",
-  "version": "3.26.0",
+  "version": "3.26.2",
   "description": "MIDI and SoundFont2/DLS library with no compromises",
   "main": "index.js",
   "type": "module",

package/src/midi/midi_tools/used_keys_loaded.js

@@ -8,7 +8,7 @@ import { isGSDrumsOn, isXGOn } from "../../utils/sysex_detector.js";
 /**
  * Gets the used programs and keys for this MIDI file with a given sound bank
  * @this {BasicMIDI}
- * @param soundfont {BasicSoundBank|WorkletSoundfontManager} - the sound bank
+ * @param soundfont {BasicSoundBank|SoundFontManager} - the sound bank
  * @returns {Object<string, Set<string>>} Object<bank:program, Set<key-velocity>>
  */
 export function getUsedProgramsAndKeys(soundfont)

package/src/sequencer/process_event.js

@@ -160,6 +160,6 @@ export function _addNewMidiPort()
 {
     for (let i = 0; i < 16; i++)
     {
-        this.synth.createWorkletChannel(true);
+        this.synth.createMidiChannel(true);
     }
 }

package/src/synthetizer/audio_engine/engine_components/key_modifier_manager.js

@@ -42,6 +42,7 @@ export class KeyModifierManager
 {
     /**
      * The velocity override mappings for MIDI keys
+     * stored as [channelNumber][midiNote]
      * @type {KeyModifier[][]}
      * @private
      */

package/src/synthetizer/audio_engine/engine_components/lowpass_filter.js

@@ -22,7 +22,7 @@ export const FILTER_SMOOTHING_FACTOR = 0.1;
  * @property {number} a4 - Filter coefficient 5
  */
 
-export class WorkletLowpassFilter
+export class LowpassFilter
 {
     /**
      * Cached coefficient calculations
@@ -175,7 +175,7 @@ export class WorkletLowpassFilter
         {
             filter.lastTargetCutoff = targetCutoff;
             filter.resonanceCb = modulatedResonance;
-            WorkletLowpassFilter.calculateCoefficients(filter, targetCutoff);
+            LowpassFilter.calculateCoefficients(filter, targetCutoff);
         }
         
         // filter the input
@@ -200,7 +200,7 @@ export class WorkletLowpassFilter
     }
     
     /**
-     * @param filter {WorkletLowpassFilter}
+     * @param filter {LowpassFilter}
      * @param cutoffCents {number}
      */
     static calculateCoefficients(filter, cutoffCents)
@@ -208,7 +208,7 @@ export class WorkletLowpassFilter
         cutoffCents = ~~cutoffCents; // Math.floor
         const qCb = filter.resonanceCb;
         // check if these coefficients were already cached
-        const cached = WorkletLowpassFilter.cachedCoefficients?.[qCb]?.[cutoffCents];
+        const cached = LowpassFilter.cachedCoefficients?.[qCb]?.[cutoffCents];
         if (cached !== undefined)
         {
             filter.a0 = cached.a0;
@@ -263,20 +263,20 @@ export class WorkletLowpassFilter
         filter.a3 = toCache.a3;
         filter.a4 = toCache.a4;
         
-        if (WorkletLowpassFilter.cachedCoefficients[qCb] === undefined)
+        if (LowpassFilter.cachedCoefficients[qCb] === undefined)
         {
-            WorkletLowpassFilter.cachedCoefficients[qCb] = [];
+            LowpassFilter.cachedCoefficients[qCb] = [];
         }
-        WorkletLowpassFilter.cachedCoefficients[qCb][cutoffCents] = toCache;
+        LowpassFilter.cachedCoefficients[qCb][cutoffCents] = toCache;
     }
 }
 
 // precompute all the cutoffs for 0q (most common)
-const dummy = new WorkletLowpassFilter(44100);
+const dummy = new LowpassFilter(44100);
 dummy.resonanceCb = 0;
 // sfspec section 8.1.3: initialFilterFc ranges from 1500 to 13,500 cents
 for (let i = 1500; i < 13500; i++)
 {
     dummy.currentInitialFc = i;
-    WorkletLowpassFilter.calculateCoefficients(dummy, i);
+    LowpassFilter.calculateCoefficients(dummy, i);
 }

package/src/synthetizer/audio_engine/engine_components/midi_audio_channel.js

@@ -370,6 +370,7 @@ class MidiAudioChannel
         this.sendChannelProperty();
     }
     
+    // noinspection JSUnusedGlobalSymbols
     /**
      * Sets a custom vibrato
      * @param depth {number} cents
@@ -387,6 +388,10 @@ class MidiAudioChannel
         this.channelVibrato.depth = depth;
     }
     
+    // noinspection JSUnusedGlobalSymbols
+    /**
+     * Yes
+     */
     disableAndLockGSNRPN()
     {
         this.lockGSNRPNParams = true;
@@ -431,7 +436,7 @@ class MidiAudioChannel
             bank: this.sentBank,
             program: this.preset.program
         };
-        this.synth?.callbacks?.channelPropertyChange?.(data, this.channelNumber);
+        this.synth?.onChannelPropertyChange?.(data, this.channelNumber);
     }
 }
 

package/src/synthetizer/audio_engine/engine_components/soundfont_manager.js

@@ -1,5 +1,4 @@
 import { SpessaSynthWarn } from "../../../utils/loggin.js";
-import { loadSoundFont } from "../../../soundfont/load_soundfont.js";
 import { isXGDrums } from "../../../utils/xg_hacks.js";
 
 /**
@@ -9,15 +8,24 @@ import { isXGDrums } from "../../../utils/xg_hacks.js";
  * @property {number} bankOffset - the soundfont's bank offset
  */
 
-export class WorkletSoundfontManager
+export class SoundFontManager
 {
     /**
-     * Creates a new instance of worklet soundfont manager (worklet scope)
-     * @param initialSoundFontBuffer {ArrayBuffer} Array buffer of the soundfont. This soudfont always has the id "main"
+     * All the soundfonts, ordered from the most important to the least.
+     * @type {SoundFontType[]}
      */
-    constructor(initialSoundFontBuffer)
+    soundfontList = [];
+    /**
+     * @type {{bank: number, presetName: string, program: number}[]}
+     */
+    presetList = [];
+    
+    /**
+     * @param presetListChangeCallback {function} to call when stuff changes
+     */
+    constructor(presetListChangeCallback)
     {
-        this.reloadManager(initialSoundFontBuffer);
+        this.presetListChangeCallback = presetListChangeCallback;
     }
     
     generatePresetList()
@@ -49,9 +57,6 @@ export class WorkletSoundfontManager
             }
         }
         
-        /**
-         * @type {{bank: number, presetName: string, program: number}[]}
-         */
         this.presetList = [];
         for (const [string, name] of Object.entries(presetList))
         {
@@ -62,6 +67,7 @@ export class WorkletSoundfontManager
                 bank: parseInt(pb[0])
             });
         }
+        this.presetListChangeCallback();
     }
     
     /**
@@ -73,13 +79,13 @@ export class WorkletSoundfontManager
         return this.presetList.slice();
     }
     
+    // noinspection JSUnusedGlobalSymbols
     /**
-     * Clears all soundfonts and adds a new one
-     * @param soundFontArrayBuffer {ArrayBuffer}
+     * Clears all soundfonts and adds a new one with an ID "main"
+     * @param soundFont {BasicSoundBank}
      */
-    reloadManager(soundFontArrayBuffer)
+    reloadManager(soundFont)
     {
-        const font = loadSoundFont(soundFontArrayBuffer);
         /**
          * All the soundfonts, ordered from the most important to the least.
          * @type {SoundFontType[]}
@@ -88,11 +94,16 @@ export class WorkletSoundfontManager
         this.soundfontList.push({
             id: "main",
             bankOffset: 0,
-            soundfont: font
+            soundfont: soundFont
         });
         this.generatePresetList();
     }
     
+    // noinspection JSUnusedGlobalSymbols
+    /**
+     * Deletes a given soundfont.
+     * @param id {string}
+     */
     deleteSoundFont(id)
     {
         if (this.soundfontList.length === 0)
@@ -113,13 +124,14 @@ export class WorkletSoundfontManager
         this.generatePresetList();
     }
     
+    // noinspection JSUnusedGlobalSymbols
     /**
-     * Adds a new soundfont buffer with a given ID
-     * @param buffer {ArrayBuffer}
+     * Adds a new soundfont with a given ID
+     * @param font {BasicSoundBank}
      * @param id {string}
      * @param bankOffset {number}
      */
-    addNewSoundFont(buffer, id, bankOffset)
+    addNewSoundFont(font, id, bankOffset)
     {
         if (this.soundfontList.find(s => s.id === id) !== undefined)
         {
@@ -127,12 +139,13 @@ export class WorkletSoundfontManager
         }
         this.soundfontList.push({
             id: id,
-            soundfont: loadSoundFont(buffer),
+            soundfont: font,
             bankOffset: bankOffset
         });
         this.generatePresetList();
     }
     
+    // noinspection JSUnusedGlobalSymbols
     /**
      * Rearranges the soundfonts
      * @param newList {string[]} the order of soundfonts, a list of strings, first overwrites second
@@ -156,7 +169,7 @@ export class WorkletSoundfontManager
     {
         if (this.soundfontList.length < 1)
         {
-            throw new Error("No soundfonts! This should never happen.");
+            throw new Error("No soundfonts! Did you forget to add one?");
         }
         for (const sf of this.soundfontList)
         {

package/src/synthetizer/audio_engine/engine_components/stereo_panner.js

@@ -7,8 +7,8 @@ import { generatorTypes } from "../../../soundfont/basic_soundfont/generator.js"
 
 export const PAN_SMOOTHING_FACTOR = 0.05;
 
-export const WORKLET_SYSTEM_REVERB_DIVIDER = 4600;
-export const WORKLET_SYSTEM_CHORUS_DIVIDER = 2000;
+export const REVERB_DIVIDER = 4600;
+export const CHORUS_DIVIDER = 2000;
 const HALF_PI = Math.PI / 2;
 
 const MIN_PAN = -500;
@@ -78,7 +78,7 @@ export function panVoice(voice,
         if (reverbSend > 0)
         {
             // reverb is mono so we need to multiply by gain
-            const reverbGain = this.synth.reverbGain * gain * (reverbSend / WORKLET_SYSTEM_REVERB_DIVIDER);
+            const reverbGain = this.synth.reverbGain * gain * (reverbSend / REVERB_DIVIDER);
             for (let i = 0; i < inputBuffer.length; i++)
             {
                 reverbLeft[i] += reverbGain * inputBuffer[i];
@@ -91,7 +91,7 @@ export function panVoice(voice,
         if (chorusSend > 0)
         {
             // chorus is stereo so we do not need to
-            const chorusGain = this.synth.chorusGain * chorusSend / WORKLET_SYSTEM_CHORUS_DIVIDER;
+            const chorusGain = this.synth.chorusGain * chorusSend / CHORUS_DIVIDER;
             const chorusLeftGain = gainLeft * chorusGain;
             const chorusRightGain = gainRight * chorusGain;
             for (let i = 0; i < inputBuffer.length; i++)

package/src/synthetizer/audio_engine/engine_components/voice.js

@@ -1,11 +1,10 @@
 /**
  * voice.js
- * purpose: prepares Voices from sample and generator data and manages sample dumping
- * note: sample dumping means sending it over to the AudioWorkletGlobalScope
+ * purpose: prepares Voices from sample and generator data
  */
 import { MIN_EXCLUSIVE_LENGTH, MIN_NOTE_LENGTH } from "../main_processor.js";
 import { SpessaSynthWarn } from "../../../utils/loggin.js";
-import { WorkletLowpassFilter } from "./lowpass_filter.js";
+import { LowpassFilter } from "./lowpass_filter.js";
 import { VolumeEnvelope } from "./volume_envelope.js";
 import { ModulationEnvelope } from "./modulation_envelope.js";
 import { addAndClampGenerator, generatorTypes } from "../../../soundfont/basic_soundfont/generator.js";
@@ -122,7 +121,7 @@ class Voice
     
     /**
      * Lowpass filter applied to the voice.
-     * @type {WorkletLowpassFilter}
+     * @type {LowpassFilter}
      */
     filter;
     
@@ -270,7 +269,7 @@ class Voice
     /**
      * Creates a Voice
      * @param sampleRate {number}
-     * @param workletSample {AudioSample}
+     * @param audioSample {AudioSample}
      * @param midiNote {number}
      * @param velocity {number}
      * @param channel {number}
@@ -282,7 +281,7 @@ class Voice
      */
     constructor(
         sampleRate,
-        workletSample,
+        audioSample,
         midiNote,
         velocity,
         channel,
@@ -293,12 +292,12 @@ class Voice
         modulators
     )
     {
-        this.sample = workletSample;
+        this.sample = audioSample;
         this.generators = generators;
         this.exclusiveClass = this.generators[generatorTypes.exclusiveClass];
         this.modulatedGenerators = new Int16Array(generators);
         this.modulators = modulators;
-        this.filter = new WorkletLowpassFilter(sampleRate);
+        this.filter = new LowpassFilter(sampleRate);
         
         this.velocity = velocity;
         this.midiNote = midiNote;
@@ -461,11 +460,11 @@ export function getVoices(channel,
             let loopEnd = sampleAndGenerators.sample.sampleLoopEndIndex;
             let loopingMode = generators[generatorTypes.sampleModes];
             /**
-             * create the worklet sample
+             * create the sample
              * offsets are calculated at note on time (to allow for modulation of them)
              * @type {AudioSample}
              */
-            const workletSample = new AudioSample(
+            const audioSample = new AudioSample(
                 sampleAndGenerators.sample.sampleData,
                 (sampleAndGenerators.sample.sampleRate / this.sampleRate) * Math.pow(
                     2,
@@ -492,14 +491,14 @@ export function getVoices(channel,
             //     Velocity: velocity,
             //     TargetKey: targetKey,
             //     MidiNote: midiNote,
-            //     AudioSample: workletSample
+            //     AudioSample: audioSample
             // }]);
             
             
             voices.push(
                 new Voice(
                     this.sampleRate,
-                    workletSample,
+                    audioSample,
                     midiNote,
                     velocity,
                     channel,

package/src/synthetizer/audio_engine/engine_methods/create_midi_channel.js

@@ -1,7 +1,5 @@
 import { MidiAudioChannel } from "../engine_components/midi_audio_channel.js";
 
-import { DEFAULT_PERCUSSION } from "../../synth_constants.js";
-
 /**
  * @param sendEvent {boolean}
  * @this {SpessaSynthProcessor}
@@ -13,15 +11,10 @@ export function createMidiChannel(sendEvent = false)
      */
     const channel = new MidiAudioChannel(this, this.defaultPreset, this.midiAudioChannels.length);
     this.midiAudioChannels.push(channel);
-    channel.resetControllers();
-    channel.sendChannelProperty();
     if (sendEvent)
     {
         this.callEvent("newchannel", undefined);
-    }
-    
-    if (channel.channelNumber % 16 === DEFAULT_PERCUSSION)
-    {
+        channel.sendChannelProperty();
         this.midiAudioChannels[this.midiAudioChannels.length - 1].setDrums(true);
     }
 }

package/src/synthetizer/audio_engine/engine_methods/render_voice.js

@@ -5,7 +5,7 @@ import { customControllers } from "../engine_components/controller_tables.js";
 import { absCentsToHz, timecentsToSeconds } from "../engine_components/unit_converter.js";
 import { getLFOValue } from "../engine_components/lfo.js";
 import { WavetableOscillator } from "../engine_components/wavetable_oscillator.js";
-import { WorkletLowpassFilter } from "../engine_components/lowpass_filter.js";
+import { LowpassFilter } from "../engine_components/lowpass_filter.js";
 import { interpolationTypes } from "../engine_components/enums.js";
 
 /**
@@ -181,7 +181,7 @@ export function renderVoice(
     }
     
     // low pass filter
-    WorkletLowpassFilter.apply(voice, bufferOut, lowpassExcursion, this.synth.filterSmoothingFactor);
+    LowpassFilter.apply(voice, bufferOut, lowpassExcursion, this.synth.filterSmoothingFactor);
     
     // vol env
     VolumeEnvelope.apply(voice, bufferOut, modLfoCentibels, this.synth.volumeEnvelopeSmoothingFactor);

package/src/synthetizer/audio_engine/engine_methods/soundfont_management/clear_sound_font.js

@@ -14,6 +14,11 @@ export function clearSoundFont(sendPresets = true, clearOverride = true)
     this.getDefaultPresets();
     this.cachedVoices = [];
     
+    if (sendPresets)
+    {
+        this.updatePresetList();
+    }
+    
     for (let i = 0; i < this.midiAudioChannels.length; i++)
     {
         const channelObject = this.midiAudioChannels[i];
@@ -23,8 +28,5 @@ export function clearSoundFont(sendPresets = true, clearOverride = true)
         }
         channelObject.programChange(channelObject.preset.program);
     }
-    if (sendPresets)
-    {
-        this.sendPresetList();
-    }
+    
 }

package/src/synthetizer/audio_engine/engine_methods/soundfont_management/set_embedded_sound_font.js

@@ -1,3 +1,7 @@
+import { loadSoundFont } from "../../../../soundfont/load_soundfont.js";
+import { SpessaSynthInfo } from "../../../../utils/loggin.js";
+import { consoleColors } from "../../../../utils/other.js";
+
 /**
  * Sets the embedded (RMI soundfont)
  * @param font {ArrayBuffer}
@@ -8,14 +12,22 @@ export function setEmbeddedSoundFont(font, offset)
 {
     // set offset
     this.soundfontBankOffset = offset;
-    this.reloadSoundFont(font, true);
+    this.clearSoundFont(false, true);
+    this.overrideSoundfont = loadSoundFont(font);
+    this.updatePresetList();
+    this.getDefaultPresets();
+    this.midiAudioChannels.forEach(c =>
+        c.programChange(c.preset.program)
+    );
     // preload all samples
     this.overrideSoundfont.samples.forEach(s => s.getAudioData());
     
+    
     // apply snapshot again if applicable
     if (this._snapshot !== undefined)
     {
         this.applySynthesizerSnapshot(this._snapshot);
         this.resetAllControllers();
     }
+    SpessaSynthInfo("%cSpessaSynth is ready!", consoleColors.recognized);
 }

package/src/synthetizer/audio_engine/engine_methods/soundfont_management/{send_preset_list.js → update_preset_list.js}

@@ -1,7 +1,7 @@
 /**
  * @this {SpessaSynthProcessor}
  */
-export function sendPresetList()
+export function updatePresetList()
 {
     /**
      * @type {{bank: number, presetName: string, program: number}[]}
@@ -28,4 +28,6 @@ export function sendPresetList()
         });
     }
     this.callEvent("presetlistchange", mainFont);
+    this.getDefaultPresets();
+    this.resetAllControllers(false);
 }

package/src/synthetizer/audio_engine/engine_methods/tuning_control/set_master_tuning.js

@@ -1,7 +1,7 @@
 import { customControllers } from "../../engine_components/controller_tables.js";
 
 /**
- * Sets the worklet's primary tuning
+ * Sets the synth's primary tuning
  * @this {SpessaSynthProcessor}
  * @param cents {number}
  */

package/src/synthetizer/audio_engine/main_processor.js

@@ -1,26 +1,20 @@
 import { SpessaSynthInfo } from "../../utils/loggin.js";
 import { consoleColors } from "../../utils/other.js";
 import { voiceKilling } from "./engine_methods/stopping_notes/voice_killing.js";
-import {
-    ALL_CHANNELS_OR_DIFFERENT_ACTION,
-    DEFAULT_PERCUSSION,
-    DEFAULT_SYNTH_MODE,
-    VOICE_CAP
-} from "../synth_constants.js";
+import { ALL_CHANNELS_OR_DIFFERENT_ACTION, DEFAULT_SYNTH_MODE, VOICE_CAP } from "../synth_constants.js";
 import { stbvorbis } from "../../externals/stbvorbis_sync/stbvorbis_sync.min.js";
 import { VOLUME_ENVELOPE_SMOOTHING_FACTOR } from "./engine_components/volume_envelope.js";
 import { systemExclusive } from "./engine_methods/system_exclusive.js";
 import { masterParameterType, setMasterParameter } from "./engine_methods/controller_control/master_parameters.js";
 import { resetAllControllers } from "./engine_methods/controller_control/reset_controllers.js";
-import { WorkletSoundfontManager } from "./engine_components/soundfont_manager.js";
+import { SoundFontManager } from "./engine_components/soundfont_manager.js";
 import { KeyModifierManager } from "./engine_components/key_modifier_manager.js";
 import { getVoices } from "./engine_components/voice.js";
 import { PAN_SMOOTHING_FACTOR } from "./engine_components/stereo_panner.js";
 import { stopAllChannels } from "./engine_methods/stopping_notes/stop_all_channels.js";
 import { setEmbeddedSoundFont } from "./engine_methods/soundfont_management/set_embedded_sound_font.js";
-import { reloadSoundFont } from "./engine_methods/soundfont_management/reload_sound_font.js";
 import { clearSoundFont } from "./engine_methods/soundfont_management/clear_sound_font.js";
-import { sendPresetList } from "./engine_methods/soundfont_management/send_preset_list.js";
+import { updatePresetList } from "./engine_methods/soundfont_management/update_preset_list.js";
 import { getPreset } from "./engine_methods/soundfont_management/get_preset.js";
 import { transposeAllChannels } from "./engine_methods/tuning_control/transpose_all_channels.js";
 import { setMasterTuning } from "./engine_methods/tuning_control/set_master_tuning.js";
@@ -30,6 +24,8 @@ import { FILTER_SMOOTHING_FACTOR } from "./engine_components/lowpass_filter.js";
 import { getEvent, messageTypes } from "../../midi/midi_message.js";
 import { IndexedByteArray } from "../../utils/indexed_array.js";
 import { interpolationTypes } from "./engine_components/enums.js";
+import { DEFAULT_SYNTH_OPTIONS } from "./synth_processor_options.js";
+import { fillWithDefaults } from "../../utils/fill_with_defaults.js";
 
 
 /**
@@ -314,7 +310,7 @@ class SpessaSynthProcessor
     defaultDrumsUsesOverride = false;
     
     /**
-     * Controls if the worklet processor is fully initialized
+     * Controls if the processor is fully initialized
      * @type {Promise<boolean>}
      */
     processorInitialized = stbvorbis.isInitialized;
@@ -332,67 +328,73 @@ class SpessaSynthProcessor
     sampleRate;
     
     /**
-     * @typedef {Object} CallbacksTypedef
-     * @property {function?} ready
-     * @property {function(EventTypes, EventCallbackData)?} eventCall
-     * @property {function(ChannelProperty, number)?} channelPropertyChange
-     * @property {function(masterParameterType, number|string)?} masterParameterChange
-     */
-    
-    /**
-     * Creates a new worklet synthesis system. contains all channels
-     * @param midiChannels {number}
-     * @param soundfont {ArrayBuffer}
-     * @param enableEventSystem {boolean}
-     * @param callbacks {CallbacksTypedef}
-     * @param sampleRate {number}
-     * @param initialTime {number}
-     * @param effectsEnabled {boolean}
-     * @param snapshot {SynthesizerSnapshot}
-     */
-    constructor(
-        soundfont,
-        sampleRate,
-        callbacks,
-        effectsEnabled = true,
-        enableEventSystem = true,
-        initialTime = 0,
-        midiChannels = 16,
-        snapshot = undefined)
+     * Sample time in seconds
+     * @type {number}
+     */
+    sampleTime;
+    
+    /**
+     * are the chorus and reverb effects enabled?
+     * @type {boolean}
+     */
+    effectsEnabled;
+    
+    /**
+     * for applying the snapshot after an override sound bank too
+     * @type {SynthesizerSnapshot}
+     * @private
+     */
+    _snapshot;
+    
+    /**
+     * Calls when an event occurs.
+     * @type {function}
+     * @param {EventTypes} eventType - the event type.
+     * @param {EventCallbackData} eventData - the event data.
+     */
+    onEventCall;
+    
+    /**
+     * Calls when a channel property is changed.
+     * @type {function}
+     * @param {ChannelProperty} property - the updated property.
+     * @param {number} channelNumber - the channel number of the said property.
+     */
+    onChannelPropertyChange;
+    
+    /**
+     * Calls when a master parameter is changed.
+     * @type {function}
+     * @param {masterParameterType} parameter - the parameter type
+     * @param {number|string} value - the new value.
+     */
+    onMasterParameterChange;
+    
+    
+    /**
+     * Creates a new synthesizer engine.
+     * @param sampleRate {number} - sample rate, in Hertz.
+     * @param options {SynthProcessorOptions} - the processor's options.
+     */
+    constructor(sampleRate,
+                options = DEFAULT_SYNTH_OPTIONS)
     {
+        options = fillWithDefaults(options, DEFAULT_SYNTH_OPTIONS);
         /**
          * Midi output count
          * @type {number}
          */
-        this.midiOutputsCount = midiChannels;
-        /**
-         * are the chorus and reverb effects enabled?
-         * @type {boolean}
-         */
-        this.effectsEnabled = effectsEnabled;
-        let initialChannelCount = this.midiOutputsCount;
-        
-        /**
-         * @type {CallbacksTypedef}
-         */
-        this.callbacks = callbacks;
-        
-        this.currentSynthTime = initialTime;
-        this.sampleRate = sampleRate;
-        
-        this.isFullyReady = false;
-        this.processorInitialized.then(() =>
-        {
-            this.isFullyReady = true;
-        });
-        
-        /**
-         * Sample time in seconds
-         * @type {number}
-         */
+        this.midiOutputsCount = options.midiChannels;
+        this.effectsEnabled = options.effectsEnabled;
+        this.enableEventSystem = options.enableEventSystem;
+        this.currentSynthTime = options.midiChannels;
         this.sampleTime = 1 / sampleRate;
+        this.sampleRate = sampleRate;
         
-        this.enableEventSystem = enableEventSystem;
+        // these smoothing factors were tested on 44,100 Hz, adjust them to target sample rate here
+        this.volumeEnvelopeSmoothingFactor = VOLUME_ENVELOPE_SMOOTHING_FACTOR * (44100 / sampleRate);
+        this.panSmoothingFactor = PAN_SMOOTHING_FACTOR * (44100 / sampleRate);
+        this.filterSmoothingFactor = FILTER_SMOOTHING_FACTOR * (44100 / sampleRate);
         
         
         for (let i = 0; i < 128; i++)
@@ -401,34 +403,18 @@ class SpessaSynthProcessor
         }
         
         /**
-         * @type {WorkletSoundfontManager}
+         * @type {SoundFontManager}
          */
-        this.soundfontManager = new WorkletSoundfontManager(
-            soundfont
-        );
-        this.sendPresetList();
-        this.getDefaultPresets();
-        
+        this.soundfontManager = new SoundFontManager(this.updatePresetList.bind(this));
         
-        for (let i = 0; i < initialChannelCount; i++)
+        for (let i = 0; i < this.midiOutputsCount; i++)
         {
-            this.createWorkletChannel(false);
+            this.createMidiChannel(false);
         }
-        
-        this.midiAudioChannels[DEFAULT_PERCUSSION].preset = this.drumPreset;
-        this.midiAudioChannels[DEFAULT_PERCUSSION].drumChannel = true;
-        
-        // these smoothing factors were tested on 44,100 Hz, adjust them to target sample rate here
-        this.volumeEnvelopeSmoothingFactor = VOLUME_ENVELOPE_SMOOTHING_FACTOR * (44100 / sampleRate);
-        this.panSmoothingFactor = PAN_SMOOTHING_FACTOR * (44100 / sampleRate);
-        this.filterSmoothingFactor = FILTER_SMOOTHING_FACTOR * (44100 / sampleRate);
-        
-        this._snapshot = snapshot;
-        if (this?._snapshot)
+        this.processorInitialized.then(() =>
         {
-            this.applySynthesizerSnapshot(snapshot);
-        }
-        this.postReady();
+            SpessaSynthInfo("%cSpessaSynth is ready!", consoleColors.recognized);
+        });
     }
     
     /**
@@ -457,7 +443,7 @@ class SpessaSynthProcessor
     setSystem(value)
     {
         this.system = value;
-        this?.callbacks?.masterParameterChange?.(masterParameterType.midiSystem, this.system);
+        this?.onMasterParameterChange?.(masterParameterType.midiSystem, this.system);
     }
     
     /**
@@ -503,16 +489,6 @@ class SpessaSynthProcessor
         this.cachedVoices[bank][program][midiNote][velocity] = voices;
     }
     
-    postReady()
-    {
-        // ensure stbvorbis is fully initialized
-        this.processorInitialized.then(() =>
-        {
-            SpessaSynthInfo("%cSpessaSynth is ready!", consoleColors.recognized);
-            this?.callbacks?.ready?.();
-        });
-    }
-    
     // noinspection JSUnusedGlobalSymbols
     /**
      * Renders float32 audio data to stereo outputs; buffer size of 128 is recommended
@@ -764,14 +740,14 @@ class SpessaSynthProcessor
     }
     
     /**
-     * Calls synth event from the worklet side
+     * Calls synth event
      * @param eventName {EventTypes} the event name
      * @param eventData {EventCallbackData}
      * @this {SpessaSynthProcessor}
      */
     callEvent(eventName, eventData)
     {
-        this?.callbacks?.eventCall?.(eventName, eventData);
+        this?.onEventCall?.(eventName, eventData);
     }
 }
 
@@ -785,7 +761,7 @@ SpessaSynthProcessor.prototype.systemExclusive = systemExclusive;
 
 // channel related
 SpessaSynthProcessor.prototype.stopAllChannels = stopAllChannels;
-SpessaSynthProcessor.prototype.createWorkletChannel = createMidiChannel;
+SpessaSynthProcessor.prototype.createMidiChannel = createMidiChannel;
 SpessaSynthProcessor.prototype.resetAllControllers = resetAllControllers;
 
 // master parameter related
@@ -797,10 +773,9 @@ SpessaSynthProcessor.prototype.setMasterTuning = setMasterTuning;
 
 // program related
 SpessaSynthProcessor.prototype.getPreset = getPreset;
-SpessaSynthProcessor.prototype.reloadSoundFont = reloadSoundFont;
 SpessaSynthProcessor.prototype.clearSoundFont = clearSoundFont;
 SpessaSynthProcessor.prototype.setEmbeddedSoundFont = setEmbeddedSoundFont;
-SpessaSynthProcessor.prototype.sendPresetList = sendPresetList;
+SpessaSynthProcessor.prototype.updatePresetList = updatePresetList;
 
 // snapshot related
 SpessaSynthProcessor.prototype.applySynthesizerSnapshot = applySynthesizerSnapshot;

package/src/synthetizer/audio_engine/snapshot/apply_synthesizer_snapshot.js

@@ -9,6 +9,7 @@ import { SynthesizerSnapshot } from "./synthesizer_snapshot.js";
  */
 export function applySynthesizerSnapshot(snapshot)
 {
+    this._snapshot = snapshot;
     SynthesizerSnapshot.applySnapshot(this, snapshot);
     SpessaSynthInfo("%cFinished applying snapshot!", consoleColors.info);
     this.resetAllControllers();

package/src/synthetizer/audio_engine/snapshot/channel_snapshot.js

@@ -104,13 +104,13 @@ export class ChannelSnapshot
     
     /**
      * Creates a snapshot of a single channel's state in the synthesizer.
-     * @param workletProcessor {SpessaSynthProcessor}
+     * @param spessaSynthProcessor {SpessaSynthProcessor}
      * @param channelNumber {number}
      * @returns {ChannelSnapshot}
      */
-    static getChannelSnapshot(workletProcessor, channelNumber)
+    static getChannelSnapshot(spessaSynthProcessor, channelNumber)
     {
-        const channelObject = workletProcessor.midiAudioChannels[channelNumber];
+        const channelObject = spessaSynthProcessor.midiAudioChannels[channelNumber];
         const channelSnapshot = new ChannelSnapshot();
         // program data
         channelSnapshot.program = channelObject.preset.program;
@@ -142,13 +142,13 @@ export class ChannelSnapshot
     
     /**
      * Applies the snapshot to the specified channel.
-     * @param workletProcessor {SpessaSynthProcessor}
+     * @param spessaSynthProcessor {SpessaSynthProcessor}
      * @param channelNumber {number}
      * @param channelSnapshot {ChannelSnapshot}
      */
-    static applyChannelSnapshot(workletProcessor, channelNumber, channelSnapshot)
+    static applyChannelSnapshot(spessaSynthProcessor, channelNumber, channelSnapshot)
     {
-        const channelObject = workletProcessor.midiAudioChannels[channelNumber];
+        const channelObject = spessaSynthProcessor.midiAudioChannels[channelNumber];
         channelObject.muteChannel(channelSnapshot.isMuted);
         channelObject.setDrums(channelSnapshot.drumChannel);
         

package/src/synthetizer/audio_engine/snapshot/synthesizer_snapshot.js

@@ -53,27 +53,27 @@ export class SynthesizerSnapshot
     
     /**
      * Creates a snapshot of the synthesizer's state.
-     * @param workletProcessor {SpessaSynthProcessor}
+     * @param spessaSynthProcessor {SpessaSynthProcessor}
      * @returns {SynthesizerSnapshot}
      */
-    static createSynthesizerSnapshot(workletProcessor)
+    static createSynthesizerSnapshot(spessaSynthProcessor)
     {
         const snapshot = new SynthesizerSnapshot();
         // channel snapshots
         snapshot.channelSnapshots =
-            workletProcessor.midiAudioChannels.map((_, i) =>
-                ChannelSnapshot.getChannelSnapshot(workletProcessor, i));
+            spessaSynthProcessor.midiAudioChannels.map((_, i) =>
+                ChannelSnapshot.getChannelSnapshot(spessaSynthProcessor, i));
         
         // key mappings
-        snapshot.keyMappings = workletProcessor.keyModifierManager.getMappings();
+        snapshot.keyMappings = spessaSynthProcessor.keyModifierManager.getMappings();
         // pan and volume
-        snapshot.mainVolume = workletProcessor.midiVolume;
-        snapshot.pan = workletProcessor.pan;
+        snapshot.mainVolume = spessaSynthProcessor.midiVolume;
+        snapshot.pan = spessaSynthProcessor.pan;
         
         // others
-        snapshot.system = workletProcessor.system;
-        snapshot.interpolation = workletProcessor.interpolationType;
-        snapshot.transposition = workletProcessor.transposition;
+        snapshot.system = spessaSynthProcessor.system;
+        snapshot.interpolation = spessaSynthProcessor.interpolationType;
+        snapshot.transposition = spessaSynthProcessor.transposition;
         
         // effect config is stored on the main thread, leave it empty
         snapshot.effectsConfig = {};
@@ -83,31 +83,31 @@ export class SynthesizerSnapshot
     
     /**
      * Applies the snapshot to the synthesizer.
-     * @param workletProcessor {SpessaSynthProcessor}
+     * @param spessaSynthProcessor {SpessaSynthProcessor}
      * @param snapshot {SynthesizerSnapshot}
      */
-    static applySnapshot(workletProcessor, snapshot)
+    static applySnapshot(spessaSynthProcessor, snapshot)
     {
         // restore system
-        workletProcessor.setSystem(snapshot.system);
+        spessaSynthProcessor.setSystem(snapshot.system);
         
         // restore pan and volume
-        workletProcessor.setMasterParameter(masterParameterType.mainVolume, snapshot.mainVolume);
-        workletProcessor.setMasterParameter(masterParameterType.masterPan, snapshot.pan);
-        workletProcessor.transposeAllChannels(snapshot.transposition);
-        workletProcessor.interpolationType = snapshot.interpolation;
-        workletProcessor.keyModifierManager.setMappings(snapshot.keyMappings);
+        spessaSynthProcessor.setMasterParameter(masterParameterType.mainVolume, snapshot.mainVolume);
+        spessaSynthProcessor.setMasterParameter(masterParameterType.masterPan, snapshot.pan);
+        spessaSynthProcessor.transposeAllChannels(snapshot.transposition);
+        spessaSynthProcessor.interpolationType = snapshot.interpolation;
+        spessaSynthProcessor.keyModifierManager.setMappings(snapshot.keyMappings);
         
         // add channels if more needed
-        while (workletProcessor.midiAudioChannels.length < snapshot.channelSnapshots.length)
+        while (spessaSynthProcessor.midiAudioChannels.length < snapshot.channelSnapshots.length)
         {
-            workletProcessor.createWorkletChannel();
+            spessaSynthProcessor.createMidiChannel();
         }
         
         // restore channels
         snapshot.channelSnapshots.forEach((channelSnapshot, index) =>
         {
-            ChannelSnapshot.applyChannelSnapshot(workletProcessor, index, channelSnapshot);
+            ChannelSnapshot.applyChannelSnapshot(spessaSynthProcessor, index, channelSnapshot);
         });
         
         SpessaSynthInfo("%cFinished restoring controllers!", consoleColors.info);

package/src/synthetizer/audio_engine/synth_processor_options.js

@@ -0,0 +1,18 @@
+/**
+ * @typedef {Object} SynthProcessorOptions
+ * @property {boolean?} enableEventSystem - if the event system is enabled.
+ * @property {number?} initialTime - initial synth time, in seconds.
+ * @property {boolean?} effectsEnabled - if the processor should route audio to the effect channels.
+ * @property {number?} midiChannels - the default MIDI channel count.
+ */
+
+
+/**
+ * @type {SynthProcessorOptions}
+ */
+export const DEFAULT_SYNTH_OPTIONS = {
+    enableEventSystem: true,
+    initialTime: 0,
+    effectsEnabled: true,
+    midiChannels: 16
+};

package/src/synthetizer/audio_engine/engine_methods/soundfont_management/reload_sound_font.js

@@ -1,28 +0,0 @@
-import { loadSoundFont } from "../../../../soundfont/load_soundfont.js";
-import { SpessaSynthInfo } from "../../../../utils/loggin.js";
-import { consoleColors } from "../../../../utils/other.js";
-
-/**
- * @param buffer {ArrayBuffer}
- * @param isOverride {Boolean}
- * @this {SpessaSynthProcessor}
- */
-export function reloadSoundFont(buffer, isOverride = false)
-{
-    this.clearSoundFont(false, isOverride);
-    if (isOverride)
-    {
-        this.overrideSoundfont = loadSoundFont(buffer);
-    }
-    else
-    {
-        this.soundfontManager.reloadManager(buffer);
-    }
-    this.getDefaultPresets();
-    this.midiAudioChannels.forEach(c =>
-        c.programChange(c.preset.program)
-    );
-    this.postReady();
-    this.sendPresetList();
-    SpessaSynthInfo("%cSpessaSynth is ready!", consoleColors.recognized);
-}