spessasynth_lib 3.25.22 → 3.26.0

package/soundfont/read_sf2/zones.js

@@ -1,263 +0,0 @@
-import { readLittleEndian } from "../../utils/byte_functions/little_endian.js";
-import { IndexedByteArray } from "../../utils/indexed_array.js";
-import { RiffChunk } from "../basic_soundfont/riff_chunk.js";
-import { BasicInstrumentZone, BasicPresetZone } from "../basic_soundfont/basic_zones.js";
-import { Generator, generatorTypes } from "../basic_soundfont/generator.js";
-import { Modulator } from "../basic_soundfont/modulator.js";
-
-/**
- * zones.js
- * purpose: reads instrumend and preset zones from soundfont and gets their respective samples and generators and modulators
- */
-
-export class InstrumentZone extends BasicInstrumentZone
-{
-    /**
-     * Creates a zone (instrument)
-     * @param dataArray {IndexedByteArray}
-     */
-    constructor(dataArray)
-    {
-        super();
-        this.generatorZoneStartIndex = readLittleEndian(dataArray, 2);
-        this.modulatorZoneStartIndex = readLittleEndian(dataArray, 2);
-        this.modulatorZoneSize = 0;
-        this.generatorZoneSize = 0;
-        this.isGlobal = true;
-    }
-    
-    setZoneSize(modulatorZoneSize, generatorZoneSize)
-    {
-        this.modulatorZoneSize = modulatorZoneSize;
-        this.generatorZoneSize = generatorZoneSize;
-    }
-    
-    /**
-     * grab the generators
-     * @param generators {Generator[]}
-     */
-    getGenerators(generators)
-    {
-        for (let i = this.generatorZoneStartIndex; i < this.generatorZoneStartIndex + this.generatorZoneSize; i++)
-        {
-            this.generators.push(generators[i]);
-        }
-    }
-    
-    /**
-     * grab the modulators
-     * @param modulators {Modulator[]}
-     */
-    getModulators(modulators)
-    {
-        for (let i = this.modulatorZoneStartIndex; i < this.modulatorZoneStartIndex + this.modulatorZoneSize; i++)
-        {
-            this.modulators.push(modulators[i]);
-        }
-    }
-    
-    /**
-     * Loads the zone's sample
-     * @param samples {BasicSample[]}
-     */
-    getSample(samples)
-    {
-        let sampleID = this.generators.find(g => g.generatorType === generatorTypes.sampleID);
-        if (sampleID)
-        {
-            this.sample = samples[sampleID.generatorValue];
-            this.isGlobal = false;
-            this.sample.useCount++;
-        }
-    }
-    
-    /**
-     * Reads the keyRange of the zone
-     */
-    getKeyRange()
-    {
-        let range = this.generators.find(g => g.generatorType === generatorTypes.keyRange);
-        if (range)
-        {
-            this.keyRange.min = range.generatorValue & 0x7F;
-            this.keyRange.max = (range.generatorValue >> 8) & 0x7F;
-        }
-    }
-    
-    /**
-     * reads the velolicty range of the zone
-     */
-    getVelRange()
-    {
-        let range = this.generators.find(g => g.generatorType === generatorTypes.velRange);
-        if (range)
-        {
-            this.velRange.min = range.generatorValue & 0x7F;
-            this.velRange.max = (range.generatorValue >> 8) & 0x7F;
-        }
-    }
-}
-
-/**
- * Reads the given instrument zone read
- * @param zonesChunk {RiffChunk}
- * @param instrumentGenerators {Generator[]}
- * @param instrumentModulators {Modulator[]}
- * @param instrumentSamples {BasicSample[]}
- * @returns {InstrumentZone[]}
- */
-export function readInstrumentZones(zonesChunk, instrumentGenerators, instrumentModulators, instrumentSamples)
-{
-    /**
-     * @type {InstrumentZone[]}
-     */
-    let zones = [];
-    while (zonesChunk.chunkData.length > zonesChunk.chunkData.currentIndex)
-    {
-        let zone = new InstrumentZone(zonesChunk.chunkData);
-        if (zones.length > 0)
-        {
-            let modulatorZoneSize = zone.modulatorZoneStartIndex - zones[zones.length - 1].modulatorZoneStartIndex;
-            let generatorZoneSize = zone.generatorZoneStartIndex - zones[zones.length - 1].generatorZoneStartIndex;
-            zones[zones.length - 1].setZoneSize(modulatorZoneSize, generatorZoneSize);
-            zones[zones.length - 1].getGenerators(instrumentGenerators);
-            zones[zones.length - 1].getModulators(instrumentModulators);
-            zones[zones.length - 1].getSample(instrumentSamples);
-            zones[zones.length - 1].getKeyRange();
-            zones[zones.length - 1].getVelRange();
-        }
-        zones.push(zone);
-    }
-    if (zones.length > 1)
-    {
-        // remove terminal
-        zones.pop();
-    }
-    return zones;
-}
-
-export class PresetZone extends BasicPresetZone
-{
-    /**
-     * Creates a zone (preset)
-     * @param dataArray {IndexedByteArray}
-     */
-    constructor(dataArray)
-    {
-        super();
-        this.generatorZoneStartIndex = readLittleEndian(dataArray, 2);
-        this.modulatorZoneStartIndex = readLittleEndian(dataArray, 2);
-        this.modulatorZoneSize = 0;
-        this.generatorZoneSize = 0;
-        this.isGlobal = true;
-    }
-    
-    setZoneSize(modulatorZoneSize, generatorZoneSize)
-    {
-        this.modulatorZoneSize = modulatorZoneSize;
-        this.generatorZoneSize = generatorZoneSize;
-    }
-    
-    /**
-     * grab the generators
-     * @param generators {Generator[]}
-     */
-    getGenerators(generators)
-    {
-        for (let i = this.generatorZoneStartIndex; i < this.generatorZoneStartIndex + this.generatorZoneSize; i++)
-        {
-            this.generators.push(generators[i]);
-        }
-    }
-    
-    /**
-     * grab the modulators
-     * @param modulators {Modulator[]}
-     */
-    getModulators(modulators)
-    {
-        for (let i = this.modulatorZoneStartIndex; i < this.modulatorZoneStartIndex + this.modulatorZoneSize; i++)
-        {
-            this.modulators.push(modulators[i]);
-        }
-    }
-    
-    /**
-     * grab the instrument
-     * @param instruments {BasicInstrument[]}
-     */
-    getInstrument(instruments)
-    {
-        let instrumentID = this.generators.find(g => g.generatorType === generatorTypes.instrument);
-        if (instrumentID)
-        {
-            this.instrument = instruments[instrumentID.generatorValue];
-            this.instrument.addUseCount();
-            this.isGlobal = false;
-        }
-    }
-    
-    /**
-     * Reads the keyRange of the zone
-     */
-    getKeyRange()
-    {
-        let range = this.generators.find(g => g.generatorType === generatorTypes.keyRange);
-        if (range)
-        {
-            this.keyRange.min = range.generatorValue & 0x7F;
-            this.keyRange.max = (range.generatorValue >> 8) & 0x7F;
-        }
-    }
-    
-    /**
-     * reads the velolicty range of the zone
-     */
-    getVelRange()
-    {
-        let range = this.generators.find(g => g.generatorType === generatorTypes.velRange);
-        if (range)
-        {
-            this.velRange.min = range.generatorValue & 0x7F;
-            this.velRange.max = (range.generatorValue >> 8) & 0x7F;
-        }
-    }
-}
-
-/**
- * Reads the given preset zone read
- * @param zonesChunk {RiffChunk}
- * @param presetGenerators {Generator[]}
- * @param instruments {BasicInstrument[]}
- * @param presetModulators {Modulator[]}
- * @returns {PresetZone[]}
- */
-export function readPresetZones(zonesChunk, presetGenerators, presetModulators, instruments)
-{
-    /**
-     * @type {PresetZone[]}
-     */
-    let zones = [];
-    while (zonesChunk.chunkData.length > zonesChunk.chunkData.currentIndex)
-    {
-        let zone = new PresetZone(zonesChunk.chunkData);
-        if (zones.length > 0)
-        {
-            let modulatorZoneSize = zone.modulatorZoneStartIndex - zones[zones.length - 1].modulatorZoneStartIndex;
-            let generatorZoneSize = zone.generatorZoneStartIndex - zones[zones.length - 1].generatorZoneStartIndex;
-            zones[zones.length - 1].setZoneSize(modulatorZoneSize, generatorZoneSize);
-            zones[zones.length - 1].getGenerators(presetGenerators);
-            zones[zones.length - 1].getModulators(presetModulators);
-            zones[zones.length - 1].getInstrument(instruments);
-            zones[zones.length - 1].getKeyRange();
-            zones[zones.length - 1].getVelRange();
-        }
-        zones.push(zone);
-    }
-    if (zones.length > 1)
-    {
-        // remove terminal
-        zones.pop();
-    }
-    return zones;
-}

package/synthetizer/README.md

@@ -1,10 +0,0 @@
-## This is the main synthesizer folder.
-
-The code here is responsible for making the actual sound.
-This is the heart of the SpessaSynth library.
-
-- `audio_engine` - the core synthesis engine, it theoretically can run on non-browser environments.
-- `audio_effects` - the WebAudioAPI audio effects.
-- `worklet_wrapper` - the wrapper for the core synthesis engine using audio worklets.
-
-`worklet_processor.min.js` - the minified worklet processor code to import.

package/synthetizer/audio_effects/effects_config.js

@@ -1,25 +0,0 @@
-import { DEFAULT_CHORUS_CONFIG } from "./fancy_chorus.js";
-
-/**
- * @typedef {Object} SynthConfig
- * @property {boolean?} chorusEnabled - indicates if the chorus effect is enabled.
- * @property {ChorusConfig?} chorusConfig - the configuration for chorus. Pass undefined to use defaults
- * @property {boolean?} reverbEnabled - indicates if the reverb effect is enabled.
- * @property {AudioBuffer?} reverbImpulseResponse - the impulse response for the reverb. Pass undefined to use defaults
- * @property {{
- *      worklet: function(context: object, name: string, options?: Object)
- * }?} audioNodeCreators - custom audio node creation functions for Web Audio wrappers.
- */
-
-
-/**
- * @type {SynthConfig}
- */
-export const DEFAULT_SYNTH_CONFIG = {
-    chorusEnabled: true,
-    chorusConfig: DEFAULT_CHORUS_CONFIG,
-    
-    reverbEnabled: true,
-    reverbImpulseResponse: undefined, // will load the integrated one
-    audioNodeCreators: undefined
-};

package/synthetizer/audio_effects/fancy_chorus.js

@@ -1,162 +0,0 @@
-/**
- * fancy_chorus.js
- * purpose: creates a simple chorus effect node
- */
-
-/**
- * @typedef {{
- *     oscillator: OscillatorNode,
- *     oscillatorGain: GainNode,
- *     delay: DelayNode
- * }} ChorusNode
- */
-
-/**
- * @typedef {Object} ChorusConfig
- * @property {number?} nodesAmount - the amount of delay nodes (for each channel) and the corresponding oscillators
- * @property {number?} defaultDelay - the initial delay, in seconds
- * @property {number?} delayVariation - the difference between delays in the delay nodes
- * @property {number?} stereoDifference - the difference of delays between two channels (added to the left channel and subtracted from the right)
- * @property {number?} oscillatorFrequency - the initial delay time oscillator frequency, in Hz.
- * @property {number?} oscillatorFrequencyVariation - the difference between frequencies of oscillators, in Hz
- * @property {number?} oscillatorGain - how much will oscillator alter the delay in delay nodes, in seconds
- */
-
-const NODES_AMOUNT = 4;
-const DEFAULT_DELAY = 0.03;
-const DELAY_VARIATION = 0.01;
-const STEREO_DIFF = 0.02;
-
-const OSC_FREQ = 0.2;
-const OSC_FREQ_VARIATION = 0.05;
-const OSC_GAIN = 0.003;
-
-export const DEFAULT_CHORUS_CONFIG = {
-    nodesAmount: NODES_AMOUNT,
-    defaultDelay: DEFAULT_DELAY,
-    delayVariation: DELAY_VARIATION,
-    stereoDifference: STEREO_DIFF,
-    oscillatorFrequency: OSC_FREQ,
-    oscillatorFrequencyVariation: OSC_FREQ_VARIATION,
-    oscillatorGain: OSC_GAIN
-};
-
-export class FancyChorus
-{
-    /**
-     * Creates a fancy chorus effect
-     * @param output {AudioNode}
-     * @param config {ChorusConfig}
-     */
-    constructor(output, config = DEFAULT_CHORUS_CONFIG)
-    {
-        const context = output.context;
-        
-        this.input = context.createChannelSplitter(2);
-        
-        const merger = context.createChannelMerger(2);
-        
-        /**
-         * @type {ChorusNode[]}
-         */
-        const chorusNodesLeft = [];
-        /**
-         * @type {ChorusNode[]}
-         */
-        const chorusNodesRight = [];
-        let freq = config.oscillatorFrequency;
-        let delay = config.defaultDelay;
-        for (let i = 0; i < config.nodesAmount; i++)
-        {
-            // left node
-            this.createChorusNode(
-                freq,
-                delay - config.stereoDifference,
-                chorusNodesLeft,
-                0,
-                merger,
-                0,
-                context,
-                config
-            );
-            // right node
-            this.createChorusNode(
-                freq,
-                delay + config.stereoDifference,
-                chorusNodesRight,
-                1,
-                merger,
-                1,
-                context,
-                config
-            );
-            freq += config.oscillatorFrequencyVariation;
-            delay += config.delayVariation;
-        }
-        
-        merger.connect(output);
-        this.merger = merger;
-        this.chorusLeft = chorusNodesLeft;
-        this.chorusRight = chorusNodesRight;
-    }
-    
-    delete()
-    {
-        this.input.disconnect();
-        delete this.input;
-        this.merger.disconnect();
-        delete this.merger;
-        for (const chorusLeftElement of this.chorusLeft)
-        {
-            chorusLeftElement.delay.disconnect();
-            chorusLeftElement.oscillator.disconnect();
-            chorusLeftElement.oscillatorGain.disconnect();
-            delete chorusLeftElement.delay;
-            delete chorusLeftElement.oscillatorGain;
-            delete chorusLeftElement.oscillatorGain;
-        }
-        for (const chorusRightElement of this.chorusRight)
-        {
-            chorusRightElement.delay.disconnect();
-            chorusRightElement.oscillator.disconnect();
-            chorusRightElement.oscillatorGain.disconnect();
-            delete chorusRightElement.delay;
-            delete chorusRightElement.oscillatorGain;
-            delete chorusRightElement.oscillatorGain;
-        }
-    }
-    
-    /**
-     * @param freq {number}
-     * @param delay {number}
-     * @param list {ChorusNode[]}
-     * @param input {number}
-     * @param output {AudioNode}
-     * @param outputNum {number}
-     * @param context {BaseAudioContext}
-     * @param config {ChorusConfig}
-     */
-    createChorusNode(freq, delay, list, input, output, outputNum, context, config)
-    {
-        const oscillator = context.createOscillator();
-        oscillator.type = "sine";
-        oscillator.frequency.value = freq;
-        const gainNode = context.createGain();
-        gainNode.gain.value = config.oscillatorGain;
-        const delayNode = context.createDelay();
-        delayNode.delayTime.value = delay;
-        
-        oscillator.connect(gainNode);
-        gainNode.connect(delayNode.delayTime);
-        oscillator.start(context.currentTime /*+ delay*/);
-        
-        this.input.connect(delayNode, input);
-        delayNode.connect(output, 0, outputNum);
-        
-        list.push({
-            oscillator: oscillator,
-            oscillatorGain: gainNode,
-            delay: delayNode
-        });
-    }
-}