spessasynth_lib 3.25.23 → 3.26.1

package/soundfont/basic_soundfont/basic_instrument.js

@@ -1,77 +0,0 @@
-export class BasicInstrument
-{
-    /**
-     * The instrument's name
-     * @type {string}
-     */
-    instrumentName = "";
-    
-    /**
-     * The instrument's zones
-     * @type {BasicInstrumentZone[]}
-     */
-    instrumentZones = [];
-    
-    /**
-     * Instrument's use count, used for trimming
-     * @type {number}
-     * @private
-     */
-    _useCount = 0;
-    
-    /**
-     * @returns {number}
-     */
-    get useCount()
-    {
-        return this._useCount;
-    }
-    
-    addUseCount()
-    {
-        this._useCount++;
-        this.instrumentZones.forEach(z => z.useCount++);
-    }
-    
-    removeUseCount()
-    {
-        this._useCount--;
-        for (let i = 0; i < this.instrumentZones.length; i++)
-        {
-            if (this.safeDeleteZone(i))
-            {
-                i--;
-            }
-        }
-    }
-    
-    deleteInstrument()
-    {
-        this.instrumentZones.forEach(z => z.deleteZone());
-        this.instrumentZones.length = 0;
-    }
-    
-    /**
-     * @param index {number}
-     * @returns {boolean} is the zone has been deleted
-     */
-    safeDeleteZone(index)
-    {
-        this.instrumentZones[index].useCount--;
-        if (this.instrumentZones[index].useCount < 1)
-        {
-            this.deleteZone(index);
-            return true;
-        }
-        return false;
-    }
-    
-    /**
-     * @param index {number}
-     */
-    deleteZone(index)
-    {
-        this.instrumentZones[index].deleteZone();
-        this.instrumentZones.splice(index, 1);
-    }
-}

package/soundfont/basic_soundfont/basic_preset.js

@@ -1,336 +0,0 @@
-/**
- * @typedef {{
- *  instrumentGenerators: Generator[],
- *  presetGenerators: Generator[],
- *  modulators: Modulator[],
- *  sample: BasicSample,
- *  sampleID: number,
- * }} SampleAndGenerators
- */
-import { generatorTypes } from "./generator.js";
-import { Modulator } from "./modulator.js";
-import { isXGDrums } from "../../utils/xg_hacks.js";
-
-export class BasicPreset
-{
-    /**
-     * The parent soundbank instance
-     * Currently used for determining default modulators and XG status
-     * @type {BasicSoundBank}
-     */
-    parentSoundBank;
-    
-    /**
-     * The preset's name
-     * @type {string}
-     */
-    presetName = "";
-    
-    /**
-     * The preset's MIDI program number
-     * @type {number}
-     */
-    program = 0;
-    
-    /**
-     * The preset's MIDI bank number
-     * @type {number}
-     */
-    bank = 0;
-    
-    /**
-     * The preset's zones
-     * @type {BasicPresetZone[]}
-     */
-    presetZones = [];
-    
-    /**
-     * Stores already found getSamplesAndGenerators for reuse
-     * @type {SampleAndGenerators[][][]}
-     */
-    foundSamplesAndGenerators = [];
-    
-    /**
-     * unused metadata
-     * @type {number}
-     */
-    library = 0;
-    /**
-     * unused metadata
-     * @type {number}
-     */
-    genre = 0;
-    /**
-     * unused metadata
-     * @type {number}
-     */
-    morphology = 0;
-    
-    /**
-     * Creates a new preset representation
-     * @param parentSoundBank {BasicSoundBank}
-     */
-    constructor(parentSoundBank)
-    {
-        this.parentSoundBank = parentSoundBank;
-        for (let i = 0; i < 128; i++)
-        {
-            this.foundSamplesAndGenerators[i] = [];
-        }
-    }
-    
-    /**
-     * @param allowXG {boolean}
-     * @param allowSFX {boolean}
-     * @returns {boolean}
-     */
-    isDrumPreset(allowXG, allowSFX = false)
-    {
-        const xg = allowXG && this.parentSoundBank.isXGBank;
-        // sfx is not cool
-        return this.bank === 128 || (
-            xg &&
-            (isXGDrums(this.bank) && (this.bank !== 126 || allowSFX))
-        );
-    }
-    
-    deletePreset()
-    {
-        this.presetZones.forEach(z => z.deleteZone());
-        this.presetZones.length = 0;
-    }
-    
-    /**
-     * @param index {number}
-     */
-    deleteZone(index)
-    {
-        this.presetZones[index].deleteZone();
-        this.presetZones.splice(index, 1);
-    }
-    
-    // noinspection JSUnusedGlobalSymbols
-    /**
-     * Preloads all samples (async)
-     */
-    preload(keyMin, keyMax)
-    {
-        for (let key = keyMin; key < keyMax + 1; key++)
-        {
-            for (let velocity = 0; velocity < 128; velocity++)
-            {
-                this.getSamplesAndGenerators(key, velocity).forEach(samandgen =>
-                {
-                    if (!samandgen.sample.isSampleLoaded)
-                    {
-                        samandgen.sample.getAudioData();
-                    }
-                });
-            }
-        }
-    }
-    
-    /**
-     * Preloads a specific key/velocity combo
-     * @param key {number}
-     * @param velocity {number}
-     */
-    preloadSpecific(key, velocity)
-    {
-        this.getSamplesAndGenerators(key, velocity).forEach(samandgen =>
-        {
-            if (!samandgen.sample.isSampleLoaded)
-            {
-                samandgen.sample.getAudioData();
-            }
-        });
-    }
-    
-    /**
-     * Returns generatorTranslator and generators for given note
-     * @param midiNote {number}
-     * @param velocity {number}
-     * @returns {SampleAndGenerators[]}
-     */
-    getSamplesAndGenerators(midiNote, velocity)
-    {
-        const memorized = this.foundSamplesAndGenerators[midiNote][velocity];
-        if (memorized)
-        {
-            return memorized;
-        }
-        
-        if (this.presetZones.length < 1)
-        {
-            return [];
-        }
-        
-        /**
-         * @param range {SoundFontRange}
-         * @param number {number}
-         * @returns {boolean}
-         */
-        function isInRange(range, number)
-        {
-            return number >= range.min && number <= range.max;
-        }
-        
-        /**
-         * @param main {Generator[]}
-         * @param adder {Generator[]}
-         */
-        function addUnique(main, adder)
-        {
-            main.push(...adder.filter(g => !main.find(mg => mg.generatorType === g.generatorType)));
-        }
-        
-        /**
-         * @param main {Modulator[]}
-         * @param adder {Modulator[]}
-         */
-        function addUniqueMods(main, adder)
-        {
-            main.push(...adder.filter(m => !main.find(mm => Modulator.isIdentical(m, mm))));
-        }
-        
-        /**
-         * @type {SampleAndGenerators[]}
-         */
-        let parsedGeneratorsAndSamples = [];
-        
-        /**
-         * global zone is always first, so it or nothing
-         * @type {Generator[]}
-         */
-        let globalPresetGenerators = this.presetZones[0].isGlobal ? [...this.presetZones[0].generators] : [];
-        
-        /**
-         * @type {Modulator[]}
-         */
-        let globalPresetModulators = this.presetZones[0].isGlobal ? [...this.presetZones[0].modulators] : [];
-        const globalKeyRange = this.presetZones[0].isGlobal ? this.presetZones[0].keyRange : { min: 0, max: 127 };
-        const globalVelRange = this.presetZones[0].isGlobal ? this.presetZones[0].velRange : { min: 0, max: 127 };
-        
-        // find the preset zones in range
-        let presetZonesInRange = this.presetZones.filter(currentZone =>
-            (
-                isInRange(
-                    currentZone.hasKeyRange ? currentZone.keyRange : globalKeyRange,
-                    midiNote
-                )
-                &&
-                isInRange(
-                    currentZone.hasVelRange ? currentZone.velRange : globalVelRange,
-                    velocity
-                )
-            ) && !currentZone.isGlobal);
-        
-        presetZonesInRange.forEach(zone =>
-        {
-            // the global zone is already taken into account earlier
-            if (zone.instrument.instrumentZones.length < 1)
-            {
-                return;
-            }
-            let presetGenerators = zone.generators;
-            let presetModulators = zone.modulators;
-            const firstZone = zone.instrument.instrumentZones[0];
-            /**
-             * global zone is always first, so it or nothing
-             * @type {Generator[]}
-             */
-            let globalInstrumentGenerators = firstZone.isGlobal ? [...firstZone.generators] : [];
-            let globalInstrumentModulators = firstZone.isGlobal ? [...firstZone.modulators] : [];
-            const globalKeyRange = firstZone.isGlobal ? firstZone.keyRange : { min: 0, max: 127 };
-            const globalVelRange = firstZone.isGlobal ? firstZone.velRange : { min: 0, max: 127 };
-            
-            
-            let instrumentZonesInRange = zone.instrument.instrumentZones
-                .filter(currentZone =>
-                    (
-                        isInRange(
-                            currentZone.hasKeyRange ? currentZone.keyRange : globalKeyRange,
-                            midiNote
-                        )
-                        &&
-                        isInRange(
-                            currentZone.hasVelRange ? currentZone.velRange : globalVelRange,
-                            velocity
-                        )
-                    ) && !currentZone.isGlobal
-                );
-            
-            instrumentZonesInRange.forEach(instrumentZone =>
-            {
-                let instrumentGenerators = [...instrumentZone.generators];
-                let instrumentModulators = [...instrumentZone.modulators];
-                
-                addUnique(
-                    presetGenerators,
-                    globalPresetGenerators
-                );
-                // add the unique global preset generators (local replace global(
-                
-                
-                // add the unique global instrument generators (local replace global)
-                addUnique(
-                    instrumentGenerators,
-                    globalInstrumentGenerators
-                );
-                
-                addUniqueMods(
-                    presetModulators,
-                    globalPresetModulators
-                );
-                addUniqueMods(
-                    instrumentModulators,
-                    globalInstrumentModulators
-                );
-                
-                // default mods
-                addUniqueMods(
-                    instrumentModulators,
-                    this.parentSoundBank.defaultModulators
-                );
-                
-                /**
-                 * sum preset modulators to instruments (amount) sf spec page 54
-                 * @type {Modulator[]}
-                 */
-                const finalModulatorList = [...instrumentModulators];
-                for (let i = 0; i < presetModulators.length; i++)
-                {
-                    let mod = presetModulators[i];
-                    const identicalInstrumentModulator = finalModulatorList.findIndex(
-                        m => Modulator.isIdentical(mod, m));
-                    if (identicalInstrumentModulator !== -1)
-                    {
-                        // sum the amounts
-                        // (this makes a new modulator because otherwise it would overwrite the one in the soundfont!
-                        finalModulatorList[identicalInstrumentModulator] = finalModulatorList[identicalInstrumentModulator].sumTransform(
-                            mod);
-                    }
-                    else
-                    {
-                        finalModulatorList.push(mod);
-                    }
-                }
-                
-                
-                // combine both generators and add to the final result
-                parsedGeneratorsAndSamples.push({
-                    instrumentGenerators: instrumentGenerators,
-                    presetGenerators: presetGenerators,
-                    modulators: finalModulatorList,
-                    sample: instrumentZone.sample,
-                    sampleID: instrumentZone.generators.find(
-                        g => g.generatorType === generatorTypes.sampleID).generatorValue
-                });
-            });
-        });
-        
-        // save and return
-        this.foundSamplesAndGenerators[midiNote][velocity] = parsedGeneratorsAndSamples;
-        return parsedGeneratorsAndSamples;
-    }
-}

package/soundfont/basic_soundfont/basic_sample.js

@@ -1,197 +0,0 @@
-/**
- * samples.js
- * purpose: parses soundfont samples, resamples if needed.
- * loads sample data, handles async loading of sf3 compressed samples
- */
-import { SpessaSynthWarn } from "../../utils/loggin.js";
-
-// should be reasonable for most cases
-const RESAMPLE_RATE = 48000;
-
-export class BasicSample
-{
-    
-    /**
-     * The sample's name
-     * @type {string}
-     */
-    sampleName;
-    
-    /**
-     * Sample rate in Hz
-     * @type {number}
-     */
-    sampleRate;
-    
-    /**
-     * Original pitch of the sample as a MIDI note number
-     * @type {number}
-     */
-    samplePitch;
-    
-    /**
-     * Pitch correction, in cents. Can be negative
-     * @type {number}
-     */
-    samplePitchCorrection;
-    
-    /**
-     * Sample link, currently unused here
-     * @type {number}
-     */
-    sampleLink;
-    
-    /**
-     * Type of the sample, currently only used for SF3
-     * @type {number}
-     */
-    sampleType;
-    
-    /**
-     * Relative to the start of the sample in sample points
-     * @type {number}
-     */
-    sampleLoopStartIndex;
-    
-    /**
-     * Relative to the start of the sample in sample points
-     * @type {number}
-     */
-    sampleLoopEndIndex;
-    
-    /**
-     * Indicates if the sample is compressed
-     * @type {boolean}
-     */
-    isCompressed;
-    
-    /**
-     * The compressed sample data if it was compressed by spessasynth
-     * @type {Uint8Array}
-     */
-    compressedData = undefined;
-    
-    /**
-     * The sample's use count
-     * @type {number}
-     */
-    useCount = 0;
-    
-    /**
-     * The sample's audio data
-     * @type {Float32Array}
-     */
-    sampleData = undefined;
-    
-    /**
-     * The basic representation of a soundfont sample
-     * @param sampleName {string} The sample's name
-     * @param sampleRate {number} The sample's rate in Hz
-     * @param samplePitch {number} The sample's pitch as a MIDI note number
-     * @param samplePitchCorrection {number} The sample's pitch correction in cents
-     * @param sampleLink {number} The sample's link, currently unused
-     * @param sampleType {number} The sample's type, an enum
-     * @param loopStart {number} The sample's loop start relative to the sample start in sample points
-     * @param loopEnd {number} The sample's loop end relative to the sample start in sample points
-     */
-    constructor(
-        sampleName,
-        sampleRate,
-        samplePitch,
-        samplePitchCorrection,
-        sampleLink,
-        sampleType,
-        loopStart,
-        loopEnd
-    )
-    {
-        this.sampleName = sampleName;
-        this.sampleRate = sampleRate;
-        this.samplePitch = samplePitch;
-        this.samplePitchCorrection = samplePitchCorrection;
-        this.sampleLink = sampleLink;
-        this.sampleType = sampleType;
-        this.sampleLoopStartIndex = loopStart;
-        this.sampleLoopEndIndex = loopEnd;
-        // https://github.com/FluidSynth/fluidsynth/wiki/SoundFont3Format
-        this.isCompressed = (sampleType & 0x10) > 0;
-    }
-    
-    
-    /**
-     * @returns {Uint8Array|IndexedByteArray}
-     */
-    getRawData()
-    {
-        const uint8 = new Uint8Array(this.sampleData.length * 2);
-        for (let i = 0; i < this.sampleData.length; i++)
-        {
-            const sample = Math.floor(this.sampleData[i] * 32768);
-            uint8[i * 2] = sample & 0xFF; // lower byte
-            uint8[i * 2 + 1] = (sample >> 8) & 0xFF; // upper byte
-        }
-        return uint8;
-    }
-    
-    resampleData(newSampleRate)
-    {
-        let audioData = this.getAudioData();
-        const ratio = newSampleRate / this.sampleRate;
-        const resampled = new Float32Array(Math.floor(audioData.length * ratio));
-        for (let i = 0; i < resampled.length; i++)
-        {
-            resampled[i] = audioData[Math.floor(i * (1 / ratio))];
-        }
-        audioData = resampled;
-        this.sampleRate = newSampleRate;
-        // adjust loop points
-        this.sampleLoopStartIndex = Math.floor(this.sampleLoopStartIndex * ratio);
-        this.sampleLoopEndIndex = Math.floor(this.sampleLoopEndIndex * ratio);
-        this.sampleData = audioData;
-    }
-    
-    /**
-     * @param quality {number}
-     * @param encodeVorbis {EncodeVorbisFunction}
-     */
-    compressSample(quality, encodeVorbis)
-    {
-        // no need to compress
-        if (this.isCompressed)
-        {
-            return;
-        }
-        // compress, always mono!
-        try
-        {
-            // if the sample rate is too low or too high, resample
-            let audioData = this.getAudioData();
-            if (this.sampleRate < 8000 || this.sampleRate > 96000)
-            {
-                this.resampleData(RESAMPLE_RATE);
-                audioData = this.getAudioData();
-            }
-            this.compressedData = encodeVorbis([audioData], 1, this.sampleRate, quality);
-            // flag as compressed
-            this.sampleType |= 0x10;
-            this.isCompressed = true;
-        }
-        catch (e)
-        {
-            SpessaSynthWarn(`Failed to compress ${this.sampleName}. Leaving as uncompressed!`);
-            this.isCompressed = false;
-            this.compressedData = undefined;
-            // flag as uncompressed
-            this.sampleType &= 0xEF;
-        }
-        
-    }
-    
-    /**
-     * @returns {Float32Array}
-     */
-    getAudioData()
-    {
-        return this.sampleData;
-    }
-}