spessasynth_lib 3.15.0 → 3.16.0

package/synthetizer/worklet_system/worklet_methods/worklet_soundfont_manager/worklet_soundfont_manager.js

@@ -0,0 +1,231 @@
+import { SoundFont2 } from '../../../../soundfont/soundfont.js'
+import { SpessaSynthWarn } from '../../../../utils/loggin.js'
+import { WorkletSoundfontManagerMessageType } from './sfman_message.js'
+
+/**
+ * @typedef {Object} SoundFontType
+ * @property {string} id - unique id for the soundfont
+ * @property {SoundFont2} soundfont - the soundfont itself
+ * @property {number} bankOffset - the soundfont's bank offset
+ */
+
+export class WorkletSoundfontManager
+{
+    /**
+     * 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"
+     * @param readyCallback {function} postReady() method from synth
+     */
+    constructor(initialSoundFontBuffer, readyCallback)
+    {
+        /**
+         * @type {Function}
+         */
+        this.ready = readyCallback;
+        this.totalSoundfontOffset = 0;
+        this.reloadManager(initialSoundFontBuffer);
+    }
+
+    _assingSampleOffsets()
+    {
+        let offset = 0;
+        this.soundfontList.forEach(s => {
+            s.soundfont.setSampleIDOffset(offset);
+            offset += s.soundfont.samples.length
+        });
+        this.totalSoundfontOffset = offset;
+    }
+
+    generatePresetList()
+    {
+        this._assingSampleOffsets();
+        /**
+         * <"bank-program", "presetName">
+         * @type {Object<string, string>}
+         */
+        const presetList = {};
+        // gather the presets in reverse and replace if necessary
+        for (let i = this.soundfontList.length - 1; i >= 0; i--)
+        {
+            const font = this.soundfontList[i];
+            for(const p of font.soundfont.presets)
+            {
+                const presetString = `${p.bank + font.bankOffset}-${p.program}`;
+                presetList[presetString] = p.presetName;
+            }
+        }
+
+        /**
+         * @type {{bank: number, presetName: string, program: number}[]}
+         */
+        this.presetList = [];
+        for(const [string, name] of Object.entries(presetList))
+        {
+            const pb = string.split("-");
+            this.presetList.push({
+                presetName: name,
+                program: parseInt(pb[1]),
+                bank: parseInt(pb[0])
+            })
+        }
+    }
+
+    /**
+     * @param type {WorkletSoundfontManagerMessageType}
+     * @param data {any}
+     */
+    handleMessage(type, data)
+    {
+        switch (type)
+        {
+            case WorkletSoundfontManagerMessageType.addNewSoundFont:
+                this.addNewSoundFont(data[0], data[1], data[2]);
+                break;
+
+            case WorkletSoundfontManagerMessageType.reloadSoundFont:
+                this.reloadManager(data);
+                break;
+
+            case WorkletSoundfontManagerMessageType.deleteSoundFont:
+                this.deleteSoundFont(data);
+                break;
+
+            case WorkletSoundfontManagerMessageType.rearrangeSoundFonts:
+                this.rearrangeSoundFonts(data);
+        }
+    }
+
+    /**
+     * Get the final preset list
+     * @returns {{bank: number, presetName: string, program: number}[]}
+     */
+    getPresetList()
+    {
+        return this.presetList;
+    }
+
+    /**
+     * Clears all soundfonts and adds a new one
+     * @param soundFontArrayBuffer {ArrayBuffer}
+     */
+    reloadManager(soundFontArrayBuffer)
+    {
+        const font =  new SoundFont2(soundFontArrayBuffer);
+        /**
+         * All the soundfonts, ordered from the most important to the least.
+         * @type {SoundFontType[]}
+         */
+        this.soundfontList = [];
+        this.soundfontList.push({
+            id: "main",
+            bankOffset: 0,
+            soundfont: font
+        });
+        this.generatePresetList();
+        this.ready();
+    }
+
+    deleteSoundFont(id)
+    {
+        if(this.soundfontList.length === 0)
+        {
+            SpessaSynthWarn("1 soundfont left. Aborting!");
+            return;
+        }
+        const index = this.soundfontList.findIndex(s => s.id === id);
+        if(index === -1)
+        {
+            SpessaSynthWarn(`No soundfont with id of "${id}" found. Aborting!`);
+            return;
+        }
+        delete this.soundfontList[index].soundfont.presets;
+        delete this.soundfontList[index].soundfont.instruments;
+        delete this.soundfontList[index].soundfont.samples;
+        this.soundfontList.splice(index, 1);
+        this.generatePresetList();
+    }
+
+    /**
+     * Adds a new soundfont buffer with a given ID
+     * @param buffer {ArrayBuffer}
+     * @param id {string}
+     * @param bankOffset {number}
+     */
+    addNewSoundFont(buffer, id, bankOffset)
+    {
+        if(this.soundfontList.find(s => s.id === id) !== undefined)
+        {
+            throw new Error("Cannot overwrite the existing soundfont. Use soundfontManager.delete(id) instead.");
+        }
+        this.soundfontList.push({
+            id: id,
+            soundfont: new SoundFont2(buffer),
+            bankOffset: bankOffset
+        });
+        this.generatePresetList();
+        this.ready();
+    }
+
+    /**
+     * Rearranges the soundfonts
+     * @param newList {string[]} the order of soundfonts, a list of strings, first overwrites second
+     */
+    rearrangeSoundFonts(newList)
+    {
+        this.soundfontList.sort((a, b) =>
+            newList.indexOf(a.id) - newList.indexOf(b.id)
+        );
+        this.generatePresetList();
+    }
+
+    /**
+     * Gets a given preset from the soundfont stack
+     * @param bankNumber {number}
+     * @param programNumber {number}
+     * @returns {Preset} the preset
+     */
+    getPreset(bankNumber, programNumber)
+    {
+        if(this.soundfontList.length < 1)
+        {
+            throw new Error("No soundfonts! This should never happen.");
+        }
+        for(const sf of this.soundfontList)
+        {
+            // check for the preset (with given offset)
+            const preset = sf.soundfont.getPresetNoFallback(bankNumber - sf.bankOffset, programNumber);
+            if(preset !== undefined)
+            {
+                return preset;
+            }
+            // if not found, advance to the next soundfont
+        }
+        // if none found, return the first correct preset found
+        if(bankNumber !== 128)
+        {
+            for(const sf of this.soundfontList)
+            {
+                const preset = sf.soundfont.presets.find(p => p.program === programNumber);
+                if(preset)
+                {
+                    return preset;
+                }
+            }
+            // if nothing at all, use the first preset
+            return this.soundfontList[0].soundfont.presets[0];
+        }
+        else
+        {
+            for(const sf of this.soundfontList)
+            {
+                const preset = sf.soundfont.presets.find(p => p.bank === 128);
+                if(preset)
+                {
+                    return preset;
+                }
+            }
+            // if nothing at all, use the first preset
+            return this.soundfontList[0].soundfont.presets[0];
+        }
+    }
+}

package/synthetizer/worklet_system/worklet_processor.js

@@ -1,6 +1,6 @@
 import { WORKLET_PROCESSOR_NAME } from '../synthetizer.js'
 import { consoleColors } from '../../utils/other.js'
-import { SpessaSynthProcessor } from './combine_class.js'
+import { SpessaSynthProcessor } from './main_processor.js'
 import { SpessaSynthInfo } from '../../utils/loggin.js'
 
 

package/synthetizer/worklet_system/worklet_utilities/worklet_processor_channel.js

@@ -109,11 +109,11 @@ export const dataEntryStates = {
 
 
 export const customControllers = {
-    channelTuning: 0, // cents, RPN for fine tuning
-    channelTransposeFine: 1, // cents, only the decimal tuning, (e.g. transpose is 4.5, then shift by 4 keys + tune by 50 cents)
-    modulationMultiplier: 2, // cents, set by moduldation depth RPN
-    masterTuning: 3, // cents, set by system exclusive
-    channelTuningSemitones: 4, // semitones, for RPN coarse tuning
+    channelTuning: 0,           // cents, RPN for fine tuning
+    channelTransposeFine: 1,    // cents, only the decimal tuning, (e.g. transpose is 4.5, then shift by 4 keys + tune by 50 cents)
+    modulationMultiplier: 2,    // cents, set by moduldation depth RPN
+    masterTuning: 3,            // cents, set by system exclusive
+    channelTuningSemitones: 4,  // semitones, for RPN coarse tuning
 }
 export const CUSTOM_CONTROLLER_TABLE_SIZE = Object.keys(customControllers).length;
 export const customResetArray = new Float32Array(CUSTOM_CONTROLLER_TABLE_SIZE);

package/synthetizer/worklet_system/worklet_utilities/worklet_voice.js

@@ -126,7 +126,6 @@ function deepClone(obj) {
  * @param sampleRate {number}
  * @param sampleDumpCallback {function({channel: number, sampleID: number, sampleData: Float32Array})}
  * @param cachedVoices {WorkletVoice[][][]} first is midi note, second is velocity. output is an array of WorkletVoices
- * @param sampleIDOffset {number}
  * @param debug {boolean}
  * @returns {WorkletVoice[]}
  */
@@ -138,7 +137,6 @@ export function getWorkletVoices(channel,
                                  sampleRate,
                                  sampleDumpCallback,
                                  cachedVoices,
-                                 sampleIDOffset,
                                  debug=false)
 {
     /**
@@ -161,7 +159,7 @@ export function getWorkletVoices(channel,
          */
         workletVoices = preset.getSamplesAndGenerators(midiNote, velocity).reduce((voices, sampleAndGenerators) => {
             // dump the sample if haven't already
-            const sampleID = sampleAndGenerators.sampleID + sampleIDOffset;
+            const sampleID = sampleAndGenerators.sampleID + preset.sampleIDOffset;
             if (globalDumpedSamplesList[sampleID] !== true)
             {
                 dumpSample(channel, sampleAndGenerators.sample, sampleID, sampleDumpCallback);

package/utils/buffer_to_wav.js

@@ -6,7 +6,7 @@
  * @property {string|undefined} genre - the song's genre
  */
 
-import { combineArrays } from './indexed_array.js'
+import { combineArrays, IndexedByteArray } from './indexed_array.js'
 import { getStringBytes } from './byte_functions/string.js'
 import { writeRIFFOddSize } from '../soundfont/read/riff_chunk.js'
 
@@ -20,17 +20,54 @@ import { writeRIFFOddSize } from '../soundfont/read/riff_chunk.js'
  */
 export function audioBufferToWav(audioBuffer, normalizeAudio = true, channelOffset = 0, metadata = {})
 {
-    // this code currently doesn't add any metadata
     const channel1Data = audioBuffer.getChannelData(channelOffset);
     const channel2Data = audioBuffer.getChannelData(channelOffset + 1);
     const length = channel1Data.length;
 
     const bytesPerSample = 2; // 16-bit PCM
 
+    // prepare INFO chunk
+    let infoChunk = new IndexedByteArray(0);
+    const infoOn = Object.keys(metadata).length > 0;
+    // INFO chunk
+    if(infoOn)
+    {
+        const encoder = new TextEncoder();
+        const infoChunks = [
+            getStringBytes("INFO"),
+            writeRIFFOddSize("ICMT", encoder.encode("Created with SpessaSynth"))
+        ];
+        if(metadata.artist)
+        {
+            infoChunks.push(
+                writeRIFFOddSize("IART", encoder.encode(metadata.artist))
+            );
+        }
+        if(metadata.album)
+        {
+            infoChunks.push(
+                writeRIFFOddSize("IPRD", encoder.encode(metadata.album))
+            );
+        }
+        if(metadata.genre)
+        {
+            infoChunks.push(
+                writeRIFFOddSize("IGNR", encoder.encode(metadata.genre))
+            );
+        }
+        if(metadata.title)
+        {
+            infoChunks.push(
+                writeRIFFOddSize("INAM", encoder.encode(metadata.title))
+            );
+        }
+        infoChunk = writeRIFFOddSize("LIST", combineArrays(infoChunks));
+    }
+
     // Prepare the header
     const headerSize = 44;
     const dataSize = length * 2 * bytesPerSample; // 2 channels, 16-bit per channel
-    const fileSize = headerSize + dataSize - 8; // total file size minus the first 8 bytes
+    const fileSize = headerSize + dataSize + infoChunk.length - 8; // total file size minus the first 8 bytes
     const header = new Uint8Array(headerSize);
 
     // 'RIFF'
@@ -65,46 +102,13 @@ export function audioBufferToWav(audioBuffer, normalizeAudio = true, channelOffs
 
     let wavData;
     let offset = headerSize;
-    let infoChunk = undefined;
-    // INFO chunk
-    if(Object.keys(metadata).length > 0)
+    if(infoOn)
     {
-        const encoder = new TextEncoder();
-        const infoChunks = [
-            getStringBytes("INFO"),
-            writeRIFFOddSize("ICMT", encoder.encode("Created with SpessaSynth"))
-        ];
-        if(metadata.artist)
-        {
-            infoChunks.push(
-                writeRIFFOddSize("IART", encoder.encode(metadata.artist))
-            );
-        }
-        if(metadata.album)
-        {
-            infoChunks.push(
-                writeRIFFOddSize("IPRD", encoder.encode(metadata.album))
-            );
-        }
-        if(metadata.genre)
-        {
-            infoChunks.push(
-                writeRIFFOddSize("IGNR", encoder.encode(metadata.genre))
-            );
-        }
-        if(metadata.title)
-        {
-            infoChunks.push(
-                writeRIFFOddSize("INAM", encoder.encode(metadata.title))
-            );
-        }
-        infoChunk = writeRIFFOddSize("LIST", combineArrays(infoChunks));
         wavData = new Uint8Array(headerSize + dataSize + infoChunk.length);
     }
     else
     {
         wavData = new Uint8Array(headerSize + dataSize);
-
     }
     wavData.set(header, 0);
 
@@ -150,7 +154,7 @@ export function audioBufferToWav(audioBuffer, normalizeAudio = true, channelOffs
         wavData[offset++] = (sample2 >> 8) & 0xff;
     }
 
-    if(infoChunk)
+    if(infoOn)
     {
         wavData.set(infoChunk, offset);
     }

package/synthetizer/worklet_system/combine_class.js

@@ -1,104 +0,0 @@
-import { SpessaSynthProcessor } from './main_processor.js'
-import { releaseVoice, renderVoice, voiceKilling } from './worklet_methods/voice_control.js'
-import { handleMessage } from './message_protocol/handle_message.js'
-import { callEvent, post, sendChannelProperties } from './message_protocol/message_sending.js'
-import { systemExclusive } from './worklet_methods/system_exclusive.js'
-import { noteOn } from './worklet_methods/note_on.js'
-import { killNote, noteOff, stopAll, stopAllChannels } from './worklet_methods/note_off.js'
-import {
-    channelPressure, pitchWheel,
-    polyPressure, setChannelTuning, setChannelTuningSemitones, setMasterTuning, setModulationDepth, setOctaveTuning,
-    transposeAllChannels,
-    transposeChannel,
-} from './worklet_methods/tuning_control.js'
-import {
-    controllerChange,
-    muteChannel,
-    setMasterGain,
-    setMasterPan,
-    setMIDIVolume,
-} from './worklet_methods/controller_control.js'
-import { disableAndLockVibrato, setVibrato } from './worklet_methods/vibrato_control.js'
-import { dataEntryCoarse, dataEntryFine } from './worklet_methods/data_entry.js'
-import { createWorkletChannel } from './worklet_utilities/worklet_processor_channel.js'
-import { resetAllControllers, resetControllers, resetParameters } from './worklet_methods/reset_controllers.js'
-import {
-    clearSoundFont,
-    getPreset,
-    programChange,
-    reloadSoundFont, sampleDump, sendPresetList,
-    setDrums,
-    setPreset,
-} from './worklet_methods/program_control.js'
-import { applySynthesizerSnapshot, sendSynthesizerSnapshot } from './worklet_methods/snapshot.js'
-
-// include other methods
-// voice related
-SpessaSynthProcessor.prototype.renderVoice = renderVoice;
-SpessaSynthProcessor.prototype.releaseVoice = releaseVoice;
-SpessaSynthProcessor.prototype.voiceKilling = voiceKilling;
-
-// message port related
-SpessaSynthProcessor.prototype.handleMessage = handleMessage;
-SpessaSynthProcessor.prototype.post = post;
-SpessaSynthProcessor.prototype.sendChannelProperties = sendChannelProperties;
-SpessaSynthProcessor.prototype.callEvent = callEvent;
-
-// system exlcusive related
-SpessaSynthProcessor.prototype.systemExclusive = systemExclusive;
-
-// note messages related
-SpessaSynthProcessor.prototype.noteOn = noteOn;
-SpessaSynthProcessor.prototype.noteOff = noteOff;
-SpessaSynthProcessor.prototype.polyPressure = polyPressure;
-SpessaSynthProcessor.prototype.killNote = killNote;
-SpessaSynthProcessor.prototype.stopAll = stopAll;
-SpessaSynthProcessor.prototype.stopAllChannels = stopAllChannels;
-SpessaSynthProcessor.prototype.muteChannel = muteChannel;
-
-// custom vibrato related
-SpessaSynthProcessor.prototype.setVibrato = setVibrato;
-SpessaSynthProcessor.prototype.disableAndLockVibrato = disableAndLockVibrato;
-
-// data entry related
-SpessaSynthProcessor.prototype.dataEntryCoarse = dataEntryCoarse;
-SpessaSynthProcessor.prototype.dataEntryFine = dataEntryFine;
-
-// channel related
-SpessaSynthProcessor.prototype.createWorkletChannel = createWorkletChannel;
-SpessaSynthProcessor.prototype.controllerChange = controllerChange;
-SpessaSynthProcessor.prototype.channelPressure = channelPressure;
-SpessaSynthProcessor.prototype.resetAllControllers = resetAllControllers;
-SpessaSynthProcessor.prototype.resetControllers = resetControllers;
-SpessaSynthProcessor.prototype.resetParameters = resetParameters;
-
-// master parameter related
-SpessaSynthProcessor.prototype.setMasterGain = setMasterGain;
-SpessaSynthProcessor.prototype.setMasterPan = setMasterPan;
-SpessaSynthProcessor.prototype.setMIDIVolume = setMIDIVolume;
-
-// tuning related
-SpessaSynthProcessor.prototype.transposeAllChannels = transposeAllChannels;
-SpessaSynthProcessor.prototype.transposeChannel = transposeChannel;
-SpessaSynthProcessor.prototype.setChannelTuning = setChannelTuning;
-SpessaSynthProcessor.prototype.setChannelTuningSemitones = setChannelTuningSemitones;
-SpessaSynthProcessor.prototype.setMasterTuning = setMasterTuning;
-SpessaSynthProcessor.prototype.setModulationDepth = setModulationDepth;
-SpessaSynthProcessor.prototype.pitchWheel = pitchWheel;
-SpessaSynthProcessor.prototype.setOctaveTuning = setOctaveTuning;
-
-// program related
-SpessaSynthProcessor.prototype.programChange = programChange;
-SpessaSynthProcessor.prototype.getPreset = getPreset;
-SpessaSynthProcessor.prototype.setPreset = setPreset;
-SpessaSynthProcessor.prototype.setDrums = setDrums;
-SpessaSynthProcessor.prototype.reloadSoundFont = reloadSoundFont;
-SpessaSynthProcessor.prototype.clearSoundFont = clearSoundFont;
-SpessaSynthProcessor.prototype.sampleDump = sampleDump;
-SpessaSynthProcessor.prototype.sendPresetList = sendPresetList;
-
-// snapshot related
-SpessaSynthProcessor.prototype.sendSynthesizerSnapshot = sendSynthesizerSnapshot;
-SpessaSynthProcessor.prototype.applySynthesizerSnapshot = applySynthesizerSnapshot;
-
-export {SpessaSynthProcessor}