spessasynth_core 3.27.7 → 4.0.0

package/src/soundfont/dls/dls_sample.js

@@ -1,238 +0,0 @@
-import { BasicSample, sampleTypes } from "../basic_soundfont/basic_sample.js";
-import { SpessaSynthWarn } from "../../utils/loggin.js";
-import { readLittleEndian } from "../../utils/byte_functions/little_endian.js";
-import { IndexedByteArray } from "../../utils/indexed_array.js";
-
-const W_FORMAT_TAG = {
-    PCM: 0x01,
-    ALAW: 0x6
-};
-
-
-/**
- * @param data {IndexedByteArray}
- * @param bytesPerSample {number}
- * @returns {Float32Array}
- */
-function readPCM(data, bytesPerSample)
-{
-    const maxSampleValue = Math.pow(2, bytesPerSample * 8 - 1); // Max value for the sample
-    const maxUnsigned = Math.pow(2, bytesPerSample * 8);
-    
-    let normalizationFactor;
-    let isUnsigned = false;
-    
-    if (bytesPerSample === 1)
-    {
-        normalizationFactor = 255; // For 8-bit normalize from 0-255
-        isUnsigned = true;
-    }
-    else
-    {
-        normalizationFactor = maxSampleValue; // For 16-bit normalize from -32,768 to 32,767
-    }
-    const sampleLength = data.length / bytesPerSample;
-    const sampleData = new Float32Array(sampleLength);
-    if (bytesPerSample === 2)
-    {
-        // special optimized case for s16 (most common)
-        const s16 = new Int16Array(data.buffer);
-        for (let i = 0; i < s16.length; i++)
-        {
-            sampleData[i] = s16[i] / 32768;
-        }
-    }
-    else
-    {
-        for (let i = 0; i < sampleData.length; i++)
-        {
-            // read
-            let sample = readLittleEndian(data, bytesPerSample);
-            // turn into signed
-            if (isUnsigned)
-            {
-                // normalize unsigned 8-bit sample
-                sampleData[i] = (sample / normalizationFactor) - 0.5;
-            }
-            else
-            {
-                // normalize signed sample
-                if (sample >= maxSampleValue)
-                {
-                    sample -= maxUnsigned;
-                }
-                sampleData[i] = sample / normalizationFactor;
-            }
-        }
-    }
-    return sampleData;
-}
-
-/**
- * @param data {IndexedByteArray}
- * @param bytesPerSample {number}
- * @returns {Float32Array}
- */
-function readALAW(data, bytesPerSample)
-{
-    const sampleLength = data.length / bytesPerSample;
-    const sampleData = new Float32Array(sampleLength);
-    for (let i = 0; i < sampleData.length; i++)
-    {
-        // read
-        const input = readLittleEndian(data, bytesPerSample);
-        
-        // https://en.wikipedia.org/wiki/G.711#A-law
-        // re-toggle toggled bits
-        let sample = input ^ 0x55;
-        
-        // remove sign bit
-        sample &= 0x7F;
-        
-        // extract exponent
-        let exponent = sample >> 4;
-        // extract mantissa
-        let mantissa = sample & 0xF;
-        if (exponent > 0)
-        {
-            mantissa += 16; // add leading '1', if exponent > 0
-        }
-        
-        mantissa = (mantissa << 4) + 0x8;
-        if (exponent > 1)
-        {
-            mantissa = mantissa << (exponent - 1);
-        }
-        
-        const s16sample = input > 127 ? mantissa : -mantissa;
-        
-        // convert to float
-        sampleData[i] = s16sample / 32678;
-    }
-    return sampleData;
-}
-
-export class DLSSample extends BasicSample
-{
-    /**
-     * in decibels of attenuation, WITHOUT EMU CORRECTION
-     * @type {number}
-     */
-    sampleDbAttenuation;
-    /**
-     * @type {Float32Array}
-     */
-    sampleData;
-    
-    /**
-     * @type {number}
-     */
-    wFormatTag;
-    
-    /**
-     * @type {number}
-     */
-    bytesPerSample;
-    
-    /**
-     * Sample's raw data before decoding it, for faster writing
-     * @type {IndexedByteArray}
-     */
-    rawData;
-    
-    /**
-     * @param name {string}
-     * @param rate {number}
-     * @param pitch {number}
-     * @param pitchCorrection {number}
-     * @param loopStart {number} sample data points
-     * @param loopEnd {number} sample data points
-     * @param sampleDbAttenuation {number} in db
-     * @param dataChunk {RiffChunk}
-     * @param wFormatTag {number}
-     * @param bytesPerSample {number}
-     */
-    constructor(
-        name,
-        rate,
-        pitch,
-        pitchCorrection,
-        loopStart,
-        loopEnd,
-        sampleDbAttenuation,
-        dataChunk,
-        wFormatTag,
-        bytesPerSample
-    )
-    {
-        super(
-            name,
-            rate,
-            pitch,
-            pitchCorrection,
-            sampleTypes.monoSample,
-            loopStart,
-            loopEnd
-        );
-        this.sampleDbAttenuation = sampleDbAttenuation;
-        this.dataOverriden = false;
-        /**
-         * @type {IndexedByteArray}
-         */
-        this.rawData = dataChunk.chunkData;
-        this.wFormatTag = wFormatTag;
-        this.bytesPerSample = bytesPerSample;
-    }
-    
-    getAudioData()
-    {
-        if (!(this.rawData instanceof Uint8Array))
-        {
-            return new Float32Array(0);
-        }
-        if (!this.sampleData)
-        {
-            let sampleData;
-            switch (this.wFormatTag)
-            {
-                default:
-                    SpessaSynthWarn(`Failed to decode sample. Unknown wFormatTag: ${this.wFormatTag}`);
-                    sampleData = new Float32Array(this.rawData.length / this.bytesPerSample);
-                    break;
-                
-                case W_FORMAT_TAG.PCM:
-                    sampleData = readPCM(this.rawData, this.bytesPerSample);
-                    break;
-                
-                case W_FORMAT_TAG.ALAW:
-                    sampleData = readALAW(this.rawData, this.bytesPerSample);
-                    break;
-                
-            }
-            this.setAudioData(sampleData);
-        }
-        return this.sampleData;
-    }
-    
-    /**
-     * @param audioData {Float32Array}
-     */
-    setAudioData(audioData)
-    {
-        super.setAudioData(audioData);
-    }
-    
-    getRawData(allowVorbis)
-    {
-        if (this.dataOverriden || this.isCompressed)
-        {
-            return super.getRawData(allowVorbis);
-        }
-        if (this.wFormatTag === W_FORMAT_TAG.PCM && this.bytesPerSample === 2)
-        {
-            // copy straight away
-            return this.rawData;
-        }
-        return this.encodeS16LE();
-    }
-}

package/src/soundfont/dls/dls_soundfont.js

@@ -1,183 +0,0 @@
-import { BasicSoundBank } from "../basic_soundfont/basic_soundbank.js";
-import { IndexedByteArray } from "../../utils/indexed_array.js";
-import { SpessaSynthGroup, SpessaSynthGroupEnd, SpessaSynthInfo } from "../../utils/loggin.js";
-import { consoleColors } from "../../utils/other.js";
-import { findRIFFListType, readRIFFChunk } from "../basic_soundfont/riff_chunk.js";
-import { readBytesAsString } from "../../utils/byte_functions/string.js";
-import { readLittleEndian } from "../../utils/byte_functions/little_endian.js";
-import { readDLSInstrumentList } from "./read_instrument_list.js";
-import { readDLSInstrument } from "./read_instrument.js";
-import { readLart } from "./read_lart.js";
-import { readDLSSamples } from "./read_samples.js";
-
-class DLSSoundFont extends BasicSoundBank
-{
-    /**
-     * Loads a new DLS (Downloadable sounds) soundfont
-     * @param buffer {ArrayBuffer}
-     */
-    constructor(buffer)
-    {
-        super();
-        this.dataArray = new IndexedByteArray(buffer);
-        SpessaSynthGroup("%cParsing DLS...", consoleColors.info);
-        if (!this.dataArray)
-        {
-            SpessaSynthGroupEnd();
-            this.parsingError("No data provided!");
-        }
-        
-        // read the main chunk
-        let firstChunk = readRIFFChunk(this.dataArray, false);
-        this.verifyHeader(firstChunk, "riff");
-        this.verifyText(readBytesAsString(this.dataArray, 4).toLowerCase(), "dls ");
-        
-        /**
-         * Read the list
-         * @type {RiffChunk[]}
-         */
-        const chunks = [];
-        while (this.dataArray.currentIndex < this.dataArray.length)
-        {
-            chunks.push(readRIFFChunk(this.dataArray));
-        }
-        
-        // mandatory
-        this.soundFontInfo["ifil"] = "2.1"; // always for dls
-        this.soundFontInfo["isng"] = "E-mu 10K2";
-        
-        // set some defaults
-        this.soundFontInfo["INAM"] = "Unnamed DLS";
-        this.soundFontInfo["IENG"] = "Unknown";
-        this.soundFontInfo["IPRD"] = "SpessaSynth DLS";
-        this.soundFontInfo["ICRD"] = new Date().toDateString();
-        
-        // read info
-        const infoChunk = findRIFFListType(chunks, "INFO");
-        if (infoChunk)
-        {
-            while (infoChunk.chunkData.currentIndex < infoChunk.chunkData.length)
-            {
-                const infoPart = readRIFFChunk(infoChunk.chunkData);
-                this.soundFontInfo[infoPart.header] = readBytesAsString(infoPart.chunkData, infoPart.size);
-            }
-        }
-        this.soundFontInfo["ICMT"] = this.soundFontInfo["ICMT"] || "(No description)";
-        if (this.soundFontInfo["ISBJ"])
-        {
-            // merge it
-            this.soundFontInfo["ICMT"] += "\n" + this.soundFontInfo["ISBJ"];
-            delete this.soundFontInfo["ISBJ"];
-        }
-        this.soundFontInfo["ICMT"] += "\nConverted from DLS to SF2 with SpessaSynth";
-        
-        for (const [info, value] of Object.entries(this.soundFontInfo))
-        {
-            SpessaSynthInfo(
-                `%c"${info}": %c"${value}"`,
-                consoleColors.info,
-                consoleColors.recognized
-            );
-        }
-        
-        // read "colh"
-        let colhChunk = chunks.find(c => c.header === "colh");
-        if (!colhChunk)
-        {
-            SpessaSynthGroupEnd();
-            this.parsingError("No colh chunk!");
-        }
-        this.instrumentAmount = readLittleEndian(colhChunk.chunkData, 4);
-        SpessaSynthInfo(
-            `%cInstruments amount: %c${this.instrumentAmount}`,
-            consoleColors.info,
-            consoleColors.recognized
-        );
-        
-        // read the wave list
-        let waveListChunk = findRIFFListType(chunks, "wvpl");
-        if (!waveListChunk)
-        {
-            SpessaSynthGroupEnd();
-            this.parsingError("No wvpl chunk!");
-        }
-        this.readDLSSamples(waveListChunk);
-        
-        // read the instrument list
-        let instrumentListChunk = findRIFFListType(chunks, "lins");
-        if (!instrumentListChunk)
-        {
-            SpessaSynthGroupEnd();
-            this.parsingError("No lins chunk!");
-        }
-        this.readDLSInstrumentList(instrumentListChunk);
-        
-        // sort presets
-        this.flush();
-        SpessaSynthInfo(
-            `%cParsing finished! %c"${this.soundFontInfo["INAM"] || "UNNAMED"}"%c has %c${this.presets.length} %cpresets,
-        %c${this.instruments.length}%c instruments and %c${this.samples.length}%c samples.`,
-            consoleColors.info,
-            consoleColors.recognized,
-            consoleColors.info,
-            consoleColors.recognized,
-            consoleColors.info,
-            consoleColors.recognized,
-            consoleColors.info,
-            consoleColors.recognized,
-            consoleColors.info
-        );
-        SpessaSynthGroupEnd();
-    }
-    
-    /**
-     * @param chunk {RiffChunk}
-     * @param expected {string}
-     */
-    verifyHeader(chunk, ...expected)
-    {
-        for (const expect of expected)
-        {
-            if (chunk.header.toLowerCase() === expect.toLowerCase())
-            {
-                return;
-            }
-        }
-        SpessaSynthGroupEnd();
-        this.parsingError(`Invalid DLS chunk header! Expected "${expected.toString()}" got "${chunk.header.toLowerCase()}"`);
-    }
-    
-    /**
-     * @param text {string}
-     * @param expected {string}
-     */
-    verifyText(text, expected)
-    {
-        if (text.toLowerCase() !== expected.toLowerCase())
-        {
-            SpessaSynthGroupEnd();
-            this.parsingError(`FourCC error: Expected "${expected.toLowerCase()}" got "${text.toLowerCase()}"`);
-        }
-    }
-    
-    /**
-     * @param error {string}
-     */
-    parsingError(error)
-    {
-        throw new Error(`DLS parse error: ${error} The file may be corrupted.`);
-    }
-    
-    destroySoundBank()
-    {
-        super.destroySoundBank();
-        delete this.dataArray;
-    }
-}
-
-DLSSoundFont.prototype.readDLSInstrumentList = readDLSInstrumentList;
-DLSSoundFont.prototype.readDLSInstrument = readDLSInstrument;
-DLSSoundFont.prototype.readLart = readLart;
-DLSSoundFont.prototype.readDLSSamples = readDLSSamples;
-
-export { DLSSoundFont };

package/src/soundfont/dls/dls_sources.js

@@ -1,63 +0,0 @@
-import { DecodedModulator } from "../basic_soundfont/modulator.js";
-
-import { generatorTypes } from "../basic_soundfont/generator_types.js";
-
-/**
- * @enum {number}
- */
-export const DLSSources = {
-    none: 0x0,
-    modLfo: 0x1,
-    velocity: 0x2,
-    keyNum: 0x3,
-    volEnv: 0x4,
-    modEnv: 0x5,
-    pitchWheel: 0x6,
-    polyPressure: 0x7,
-    channelPressure: 0x8,
-    vibratoLfo: 0x9,
-    
-    modulationWheel: 0x81,
-    volume: 0x87,
-    pan: 0x8a,
-    expression: 0x8b,
-    // note: these are flipped unintentionally in DLS2 table 9. Argh!
-    chorus: 0xdd,
-    reverb: 0xdb,
-    
-    pitchWheelRange: 0x100,
-    fineTune: 0x101,
-    coarseTune: 0x102
-};
-
-export const DEFAULT_DLS_REVERB = new DecodedModulator(
-    0x00DB,
-    0x0,
-    generatorTypes.reverbEffectsSend,
-    1000,
-    0
-);
-
-export const DEFAULT_DLS_CHORUS = new DecodedModulator(
-    0x00DD,
-    0x0,
-    generatorTypes.chorusEffectsSend,
-    1000,
-    0
-);
-
-export const DLS_1_NO_VIBRATO_MOD = new DecodedModulator(
-    0x0081,
-    0x0,
-    generatorTypes.vibLfoToPitch,
-    0,
-    0
-);
-
-export const DLS_1_NO_VIBRATO_PRESSURE = new DecodedModulator(
-    0x000D,
-    0x0,
-    generatorTypes.vibLfoToPitch,
-    0,
-    0
-);

package/src/soundfont/dls/dls_zone.js

@@ -1,89 +0,0 @@
-import { Generator } from "../basic_soundfont/generator.js";
-import { generatorTypes } from "../basic_soundfont/generator_types.js";
-import { BasicInstrumentZone } from "../basic_soundfont/basic_instrument_zone.js";
-
-export class DLSZone extends BasicInstrumentZone
-{
-    /**
-     * @param inst {BasicInstrument}
-     */
-    constructor(inst)
-    {
-        super(inst);
-    }
-    
-    /**
-     * @param attenuationCb {number} with EMU correction
-     * @param loopingMode {number} the sfont one
-     * @param loop {{start: number, end: number}}
-     * @param sampleKey {number}
-     * @param sample {BasicSample}
-     * @param sampleID {number}
-     * @param samplePitchCorrection {number} cents
-     */
-    setWavesample(
-        attenuationCb,
-        loopingMode,
-        loop,
-        sampleKey,
-        sample,
-        sampleID,
-        samplePitchCorrection
-    )
-    {
-        if (loopingMode !== 0)
-        {
-            this.addGenerators(new Generator(generatorTypes.sampleModes, loopingMode));
-        }
-        this.addGenerators(new Generator(generatorTypes.initialAttenuation, attenuationCb));
-        
-        // correct tuning if needed
-        samplePitchCorrection -= sample.samplePitchCorrection;
-        const coarseTune = Math.trunc(samplePitchCorrection / 100);
-        if (coarseTune !== 0)
-        {
-            this.addGenerators(new Generator(generatorTypes.coarseTune, coarseTune));
-        }
-        const fineTune = samplePitchCorrection - (coarseTune * 100);
-        if (fineTune !== 0)
-        {
-            this.addGenerators(new Generator(generatorTypes.fineTune, fineTune));
-        }
-        
-        // correct loop if needed
-        if (loopingMode !== 0)
-        {
-            const diffStart = loop.start - sample.sampleLoopStartIndex;
-            const diffEnd = loop.end - sample.sampleLoopEndIndex;
-            if (diffStart !== 0)
-            {
-                const fine = diffStart % 32768;
-                this.addGenerators(new Generator(generatorTypes.startloopAddrsOffset, fine));
-                // coarse generator uses 32768 samples per step
-                const coarse = Math.trunc(diffStart / 32768);
-                if (coarse !== 0)
-                {
-                    this.addGenerators(new Generator(generatorTypes.startloopAddrsCoarseOffset, coarse));
-                }
-            }
-            if (diffEnd !== 0)
-            {
-                const fine = diffEnd % 32768;
-                this.addGenerators(new Generator(generatorTypes.endloopAddrsOffset, fine));
-                // coarse generator uses 32768 samples per step
-                const coarse = Math.trunc(diffEnd / 32768);
-                if (coarse !== 0)
-                {
-                    this.addGenerators(new Generator(generatorTypes.endloopAddrsCoarseOffset, coarse));
-                }
-            }
-        }
-        // correct the key if needed
-        if (sampleKey !== sample.samplePitch)
-        {
-            this.addGenerators(new Generator(generatorTypes.overridingRootKey, sampleKey));
-        }
-        // add sample
-        this.setSample(sample);
-    }
-}