spessasynth_core 3.27.8 → 4.0.0

package/src/soundfont/dls/read_samples.js

@@ -1,154 +0,0 @@
-import { findRIFFListType, readRIFFChunk } from "../basic_soundfont/riff_chunk.js";
-import { readBytesAsString } from "../../utils/byte_functions/string.js";
-import {
-    SpessaSynthGroupCollapsed,
-    SpessaSynthGroupEnd,
-    SpessaSynthInfo,
-    SpessaSynthWarn
-} from "../../utils/loggin.js";
-import { consoleColors } from "../../utils/other.js";
-import { readLittleEndian, signedInt16 } from "../../utils/byte_functions/little_endian.js";
-import { DLSSample } from "./dls_sample.js";
-
-
-/**
- * @this {DLSSoundFont}
- * @param waveListChunk {RiffChunk}
- */
-export function readDLSSamples(waveListChunk)
-{
-    SpessaSynthGroupCollapsed(
-        "%cLoading Wave samples...",
-        consoleColors.recognized
-    );
-    let sampleID = 0;
-    while (waveListChunk.chunkData.currentIndex < waveListChunk.chunkData.length)
-    {
-        const waveChunk = readRIFFChunk(waveListChunk.chunkData);
-        this.verifyHeader(waveChunk, "LIST");
-        this.verifyText(readBytesAsString(waveChunk.chunkData, 4), "wave");
-        
-        /**
-         * @type {RiffChunk[]}
-         */
-        const waveChunks = [];
-        while (waveChunk.chunkData.currentIndex < waveChunk.chunkData.length)
-        {
-            waveChunks.push(readRIFFChunk(waveChunk.chunkData));
-        }
-        
-        const fmtChunk = waveChunks.find(c => c.header === "fmt ");
-        if (!fmtChunk)
-        {
-            throw new Error("No fmt chunk in the wave file!");
-        }
-        // https://github.com/tpn/winsdk-10/blob/9b69fd26ac0c7d0b83d378dba01080e93349c2ed/Include/10.0.14393.0/shared/mmreg.h#L2108
-        const wFormatTag = readLittleEndian(fmtChunk.chunkData, 2);
-        const channelsAmount = readLittleEndian(fmtChunk.chunkData, 2);
-        if (channelsAmount !== 1)
-        {
-            throw new Error(`Only mono samples are supported. Fmt reports ${channelsAmount} channels`);
-        }
-        const sampleRate = readLittleEndian(fmtChunk.chunkData, 4);
-        // skip avg bytes
-        readLittleEndian(fmtChunk.chunkData, 4);
-        // blockAlign
-        readLittleEndian(fmtChunk.chunkData, 2);
-        // it's bits per sample because one channel
-        const wBitsPerSample = readLittleEndian(fmtChunk.chunkData, 2);
-        const bytesPerSample = wBitsPerSample / 8;
-        
-        const dataChunk = waveChunks.find(c => c.header === "data");
-        if (!dataChunk)
-        {
-            this.parsingError("No data chunk in the WAVE chunk!");
-        }
-        
-        // read sample name
-        const waveInfo = findRIFFListType(waveChunks, "INFO");
-        let sampleName = `Unnamed ${sampleID}`;
-        if (waveInfo)
-        {
-            let infoChunk = readRIFFChunk(waveInfo.chunkData);
-            while (infoChunk.header !== "INAM" && waveInfo.chunkData.currentIndex < waveInfo.chunkData.length)
-            {
-                infoChunk = readRIFFChunk(waveInfo.chunkData);
-            }
-            if (infoChunk.header === "INAM")
-            {
-                sampleName = readBytesAsString(infoChunk.chunkData, infoChunk.size).trim();
-            }
-        }
-        
-        // correct defaults
-        let sampleKey = 60;
-        let samplePitch = 0;
-        let sampleLoopStart = 0;
-        const sampleLength = dataChunk.size / bytesPerSample;
-        let sampleLoopEnd = sampleLength - 1;
-        let sampleDbAttenuation = 0;
-        
-        // read wsmp
-        const wsmpChunk = waveChunks.find(c => c.header === "wsmp");
-        if (wsmpChunk)
-        {
-            // skip cbsize
-            readLittleEndian(wsmpChunk.chunkData, 4);
-            sampleKey = readLittleEndian(wsmpChunk.chunkData, 2);
-            // section 1.14.2: Each relative pitch unit represents 1/65536 cents.
-            // but that doesn't seem true for this one: it's just cents.
-            samplePitch = signedInt16(
-                wsmpChunk.chunkData[wsmpChunk.chunkData.currentIndex++],
-                wsmpChunk.chunkData[wsmpChunk.chunkData.currentIndex++]
-            );
-            
-            // pitch correction: convert hundreds to the root key
-            const samplePitchSemitones = Math.trunc(samplePitch / 100);
-            sampleKey += samplePitchSemitones;
-            samplePitch -= samplePitchSemitones * 100;
-            
-            
-            // gain is applied it manually here (literally multiplying the samples)
-            const gainCorrection = readLittleEndian(wsmpChunk.chunkData, 4);
-            // convert to signed and turn into decibels
-            sampleDbAttenuation = (gainCorrection | 0) / -655360;
-            // no idea about ful options
-            readLittleEndian(wsmpChunk.chunkData, 4);
-            const loopsAmount = readLittleEndian(wsmpChunk.chunkData, 4);
-            if (loopsAmount === 1)
-            {
-                // skip size and type
-                readLittleEndian(wsmpChunk.chunkData, 8);
-                sampleLoopStart = readLittleEndian(wsmpChunk.chunkData, 4);
-                const loopSize = readLittleEndian(wsmpChunk.chunkData, 4);
-                sampleLoopEnd = sampleLoopStart + loopSize;
-            }
-        }
-        else
-        {
-            SpessaSynthWarn("No wsmp chunk in wave... using sane defaults.");
-        }
-        
-        this.samples.push(new DLSSample(
-            sampleName,
-            sampleRate,
-            sampleKey,
-            samplePitch,
-            sampleLoopStart,
-            sampleLoopEnd,
-            sampleDbAttenuation,
-            dataChunk,
-            wFormatTag,
-            bytesPerSample
-        ));
-        
-        
-        sampleID++;
-        SpessaSynthInfo(
-            `%cLoaded sample %c${sampleName}`,
-            consoleColors.info,
-            consoleColors.recognized
-        );
-    }
-    SpessaSynthGroupEnd();
-}

package/src/soundfont/load_soundfont.js

@@ -1,21 +0,0 @@
-import { IndexedByteArray } from "../utils/indexed_array.js";
-import { readBytesAsString } from "../utils/byte_functions/string.js";
-import { DLSSoundFont } from "./dls/dls_soundfont.js";
-import { SoundFont2 } from "./read_sf2/soundfont.js";
-
-/**
- * Loads a soundfont or dls file
- * @param buffer {ArrayBuffer} the binary file to load
- * @returns {BasicSoundBank}
- */
-export function loadSoundFont(buffer)
-{
-    const check = buffer.slice(8, 12);
-    const a = new IndexedByteArray(check);
-    const id = readBytesAsString(a, 4, false).toLowerCase();
-    if (id === "dls ")
-    {
-        return new DLSSoundFont(buffer);
-    }
-    return new SoundFont2(buffer, false);
-}

package/src/soundfont/read_sf2/generators.js

@@ -1,43 +0,0 @@
-import { IndexedByteArray } from "../../utils/indexed_array.js";
-import { RiffChunk } from "../basic_soundfont/riff_chunk.js";
-import { signedInt16 } from "../../utils/byte_functions/little_endian.js";
-import { Generator } from "../basic_soundfont/generator.js";
-
-
-export class ReadGenerator extends Generator
-{
-    /**
-     * Creates a generator
-     * @param dataArray {IndexedByteArray}
-     */
-    constructor(dataArray)
-    {
-        super();
-        // 4 bytes:
-        // type, type, type, value
-        const i = dataArray.currentIndex;
-        /**
-         * @type {generatorTypes|number}
-         */
-        this.generatorType = (dataArray[i + 1] << 8) | dataArray[i];
-        this.generatorValue = signedInt16(dataArray[i + 2], dataArray[i + 3]);
-        dataArray.currentIndex += 4;
-    }
-}
-
-/**
- * Reads the generator read
- * @param generatorChunk {RiffChunk}
- * @returns {Generator[]}
- */
-export function readGenerators(generatorChunk)
-{
-    let gens = [];
-    while (generatorChunk.chunkData.length > generatorChunk.chunkData.currentIndex)
-    {
-        gens.push(new ReadGenerator(generatorChunk.chunkData));
-    }
-    // remove terminal
-    gens.pop();
-    return gens;
-}

package/src/soundfont/read_sf2/instrument_zones.js

@@ -1,75 +0,0 @@
-/**
- * instrument_zones.js
- * purpose: reads instrument zones from soundfont and gets their respective samples and generators and modulators
- */
-import { BasicInstrumentZone } from "../basic_soundfont/basic_instrument_zone.js";
-import { generatorTypes } from "../basic_soundfont/generator_types.js";
-
-export class InstrumentZone extends BasicInstrumentZone
-{
-    /**
-     * Creates a zone (instrument)
-     * @param inst {Instrument}
-     */
-    constructor(inst)
-    {
-        super(inst);
-    }
-    
-    /**
-     * Loads the zone's sample
-     * @param samples {BasicSample[]}
-     */
-    getSample(samples)
-    {
-        let sampleID = this.generators.find(g => g.generatorType === generatorTypes.sampleID);
-        if (sampleID)
-        {
-            this.setSample(samples[sampleID.generatorValue]);
-        }
-    }
-}
-
-/**
- * Reads the given instrument zone
- * @param indexes {{mod: number[], gen: number[]}}
- * @param instrumentGenerators {Generator[]}
- * @param instrumentModulators {Modulator[]}
- * @param samples {BasicSample[]}
- * @param instruments {Instrument[]}
- */
-export function applyInstrumentZones(indexes, instrumentGenerators, instrumentModulators, samples, instruments)
-{
-    const genStartIndexes = indexes.gen;
-    const modStartIndexes = indexes.mod;
-    
-    let modIndex = 0;
-    let genIndex = 0;
-    for (const instrument of instruments)
-    {
-        for (let i = 0; i < instrument.zonesCount; i++)
-        {
-            const gensStart = genStartIndexes[genIndex++];
-            const gensEnd = genStartIndexes[genIndex];
-            const gens = instrumentGenerators.slice(gensStart, gensEnd);
-            const modsStart = modStartIndexes[modIndex++];
-            const modsEnd = modStartIndexes[modIndex];
-            const mods = instrumentModulators.slice(modsStart, modsEnd);
-            // check for global zone
-            if (gens.find(g => g.generatorType === generatorTypes.sampleID))
-            {
-                // regular zone
-                const zone = instrument.createZone();
-                zone.addGenerators(...gens);
-                zone.addModulators(...mods);
-                zone.getSample(samples);
-            }
-            else
-            {
-                // global zone
-                instrument.globalZone.addGenerators(...gens);
-                instrument.globalZone.addModulators(...mods);
-            }
-        }
-    }
-}

package/src/soundfont/read_sf2/instruments.js

@@ -1,71 +0,0 @@
-import { RiffChunk } from "../basic_soundfont/riff_chunk.js";
-import { readLittleEndian } from "../../utils/byte_functions/little_endian.js";
-import { readBytesAsString } from "../../utils/byte_functions/string.js";
-import { BasicInstrument } from "../basic_soundfont/basic_instrument.js";
-
-import { InstrumentZone } from "./instrument_zones.js";
-
-/**
- * instrument.js
- * purpose: parses soundfont instrument and stores them as a class
- */
-
-export class Instrument extends BasicInstrument
-{
-    /**
-     * @type {number}
-     */
-    zoneStartIndex;
-    /**
-     * @type {number}
-     */
-    zonesCount = 0;
-    
-    /**
-     * Creates an instrument
-     * @param instrumentChunk {RiffChunk}
-     */
-    constructor(instrumentChunk)
-    {
-        super();
-        this.instrumentName = readBytesAsString(instrumentChunk.chunkData, 20);
-        this.zoneStartIndex = readLittleEndian(instrumentChunk.chunkData, 2);
-    }
-    
-    /**
-     * @returns {InstrumentZone}
-     */
-    createZone()
-    {
-        const z = new InstrumentZone(this);
-        this.instrumentZones.push(z);
-        return z;
-    }
-}
-
-/**
- * Reads the instruments
- * @param instrumentChunk {RiffChunk}
- * @returns {Instrument[]}
- */
-export function readInstruments(instrumentChunk)
-{
-    /**
-     * @type {Instrument[]}
-     */
-    let instruments = [];
-    while (instrumentChunk.chunkData.length > instrumentChunk.chunkData.currentIndex)
-    {
-        let instrument = new Instrument(instrumentChunk);
-        
-        if (instruments.length > 0)
-        {
-            const previous = instruments[instruments.length - 1];
-            previous.zonesCount = instrument.zoneStartIndex - previous.zoneStartIndex;
-        }
-        instruments.push(instrument);
-    }
-    // remove EOI
-    instruments.pop();
-    return instruments;
-}

package/src/soundfont/read_sf2/modulators.js

@@ -1,25 +0,0 @@
-import { readLittleEndian, signedInt16 } from "../../utils/byte_functions/little_endian.js";
-import { DecodedModulator, Modulator } from "../basic_soundfont/modulator.js";
-
-/**
- * Reads the modulator read
- * @param modulatorChunk {RiffChunk}
- * @returns {Modulator[]}
- */
-export function readModulators(modulatorChunk)
-{
-    let mods = [];
-    while (modulatorChunk.chunkData.length > modulatorChunk.chunkData.currentIndex)
-    {
-        const dataArray = modulatorChunk.chunkData;
-        const sourceEnum = readLittleEndian(dataArray, 2);
-        const destination = readLittleEndian(dataArray, 2);
-        const amount = signedInt16(dataArray[dataArray.currentIndex++], dataArray[dataArray.currentIndex++]);
-        const secondarySourceEnum = readLittleEndian(dataArray, 2);
-        const transformType = readLittleEndian(dataArray, 2);
-        mods.push(new DecodedModulator(sourceEnum, secondarySourceEnum, destination, amount, transformType));
-    }
-    // remove terminal
-    mods.pop();
-    return mods;
-}

package/src/soundfont/read_sf2/preset_zones.js

@@ -1,79 +0,0 @@
-import { BasicPresetZone } from "../basic_soundfont/basic_preset_zone.js";
-import { Generator } from "../basic_soundfont/generator.js";
-import { Modulator } from "../basic_soundfont/modulator.js";
-import { generatorTypes } from "../basic_soundfont/generator_types.js";
-
-/**
- * preset_zones.js
- * purpose: reads preset zones from soundfont and gets their respective samples and generators and modulators
- */
-
-export class PresetZone extends BasicPresetZone
-{
-    /**
-     * Creates a zone (preset)
-     * @param preset {BasicPreset}
-     */
-    constructor(preset)
-    {
-        super(preset);
-    }
-    
-    /**
-     * grab the instrument
-     * @param instruments {BasicInstrument[]}
-     */
-    getInstrument(instruments)
-    {
-        let instrumentID = this.generators.find(g => g.generatorType === generatorTypes.instrument);
-        if (instrumentID)
-        {
-            this.setInstrument(instruments[instrumentID.generatorValue]);
-        }
-    }
-}
-
-
-/**
- * Reads the given preset zone
- * @param indexes {{mod: number[], gen: number[]}}
- * @param presetGens {Generator[]}
- * @param instruments {BasicInstrument[]}
- * @param presetMods {Modulator[]}
- * @param presets {Preset[]}
- */
-export function applyPresetZones(indexes, presetGens, presetMods, instruments, presets)
-{
-    const genStartIndexes = indexes.gen;
-    const modStartIndexes = indexes.mod;
-    
-    let modIndex = 0;
-    let genIndex = 0;
-    for (const preset of presets)
-    {
-        for (let i = 0; i < preset.zonesCount; i++)
-        {
-            const gensStart = genStartIndexes[genIndex++];
-            const gensEnd = genStartIndexes[genIndex];
-            const gens = presetGens.slice(gensStart, gensEnd);
-            const modsStart = modStartIndexes[modIndex++];
-            const modsEnd = modStartIndexes[modIndex];
-            const mods = presetMods.slice(modsStart, modsEnd);
-            // check for global zone
-            if (gens.find(g => g.generatorType === generatorTypes.instrument) !== undefined)
-            {
-                // regular zone
-                const zone = preset.createZone();
-                zone.addGenerators(...gens);
-                zone.addModulators(...mods);
-                zone.getInstrument(instruments);
-            }
-            else
-            {
-                // global zone
-                preset.globalZone.addGenerators(...gens);
-                preset.globalZone.addModulators(...mods);
-            }
-        }
-    }
-}

package/src/soundfont/read_sf2/presets.js

@@ -1,80 +0,0 @@
-import { RiffChunk } from "../basic_soundfont/riff_chunk.js";
-import { readLittleEndian } from "../../utils/byte_functions/little_endian.js";
-import { readBytesAsString } from "../../utils/byte_functions/string.js";
-import { BasicPreset } from "../basic_soundfont/basic_preset.js";
-import { PresetZone } from "./preset_zones.js";
-
-/**
- * parses soundfont presets, also includes function for getting the generators and samples from midi note and velocity
- */
-
-export class Preset extends BasicPreset
-{
-    
-    /**
-     * @type {number}
-     */
-    zoneStartIndex;
-    /**
-     * @type {number}
-     */
-    zonesCount = 0;
-    
-    /**
-     * Creates a preset
-     * @param presetChunk {RiffChunk}
-     * @param sf2 {BasicSoundBank}
-     */
-    constructor(presetChunk, sf2)
-    {
-        super(sf2);
-        this.presetName = readBytesAsString(presetChunk.chunkData, 20)
-            .replace(/\d{3}:\d{3}/, ""); // remove those pesky "000:001"
-        
-        this.program = readLittleEndian(presetChunk.chunkData, 2);
-        this.bank = readLittleEndian(presetChunk.chunkData, 2);
-        this.zoneStartIndex = readLittleEndian(presetChunk.chunkData, 2);
-        
-        // read the dword
-        this.library = readLittleEndian(presetChunk.chunkData, 4);
-        this.genre = readLittleEndian(presetChunk.chunkData, 4);
-        this.morphology = readLittleEndian(presetChunk.chunkData, 4);
-    }
-    
-    /**
-     * @returns {PresetZone}
-     */
-    createZone()
-    {
-        const z = new PresetZone(this);
-        this.presetZones.push(z);
-        return z;
-    }
-}
-
-/**
- * Reads the presets
- * @param presetChunk {RiffChunk}
- * @param parent {BasicSoundBank}
- * @returns {Preset[]}
- */
-export function readPresets(presetChunk, parent)
-{
-    /**
-     * @type {Preset[]}
-     */
-    let presets = [];
-    while (presetChunk.chunkData.length > presetChunk.chunkData.currentIndex)
-    {
-        let preset = new Preset(presetChunk, parent);
-        if (presets.length > 0)
-        {
-            const previous = presets[presets.length - 1];
-            previous.zonesCount = preset.zoneStartIndex - previous.zoneStartIndex;
-        }
-        presets.push(preset);
-    }
-    // remove EOP
-    presets.pop();
-    return presets;
-}