spessasynth_core 1.1.3 → 1.1.4

package/src/soundfont/basic_soundfont/riff_chunk.js

@@ -0,0 +1,149 @@
+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 read and stores it as a class
+ */
+
+export class RiffChunk
+{
+    /**
+     * Creates a new riff read
+     * @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);
+    let chunkData = undefined;
+    if (readData)
+    {
+        chunkData = new IndexedByteArray(dataArray.buffer.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);
+}
+
+/**
+ * @param chunk {RiffChunk}
+ * @param prepend {IndexedByteArray}
+ * @returns {IndexedByteArray}
+ */
+export function writeRIFFChunk(chunk, prepend = undefined)
+{
+    let size = 8 + chunk.size;
+    if (chunk.size % 2 !== 0)
+    {
+        size++;
+    }
+    if (prepend)
+    {
+        size += prepend.length;
+    }
+    const array = new IndexedByteArray(size);
+    // prepend data (for example, type before the read)
+    if (prepend)
+    {
+        array.set(prepend, array.currentIndex);
+        array.currentIndex += prepend.length;
+    }
+    // write header
+    writeStringAsBytes(array, chunk.header);
+    // write size (excluding header and the size itself) and then prepend if specified
+    writeDword(array, size - 8 - (prepend?.length || 0));
+    // write data
+    array.set(chunk.chunkData, array.currentIndex);
+    return array;
+}
+
+/**
+ * @param header {string}
+ * @param data {Uint8Array}
+ * @param addZeroByte {Boolean}
+ * @param isList {boolean}
+ * @returns {IndexedByteArray}
+ */
+export function writeRIFFOddSize(header, data, addZeroByte = false, isList = false)
+{
+    if (addZeroByte)
+    {
+        const tempData = new Uint8Array(data.length + 1);
+        tempData.set(data);
+        data = tempData;
+    }
+    let offset = 8;
+    let finalSize = offset + data.length;
+    let writtenSize = data.length;
+    if (finalSize % 2 !== 0)
+    {
+        finalSize++;
+    }
+    let headerWritten = header;
+    if (isList)
+    {
+        finalSize += 4;
+        writtenSize += 4;
+        offset += 4;
+        headerWritten = "LIST";
+    }
+    const outArray = new IndexedByteArray(finalSize);
+    writeStringAsBytes(outArray, headerWritten);
+    writeDword(outArray, writtenSize);
+    if (isList)
+    {
+        writeStringAsBytes(outArray, header);
+    }
+    outArray.set(data, offset);
+    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

@@ -0,0 +1,173 @@
+import { getDLSArticulatorFromSf2Generator, getDLSArticulatorFromSf2Modulator } from "./modulator_converter.js";
+import { writeRIFFOddSize } from "../riff_chunk.js";
+import { combineArrays, IndexedByteArray } from "../../../utils/indexed_array.js";
+import { Generator, generatorTypes } 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";
+
+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 {BasicInstrumentZone}
+ * @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 writeRIFFOddSize(
+        "art2",
+        combineArrays([art2Data, ...out])
+    );
+}

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

@@ -0,0 +1,49 @@
+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;
+    }
+}