spessasynth_core 3.27.8 → 4.0.0

package/src/soundfont/basic_soundfont/basic_instrument.js

@@ -1,115 +0,0 @@
-import { BasicGlobalZone } from "./basic_global_zone.js";
-import { BasicInstrumentZone } from "./basic_instrument_zone.js";
-import { SpessaSynthWarn } from "../../utils/loggin.js";
-
-export class BasicInstrument
-{
-    /**
-     * The instrument's name
-     * @type {string}
-     */
-    instrumentName = "";
-    
-    /**
-     * The instrument's zones
-     * @type {BasicInstrumentZone[]}
-     * @readonly
-     */
-    instrumentZones = [];
-    
-    /**
-     * Instrument's global zone
-     * @type {BasicGlobalZone}
-     */
-    globalZone = new BasicGlobalZone();
-    
-    /**
-     * Instrument's linked presets (the presets that use it)
-     * note that duplicates are allowed since one preset can use the same instrument multople times
-     * @type {BasicPreset[]}
-     */
-    linkedPresets = [];
-    
-    /**
-     * @returns {number}
-     */
-    get useCount()
-    {
-        return this.linkedPresets.length;
-    }
-    
-    /**
-     * @returns {BasicInstrumentZone}
-     */
-    createZone()
-    {
-        const zone = new BasicInstrumentZone(this);
-        this.instrumentZones.push(zone);
-        return zone;
-    }
-    
-    /**
-     * @param preset {BasicPreset}
-     */
-    linkTo(preset)
-    {
-        this.linkedPresets.push(preset);
-        this.instrumentZones.forEach(z => z.useCount++);
-    }
-    
-    /**
-     * @param preset {BasicPreset}
-     */
-    unlinkFrom(preset)
-    {
-        const index = this.linkedPresets.indexOf(preset);
-        if (index < 0)
-        {
-            SpessaSynthWarn(`Cannot unlink ${preset.presetName} from ${this.instrumentName}: not linked.`);
-            return;
-        }
-        this.linkedPresets.splice(index, 1);
-        this.instrumentZones.forEach(z => z.useCount--);
-    }
-    
-    deleteUnusedZones()
-    {
-        this.instrumentZones = this.instrumentZones.filter(z =>
-        {
-            const stays = z.useCount > 0;
-            if (!stays)
-            {
-                z.deleteZone();
-            }
-            return stays;
-        });
-    }
-    
-    // unlinks everything from this instrument
-    deleteInstrument()
-    {
-        if (this.useCount > 0)
-        {
-            throw new Error(`Cannot delete an instrument that is used by: ${this.linkedPresets.map(p => p.presetName)}.`);
-        }
-        this.instrumentZones.forEach(z => z.deleteZone());
-    }
-    
-    /**
-     * @param index {number}
-     * @param force {boolean} ignore use count
-     * @returns {boolean} if deleted
-     */
-    deleteZone(index, force = false)
-    {
-        const zone = this.instrumentZones[index];
-        zone.useCount -= 1;
-        if (zone.useCount < 1 || force)
-        {
-            zone.deleteZone();
-            this.instrumentZones.splice(index, 1);
-            return true;
-        }
-        return false;
-    }
-}

package/src/soundfont/basic_soundfont/basic_instrument_zone.js

@@ -1,45 +0,0 @@
-import { BasicZone } from "./basic_zone.js";
-
-export class BasicInstrumentZone extends BasicZone
-{
-    /**
-     * The parent instrument.
-     * @type {BasicInstrument}
-     */
-    parentInstrument;
-    
-    /**
-     * Zone's sample.
-     * @type {BasicSample}
-     */
-    sample;
-    /**
-     * For tracking on the individual zone level, since multiple presets can refer to the same instrument.
-     * @type {number}
-     */
-    useCount;
-    
-    /**
-     * @param instrument {BasicInstrument}
-     */
-    constructor(instrument)
-    {
-        super();
-        this.parentInstrument = instrument;
-        this.useCount = instrument.useCount;
-    }
-    
-    /**
-     * @param sample {BasicSample}
-     */
-    setSample(sample)
-    {
-        this.sample = sample;
-        sample.linkTo(this.parentInstrument);
-    }
-    
-    deleteZone()
-    {
-        this.sample.unlinkFrom(this.parentInstrument);
-    }
-}

package/src/soundfont/basic_soundfont/basic_preset.js

@@ -1,313 +0,0 @@
-/**
- * @typedef {{
- *  instrumentGenerators: Generator[],
- *  presetGenerators: Generator[],
- *  modulators: Modulator[],
- *  sample: BasicSample,
- * }} SampleAndGenerators
- */
-import { Modulator } from "./modulator.js";
-import { isXGDrums } from "../../utils/xg_hacks.js";
-
-import { BasicGlobalZone } from "./basic_global_zone.js";
-import { BasicPresetZone } from "./basic_preset_zone.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 = [];
-    
-    /**
-     * Preset's global zone
-     * @type {BasicGlobalZone}
-     */
-    globalZone = new BasicGlobalZone();
-    
-    /**
-     * 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;
-    }
-    
-    /**
-     * @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))
-        );
-    }
-    
-    // unlinks everything from this preset
-    deletePreset()
-    {
-        this.presetZones.forEach(z => z.deleteZone());
-    }
-    
-    /**
-     * @param index {number}
-     */
-    deleteZone(index)
-    {
-        this.presetZones[index].deleteZone();
-        this.presetZones.splice(index, 1);
-    }
-    
-    /**
-     * @returns {BasicPresetZone}
-     */
-    createZone()
-    {
-        const z = new BasicPresetZone(this);
-        this.presetZones.push(z);
-        return z;
-    }
-    
-    // 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 =>
-                {
-                    samandgen.sample.getAudioData();
-                });
-            }
-        }
-    }
-    
-    /**
-     * Returns samples and generators for given note
-     * @param midiNote {number}
-     * @param velocity {number}
-     * @returns {SampleAndGenerators[]}
-     */
-    getSamplesAndGenerators(midiNote, velocity)
-    {
-        
-        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.globalZone.generators];
-        
-        /**
-         * @type {Modulator[]}
-         */
-        let globalPresetModulators = [...this.globalZone.modulators];
-        const globalKeyRange = this.globalZone.keyRange;
-        const globalVelRange = this.globalZone.velRange;
-        
-        // 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
-            )
-        );
-        
-        presetZonesInRange.forEach(presetZone =>
-        {
-            const instrument = presetZone.instrument;
-            // the global zone is already taken into account earlier
-            if (instrument.instrumentZones.length < 1)
-            {
-                return;
-            }
-            let presetGenerators = presetZone.generators;
-            let presetModulators = presetZone.modulators;
-            /**
-             * global zone is always first, so it or nothing
-             * @type {Generator[]}
-             */
-            let globalInstrumentGenerators = [...instrument.globalZone.generators];
-            let globalInstrumentModulators = [...instrument.globalZone.modulators];
-            const globalKeyRange = instrument.globalZone.keyRange;
-            const globalVelRange = instrument.globalZone.velRange;
-            
-            
-            let instrumentZonesInRange = instrument.instrumentZones
-                .filter(currentZone =>
-                    
-                    isInRange(
-                        currentZone.hasKeyRange ? currentZone.keyRange : globalKeyRange,
-                        midiNote
-                    )
-                    &&
-                    isInRange(
-                        currentZone.hasVelRange ? currentZone.velRange : globalVelRange,
-                        velocity
-                    )
-                );
-            
-            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
-                });
-            });
-        });
-        return parsedGeneratorsAndSamples;
-    }
-}

package/src/soundfont/basic_soundfont/basic_preset_zone.js

@@ -1,39 +0,0 @@
-import { BasicZone } from "./basic_zone.js";
-
-export class BasicPresetZone extends BasicZone
-{
-    /**
-     * The parent preset.
-     * @type {BasicPreset}
-     */
-    parentPreset;
-    
-    /**
-     * Zone's instrument.
-     * @type {BasicInstrument}
-     */
-    instrument;
-    
-    /**
-     * @param preset {BasicPreset}
-     */
-    constructor(preset)
-    {
-        super();
-        this.parentPreset = preset;
-    }
-    
-    deleteZone()
-    {
-        this.instrument.unlinkFrom(this.parentPreset);
-    }
-    
-    /**
-     * @param instrument {BasicInstrument}
-     */
-    setInstrument(instrument)
-    {
-        this.instrument = instrument;
-        this.instrument.linkTo(this.parentPreset);
-    }
-}