spessasynth_core 3.27.7 → 4.0.0

package/src/soundfont/basic_soundfont/riff_chunk.js

@@ -1,195 +0,0 @@
-import { IndexedByteArray } from "../../utils/indexed_array.js";
-import { readLittleEndian, writeDword } from "../../utils/byte_functions/little_endian.js";
-import { readBytesAsString, writeStringAsBytes } from "../../utils/byte_functions/string.js";
-
-/**
- * riff_chunk.js
- * reads a riff chunk and stores it as a class
- */
-
-export class RiffChunk
-{
-    /**
-     * The chunks FourCC code
-     * @type {string}
-     */
-    header;
-    
-    /**
-     * Chunk's size, in bytes
-     * @type {number}
-     */
-    size;
-    
-    /**
-     * Chunk's binary data
-     * @type {IndexedByteArray}
-     */
-    chunkData;
-    
-    /**
-     * Creates a new RIFF chunk
-     * @constructor
-     * @param header {string}
-     * @param size {number}
-     * @param data {IndexedByteArray}
-     */
-    constructor(header, size, data)
-    {
-        this.header = header;
-        this.size = size;
-        this.chunkData = data;
-    }
-    
-}
-
-/**
- * @param dataArray {IndexedByteArray}
- * @param readData {boolean}
- * @param forceShift {boolean}
- * @returns {RiffChunk}
- */
-export function readRIFFChunk(dataArray, readData = true, forceShift = false)
-{
-    let header = readBytesAsString(dataArray, 4);
-    
-    let size = readLittleEndian(dataArray, 4);
-    if (header === "")
-    {
-        // safeguard against evil DLS files
-        // The test case: CrysDLS v1.23.dls
-        // https://github.com/spessasus/spessasynth_core/issues/5
-        size = 0;
-    }
-    /**
-     * @type {IndexedByteArray}
-     */
-    let chunkData = undefined;
-    if (readData)
-    {
-        chunkData = dataArray.slice(dataArray.currentIndex, dataArray.currentIndex + size);
-    }
-    if (readData || forceShift)
-    {
-        dataArray.currentIndex += size;
-    }
-    
-    if (size % 2 !== 0)
-    {
-        if (dataArray[dataArray.currentIndex] === 0)
-        {
-            dataArray.currentIndex++;
-        }
-    }
-    
-    return new RiffChunk(header, size, chunkData);
-}
-
-/**
- * Writes a RIFF chunk correctly
- * @param header {string} fourCC
- * @param data {Uint8Array} chunk data
- * @param addZeroByte {boolean} add a zero byte into the chunk size
- * @param isList {boolean} adds "LIST" as the chunk type and writes the actual type at the start of the data
- * @returns {IndexedByteArray}
- */
-export function writeRIFFChunkRaw(header, data, addZeroByte = false, isList = false)
-{
-    let dataStartOffset = 8;
-    let headerWritten = header;
-    let dataLength = data.length;
-    if (addZeroByte)
-    {
-        dataLength++;
-    }
-    let writtenSize = dataLength;
-    if (isList)
-    {
-        // written header is LIST and the passed header is the first 4 bytes of chunk data
-        dataStartOffset += 4;
-        writtenSize += 4;
-        headerWritten = "LIST";
-    }
-    let finalSize = dataStartOffset + dataLength;
-    if (finalSize % 2 !== 0)
-    {
-        // pad byte does not get included in the size
-        finalSize++;
-    }
-    
-    const outArray = new IndexedByteArray(finalSize);
-    // FourCC ("RIFF", "LIST", "pdta" etc.)
-    writeStringAsBytes(outArray, headerWritten);
-    // chunk size
-    writeDword(outArray, writtenSize);
-    if (isList)
-    {
-        // list type (e.g. "INFO")
-        writeStringAsBytes(outArray, header);
-    }
-    outArray.set(data, dataStartOffset);
-    return outArray;
-}
-
-/**
- * Writes RIFF chunk given binary blobs
- * @param header {string} fourCC
- * @param chunks {Uint8Array[]} chunk data parts, it will be combined in order
- * @param isList {boolean} adds "LIST" as the chunk type and writes the actual type at the start of the data
- * @returns {IndexedByteArray}
- */
-export function writeRIFFChunkParts(header, chunks, isList = false)
-{
-    let dataOffset = 8;
-    let headerWritten = header;
-    let dataLength = chunks.reduce((len, c) => c.length + len, 0);
-    let writtenSize = dataLength;
-    if (isList)
-    {
-        // written header is LIST and the passed header is the first 4 bytes of chunk data
-        dataOffset += 4;
-        writtenSize += 4;
-        headerWritten = "LIST";
-    }
-    let finalSize = dataOffset + dataLength;
-    if (finalSize % 2 !== 0)
-    {
-        // pad byte does not get included in the size
-        finalSize++;
-    }
-    
-    const outArray = new IndexedByteArray(finalSize);
-    // fourCC ("RIFF", "LIST", "pdta" etc.)
-    writeStringAsBytes(outArray, headerWritten);
-    // chunk size
-    writeDword(outArray, writtenSize);
-    if (isList)
-    {
-        // list type (e.g. "INFO")
-        writeStringAsBytes(outArray, header);
-    }
-    chunks.forEach(c =>
-    {
-        outArray.set(c, dataOffset);
-        dataOffset += c.length;
-    });
-    return outArray;
-}
-
-/**
- * @param collection {RiffChunk[]}
- * @param type {string}
- * @returns {RiffChunk|undefined}
- */
-export function findRIFFListType(collection, type)
-{
-    return collection.find(c =>
-    {
-        if (c.header !== "LIST")
-        {
-            return false;
-        }
-        c.chunkData.currentIndex = 0;
-        return readBytesAsString(c.chunkData, 4) === type;
-    });
-}

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

@@ -1,174 +0,0 @@
-import { getDLSArticulatorFromSf2Generator, getDLSArticulatorFromSf2Modulator } from "./modulator_converter.js";
-import { writeRIFFChunkParts } from "../riff_chunk.js";
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { Generator } from "../generator.js";
-import { writeDword } from "../../../utils/byte_functions/little_endian.js";
-import { consoleColors } from "../../../utils/other.js";
-import { SpessaSynthInfo, SpessaSynthWarn } from "../../../utils/loggin.js";
-import { Modulator } from "../modulator.js";
-import {
-    DEFAULT_DLS_CHORUS,
-    DEFAULT_DLS_REVERB,
-    DLS_1_NO_VIBRATO_MOD,
-    DLS_1_NO_VIBRATO_PRESSURE
-} from "../../dls/dls_sources.js";
-import { generatorTypes } from "../generator_types.js";
-
-const invalidGeneratorTypes = new Set([
-    generatorTypes.sampleModes,
-    generatorTypes.initialAttenuation,
-    generatorTypes.keyRange,
-    generatorTypes.velRange,
-    generatorTypes.sampleID,
-    generatorTypes.fineTune,
-    generatorTypes.coarseTune,
-    generatorTypes.startAddrsOffset,
-    generatorTypes.startAddrsCoarseOffset,
-    generatorTypes.endAddrOffset,
-    generatorTypes.endAddrsCoarseOffset,
-    generatorTypes.startloopAddrsOffset,
-    generatorTypes.startloopAddrsCoarseOffset,
-    generatorTypes.endloopAddrsOffset,
-    generatorTypes.endloopAddrsCoarseOffset,
-    generatorTypes.overridingRootKey,
-    generatorTypes.exclusiveClass
-]);
-
-/**
- * @param zone {BasicZone}
- * @returns {IndexedByteArray}
- */
-export function writeArticulator(zone)
-{
-    
-    
-    // envelope generators are limited to 40 seconds
-    // in timecents, this is 1200 * log2(10) = 6386
-    
-    for (let i = 0; i < zone.generators.length; i++)
-    {
-        const g = zone.generators[i];
-        if (
-            g.generatorType === generatorTypes.delayVolEnv ||
-            g.generatorType === generatorTypes.attackVolEnv ||
-            g.generatorType === generatorTypes.holdVolEnv ||
-            g.generatorType === generatorTypes.decayVolEnv ||
-            g.generatorType === generatorTypes.releaseVolEnv ||
-            g.generatorType === generatorTypes.delayModEnv ||
-            g.generatorType === generatorTypes.attackModEnv ||
-            g.generatorType === generatorTypes.holdModEnv ||
-            g.generatorType === generatorTypes.decayModEnv
-        )
-        {
-            zone.generators[i] = new Generator(g.generatorType, Math.min(g.generatorValue, 6386), false);
-        }
-    }
-    
-    
-    // read_articulation.js:
-    // according to viena and another strange (with modulators) rendition of gm.dls in sf2,
-    // it shall be divided by -128,
-    // and a strange correction needs to be applied to the real value:
-    // real + (60 / 128) * scale
-    // we invert this here
-    for (let i = 0; i < zone.generators.length; i++)
-    {
-        const relativeGenerator = zone.generators[i];
-        let absoluteCounterpart = undefined;
-        switch (relativeGenerator.generatorType)
-        {
-            default:
-                continue;
-            
-            case generatorTypes.keyNumToVolEnvDecay:
-                absoluteCounterpart = generatorTypes.decayVolEnv;
-                break;
-            case generatorTypes.keyNumToVolEnvHold:
-                absoluteCounterpart = generatorTypes.holdVolEnv;
-                break;
-            case generatorTypes.keyNumToModEnvDecay:
-                absoluteCounterpart = generatorTypes.decayModEnv;
-                break;
-            case generatorTypes.keyNumToModEnvHold:
-                absoluteCounterpart = generatorTypes.holdModEnv;
-        }
-        let absoluteGenerator = zone.generators.find(g => g.generatorType === absoluteCounterpart);
-        if (absoluteGenerator === undefined)
-        {
-            // there's no absolute generator here.
-            continue;
-        }
-        const dlsRelative = relativeGenerator.generatorValue * -128;
-        const subtraction = (60 / 128) * dlsRelative;
-        const newAbsolute = absoluteGenerator.generatorValue - subtraction;
-        
-        const iR = zone.generators.indexOf(relativeGenerator);
-        const iA = zone.generators.indexOf(absoluteGenerator);
-        zone.generators[iA] =
-            new Generator(absoluteCounterpart, newAbsolute, false);
-        zone.generators[iR] =
-            new Generator(relativeGenerator.generatorType, dlsRelative, false);
-    }
-    /**
-     * @type {Articulator[]}
-     */
-    const generators = zone.generators.reduce((arrs, g) =>
-    {
-        if (invalidGeneratorTypes.has(g.generatorType))
-        {
-            return arrs;
-        }
-        const art = getDLSArticulatorFromSf2Generator(g);
-        if (art !== undefined)
-        {
-            arrs.push(art);
-            SpessaSynthInfo("%cSucceeded converting to DLS Articulator!", consoleColors.recognized);
-            
-        }
-        else
-        {
-            SpessaSynthWarn("Failed converting to DLS Articulator!");
-        }
-        return arrs;
-    }, []);
-    /**
-     * @type {Articulator[]}
-     */
-    const modulators = zone.modulators.reduce((arrs, m) =>
-    {
-        // do not write the default DLS modulators
-        if (
-            Modulator.isIdentical(m, DEFAULT_DLS_CHORUS, true) ||
-            Modulator.isIdentical(m, DEFAULT_DLS_REVERB, true) ||
-            Modulator.isIdentical(m, DLS_1_NO_VIBRATO_MOD, true) ||
-            Modulator.isIdentical(m, DLS_1_NO_VIBRATO_PRESSURE, true)
-        )
-        {
-            return arrs;
-        }
-        const art = getDLSArticulatorFromSf2Modulator(m);
-        if (art !== undefined)
-        {
-            arrs.push(art);
-            SpessaSynthInfo("%cSucceeded converting to DLS Articulator!", consoleColors.recognized);
-            
-        }
-        else
-        {
-            SpessaSynthWarn("Failed converting to DLS Articulator!");
-        }
-        return arrs;
-    }, []);
-    generators.push(...modulators);
-    
-    const art2Data = new IndexedByteArray(8);
-    writeDword(art2Data, 8); // cbSize
-    writeDword(art2Data, generators.length); // cbConnectionBlocks
-    
-    
-    const out = generators.map(a => a.writeArticulator());
-    return writeRIFFChunkParts(
-        "art2",
-        [art2Data, ...out]
-    );
-}

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

@@ -1,49 +0,0 @@
-import { IndexedByteArray } from "../../../utils/indexed_array.js";
-import { writeDword, writeWord } from "../../../utils/byte_functions/little_endian.js";
-
-export class Articulator
-{
-    /**
-     * @type {DLSSources}
-     */
-    source;
-    /**
-     * @type {DLSSources}
-     */
-    control;
-    /**
-     * @type {DLSDestinations}
-     */
-    destination;
-    /**
-     * @type {number}
-     */
-    scale;
-    /**
-     * @type {number}
-     */
-    transform;
-    
-    constructor(source, control, destination, scale, transform)
-    {
-        this.source = source;
-        this.control = control;
-        this.destination = destination;
-        this.scale = scale;
-        this.transform = transform;
-    }
-    
-    /**
-     * @returns {IndexedByteArray}
-     */
-    writeArticulator()
-    {
-        const out = new IndexedByteArray(12);
-        writeWord(out, this.source);
-        writeWord(out, this.control);
-        writeWord(out, this.destination);
-        writeWord(out, this.transform);
-        writeDword(out, this.scale << 16);
-        return out;
-    }
-}