spessasynth_core 3.27.8 → 4.0.1

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

@@ -1,78 +0,0 @@
-import { writeDword, writeWord } from "../../../utils/byte_functions/little_endian.js";
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { writeRIFFChunkRaw } from "../riff_chunk.js";
-
-const WSMP_SIZE = 20;
-
-/**
- * @param sample {BasicSample}
- * @param rootKey {number}
- * @param tuning {number}
- * @param attenuationCentibels {number} CENTIBELS, NO CORRECTION
- * @param loopStart {number}
- * @param loopEnd {number}
- * @param loopingMode {number}
- * @returns {IndexedByteArray}
- */
-export function writeWavesample(
-    sample,
-    rootKey,
-    tuning,
-    attenuationCentibels,
-    loopStart,
-    loopEnd,
-    loopingMode)
-{
-    let loopCount = loopingMode === 0 ? 0 : 1;
-    const wsmpData = new IndexedByteArray(WSMP_SIZE + loopCount * 16);
-    writeDword(wsmpData, WSMP_SIZE); // cbSize
-    // usUnityNote (apply root pitch here)
-    writeWord(wsmpData, rootKey);
-    // sFineTune
-    writeWord(wsmpData, tuning);
-    
-    // gain correction, use InitialAttenuation, apply attenuation correction
-    const attenuationCb = attenuationCentibels * 0.4;
-    
-    // gain correction: Each unit of gain represents 1/655360 dB
-    const lGain = Math.floor(attenuationCb * -65536);
-    writeDword(wsmpData, lGain);
-    // fulOptions: has to be 2, according to all DLS files I have
-    writeDword(wsmpData, 2);
-    
-    const loopSize = loopEnd - loopStart;
-    let ulLoopType = 0;
-    switch (loopingMode)
-    {
-        default:
-        case 0:
-            // no loop
-            loopCount = 0;
-            break;
-        
-        case 1:
-            // loop
-            ulLoopType = 0;
-            loopCount = 1;
-            break;
-        
-        case 3:
-            // loop and release
-            ulLoopType = 1;
-            loopCount = 1;
-    }
-    
-    // cSampleLoops
-    writeDword(wsmpData, loopCount);
-    if (loopCount === 1)
-    {
-        writeDword(wsmpData, 16); // cbSize
-        writeDword(wsmpData, ulLoopType);
-        writeDword(wsmpData, loopStart);
-        writeDword(wsmpData, loopSize);
-    }
-    return writeRIFFChunkRaw(
-        "wsmp",
-        wsmpData
-    );
-}

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

@@ -1,35 +0,0 @@
-import { writeDLSSample } from "./wave.js";
-import { writeRIFFChunkParts } from "../riff_chunk.js";
-
-/**
- * @this {BasicSoundBank}
- * @param {ProgressFunction|undefined} progressFunction
- * @returns {Promise<{data: IndexedByteArray, indexes: number[] }>}
- */
-export async function writeWavePool(progressFunction)
-{
-    let currentIndex = 0;
-    const offsets = [];
-    /**
-     * @type {IndexedByteArray[]}
-     */
-    const samples = [];
-    let written = 0;
-    for (const s of this.samples)
-    {
-        const out = writeDLSSample(s);
-        await progressFunction?.(s.sampleName, written, this.samples.length);
-        offsets.push(currentIndex);
-        currentIndex += out.length;
-        samples.push(out);
-        written++;
-    }
-    return {
-        data: writeRIFFChunkParts(
-            "wvpl",
-            samples,
-            true
-        ),
-        indexes: offsets
-    };
-}

package/src/soundfont/basic_soundfont/write_sf2/ibag.js

@@ -1,60 +0,0 @@
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { writeWord } from "../../../utils/byte_functions/little_endian.js";
-import { writeRIFFChunkRaw } from "../riff_chunk.js";
-
-const BAG_SIZE = 4;
-
-/**
- * @this {BasicSoundBank}
- * @returns {ReturnedExtendedSf2Chunks}
- */
-export function getIBAG()
-{
-    // write all ibag with their start indexes as they were changed in getIGEN() and getIMOD()
-    const ibagSize = this.instruments.reduce(
-        (sum, i) =>
-            // +1 because global zone
-            (i.instrumentZones.length + 1) * BAG_SIZE + sum,
-        BAG_SIZE
-    );
-    const ibagData = new IndexedByteArray(ibagSize);
-    // https://github.com/spessasus/soundfont-proposals/blob/main/extended_limits.md
-    const xibagData = new IndexedByteArray(ibagSize);
-    let generatorIndex = 0;
-    let modulatorIndex = 0;
-    /**
-     * @param z {BasicZone}
-     */
-    const writeZone = z =>
-    {
-        // bottom WORD: regular ibag
-        writeWord(ibagData, generatorIndex & 0xFFFF);
-        writeWord(ibagData, modulatorIndex & 0xFFFF);
-        // top WORD: extended ibag
-        writeWord(xibagData, generatorIndex >> 16);
-        writeWord(xibagData, modulatorIndex >> 16);
-        generatorIndex += z.generators.length;
-        modulatorIndex += z.modulators.length;
-    };
-    
-    for (const inst of this.instruments)
-    {
-        writeZone(inst.globalZone);
-        for (const ibag of inst.instrumentZones)
-        {
-            writeZone(ibag);
-        }
-    }
-    // write the terminal IBAG
-    writeWord(ibagData, generatorIndex & 0xFFFF);
-    writeWord(ibagData, modulatorIndex & 0xFFFF);
-    writeWord(xibagData, generatorIndex >> 16);
-    writeWord(xibagData, modulatorIndex >> 16);
-    const ibag = writeRIFFChunkRaw("ibag", ibagData);
-    const xibag = writeRIFFChunkRaw("ibag", xibagData);
-    return {
-        pdta: ibag,
-        xdta: xibag,
-        highestIndex: Math.max(generatorIndex, modulatorIndex)
-    };
-}

package/src/soundfont/basic_soundfont/write_sf2/igen.js

@@ -1,91 +0,0 @@
-import { writeDword, writeWord } from "../../../utils/byte_functions/little_endian.js";
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { writeRIFFChunkRaw } from "../riff_chunk.js";
-import { GEN_BYTE_SIZE, Generator } from "../generator.js";
-import { generatorTypes } from "../generator_types.js";
-
-/**
- * @this {BasicSoundBank}
- * @returns {ReturnedExtendedSf2Chunks}
- */
-export function getIGEN()
-{
-    // go through all instruments -> zones and write generators sequentially (add 4 for terminal)
-    let igenSize = GEN_BYTE_SIZE;
-    for (const inst of this.instruments)
-    {
-        igenSize += inst.globalZone.generators.length * GEN_BYTE_SIZE;
-        igenSize += inst.instrumentZones.reduce((sum, z) =>
-        {
-            // clear sample and range generators before determining the size
-            z.generators = (z.generators.filter(g =>
-                g.generatorType !== generatorTypes.sampleID &&
-                g.generatorType !== generatorTypes.keyRange &&
-                g.generatorType !== generatorTypes.velRange
-            ));
-            // add sample and ranges if necessary
-            // unshift vel then key (to make key first) and the sample is last
-            if (z.hasVelRange)
-            {
-                z.prependGenerator(new Generator(
-                    generatorTypes.velRange,
-                    z.velRange.max << 8 | Math.max(z.velRange.min, 0),
-                    false
-                ));
-            }
-            if (z.hasKeyRange)
-            {
-                z.prependGenerator(new Generator(
-                    generatorTypes.keyRange,
-                    z.keyRange.max << 8 | Math.max(z.keyRange.min, 0),
-                    false
-                ));
-            }
-            // add sample id
-            z.addGenerators(new Generator(
-                generatorTypes.sampleID,
-                this.samples.indexOf(z.sample),
-                false
-            ));
-            return z.generators.length * GEN_BYTE_SIZE + sum;
-        }, 0);
-    }
-    const igenData = new IndexedByteArray(igenSize);
-    
-    /**
-     * @param z {BasicZone}
-     */
-    const writeZone = z =>
-    {
-        for (const gen of z.generators)
-        {
-            // name is deceptive, it works on negatives
-            writeWord(igenData, gen.generatorType);
-            writeWord(igenData, gen.generatorValue);
-        }
-    };
-    
-    for (const instrument of this.instruments)
-    {
-        // global zone
-        writeZone(instrument.globalZone);
-        for (const instrumentZone of instrument.instrumentZones)
-        {
-            writeZone(instrumentZone);
-        }
-    }
-    // terminal generator, is zero
-    writeDword(igenData, 0);
-    
-    // https://github.com/spessasus/soundfont-proposals/blob/main/extended_limits.md
-    const xigenData = new IndexedByteArray(GEN_BYTE_SIZE);
-    writeDword(xigenData, 0);
-    
-    const igen = writeRIFFChunkRaw("igen", igenData);
-    const xigen = writeRIFFChunkRaw("igen", xigenData);
-    return {
-        pdta: igen,
-        xdta: xigen,
-        highestIndex: 0 // not applicable
-    };
-}

package/src/soundfont/basic_soundfont/write_sf2/imod.js

@@ -1,62 +0,0 @@
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { writeLittleEndian, writeWord } from "../../../utils/byte_functions/little_endian.js";
-import { writeRIFFChunkRaw } from "../riff_chunk.js";
-import { MOD_BYTE_SIZE } from "../modulator.js";
-
-/**
- * @this {BasicSoundBank}
- * @returns {ReturnedExtendedSf2Chunks}
- */
-export function getIMOD()
-{
-    // very similar to igen,
-    // go through all instruments -> zones and write modulators sequentially
-    let imodSize = MOD_BYTE_SIZE; // terminal
-    for (const inst of this.instruments)
-    {
-        imodSize += inst.globalZone.modulators.length * MOD_BYTE_SIZE;
-        // start with one mod for global
-        imodSize += inst.instrumentZones.reduce((sum, z) => z.modulators.length * MOD_BYTE_SIZE + sum, 0);
-    }
-    const imodData = new IndexedByteArray(imodSize);
-    
-    /**
-     * @param z {BasicZone}
-     */
-    const writeZone = z =>
-    {
-        for (const mod of z.modulators)
-        {
-            writeWord(imodData, mod.getSourceEnum());
-            writeWord(imodData, mod.modulatorDestination);
-            writeWord(imodData, mod.transformAmount);
-            writeWord(imodData, mod.getSecSrcEnum());
-            writeWord(imodData, mod.transformType);
-        }
-    };
-    
-    for (const inst of this.instruments)
-    {
-        // global
-        writeZone(inst.globalZone);
-        for (const instrumentZone of inst.instrumentZones)
-        {
-            writeZone(instrumentZone);
-        }
-    }
-    
-    // terminal modulator, is zero
-    writeLittleEndian(imodData, 0, MOD_BYTE_SIZE);
-    
-    // https://github.com/spessasus/soundfont-proposals/blob/main/extended_limits.md
-    const ximodData = new IndexedByteArray(MOD_BYTE_SIZE);
-    writeLittleEndian(ximodData, 0, MOD_BYTE_SIZE);
-    
-    const imod = writeRIFFChunkRaw("imod", imodData);
-    const ximod = writeRIFFChunkRaw("imod", ximodData);
-    return {
-        pdta: imod,
-        xdta: ximod,
-        highestIndex: 0 // not applicable
-    };
-}

package/src/soundfont/basic_soundfont/write_sf2/inst.js

@@ -1,42 +0,0 @@
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { writeStringAsBytes } from "../../../utils/byte_functions/string.js";
-import { writeWord } from "../../../utils/byte_functions/little_endian.js";
-import { writeRIFFChunkRaw } from "../riff_chunk.js";
-
-const INST_SIZE = 22;
-
-/**
- * @this {BasicSoundBank}
- * @returns {ReturnedExtendedSf2Chunks}
- */
-export function getINST()
-{
-    const instSize = this.instruments.length * INST_SIZE + INST_SIZE;
-    const instData = new IndexedByteArray(instSize);
-    // https://github.com/spessasus/soundfont-proposals/blob/main/extended_limits.md
-    const xinstData = new IndexedByteArray(instSize);
-    // the instrument start index is adjusted in ibag, write it here
-    let instrumentStart = 0;
-    for (const inst of this.instruments)
-    {
-        writeStringAsBytes(instData, inst.instrumentName.substring(0, 20), 20);
-        writeStringAsBytes(xinstData, inst.instrumentName.substring(20), 20);
-        writeWord(instData, instrumentStart & 0xFFFF);
-        writeWord(xinstData, instrumentStart >> 16);
-        instrumentStart += inst.instrumentZones.length + 1; // global
-    }
-    // write EOI
-    writeStringAsBytes(instData, "EOI", 20);
-    writeStringAsBytes(xinstData, "EOI", 20);
-    writeWord(instData, instrumentStart & 0xFFFF);
-    writeWord(xinstData, instrumentStart >> 16);
-    
-    const inst = writeRIFFChunkRaw("inst", instData);
-    const xinst = writeRIFFChunkRaw("inst", xinstData);
-    
-    return {
-        pdta: inst,
-        xdta: xinst,
-        highestIndex: instrumentStart
-    };
-}

package/src/soundfont/basic_soundfont/write_sf2/pbag.js

@@ -1,57 +0,0 @@
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { writeWord } from "../../../utils/byte_functions/little_endian.js";
-import { writeRIFFChunkRaw } from "../riff_chunk.js";
-
-const BAG_SIZE = 4;
-
-/**
- * @this {BasicSoundBank}
- * @returns {ReturnedExtendedSf2Chunks}
- */
-export function getPBAG()
-{
-    // write all pbag with their start indexes as they were changed in getPGEN() and getPMOD()
-    const pbagSize = this.presets.reduce((sum, i) =>
-        // +1 because global zone
-        (i.presetZones.length + 1) * BAG_SIZE + sum, BAG_SIZE);
-    const pbagData = new IndexedByteArray(pbagSize);
-    // https://github.com/spessasus/soundfont-proposals/blob/main/extended_limits.md
-    const xpbagData = new IndexedByteArray(pbagSize);
-    let generatorIndex = 0;
-    let modulatorIndex = 0;
-    
-    /**
-     * @param z {BasicZone}
-     */
-    const writeZone = z =>
-    {
-        writeWord(pbagData, generatorIndex & 0xFFFF);
-        writeWord(pbagData, modulatorIndex & 0xFFFF);
-        writeWord(xpbagData, generatorIndex >> 16);
-        writeWord(xpbagData, modulatorIndex >> 16);
-        generatorIndex += z.generators.length;
-        modulatorIndex += z.modulators.length;
-    };
-    
-    for (const preset of this.presets)
-    {
-        // global
-        writeZone(preset.globalZone);
-        for (const pbag of preset.presetZones)
-        {
-            writeZone(pbag);
-        }
-    }
-    // write the terminal PBAG
-    writeWord(pbagData, generatorIndex);
-    writeWord(pbagData, modulatorIndex);
-    writeWord(xpbagData, generatorIndex);
-    writeWord(xpbagData, modulatorIndex);
-    const pbag = writeRIFFChunkRaw("pbag", pbagData);
-    const xbag = writeRIFFChunkRaw("pbag", xpbagData);
-    return {
-        pdta: pbag,
-        xdta: xbag,
-        highestIndex: Math.max(generatorIndex, modulatorIndex)
-    };
-}

package/src/soundfont/basic_soundfont/write_sf2/pgen.js

@@ -1,92 +0,0 @@
-import { writeDword, writeWord } from "../../../utils/byte_functions/little_endian.js";
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { writeRIFFChunkRaw } from "../riff_chunk.js";
-
-import { GEN_BYTE_SIZE, Generator } from "../generator.js";
-import { generatorTypes } from "../generator_types.js";
-
-/**
- * @this {BasicSoundBank}
- * @returns {ReturnedExtendedSf2Chunks}
- */
-export function getPGEN()
-{
-    // almost identical to igen, except the correct instrument instead of sample gen
-    // goes through all preset zones and writes generators sequentially (add 4 for terminal)
-    let pgenSize = GEN_BYTE_SIZE;
-    for (const preset of this.presets)
-    {
-        pgenSize += preset.globalZone.generators.length * GEN_BYTE_SIZE;
-        pgenSize += preset.presetZones.reduce((size, z) =>
-        {
-            // clear instrument and range generators before determining the size
-            z.generators = z.generators.filter(g =>
-                g.generatorType !== generatorTypes.instrument &&
-                g.generatorType !== generatorTypes.keyRange &&
-                g.generatorType !== generatorTypes.velRange
-            );
-            // unshift vel then key and instrument is last
-            if (z.hasVelRange)
-            {
-                z.prependGenerator(new Generator(
-                    generatorTypes.velRange,
-                    z.velRange.max << 8 | Math.max(z.velRange.min, 0),
-                    false
-                ));
-            }
-            if (z.hasKeyRange)
-            {
-                z.prependGenerator(new Generator(
-                    generatorTypes.keyRange,
-                    z.keyRange.max << 8 | Math.max(z.keyRange.min, 0),
-                    false
-                ));
-            }
-            // write the instrument id
-            z.addGenerators(new Generator(
-                generatorTypes.instrument,
-                this.instruments.indexOf(z.instrument),
-                false
-            ));
-            return z.generators.length * GEN_BYTE_SIZE + size;
-        }, 0);
-    }
-    const pgenData = new IndexedByteArray(pgenSize);
-    
-    /**
-     * @param z {BasicZone}
-     */
-    const writeZone = z =>
-    {
-        for (const gen of z.generators)
-        {
-            // name is deceptive, it works on negatives
-            writeWord(pgenData, gen.generatorType);
-            writeWord(pgenData, gen.generatorValue);
-        }
-    };
-    for (const preset of this.presets)
-    {
-        // global zone
-        writeZone(preset.globalZone);
-        for (const zone of preset.presetZones)
-        {
-            writeZone(zone);
-        }
-    }
-    // terminal generator, is zero
-    writeDword(pgenData, 0);
-    
-    // https://github.com/spessasus/soundfont-proposals/blob/main/extended_limits.md
-    const xpgenData = new IndexedByteArray(GEN_BYTE_SIZE);
-    writeDword(xpgenData, 0);
-    
-    const pgen = writeRIFFChunkRaw("pgen", pgenData);
-    
-    const xpgen = writeRIFFChunkRaw("pgen", xpgenData);
-    return {
-        pdta: pgen,
-        xdta: xpgen,
-        highestIndex: 0 // not applicable
-    };
-}

package/src/soundfont/basic_soundfont/write_sf2/phdr.js

@@ -1,61 +0,0 @@
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { writeStringAsBytes } from "../../../utils/byte_functions/string.js";
-import { writeDword, writeWord } from "../../../utils/byte_functions/little_endian.js";
-import { writeRIFFChunkRaw } from "../riff_chunk.js";
-
-const PHDR_SIZE = 38;
-
-/**
- * @this {BasicSoundBank}
- * @returns {ReturnedExtendedSf2Chunks}
- */
-export function getPHDR()
-{
-    const phdrSize = this.presets.length * PHDR_SIZE + PHDR_SIZE;
-    const phdrData = new IndexedByteArray(phdrSize);
-    // https://github.com/spessasus/soundfont-proposals/blob/main/extended_limits.md
-    const xphdrData = new IndexedByteArray(phdrSize);
-    // the preset start is adjusted in pbag, this is only for the terminal preset index
-    let presetStart = 0;
-    for (const preset of this.presets)
-    {
-        writeStringAsBytes(phdrData, preset.presetName.substring(0, 20), 20);
-        writeStringAsBytes(xphdrData, preset.presetName.substring(20), 20);
-        
-        writeWord(phdrData, preset.program);
-        writeWord(phdrData, preset.bank);
-        writeWord(phdrData, presetStart & 0xFFFF);
-        
-        xphdrData.currentIndex += 4;
-        writeWord(xphdrData, presetStart >> 16);
-        
-        // 3 unused dword, spec says to keep em so we do
-        writeDword(phdrData, preset.library);
-        writeDword(phdrData, preset.genre);
-        writeDword(phdrData, preset.morphology);
-        
-        xphdrData.currentIndex += 12;
-        
-        presetStart += preset.presetZones.length + 1; // global
-    }
-    // write EOP
-    writeStringAsBytes(phdrData, "EOP", 20);
-    phdrData.currentIndex += 4; // program, bank
-    writeWord(phdrData, presetStart & 0xFFFF);
-    phdrData.currentIndex += 12;// library, genre, morphology
-    
-    writeStringAsBytes(xphdrData, "EOP", 20);
-    xphdrData.currentIndex += 4; // program, bank
-    writeWord(xphdrData, presetStart >> 16);
-    xphdrData.currentIndex += 12;// library, genre, morphology
-    
-    const phdr = writeRIFFChunkRaw("phdr", phdrData);
-    
-    const xphdr = writeRIFFChunkRaw("phdr", xphdrData);
-    
-    return {
-        pdta: phdr,
-        xdta: xphdr,
-        highestIndex: presetStart
-    };
-}

package/src/soundfont/basic_soundfont/write_sf2/pmod.js

@@ -1,62 +0,0 @@
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { writeLittleEndian, writeWord } from "../../../utils/byte_functions/little_endian.js";
-import { writeRIFFChunkRaw } from "../riff_chunk.js";
-import { MOD_BYTE_SIZE } from "../modulator.js";
-
-/**
- * @this {BasicSoundBank}
- * @returns {ReturnedExtendedSf2Chunks}
- */
-export function getPMOD()
-{
-    // very similar to imod,
-    // go through all presets -> zones and write modulators sequentially
-    let pmodSize = MOD_BYTE_SIZE;
-    for (const preset of this.presets)
-    {
-        pmodSize += preset.globalZone.modulators.length * MOD_BYTE_SIZE;
-        pmodSize += preset.presetZones.reduce((sum, z) => z.modulators.length * MOD_BYTE_SIZE + sum, 0);
-    }
-    const pmodData = new IndexedByteArray(pmodSize);
-    
-    /**
-     * @param z {BasicZone}
-     */
-    const writeZone = z =>
-    {
-        for (const mod of z.modulators)
-        {
-            writeWord(pmodData, mod.getSourceEnum());
-            writeWord(pmodData, mod.modulatorDestination);
-            writeWord(pmodData, mod.transformAmount);
-            writeWord(pmodData, mod.getSecSrcEnum());
-            writeWord(pmodData, mod.transformType);
-        }
-    };
-    
-    
-    for (const preset of this.presets)
-    {
-        // global
-        writeZone(preset.globalZone);
-        for (const zone of preset.presetZones)
-        {
-            writeZone(zone);
-        }
-    }
-    
-    // terminal modulator, is zero
-    writeLittleEndian(pmodData, 0, MOD_BYTE_SIZE);
-    
-    // https://github.com/spessasus/soundfont-proposals/blob/main/extended_limits.md
-    const xpmodData = new IndexedByteArray(MOD_BYTE_SIZE);
-    writeLittleEndian(xpmodData, 0, MOD_BYTE_SIZE);
-    
-    const pmod = writeRIFFChunkRaw("pmod", pmodData);
-    const xpmod = writeRIFFChunkRaw("pmod", xpmodData);
-    return {
-        pdta: pmod,
-        xdta: xpmod,
-        highestIndex: 0 // not applicable
-    };
-}