spessasynth_core 3.27.7 → 4.0.0

package/src/synthetizer/audio_engine/engine_methods/portamento_time.js

@@ -1,92 +0,0 @@
-// Tests were performed by John Novak
-// https://github.com/dosbox-staging/dosbox-staging/pull/2705
-
-/*
-CC 5 value  Portamento time
-----------  ---------------
-     0          0.000 s
-     1          0.006 s
-     2          0.023 s
-     4          0.050 s
-     8          0.110 s
-    16          0.250 s
-    32          0.500 s
-    64          2.060 s
-    80          4.200 s
-    96          8.400 s
-   112         19.500 s
-   116         26.700 s
-   120         40.000 s
-   124         80.000 s
-   127        480.000 s
-*/
-
-const portamentoLookup = {
-    0: 0.000,
-    1: 0.006,
-    2: 0.023,
-    4: 0.050,
-    8: 0.110,
-    16: 0.250,
-    32: 0.500,
-    64: 2.060,
-    80: 4.200,
-    96: 8.400,
-    112: 19.500,
-    116: 26.700,
-    120: 40.000,
-    124: 80.000,
-    127: 480.000
-};
-
-/**
- * @param value {number}
- * @returns {number}
- */
-function getLookup(value)
-{
-    if (portamentoLookup[value] !== undefined)
-    {
-        return portamentoLookup[value];
-    }
-    // get the nearest lower and upper points from the lookup table
-    let lower = null;
-    let upper = null;
-    
-    for (let key of Object.keys(portamentoLookup))
-    {
-        key = parseInt(key);
-        if (key < value && (lower === null || key > lower))
-        {
-            lower = key;
-        }
-        if (key > value && (upper === null || key < upper))
-        {
-            upper = key;
-        }
-    }
-    
-    // if we have found both lower and upper points, perform linear interpolation
-    if (lower !== null && upper !== null)
-    {
-        let lowerTime = portamentoLookup[lower];
-        let upperTime = portamentoLookup[upper];
-        
-        // linear interpolation
-        return lowerTime + ((value - lower) * (upperTime - lowerTime)) / (upper - lower);
-    }
-    return 0;
-}
-
-
-/**
- * Converts portamento time to seconds
- * @param time {number} 0 - 127
- * @param distance {number} distance in keys
- * @returns {number} seconds
- */
-export function portamentoTimeToSeconds(time, distance)
-{
-    // this seems to work fine for the MIDIs I have
-    return getLookup(time) * (distance / 30);
-}

package/src/synthetizer/audio_engine/engine_methods/program_change.js

@@ -1,35 +0,0 @@
-import { SpessaSynthWarn } from "../../../utils/loggin.js";
-import { BasicPreset } from "../../../soundfont/basic_soundfont/basic_preset.js";
-
-/**
- * executes a program change
- * @param programNumber {number}
- * @this {MidiAudioChannel}
- */
-export function programChange(programNumber)
-{
-    if (this.lockPreset)
-    {
-        return;
-    }
-    // always 128 for percussion
-    let bank = this.getBankSelect();
-    
-    const isXG = this.isXGChannel;
-    const p = this.synth.soundfontManager.getPreset(bank, programNumber, isXG);
-    let preset = p.preset;
-    if (!preset)
-    {
-        SpessaSynthWarn("No presets! Using empty fallback.");
-        preset = new BasicPreset(this.synth.soundfontManager.soundfontList[0].soundfont);
-        preset.presetName = "SPESSA EMPTY FALLBACK PRESET";
-    }
-    this.setPreset(preset);
-    this.sentBank = Math.min(128, preset.bank + p.bankOffset);
-    this.synth.callEvent("programchange", {
-        channel: this.channelNumber,
-        program: preset.program,
-        bank: this.sentBank
-    });
-    this.sendChannelProperty();
-}

package/src/synthetizer/audio_engine/engine_methods/render_voice.js

@@ -1,214 +0,0 @@
-import { VolumeEnvelope } from "../engine_components/volume_envelope.js";
-import { ModulationEnvelope } from "../engine_components/modulation_envelope.js";
-import { customControllers } from "../engine_components/controller_tables.js";
-import { absCentsToHz, timecentsToSeconds } from "../engine_components/unit_converter.js";
-import { getLFOValue } from "../engine_components/lfo.js";
-import { WavetableOscillator } from "../engine_components/wavetable_oscillator.js";
-import { LowpassFilter } from "../engine_components/lowpass_filter.js";
-import { generatorTypes } from "../../../soundfont/basic_soundfont/generator_types.js";
-
-/**
- * Renders a voice to the stereo output buffer
- * @param voice {Voice} the voice to render
- * @param timeNow {number} current time in seconds
- * @param outputLeft {Float32Array} the left output buffer
- * @param outputRight {Float32Array} the right output buffer
- * @param reverbOutputLeft {Float32Array} left output for reverb
- * @param reverbOutputRight {Float32Array} right output for reverb
- * @param chorusOutputLeft {Float32Array} left output for chorus
- * @param chorusOutputRight {Float32Array} right output for chorus
- * @param startIndex {number}
- * @param sampleCount {number}
- * @this {MidiAudioChannel}
- * @returns {boolean} true if the voice is finished
- */
-export function renderVoice(
-    voice, timeNow,
-    outputLeft, outputRight,
-    reverbOutputLeft, reverbOutputRight,
-    chorusOutputLeft, chorusOutputRight,
-    startIndex, sampleCount
-)
-{
-    // check if release
-    if (!voice.isInRelease)
-    {
-        // if not in release, check if the release time is
-        if (timeNow >= voice.releaseStartTime)
-        {
-            // release the voice here
-            voice.isInRelease = true;
-            VolumeEnvelope.startRelease(voice);
-            ModulationEnvelope.startRelease(voice);
-            if (voice.sample.loopingMode === 3)
-            {
-                voice.sample.isLooping = false;
-            }
-        }
-    }
-    
-    
-    // if the initial attenuation is more than 100dB, skip the voice (it's silent anyway)
-    if (voice.modulatedGenerators[generatorTypes.initialAttenuation] > 2500)
-    {
-        if (voice.isInRelease)
-        {
-            voice.finished = true;
-        }
-        return voice.finished;
-    }
-    
-    // TUNING
-    let targetKey = voice.targetKey;
-    
-    // calculate tuning
-    let cents = voice.modulatedGenerators[generatorTypes.fineTune]         // soundfont fine tune
-        + this.channelOctaveTuning[voice.midiNote]                         // MTS octave tuning
-        + this.channelTuningCents;                                         // channel tuning
-    let semitones = voice.modulatedGenerators[generatorTypes.coarseTune];  // soundfont coarse tuning
-    
-    // midi tuning standard
-    const tuning = this.synth.tunings[this.preset?.program]?.[voice.realKey];
-    if (tuning !== undefined && tuning?.midiNote >= 0)
-    {
-        // override key
-        targetKey = tuning.midiNote;
-        // add micro-tonal tuning
-        cents += tuning.centTuning;
-    }
-    
-    // portamento
-    if (voice.portamentoFromKey > -1)
-    {
-        // 0 to 1
-        const elapsed = Math.min((timeNow - voice.startTime) / voice.portamentoDuration, 1);
-        const diff = targetKey - voice.portamentoFromKey;
-        // zero progress means the pitch being in fromKey, full progress means the normal pitch
-        semitones -= diff * (1 - elapsed);
-    }
-    
-    // calculate tuning by key using soundfont's scale tuning
-    cents += (targetKey - voice.sample.rootKey) * voice.modulatedGenerators[generatorTypes.scaleTuning];
-    
-    // low pass excursion with LFO and mod envelope
-    let lowpassExcursion = 0;
-    let volumeExcursionCentibels = 0;
-    
-    // vibrato LFO
-    const vibPitchDepth = voice.modulatedGenerators[generatorTypes.vibLfoToPitch];
-    const vibVolDepth = voice.modulatedGenerators[generatorTypes.vibLfoToVolume];
-    const vibFilterDepth = voice.modulatedGenerators[generatorTypes.vibLfoToFilterFc];
-    if (vibPitchDepth !== 0 || vibVolDepth !== 0 || vibFilterDepth !== 0)
-    {
-        // calculate start time and lfo value
-        const vibStart = voice.startTime + timecentsToSeconds(voice.modulatedGenerators[generatorTypes.delayVibLFO]);
-        const vibFreqHz = absCentsToHz(voice.modulatedGenerators[generatorTypes.freqVibLFO]);
-        const vibLfoValue = getLFOValue(vibStart, vibFreqHz, timeNow);
-        // use modulation multiplier (RPN modulation depth)
-        cents += vibLfoValue * (vibPitchDepth * this.customControllers[customControllers.modulationMultiplier]);
-        // vol env volume offset
-        // negate the lfo value because audigy starts with increase rather than decrease
-        volumeExcursionCentibels += -vibLfoValue * vibVolDepth;
-        // low pass frequency
-        lowpassExcursion += vibLfoValue * vibFilterDepth;
-    }
-    
-    // mod LFO
-    const modPitchDepth = voice.modulatedGenerators[generatorTypes.modLfoToPitch];
-    const modVolDepth = voice.modulatedGenerators[generatorTypes.modLfoToVolume];
-    const modFilterDepth = voice.modulatedGenerators[generatorTypes.modLfoToFilterFc];
-    // don't compute mod lfo unless necessary
-    if (modPitchDepth !== 0 || modFilterDepth !== 0 || modVolDepth !== 0)
-    {
-        // calculate start time and lfo value
-        const modStart = voice.startTime + timecentsToSeconds(voice.modulatedGenerators[generatorTypes.delayModLFO]);
-        const modFreqHz = absCentsToHz(voice.modulatedGenerators[generatorTypes.freqModLFO]);
-        const modLfoValue = getLFOValue(modStart, modFreqHz, timeNow);
-        // use modulation multiplier (RPN modulation depth)
-        cents += modLfoValue * (modPitchDepth * this.customControllers[customControllers.modulationMultiplier]);
-        // vol env volume offset
-        // negate the lfo value because audigy starts with increase rather than decrease
-        volumeExcursionCentibels += -modLfoValue * modVolDepth;
-        // low pass frequency
-        lowpassExcursion += modLfoValue * modFilterDepth;
-    }
-    
-    // channel vibrato (GS NRPN)
-    if (this.channelVibrato.depth > 0)
-    {
-        // same as others
-        const channelVibrato = getLFOValue(
-            voice.startTime + this.channelVibrato.delay,
-            this.channelVibrato.rate,
-            timeNow
-        );
-        if (channelVibrato)
-        {
-            cents += channelVibrato * this.channelVibrato.depth;
-        }
-    }
-    
-    // mod env
-    const modEnvPitchDepth = voice.modulatedGenerators[generatorTypes.modEnvToPitch];
-    const modEnvFilterDepth = voice.modulatedGenerators[generatorTypes.modEnvToFilterFc];
-    // don't compute mod env unless necessary
-    if (modEnvFilterDepth !== 0 || modEnvPitchDepth !== 0)
-    {
-        const modEnv = ModulationEnvelope.getValue(voice, timeNow);
-        // apply values
-        lowpassExcursion += modEnv * modEnvFilterDepth;
-        cents += modEnv * modEnvPitchDepth;
-    }
-    
-    // default resonant modulator: it does not affect the filter gain (neither XG nor GS did that)
-    volumeExcursionCentibels -= voice.resonanceOffset;
-    
-    // finally, calculate the playback rate
-    const centsTotal = ~~(cents + semitones * 100);
-    if (centsTotal !== voice.currentTuningCents)
-    {
-        voice.currentTuningCents = centsTotal;
-        voice.currentTuningCalculated = Math.pow(2, centsTotal / 1200);
-    }
-    
-    
-    // SYNTHESIS
-    const bufferOut = new Float32Array(sampleCount);
-    
-    
-    // looping mode 2: start on release. process only volEnv
-    if (voice.sample.loopingMode === 2 && !voice.isInRelease)
-    {
-        VolumeEnvelope.apply(
-            voice,
-            bufferOut,
-            volumeExcursionCentibels,
-            this.synth.volumeEnvelopeSmoothingFactor
-        );
-        return voice.finished;
-    }
-    
-    // wave table oscillator
-    WavetableOscillator.getSample(voice, bufferOut, this.synth.interpolationType);
-    
-    // low pass filter
-    LowpassFilter.apply(voice, bufferOut, lowpassExcursion, this.synth.filterSmoothingFactor);
-    
-    // vol env
-    VolumeEnvelope.apply(
-        voice,
-        bufferOut,
-        volumeExcursionCentibels,
-        this.synth.volumeEnvelopeSmoothingFactor
-    );
-    
-    this.panAndMixVoice(
-        voice,
-        bufferOut,
-        outputLeft, outputRight,
-        reverbOutputLeft, reverbOutputRight,
-        chorusOutputLeft, chorusOutputRight,
-        startIndex
-    );
-    return voice.finished;
-}

package/src/synthetizer/audio_engine/engine_methods/soundfont_management/embedded_sound_bank.js

@@ -1,42 +0,0 @@
-import { loadSoundFont } from "../../../../soundfont/load_soundfont.js";
-import { SpessaSynthInfo } from "../../../../utils/loggin.js";
-import { consoleColors } from "../../../../utils/other.js";
-import { EMBEDDED_SOUND_BANK_ID } from "../../../synth_constants.js";
-
-/**
- * @this {SpessaSynthProcessor}
- */
-export function clearEmbeddedBank()
-{
-    if (this.soundfontManager.soundfontList.some(s => s.id === EMBEDDED_SOUND_BANK_ID))
-    {
-        this.soundfontManager.deleteSoundFont(EMBEDDED_SOUND_BANK_ID);
-    }
-}
-
-/**
- * Sets the embedded (RMI soundfont)
- * @param font {ArrayBuffer}
- * @param offset {number}
- * @this {SpessaSynthProcessor}
- */
-export function setEmbeddedSoundFont(font, offset)
-{
-    // the embedded bank is set as the first bank in the manager,
-    // with a special ID that does not clear when reloadManager is performed.
-    const loadedFont = loadSoundFont(font);
-    this.soundfontManager.addNewSoundFont(loadedFont, EMBEDDED_SOUND_BANK_ID, offset);
-    // rearrange so the embedded is first (most important as it overrides all others)
-    const order = this.soundfontManager.getCurrentSoundFontOrder();
-    order.pop();
-    order.unshift(EMBEDDED_SOUND_BANK_ID);
-    this.soundfontManager.rearrangeSoundFonts(order);
-    
-    
-    // apply snapshot again if applicable
-    if (this._snapshot !== undefined)
-    {
-        this.applySynthesizerSnapshot(this._snapshot);
-    }
-    SpessaSynthInfo(`%cEmbedded sound bank set at offset %c${offset}`, consoleColors.recognized, consoleColors.value);
-}

package/src/synthetizer/audio_engine/engine_methods/soundfont_management/update_preset_list.js

@@ -1,19 +0,0 @@
-/**
- * @this {SpessaSynthProcessor}
- */
-export function updatePresetList()
-{
-    /**
-     * @type {{bank: number, presetName: string, program: number}[]}
-     */
-    const mainFont = this.soundfontManager.getPresetList();
-    this.clearCache();
-    this.callEvent("presetlistchange", mainFont);
-    this.getDefaultPresets();
-    // unlock presets
-    this.midiAudioChannels.forEach(c =>
-    {
-        c.setPresetLock(false);
-    });
-    this.resetAllControllers(false);
-}

package/src/synthetizer/audio_engine/engine_methods/stopping_notes/kill_note.js

@@ -1,23 +0,0 @@
-import { customControllers } from "../../engine_components/controller_tables.js";
-import { generatorTypes } from "../../../../soundfont/basic_soundfont/generator_types.js";
-
-/**
- * Stops a note nearly instantly
- * @param midiNote {number}
- * @param releaseTime {number} ticks
- * @this {MidiAudioChannel}
- */
-export function killNote(midiNote, releaseTime = -12000)
-{
-    midiNote += this.customControllers[customControllers.channelKeyShift];
-    
-    this.voices.forEach(v =>
-    {
-        if (v.realKey !== midiNote)
-        {
-            return;
-        }
-        v.modulatedGenerators[generatorTypes.releaseVolEnv] = releaseTime; // set release to be very short
-        v.release(this.synth.currentSynthTime);
-    });
-}

package/src/synthetizer/audio_engine/engine_methods/stopping_notes/note_off.js

@@ -1,56 +0,0 @@
-import { SpessaSynthWarn } from "../../../../utils/loggin.js";
-import { customControllers } from "../../engine_components/controller_tables.js";
-
-/**
- * Release a note
- * @param midiNote {number}
- * @this {MidiAudioChannel}
- */
-export function noteOff(midiNote)
-{
-    if (midiNote > 127 || midiNote < 0)
-    {
-        SpessaSynthWarn(`Received a noteOn for note`, midiNote, "Ignoring.");
-        return;
-    }
-    
-    let realKey = midiNote + this.channelTransposeKeyShift + this.customControllers[customControllers.channelKeyShift];
-    
-    // if high performance mode, kill notes instead of stopping them
-    if (this.synth.highPerformanceMode)
-    {
-        // if the channel is percussion channel, do not kill the notes
-        if (!this.drumChannel)
-        {
-            this.killNote(realKey, -6950);
-            this.synth.callEvent("noteoff", {
-                midiNote: midiNote,
-                channel: this.channelNumber
-            });
-            return;
-        }
-    }
-    
-    const channelVoices = this.voices;
-    channelVoices.forEach(v =>
-    {
-        if (v.realKey !== realKey || v.isInRelease === true)
-        {
-            return;
-        }
-        // if hold pedal, move to sustain
-        if (this.holdPedal)
-        {
-            this.sustainedVoices.push(v);
-        }
-        else
-        {
-            v.release(this.synth.currentSynthTime);
-        }
-    });
-    this.synth.callEvent("noteoff", {
-        midiNote: midiNote,
-        channel: this.channelNumber
-    });
-}
-

package/src/synthetizer/audio_engine/engine_methods/stopping_notes/stop_all_channels.js

@@ -1,16 +0,0 @@
-import { SpessaSynthInfo } from "../../../../utils/loggin.js";
-import { consoleColors } from "../../../../utils/other.js";
-
-/**
- * @this {SpessaSynthProcessor}
- * @param force {boolean}
- */
-export function stopAllChannels(force = false)
-{
-    SpessaSynthInfo("%cStop all received!", consoleColors.info);
-    for (let i = 0; i < this.midiAudioChannels.length; i++)
-    {
-        this.midiAudioChannels[i].stopAllNotes(force);
-    }
-    this.callEvent("stopall", undefined);
-}

package/src/synthetizer/audio_engine/engine_methods/stopping_notes/stop_all_notes.js

@@ -1,30 +0,0 @@
-/**
- * stops all notes on a given channel
- * @param force {boolean}
- * @this {MidiAudioChannel}
- */
-export function stopAllNotes(force = false)
-{
-    if (force)
-    {
-        // force stop all
-        this.voices.length = 0;
-        this.sustainedVoices.length = 0;
-        this.sendChannelProperty();
-    }
-    else
-    {
-        this.voices.forEach(v =>
-        {
-            if (v.isInRelease)
-            {
-                return;
-            }
-            v.release(this.synth.currentSynthTime);
-        });
-        this.sustainedVoices.forEach(v =>
-        {
-            v.release(this.synth.currentSynthTime);
-        });
-    }
-}

package/src/synthetizer/audio_engine/engine_methods/stopping_notes/voice_killing.js

@@ -1,63 +0,0 @@
-/**
- * @param channel {MidiAudioChannel}
- * @param voice {Voice}
- * @return {number}
- */
-function getPriority(channel, voice)
-{
-    let priority = 0;
-    if (channel.drumChannel)
-    {
-        // important
-        priority += 5;
-    }
-    if (voice.isInRelease)
-    {
-        // not important
-        priority -= 5;
-    }
-    // less velocity = less important
-    priority += voice.velocity / 25; // map to 0-5
-    // the newer, more important
-    priority -= voice.volumeEnvelope.state;
-    if (voice.isInRelease)
-    {
-        priority -= 5;
-    }
-    priority -= voice.volumeEnvelope.currentAttenuationDb / 50;
-    return priority;
-}
-
-/**
- * @this {SpessaSynthProcessor}
- * @param amount {number}
- */
-export function voiceKilling(amount)
-{
-    let allVoices = [];
-    for (const channel of this.midiAudioChannels)
-    {
-        for (const voice of channel.voices)
-        {
-            if (!voice.finished)
-            {
-                const priority = getPriority(channel, voice);
-                allVoices.push({ channel, voice, priority });
-            }
-        }
-    }
-    
-    // Step 2: Sort voices by priority (ascending order)
-    allVoices.sort((a, b) => a.priority - b.priority);
-    const voicesToRemove = allVoices.slice(0, amount);
-    
-    for (const { channel, voice } of voicesToRemove)
-    {
-        const index = channel.voices.indexOf(voice);
-        if (index > -1)
-        {
-            channel.voices.splice(index, 1);
-        }
-    }
-}
-