spessasynth_core 3.27.7 → 4.0.0

package/src/soundfont/basic_soundfont/write_dls/combine_zones.js

@@ -1,374 +0,0 @@
-import { Modulator } from "../modulator.js";
-import { Generator } from "../generator.js";
-import { generatorLimits, generatorTypes } from "../generator_types.js";
-import { BasicInstrument } from "../basic_instrument.js";
-
-const notGlobalizedTypes = new Set([
-    generatorTypes.velRange,
-    generatorTypes.keyRange,
-    generatorTypes.instrument,
-    generatorTypes.exclusiveClass,
-    generatorTypes.endOper,
-    generatorTypes.sampleModes,
-    generatorTypes.startloopAddrsOffset,
-    generatorTypes.startloopAddrsCoarseOffset,
-    generatorTypes.endloopAddrsOffset,
-    generatorTypes.endloopAddrsCoarseOffset,
-    generatorTypes.startAddrsOffset,
-    generatorTypes.startAddrsCoarseOffset,
-    generatorTypes.endAddrOffset,
-    generatorTypes.endAddrsCoarseOffset,
-    generatorTypes.initialAttenuation, // written into wsmp, there's no global wsmp
-    generatorTypes.fineTune,           // written into wsmp, there's no global wsmp
-    generatorTypes.coarseTune,         // written into wsmp, there's no global wsmp
-    generatorTypes.keyNumToVolEnvHold, // KEY TO SOMETHING:
-    generatorTypes.keyNumToVolEnvDecay,// cannot be globalized as they modify their respective generators
-    generatorTypes.keyNumToModEnvHold, // (for example, keyNumToVolEnvDecay modifies VolEnvDecay)
-    generatorTypes.keyNumToModEnvDecay
-]);
-
-/**
- * Combines preset zones
- * @param preset {BasicPreset}
- * @param globalize {boolean}
- * @returns {BasicInstrument}
- */
-export function combineZones(preset, globalize = true)
-{
-    /**
-     * @param main {Generator[]}
-     * @param adder {Generator[]}
-     */
-    function addUnique(main, adder)
-    {
-        main.push(...adder.filter(g => !main.find(mg => mg.generatorType === g.generatorType)));
-    }
-    
-    /**
-     * @param r1 {SoundFontRange}
-     * @param r2 {SoundFontRange}
-     * @returns {SoundFontRange}
-     */
-    function subtractRanges(r1, r2)
-    {
-        return { min: Math.max(r1.min, r2.min), max: Math.min(r1.max, r2.max) };
-    }
-    
-    /**
-     * @param main {Modulator[]}
-     * @param adder {Modulator[]}
-     */
-    function addUniqueMods(main, adder)
-    {
-        main.push(...adder.filter(m => !main.find(mm => Modulator.isIdentical(m, mm))));
-    }
-    
-    const outputInstrument = new BasicInstrument();
-    
-    /**
-     * @type {Generator[]}
-     */
-    const globalPresetGenerators = [];
-    /**
-     * @type {Modulator[]}
-     */
-    const globalPresetModulators = [];
-    // find the global zone and apply ranges, generators, and modulators
-    const globalPresetZone = preset.globalZone;
-    globalPresetGenerators.push(...globalPresetZone.generators);
-    globalPresetModulators.push(...globalPresetZone.modulators);
-    let globalPresetKeyRange = globalPresetZone.keyRange;
-    let globalPresetVelRange = globalPresetZone.velRange;
-    // for each non-global preset zone
-    for (const presetZone of preset.presetZones)
-    {
-        // use global ranges if not provided
-        let presetZoneKeyRange = presetZone.keyRange;
-        if (!presetZone.hasKeyRange)
-        {
-            presetZoneKeyRange = globalPresetKeyRange;
-        }
-        let presetZoneVelRange = presetZone.velRange;
-        if (!presetZone.hasVelRange)
-        {
-            presetZoneVelRange = globalPresetVelRange;
-        }
-        // add unique generators and modulators from the global zone
-        const presetGenerators = presetZone.generators.map(g => new Generator(g.generatorType, g.generatorValue));
-        addUnique(presetGenerators, globalPresetGenerators);
-        const presetModulators = [...presetZone.modulators];
-        addUniqueMods(presetModulators, globalPresetModulators);
-        const instrument = presetZone.instrument;
-        const iZones = instrument.instrumentZones;
-        /**
-         * @type {Generator[]}
-         */
-        const globalInstGenerators = [];
-        /**
-         * @type {Modulator[]}
-         */
-        const globalInstModulators = [];
-        const globalInstZone = instrument.globalZone;
-        globalInstGenerators.push(...globalInstZone.generators);
-        globalInstModulators.push(...globalInstZone.modulators);
-        let globalInstKeyRange = globalInstZone.keyRange;
-        let globalInstVelRange = globalInstZone.velRange;
-        // for each non-global instrument zone
-        for (const instZone of iZones)
-        {
-            // use global ranges if not provided
-            let instZoneKeyRange = instZone.keyRange;
-            if (!instZone.hasKeyRange)
-            {
-                instZoneKeyRange = globalInstKeyRange;
-            }
-            let instZoneVelRange = instZone.velRange;
-            if (!instZone.hasVelRange)
-            {
-                instZoneVelRange = globalInstVelRange;
-            }
-            instZoneKeyRange = subtractRanges(instZoneKeyRange, presetZoneKeyRange);
-            instZoneVelRange = subtractRanges(instZoneVelRange, presetZoneVelRange);
-            
-            // if either of the zones is out of range (i.e.m min larger than the max),
-            // then we discard that zone
-            if (instZoneKeyRange.max < instZoneKeyRange.min || instZoneVelRange.max < instZoneVelRange.min)
-            {
-                continue;
-            }
-            
-            // add unique generators and modulators from the global zone
-            const instGenerators = instZone.generators.map(g => new Generator(g.generatorType, g.generatorValue));
-            addUnique(instGenerators, globalInstGenerators);
-            const instModulators = [...instZone.modulators];
-            addUniqueMods(instModulators, globalInstModulators);
-            
-            /**
-             * sum preset modulators to instruments (amount) sf spec page 54
-             * @type {Modulator[]}
-             */
-            const finalModList = [...instModulators];
-            for (const mod of presetModulators)
-            {
-                const identicalInstMod = finalModList.findIndex(
-                    m => Modulator.isIdentical(mod, m));
-                if (identicalInstMod !== -1)
-                {
-                    // sum the amounts
-                    // (this makes a new modulator
-                    // because otherwise it would overwrite the one in the soundfont!
-                    finalModList[identicalInstMod] = finalModList[identicalInstMod].sumTransform(
-                        mod);
-                }
-                else
-                {
-                    finalModList.push(mod);
-                }
-            }
-            
-            // clone the generators as the values are modified during DLS conversion (keyNumToSomething)
-            let finalGenList = instGenerators.map(g => new Generator(g.generatorType, g.generatorValue));
-            for (const gen of presetGenerators)
-            {
-                if (gen.generatorType === generatorTypes.velRange ||
-                    gen.generatorType === generatorTypes.keyRange ||
-                    gen.generatorType === generatorTypes.instrument ||
-                    gen.generatorType === generatorTypes.endOper ||
-                    gen.generatorType === generatorTypes.sampleModes)
-                {
-                    continue;
-                }
-                const identicalInstGen = instGenerators.findIndex(g => g.generatorType === gen.generatorType);
-                if (identicalInstGen !== -1)
-                {
-                    // if exists, sum to that generator
-                    const newAmount = finalGenList[identicalInstGen].generatorValue + gen.generatorValue;
-                    finalGenList[identicalInstGen] = new Generator(gen.generatorType, newAmount);
-                }
-                else
-                {
-                    // if not, sum to the default generator
-                    const newAmount = generatorLimits[gen.generatorType].def + gen.generatorValue;
-                    finalGenList.push(new Generator(gen.generatorType, newAmount));
-                }
-            }
-            
-            // remove unwanted
-            finalGenList = finalGenList.filter(g =>
-                g.generatorType !== generatorTypes.sampleID &&
-                g.generatorType !== generatorTypes.keyRange &&
-                g.generatorType !== generatorTypes.velRange &&
-                g.generatorType !== generatorTypes.endOper &&
-                g.generatorType !== generatorTypes.instrument &&
-                g.generatorValue !== generatorLimits[g.generatorType].def
-            );
-            
-            // create the zone and copy over values
-            const zone = outputInstrument.createZone();
-            zone.keyRange = instZoneKeyRange;
-            zone.velRange = instZoneVelRange;
-            if (zone.keyRange.min === 0 && zone.keyRange.max === 127)
-            {
-                zone.keyRange.min = -1;
-            }
-            if (zone.velRange.min === 0 && zone.velRange.max === 127)
-            {
-                zone.velRange.min = -1;
-            }
-            zone.setSample(instZone.sample);
-            zone.addGenerators(...finalGenList);
-            zone.addModulators(...finalModList);
-        }
-    }
-    const globalZone = outputInstrument.globalZone;
-    if (globalize)
-    {
-        // create a global zone and add repeating generators to it
-        // also modulators
-        // iterate over every type of generator
-        for (let checkedType = 0; checkedType < 58; checkedType++)
-        {
-            // not these though
-            if (notGlobalizedTypes.has(checkedType))
-            {
-                continue;
-            }
-            /**
-             * @type {Record<string, number>}
-             */
-            let occurencesForValues = {};
-            const defaultForChecked = generatorLimits[checkedType]?.def || 0;
-            occurencesForValues[defaultForChecked] = 0;
-            for (const z of outputInstrument.instrumentZones)
-            {
-                const gen = z.generators.find(g => g.generatorType === checkedType);
-                if (gen)
-                {
-                    const value = gen.generatorValue;
-                    if (occurencesForValues[value] === undefined)
-                    {
-                        occurencesForValues[value] = 1;
-                    }
-                    else
-                    {
-                        occurencesForValues[value]++;
-                    }
-                }
-                else
-                {
-                    occurencesForValues[defaultForChecked]++;
-                }
-                
-                // if the checked type has the keyNumTo something generator set, it cannot be globalized.
-                let relativeCounterpart;
-                switch (checkedType)
-                {
-                    default:
-                        continue;
-                    
-                    case generatorTypes.decayVolEnv:
-                        relativeCounterpart = generatorTypes.keyNumToVolEnvDecay;
-                        break;
-                    case generatorTypes.holdVolEnv:
-                        relativeCounterpart = generatorTypes.keyNumToVolEnvHold;
-                        break;
-                    case generatorTypes.decayModEnv:
-                        relativeCounterpart = generatorTypes.keyNumToModEnvDecay;
-                        break;
-                    case generatorTypes.holdModEnv:
-                        relativeCounterpart = generatorTypes.keyNumToModEnvHold;
-                }
-                const relative = z.generators.find(g => g.generatorType === relativeCounterpart);
-                if (relative !== undefined)
-                {
-                    occurencesForValues = {};
-                    break;
-                }
-            }
-            // if at least one occurrence, find the most used one and add it to global
-            if (Object.keys(occurencesForValues).length > 0)
-            {
-                // [value, occurrences]
-                const valueToGlobalize = Object.entries(occurencesForValues).reduce((max, curr) =>
-                {
-                    if (max[1] < curr[1])
-                    {
-                        return curr;
-                    }
-                    return max;
-                }, [0, 0]);
-                const targetValue = parseInt(valueToGlobalize[0]);
-                
-                // if the global value is the default value just remove it, no need to add it
-                if (targetValue !== defaultForChecked)
-                {
-                    globalZone.addGenerators(new Generator(checkedType, targetValue));
-                }
-                // remove from the zones
-                outputInstrument.instrumentZones.forEach(z =>
-                {
-                    const gen = z.generators.findIndex(g =>
-                        g.generatorType === checkedType);
-                    if (gen !== -1)
-                    {
-                        if (z.generators[gen].generatorValue === targetValue)
-                        {
-                            // That exact value exists. Since it's global now, remove it
-                            z.generators.splice(gen, 1);
-                        }
-                    }
-                    else
-                    {
-                        // That type does not exist at all here.
-                        // Since we're globalizing, we need to add the default here.
-                        if (targetValue !== defaultForChecked)
-                        {
-                            z.addGenerators(new Generator(checkedType, defaultForChecked));
-                        }
-                    }
-                });
-            }
-        }
-        
-        // globalize only modulators that exist in all zones
-        const firstZone = outputInstrument.instrumentZones[0];
-        const modulators = firstZone.modulators.map(m => Modulator.copy(m));
-        for (const checkedModulator of modulators)
-        {
-            let existsForAllZones = true;
-            for (const zone of outputInstrument.instrumentZones)
-            {
-                if (!existsForAllZones)
-                {
-                    continue;
-                }
-                // check if that zone has an existing modulator
-                const mod = zone.modulators.find(m => Modulator.isIdentical(m, checkedModulator));
-                if (!mod)
-                {
-                    // does not exist for this zone, so it's not global.
-                    existsForAllZones = false;
-                }
-                // exists.
-                
-            }
-            if (existsForAllZones === true)
-            {
-                globalZone.addModulators(Modulator.copy(checkedModulator));
-                // delete it from local zones.
-                for (const zone of outputInstrument.instrumentZones)
-                {
-                    const modulator = zone.modulators.find(m => Modulator.isIdentical(m, checkedModulator));
-                    // Check if the amount is correct.
-                    // If so, delete it since it's global.
-                    // If not, then it will simply override global as it's identical.
-                    if (modulator.transformAmount === checkedModulator.transformAmount)
-                    {
-                        zone.modulators.splice(zone.modulators.indexOf(modulator), 1);
-                    }
-                }
-            }
-        }
-    }
-    return outputInstrument;
-}

package/src/soundfont/basic_soundfont/write_dls/ins.js

@@ -1,85 +0,0 @@
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { combineZones } from "./combine_zones.js";
-import { writeRIFFChunkParts, writeRIFFChunkRaw } from "../riff_chunk.js";
-import { writeDword } from "../../../utils/byte_functions/little_endian.js";
-import { writeDLSRegion } from "./rgn2.js";
-import { writeArticulator } from "./art2.js";
-import { SpessaSynthGroupCollapsed, SpessaSynthGroupEnd } from "../../../utils/loggin.js";
-import { consoleColors } from "../../../utils/other.js";
-import { getStringBytes } from "../../../utils/byte_functions/string.js";
-
-/**
- * @this {BasicSoundBank}
- * @param preset {BasicPreset}
- * @returns {IndexedByteArray}
- */
-export function writeIns(preset)
-{
-    SpessaSynthGroupCollapsed(
-        `%cWriting %c${preset.presetName}%c...`,
-        consoleColors.info,
-        consoleColors.recognized,
-        consoleColors.info
-    );
-    // combine preset and instrument zones into a single instrument zone (region) list
-    const inst = combineZones(preset);
-    const global = inst.globalZone;
-    const zones = inst.instrumentZones;
-    
-    
-    // insh: instrument header
-    const inshData = new IndexedByteArray(12);
-    writeDword(inshData, zones.length); // cRegions
-    // bank MSB is in bits 8-14
-    let ulBank = (preset.bank & 127) << 8;
-    // bit 32 means drums
-    if (preset.bank === 128)
-    {
-        ulBank |= (1 << 31);
-    }
-    writeDword(inshData, ulBank);                     // ulBank
-    writeDword(inshData, preset.program & 127); // ulInstrument
-    
-    const insh = writeRIFFChunkRaw(
-        "insh",
-        inshData
-    );
-    
-    // write global zone
-    const art2 = writeArticulator(global);
-    let lar2 = writeRIFFChunkRaw(
-        "lar2",
-        art2,
-        false,
-        true
-    );
-    
-    // write the region list
-    const lrgn = writeRIFFChunkParts(
-        "lrgn",
-        zones.reduce((arrs, z) =>
-        {
-            arrs.push(writeDLSRegion.apply(this, [z, global]));
-            return arrs;
-        }, []),
-        true
-    );
-    
-    // writeINFO
-    const inam = writeRIFFChunkRaw(
-        "INAM",
-        getStringBytes(preset.presetName, true)
-    );
-    const info = writeRIFFChunkRaw(
-        "INFO",
-        inam,
-        false,
-        true
-    );
-    
-    SpessaSynthGroupEnd();
-    return writeRIFFChunkParts(
-        "ins ", [insh, lrgn, lar2, info],
-        true
-    );
-}

package/src/soundfont/basic_soundfont/write_dls/lins.js

@@ -1,15 +0,0 @@
-import { writeRIFFChunkParts } from "../riff_chunk.js";
-import { writeIns } from "./ins.js";
-
-/**
- * @this {BasicSoundBank}
- * @returns {IndexedByteArray}
- */
-export function writeLins()
-{
-    return writeRIFFChunkParts(
-        "lins",
-        this.presets.map(p => writeIns.apply(this, [p])),
-        true
-    );
-}