spessasynth_core 3.27.8 → 4.0.0

package/src/synthetizer/audio_engine/engine_methods/controller_control/controller_change.js

@@ -1,159 +0,0 @@
-import { midiControllers } from "../../../../midi/midi_message.js";
-import { channelConfiguration, customControllers, dataEntryStates } from "../../engine_components/controller_tables.js";
-import { nonRegisteredMSB } from "../data_entry/data_entry_coarse.js";
-
-/**
- * @param controllerNumber {number}
- * @param controllerValue {number}
- * @param force {boolean}
- * @this {MidiAudioChannel}
- */
-export function controllerChange(controllerNumber, controllerValue, force = false)
-{
-    if (controllerNumber > 127)
-    {
-        // channel configuration. force must be set to true
-        if (!force)
-        {
-            return;
-        }
-        switch (controllerNumber)
-        {
-            default:
-                return;
-            
-            case channelConfiguration.velocityOverride:
-                this.velocityOverride = controllerValue;
-        }
-    }
-    
-    // lsb controller values: append them as the lower nibble of the 14-bit value
-    // excluding bank select and data entry as it's handled separately
-    if (
-        controllerNumber >= midiControllers.lsbForControl1ModulationWheel
-        && controllerNumber <= midiControllers.lsbForControl13EffectControl2
-        && controllerNumber !== midiControllers.lsbForControl6DataEntry
-    )
-    {
-        const actualCCNum = controllerNumber - 32;
-        if (this.lockedControllers[actualCCNum])
-        {
-            return;
-        }
-        // append the lower nibble to the main controller
-        this.midiControllers[actualCCNum] = (this.midiControllers[actualCCNum] & 0x3F80) | (controllerValue & 0x7F);
-        this.voices.forEach(v => this.computeModulators(v, 1, actualCCNum));
-    }
-    if (this.lockedControllers[controllerNumber])
-    {
-        return;
-    }
-    
-    // apply the cc to the table
-    this.midiControllers[controllerNumber] = controllerValue << 7;
-    
-    // interpret special CCs
-    {
-        switch (controllerNumber)
-        {
-            case midiControllers.allNotesOff:
-                this.stopAllNotes();
-                break;
-            
-            case midiControllers.allSoundOff:
-                this.stopAllNotes(true);
-                break;
-            
-            // special case: bank select
-            case midiControllers.bankSelect:
-                this.setBankSelect(controllerValue);
-                break;
-            
-            case midiControllers.lsbForControl0BankSelect:
-                this.setBankSelect(controllerValue, true);
-                break;
-            
-            // check for RPN and NPRN and data entry
-            case midiControllers.RPNLsb:
-                this.dataEntryState = dataEntryStates.RPFine;
-                break;
-            
-            case midiControllers.RPNMsb:
-                this.dataEntryState = dataEntryStates.RPCoarse;
-                break;
-            
-            case midiControllers.NRPNMsb:
-                // sfspec section 9.6.2
-                this.customControllers[customControllers.sf2NPRNGeneratorLSB] = 0;
-                this.dataEntryState = dataEntryStates.NRPCoarse;
-                break;
-            
-            case midiControllers.NRPNLsb:
-                if (this.midiControllers[midiControllers.NRPNMsb] >> 7 === nonRegisteredMSB.SF2)
-                {
-                    // if a <100 value has already been sent, reset!
-                    if (this.customControllers[customControllers.sf2NPRNGeneratorLSB] % 100 !== 0)
-                    {
-                        this.customControllers[customControllers.sf2NPRNGeneratorLSB] = 0;
-                    }
-                    
-                    if (controllerValue === 100)
-                    {
-                        this.customControllers[customControllers.sf2NPRNGeneratorLSB] += 100;
-                    }
-                    else if (controllerValue === 101)
-                    {
-                        this.customControllers[customControllers.sf2NPRNGeneratorLSB] += 1000;
-                    }
-                    else if (controllerValue === 102)
-                    {
-                        this.customControllers[customControllers.sf2NPRNGeneratorLSB] += 10000;
-                    }
-                    else if (controllerValue < 100)
-                    {
-                        this.customControllers[customControllers.sf2NPRNGeneratorLSB] += controllerValue;
-                    }
-                }
-                this.dataEntryState = dataEntryStates.NRPFine;
-                break;
-            
-            case midiControllers.dataEntryMsb:
-                this.dataEntryCoarse(controllerValue);
-                break;
-            
-            case midiControllers.lsbForControl6DataEntry:
-                this.dataEntryFine(controllerValue);
-                break;
-            
-            case midiControllers.resetAllControllers:
-                this.resetControllersRP15Compliant();
-                break;
-            
-            case midiControllers.sustainPedal:
-                if (controllerValue >= 64)
-                {
-                    this.holdPedal = true;
-                }
-                else
-                {
-                    this.holdPedal = false;
-                    this.sustainedVoices.forEach(v =>
-                    {
-                        v.release(this.synth.currentSynthTime);
-                    });
-                    this.sustainedVoices = [];
-                }
-                break;
-            
-            // default: just compute modulators
-            default:
-                this.voices.forEach(v => this.computeModulators(v, 1, controllerNumber));
-                break;
-        }
-    }
-    this.synth.callEvent("controllerchange", {
-        channel: this.channelNumber,
-        controllerNumber: controllerNumber,
-        controllerValue: controllerValue
-    });
-}

package/src/synthetizer/audio_engine/engine_methods/controller_control/master_parameters.js

@@ -1,53 +0,0 @@
-import { SYNTHESIZER_GAIN } from "../../main_processor.js";
-
-/**
- * @enum {number}
- */
-export const masterParameterType = {
-    mainVolume: 0,
-    masterPan: 1,
-    voicesCap: 2,
-    interpolationType: 3,
-    midiSystem: 4,
-    monophonicRetriggerMode: 5
-};
-
-/**
- * @this {SpessaSynthProcessor}
- * @param type {masterParameterType}
- * @param value {number|string|interpolationTypes}
- */
-export function setMasterParameter(type, value)
-{
-    switch (type)
-    {
-        case masterParameterType.masterPan:
-            let pan = value;
-            this.pan = pan;
-            // clamp to 0-1 (0 is left)
-            pan = (pan / 2) + 0.5;
-            this.panLeft = (1 - pan);
-            this.panRight = (pan);
-            break;
-        
-        case masterParameterType.mainVolume:
-            this.masterGain = value * SYNTHESIZER_GAIN;
-            break;
-        
-        case masterParameterType.voicesCap:
-            this.voiceCap = value;
-            break;
-        
-        case masterParameterType.interpolationType:
-            this.interpolationType = value;
-            break;
-        
-        case masterParameterType.midiSystem:
-            this.setSystem(value);
-            break;
-        
-        case masterParameterType.monophonicRetriggerMode:
-            this._monophonicRetriggerMode = true;
-            break;
-    }
-}

package/src/synthetizer/audio_engine/engine_methods/controller_control/reset_controllers.js

@@ -1,254 +0,0 @@
-import { consoleColors } from "../../../../utils/other.js";
-import { SpessaSynthInfo } from "../../../../utils/loggin.js";
-import { modulatorSources } from "../../../../soundfont/basic_soundfont/modulator.js";
-import {
-    customControllers,
-    customResetArray,
-    dataEntryStates,
-    NON_CC_INDEX_OFFSET,
-    PORTAMENTO_CONTROL_UNSET,
-    resetArray
-} from "../../engine_components/controller_tables.js";
-import { midiControllers } from "../../../../midi/midi_message.js";
-import { DEFAULT_PERCUSSION, DEFAULT_SYNTH_MODE } from "../../../synth_constants.js";
-import { getDefaultBank } from "../../../../utils/xg_hacks.js";
-
-
-/**
- * Full system reset
- * @this {SpessaSynthProcessor}
- * @param log {boolean}
- */
-export function resetAllControllers(log = true)
-{
-    if (log)
-    {
-        SpessaSynthInfo("%cResetting all controllers!", consoleColors.info);
-    }
-    this.callEvent("allcontrollerreset", undefined);
-    this.setSystem(DEFAULT_SYNTH_MODE);
-    for (let channelNumber = 0; channelNumber < this.midiAudioChannels.length; channelNumber++)
-    {
-        /**
-         * @type {MidiAudioChannel}
-         **/
-        const ch = this.midiAudioChannels[channelNumber];
-        
-        ch.resetControllers();
-        // if preset is unlocked, switch to non-drums and call event
-        if (!ch.lockPreset)
-        {
-            ch.setBankSelect(getDefaultBank(this.system));
-            if (channelNumber % 16 === DEFAULT_PERCUSSION)
-            {
-                ch.setPreset(this.drumPreset);
-                ch.drumChannel = true;
-                this.callEvent("drumchange", {
-                    channel: channelNumber,
-                    isDrumChannel: true
-                });
-            }
-            else
-            {
-                ch.drumChannel = false;
-                ch.setPreset(this.defaultPreset);
-                this.callEvent("drumchange", {
-                    channel: channelNumber,
-                    isDrumChannel: false
-                });
-            }
-        }
-        else
-        {
-            this.callEvent("drumchange", {
-                channel: channelNumber,
-                isDrumChannel: ch.drumChannel
-            });
-        }
-        // safety net
-        if (!ch.preset)
-        {
-            continue;
-        }
-        const presetBank = ch.preset?.bank;
-        // call program change
-        this.callEvent("programchange", {
-            channel: channelNumber,
-            program: ch.preset?.program,
-            bank: presetBank
-        });
-        
-        for (let ccNum = 0; ccNum < 128; ccNum++)
-        {
-            if (this.midiAudioChannels[channelNumber].lockedControllers[ccNum])
-            {
-                // was not reset so restore the value
-                this.callEvent("controllerchange", {
-                    channel: channelNumber,
-                    controllerNumber: ccNum,
-                    controllerValue: this.midiAudioChannels[channelNumber].midiControllers[ccNum] >> 7
-                });
-            }
-            
-        }
-        
-        
-        // restore pitch wheel
-        if (this.midiAudioChannels[channelNumber].lockedControllers[NON_CC_INDEX_OFFSET + modulatorSources.pitchWheel] === false)
-        {
-            const val = this.midiAudioChannels[channelNumber].midiControllers[NON_CC_INDEX_OFFSET + modulatorSources.pitchWheel];
-            const msb = val >> 7;
-            const lsb = val & 0x7F;
-            this.callEvent("pitchwheel", {
-                channel: channelNumber,
-                MSB: msb,
-                LSB: lsb
-            });
-        }
-        
-        // restore channel pressure
-        if (this.midiAudioChannels[channelNumber].lockedControllers[NON_CC_INDEX_OFFSET + modulatorSources.channelPressure] === false)
-        {
-            const val = this.midiAudioChannels[channelNumber].midiControllers[NON_CC_INDEX_OFFSET + modulatorSources.channelPressure] >> 7;
-            this.callEvent("channelpressure", {
-                channel: channelNumber,
-                pressure: val
-            });
-        }
-    }
-    this.tunings = [];
-    this.tunings = [];
-    for (let i = 0; i < 128; i++)
-    {
-        this.tunings.push([]);
-    }
-    
-    this.setMIDIVolume(1);
-}
-
-/**
- * Resets all controllers for channel
- * @this {MidiAudioChannel}
- */
-export function resetControllers()
-{
-    this.channelOctaveTuning.fill(0);
-    
-    // reset the array
-    for (let i = 0; i < resetArray.length; i++)
-    {
-        if (this.lockedControllers[i])
-        {
-            continue;
-        }
-        const resetValue = resetArray[i];
-        if (this.midiControllers[i] !== resetValue && i < 127)
-        {
-            if (i === midiControllers.portamentoControl)
-            {
-                this.midiControllers[i] = PORTAMENTO_CONTROL_UNSET;
-            }
-            else
-            {
-                this.controllerChange(i, resetValue >> 7);
-            }
-        }
-        else
-        {
-            // out of range, do a regular reset
-            this.midiControllers[i] = resetValue;
-        }
-    }
-    this.channelVibrato = { rate: 0, depth: 0, delay: 0 };
-    this.holdPedal = false;
-    this.randomPan = false;
-    
-    this.sysExModulators.resetModulators();
-    
-    // reset custom controllers
-    // special case: transpose does not get affected
-    const transpose = this.customControllers[customControllers.channelTransposeFine];
-    this.customControllers.set(customResetArray);
-    this.setCustomController(customControllers.channelTransposeFine, transpose);
-    this.resetParameters();
-    
-}
-
-
-/**
- * @type {Set<midiControllers|number>}
- */
-export const nonResetableCCs = new Set([
-    midiControllers.bankSelect,
-    midiControllers.lsbForControl0BankSelect,
-    midiControllers.mainVolume,
-    midiControllers.lsbForControl7MainVolume,
-    midiControllers.pan,
-    midiControllers.lsbForControl10Pan,
-    midiControllers.reverbDepth,
-    midiControllers.tremoloDepth,
-    midiControllers.chorusDepth,
-    midiControllers.detuneDepth,
-    midiControllers.phaserDepth,
-    midiControllers.soundVariation,
-    midiControllers.filterResonance,
-    midiControllers.releaseTime,
-    midiControllers.attackTime,
-    midiControllers.brightness,
-    midiControllers.decayTime,
-    midiControllers.vibratoRate,
-    midiControllers.vibratoDepth,
-    midiControllers.vibratoDelay,
-    midiControllers.soundController10
-]);
-
-/**
- * Reset all controllers for channel, but RP-15 compliant
- *  https://amei.or.jp/midistandardcommittee/Recommended_Practice/e/rp15.pdf
- *  @this {MidiAudioChannel}
- */
-export function resetControllersRP15Compliant()
-{
-    // reset tunings
-    this.channelOctaveTuning.fill(0);
-    
-    // reset pitch bend
-    this.pitchWheel(64, 0);
-    
-    this.channelVibrato = { rate: 0, depth: 0, delay: 0 };
-    
-    for (let i = 0; i < 128; i++)
-    {
-        const resetValue = resetArray[i];
-        if (!nonResetableCCs.has(i) && resetValue !== this.midiControllers[i])
-        {
-            if (i === midiControllers.portamentoControl)
-            {
-                this.midiControllers[i] = PORTAMENTO_CONTROL_UNSET;
-            }
-            else
-            {
-                this.controllerChange(i, resetValue >> 7);
-            }
-        }
-    }
-    this.resetGeneratorOverrides();
-    this.resetGeneratorOffsets();
-}
-
-/**
- * @this {MidiAudioChannel}
- */
-export function resetParameters()
-{
-    /**
-     * reset the state machine to idle
-     */
-    this.dataEntryState = dataEntryStates.Idle;
-    this.midiControllers[midiControllers.NRPNLsb] = 127 << 7;
-    this.midiControllers[midiControllers.NRPNMsb] = 127 << 7;
-    this.midiControllers[midiControllers.RPNLsb] = 127 << 7;
-    this.midiControllers[midiControllers.RPNMsb] = 127 << 7;
-    this.resetGeneratorOverrides();
-    this.resetGeneratorOffsets();
-}

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

@@ -1,20 +0,0 @@
-import { MidiAudioChannel } from "../engine_components/midi_audio_channel.js";
-
-/**
- * @param sendEvent {boolean}
- * @this {SpessaSynthProcessor}
- */
-export function createMidiChannel(sendEvent = false)
-{
-    /**
-     * @type {MidiAudioChannel}
-     */
-    const channel = new MidiAudioChannel(this, this.defaultPreset, this.midiAudioChannels.length);
-    this.midiAudioChannels.push(channel);
-    if (sendEvent)
-    {
-        this.callEvent("newchannel", undefined);
-        channel.sendChannelProperty();
-        this.midiAudioChannels[this.midiAudioChannels.length - 1].setDrums(true);
-    }
-}

package/src/synthetizer/audio_engine/engine_methods/data_entry/awe32.js

@@ -1,198 +0,0 @@
-import { SpessaSynthWarn } from "../../../../utils/loggin.js";
-import { consoleColors } from "../../../../utils/other.js";
-import { generatorTypes } from "../../../../soundfont/basic_soundfont/generator_types.js";
-
-/**
- * http://archive.gamedev.net/archive/reference/articles/article445.html
- * https://github.com/user-attachments/files/15757220/adip301.pdf
- * @type {generatorTypes[]}
- */
-const AWE_NRPN_GENERATOR_MAPPINGS = [
-    generatorTypes.delayModLFO,
-    generatorTypes.freqModLFO,
-    
-    generatorTypes.delayVibLFO,
-    generatorTypes.freqVibLFO,
-    
-    generatorTypes.delayModEnv,
-    generatorTypes.attackModEnv,
-    generatorTypes.holdModEnv,
-    generatorTypes.decayModEnv,
-    generatorTypes.sustainModEnv,
-    generatorTypes.releaseModEnv,
-    
-    generatorTypes.delayVolEnv,
-    generatorTypes.attackVolEnv,
-    generatorTypes.holdVolEnv,
-    generatorTypes.decayVolEnv,
-    generatorTypes.sustainVolEnv,
-    generatorTypes.releaseVolEnv,
-    
-    generatorTypes.fineTune,
-    
-    generatorTypes.modLfoToPitch,
-    generatorTypes.vibLfoToPitch,
-    generatorTypes.modEnvToPitch,
-    generatorTypes.modLfoToVolume,
-    
-    generatorTypes.initialFilterFc,
-    generatorTypes.initialFilterQ,
-    
-    generatorTypes.modLfoToFilterFc,
-    generatorTypes.modEnvToFilterFc,
-    
-    generatorTypes.chorusEffectsSend,
-    generatorTypes.reverbEffectsSend
-];
-
-/**
- * Function that emulates AWE32 similarly to fluidsynth
- * https://github.com/FluidSynth/fluidsynth/wiki/FluidFeatures
- *
- * Note: This makes use of findings by mrbumpy409:
- * https://github.com/fluidSynth/fluidsynth/issues/1473
- *
- * The excellent test files are available here, also collected and converted by mrbumpy409:
- * https://github.com/mrbumpy409/AWE32-midi-conversions
- * @this {MidiAudioChannel}
- * @param aweGen {number}
- * @param dataLSB {number}
- * @param dataMSB {number}
- */
-export function handleAWE32NRPN(aweGen, dataLSB, dataMSB)
-{
-    const clip = (v, min, max) => Math.max(min, Math.min(max, v));
-    const msecToTimecents = ms => Math.max(-32768, 1200 * Math.log2(ms / 1000));
-    const hzToCents = hz => 6900 + 1200 * Math.log2(hz / 440);
-    
-    
-    let dataValue = (dataMSB << 7) | dataLSB;
-    // center the value
-    // though ranges reported as 0 to 127 only use LSB
-    dataValue -= 8192;
-    const generator = AWE_NRPN_GENERATOR_MAPPINGS[aweGen];
-    if (!generator)
-    {
-        SpessaSynthWarn(
-            `Invalid AWE32 LSB: %c${aweGen}`,
-            consoleColors.unrecognized
-        );
-    }
-    let milliseconds, hertz, centibels, cents;
-    switch (generator)
-    {
-        default:
-            // this should not happen
-            break;
-        
-        // delays
-        case generatorTypes.delayModLFO:
-        case generatorTypes.delayVibLFO:
-        case generatorTypes.delayVolEnv:
-        case generatorTypes.delayModEnv:
-            milliseconds = 4 * clip(dataValue, 0, 5900);
-            // convert to timecents
-            this.setGeneratorOverride(generator, msecToTimecents(milliseconds));
-            break;
-        
-        // attacks
-        case generatorTypes.attackVolEnv:
-        case generatorTypes.attackModEnv:
-            milliseconds = clip(dataValue, 0, 5940);
-            // convert to timecents
-            this.setGeneratorOverride(generator, msecToTimecents(milliseconds));
-            break;
-        
-        // holds
-        case generatorTypes.holdVolEnv:
-        case generatorTypes.holdModEnv:
-            milliseconds = clip(dataValue, 0, 8191);
-            // convert to timecents
-            this.setGeneratorOverride(generator, msecToTimecents(milliseconds));
-            break;
-        
-        // decays and releases (share clips and units)
-        case generatorTypes.decayModEnv:
-        case generatorTypes.decayVolEnv:
-        case generatorTypes.releaseVolEnv:
-        case generatorTypes.releaseModEnv:
-            milliseconds = 4 * clip(dataValue, 0, 5940);
-            // convert to timecents
-            this.setGeneratorOverride(generator, msecToTimecents(milliseconds));
-            break;
-        
-        // lfo frequencies
-        case generatorTypes.freqVibLFO:
-        case generatorTypes.freqModLFO:
-            hertz = 0.084 * dataLSB;
-            // convert to abs cents
-            this.setGeneratorOverride(generator, hzToCents(hertz), true);
-            break;
-        
-        // sustains
-        case generatorTypes.sustainVolEnv:
-        case generatorTypes.sustainModEnv:
-            // 0.75 dB is 7.5 cB
-            centibels = dataLSB * 7.5;
-            this.setGeneratorOverride(generator, centibels);
-            break;
-        
-        // pitch
-        case generatorTypes.fineTune:
-            // data is already centered
-            this.setGeneratorOverride(generator, dataValue, true);
-            break;
-        
-        // lfo to pitch
-        case generatorTypes.modLfoToPitch:
-        case generatorTypes.vibLfoToPitch:
-            cents = clip(dataValue, -127, 127) * 9.375;
-            this.setGeneratorOverride(generator, cents, true);
-            break;
-        
-        // env to pitch
-        case generatorTypes.modEnvToPitch:
-            cents = clip(dataValue, -127, 127) * 9.375;
-            this.setGeneratorOverride(generator, cents);
-            break;
-        
-        // mod lfo to vol
-        case generatorTypes.modLfoToVolume:
-            // 0.1875 dB is 1.875 cB
-            centibels = 1.875 * dataLSB;
-            this.setGeneratorOverride(generator, centibels, true);
-            break;
-        
-        // filter fc
-        case generatorTypes.initialFilterFc:
-            // minimum: 100 Hz -> 4335 cents
-            const fcCents = 4335 + 59 * dataLSB;
-            this.setGeneratorOverride(generator, fcCents, true);
-            break;
-        
-        // filter Q
-        case generatorTypes.initialFilterQ:
-            // note: this uses the "modulator-ish" approach proposed by mrbumpy409
-            // here https://github.com/FluidSynth/fluidsynth/issues/1473
-            centibels = 215 * (dataLSB / 127);
-            this.setGeneratorOverride(generator, centibels, true);
-            break;
-        
-        // to filterFc
-        case generatorTypes.modLfoToFilterFc:
-            cents = clip(dataValue, -64, 63) * 56.25;
-            this.setGeneratorOverride(generator, cents, true);
-            break;
-        
-        case generatorTypes.modEnvToFilterFc:
-            cents = clip(dataValue, -64, 63) * 56.25;
-            this.setGeneratorOverride(generator, cents);
-            break;
-        
-        // effects
-        case generatorTypes.chorusEffectsSend:
-        case generatorTypes.reverbEffectsSend:
-            this.setGeneratorOverride(generator, clip(dataValue, 0, 255) * (1000 / 255));
-            break;
-    }
-}