spessasynth_lib 3.24.13 → 3.24.16

package/synthetizer/worklet_system/snapshot/snapshot.js

@@ -1,311 +0,0 @@
-import { returnMessageType } from "../message_protocol/worklet_message.js";
-import { SpessaSynthInfo } from "../../../utils/loggin.js";
-import { consoleColors } from "../../../utils/other.js";
-import { getBankSelect, setBankSelect } from "../worklet_utilities/worklet_processor_channel.js";
-
-/**
- * Represents a snapshot of a single channel's state in the synthesizer.
- */
-class ChannelSnapshot
-{
-    /**
-     * The channel's MIDI program number.
-     * @type {number}
-     */
-    program;
-    
-    /**
-     * The channel's bank number.
-     * @type {number}
-     */
-    bank;
-    
-    /**
-     * The name of the patch currently loaded in the channel.
-     * @type {string}
-     */
-    patchName;
-    
-    /**
-     * Indicates whether the channel's program change is disabled.
-     * @type {boolean}
-     */
-    lockPreset;
-    
-    /**
-     * The array of all MIDI controllers (in 14-bit values) with the modulator sources at the end.
-     * @type {Int16Array}
-     */
-    midiControllers;
-    
-    /**
-     * An array of booleans, indicating if the controller with a current index is locked.
-     * @type {boolean[]}
-     */
-    lockedControllers;
-    
-    /**
-     * Array of custom (not SF2) control values such as RPN pitch tuning, transpose, modulation depth, etc.
-     * @type {Float32Array}
-     */
-    customControllers;
-    
-    /**
-     * Indicates whether the channel vibrato is locked.
-     * @type {boolean}
-     */
-    lockVibrato;
-    
-    /**
-     * The channel's vibrato settings.
-     * @type {Object}
-     * @property {number} depth - Vibrato depth, in gain.
-     * @property {number} delay - Vibrato delay from note on in seconds.
-     * @property {number} rate - Vibrato rate in Hz.
-     */
-    channelVibrato;
-    
-    /**
-     * Key shift for the channel.
-     * @type {number}
-     */
-    channelTransposeKeyShift;
-    
-    /**
-     * The channel's octave tuning in cents.
-     * @type {Int8Array}
-     */
-    channelOctaveTuning;
-    
-    /**
-     * Tuning of individual keys in cents.
-     * @type {Int16Array}
-     */
-    keyCentTuning;
-    
-    /**
-     * Indicates whether the channel is muted.
-     * @type {boolean}
-     */
-    isMuted;
-    
-    /**
-     * Overrides velocity if greater than 0, otherwise disabled.
-     * @type {number}
-     */
-    velocityOverride;
-    
-    /**
-     * Indicates whether the channel is a drum channel.
-     * @type {boolean}
-     */
-    drumChannel;
-    
-    /**
-     * Creates a snapshot of a single channel's state in the synthesizer.
-     * @param workletProcessor {SpessaSynthProcessor}
-     * @param channelNumber {number}
-     * @returns {ChannelSnapshot}
-     */
-    static getChannelSnapshot(workletProcessor, channelNumber)
-    {
-        const channel = workletProcessor.workletProcessorChannels[channelNumber];
-        const channelSnapshot = new ChannelSnapshot();
-        // program data
-        channelSnapshot.program = channel.preset.program;
-        channelSnapshot.bank = getBankSelect(channel);
-        channelSnapshot.lockPreset = channel.lockPreset;
-        channelSnapshot.patchName = channel.preset.presetName;
-        
-        // controller data
-        channelSnapshot.midiControllers = channel.midiControllers;
-        channelSnapshot.lockedControllers = channel.lockedControllers;
-        channelSnapshot.customControllers = channel.customControllers;
-        
-        // vibrato data
-        channelSnapshot.channelVibrato = channel.channelVibrato;
-        channelSnapshot.lockVibrato = channel.lockGSNRPNParams;
-        
-        // tuning and transpose data
-        channelSnapshot.channelTransposeKeyShift = channel.channelTransposeKeyShift;
-        channelSnapshot.channelOctaveTuning = channel.channelOctaveTuning;
-        channelSnapshot.keyCentTuning = channel.keyCentTuning;
-        
-        // other data
-        channelSnapshot.isMuted = channel.isMuted;
-        channelSnapshot.velocityOverride = channel.velocityOverride;
-        channelSnapshot.drumChannel = channel.drumChannel;
-        return channelSnapshot;
-    }
-    
-    /**
-     * Applies the snapshot to the specified channel.
-     * @param workletProcessor {SpessaSynthProcessor}
-     * @param channelNumber {number}
-     * @param channelSnapshot {ChannelSnapshot}
-     */
-    static applyChannelSnapshot(workletProcessor, channelNumber, channelSnapshot)
-    {
-        const channelObject = workletProcessor.workletProcessorChannels[channelNumber];
-        workletProcessor.muteChannel(channelNumber, channelSnapshot.isMuted);
-        workletProcessor.setDrums(channelNumber, channelSnapshot.drumChannel);
-        
-        // restore controllers
-        channelObject.midiControllers = channelSnapshot.midiControllers;
-        channelObject.lockedControllers = channelSnapshot.lockedControllers;
-        channelObject.customControllers = channelSnapshot.customControllers;
-        
-        // restore vibrato and transpose
-        channelObject.channelVibrato = channelSnapshot.channelVibrato;
-        channelObject.lockGSNRPNParams = channelSnapshot.lockVibrato;
-        channelObject.channelTransposeKeyShift = channelSnapshot.channelTransposeKeyShift;
-        channelObject.channelOctaveTuning = channelSnapshot.channelOctaveTuning;
-        channelObject.velocityOverride = channelSnapshot.velocityOverride;
-        
-        // restore preset and lock
-        channelObject.lockPreset = false;
-        setBankSelect(channelObject, channelSnapshot.bank);
-        workletProcessor.programChange(channelNumber, channelSnapshot.program);
-        channelObject.lockPreset = channelSnapshot.lockPreset;
-    }
-}
-
-/**
- * Represents a snapshot of the synthesizer's state.
- */
-class SynthesizerSnapshot
-{
-    /**
-     * The individual channel snapshots.
-     * @type {ChannelSnapshot[]}
-     */
-    channelSnapshots;
-    
-    /**
-     * Key modifiers.
-     * @type {KeyModifier[][]}
-     */
-    keyMappings;
-    
-    /**
-     * Main synth volume (set by MIDI), from 0 to 1.
-     * @type {number}
-     */
-    mainVolume;
-    
-    /**
-     * Master stereo panning, from -1 to 1.
-     * @type {number}
-     */
-    pan;
-    
-    /**
-     * The synth's interpolation type.
-     * @type {interpolationTypes}
-     */
-    interpolation;
-    
-    /**
-     * The synth's system. Values can be "gs", "gm", "gm2" or "xg".
-     * @type {SynthSystem}
-     */
-    system;
-    
-    /**
-     * The current synth transposition in semitones. Can be a float.
-     * @type {number}
-     */
-    transposition;
-    
-    /**
-     * The effects configuration object.
-     * @type {SynthConfig}
-     */
-    effectsConfig;
-    
-    
-    /**
-     * Creates a snapshot of the synthesizer's state.
-     * @param workletProcessor {SpessaSynthProcessor}
-     * @returns {SynthesizerSnapshot}
-     */
-    static createSynthesizerSnapshot(workletProcessor)
-    {
-        const snapshot = new SynthesizerSnapshot();
-        // channel snapshots
-        snapshot.channelSnapshots =
-            workletProcessor.workletProcessorChannels.map((_, i) =>
-                ChannelSnapshot.getChannelSnapshot(workletProcessor, i));
-        
-        // key mappings
-        snapshot.keyMappings = workletProcessor.keyModifierManager.getMappings();
-        // pan and volume
-        snapshot.mainVolume = workletProcessor.midiVolume;
-        snapshot.pan = workletProcessor.pan;
-        
-        // others
-        snapshot.system = workletProcessor.system;
-        snapshot.interpolation = workletProcessor.interpolationType;
-        snapshot.transposition = workletProcessor.transposition;
-        
-        // effects config is stored on the main thread, leave it empty
-        snapshot.effectsConfig = {};
-        return snapshot;
-        
-    }
-    
-    /**
-     * Applies the snapshot to the synthesizer.
-     * @param workletProcessor {SpessaSynthProcessor}
-     * @param snapshot {SynthesizerSnapshot}
-     */
-    static applySnapshot(workletProcessor, snapshot)
-    {
-        // restore system
-        workletProcessor.system = snapshot.system;
-        
-        // restore pan and volume
-        workletProcessor.setMasterGain(snapshot.mainVolume);
-        workletProcessor.setMasterPan(snapshot.pan);
-        workletProcessor.transposeAllChannels(snapshot.transposition);
-        workletProcessor.interpolationType = snapshot.interpolation;
-        workletProcessor.keyModifierManager.setMappings(snapshot.keyMappings);
-        
-        // add channels if more needed
-        while (workletProcessor.workletProcessorChannels.length < snapshot.channelSnapshots.length)
-        {
-            workletProcessor.createWorkletChannel();
-        }
-        
-        // restore channels
-        snapshot.channelSnapshots.forEach((channelSnapshot, index) =>
-        {
-            ChannelSnapshot.applyChannelSnapshot(workletProcessor, index, channelSnapshot);
-        });
-        
-        SpessaSynthInfo("%cFinished restoring controllers!", consoleColors.info);
-    }
-}
-
-/**
- * sends a snapshot of the current controller values of the synth (used to copy that data to OfflineAudioContext when rendering)
- * @this {SpessaSynthProcessor}
- */
-export function sendSynthesizerSnapshot()
-{
-    this.post({
-        messageType: returnMessageType.synthesizerSnapshot,
-        messageData: SynthesizerSnapshot.createSynthesizerSnapshot(this)
-    });
-}
-
-/**
- * Applies the snapshot to the synth
- * @param snapshot {SynthesizerSnapshot}
- * @this {SpessaSynthProcessor}
- */
-export function applySynthesizerSnapshot(snapshot)
-{
-    SynthesizerSnapshot.applySnapshot(this, snapshot);
-    SpessaSynthInfo("%cFinished applying snapshot!", consoleColors.info);
-}

package/synthetizer/worklet_system/worklet_methods/controller_control.js

@@ -1,260 +0,0 @@
-import { consoleColors } from "../../../utils/other.js";
-import { midiControllers } from "../../../midi_parser/midi_message.js";
-import { channelConfiguration, getBankSelect, setBankSelect } from "../worklet_utilities/worklet_processor_channel.js";
-import { computeModulators } from "../worklet_utilities/worklet_modulator.js";
-import { SpessaSynthInfo, SpessaSynthWarn } from "../../../utils/loggin.js";
-import { SYNTHESIZER_GAIN } from "../main_processor.js";
-import { DEFAULT_PERCUSSION } from "../../synthetizer.js";
-import { dataEntryStates } from "../worklet_utilities/controller_tables.js";
-
-/**
- * @param channel {number}
- * @param controllerNumber {number}
- * @param controllerValue {number}
- * @param force {boolean}
- * @this {SpessaSynthProcessor}
- */
-export function controllerChange(channel, controllerNumber, controllerValue, force = false)
-{
-    /**
-     * @type {WorkletProcessorChannel}
-     */
-    const channelObject = this.workletProcessorChannels[channel];
-    if (channelObject === undefined)
-    {
-        SpessaSynthWarn(`Trying to access channel ${channel} which does not exist... ignoring!`);
-        return;
-    }
-    if (controllerNumber > 127)
-    {
-        // channel configuration. force must be set to true
-        if (!force)
-        {
-            return;
-        }
-        switch (controllerNumber)
-        {
-            default:
-                return;
-            
-            case channelConfiguration.velocityOverride:
-                channelObject.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 (channelObject.lockedControllers[actualCCNum])
-        {
-            return;
-        }
-        // append the lower nibble to the main controller
-        channelObject.midiControllers[actualCCNum] = (channelObject.midiControllers[actualCCNum] & 0x3F80) | (controllerValue & 0x7F);
-        channelObject.voices.forEach(v => computeModulators(v, channelObject.midiControllers, 1, actualCCNum));
-    }
-    switch (controllerNumber)
-    {
-        case midiControllers.allNotesOff:
-            this.stopAll(channel);
-            break;
-        
-        case midiControllers.allSoundOff:
-            this.stopAll(channel, true);
-            break;
-        
-        // special case: bank select
-        case midiControllers.bankSelect:
-            let bankNr = controllerValue;
-            if (!force)
-            {
-                switch (this.system)
-                {
-                    case "gm":
-                        // gm ignores bank select
-                        SpessaSynthInfo(
-                            `%cIgnoring the Bank Select (${controllerValue}), as the synth is in GM mode.`,
-                            consoleColors.info
-                        );
-                        return;
-                    
-                    case "xg":
-                        // for xg, if msb is 120, 126 or 127, then it's drums
-                        if (bankNr === 120 || bankNr === 126 || bankNr === 127)
-                        {
-                            this.setDrums(channel, true);
-                        }
-                        else
-                        {
-                            // drums shall not be disabled on channel 9
-                            if (channel % 16 !== DEFAULT_PERCUSSION)
-                            {
-                                this.setDrums(channel, false);
-                            }
-                        }
-                        break;
-                    
-                    case "gm2":
-                        if (bankNr === 120)
-                        {
-                            this.setDrums(channel, true);
-                        }
-                }
-                
-                if (channelObject.drumChannel)
-                {
-                    // 128 for percussion channel
-                    bankNr = 128;
-                }
-                if (bankNr === 128 && !channelObject.drumChannel)
-                {
-                    // if a channel is not for percussion, default to bank current
-                    bankNr = getBankSelect(channelObject);
-                }
-            }
-            
-            setBankSelect(channelObject, bankNr);
-            break;
-        
-        case midiControllers.lsbForControl0BankSelect:
-            if (this.system === "xg")
-            {
-                if (!channelObject.drumChannel)
-                {
-                    // some soundfonts use 127 as drums and
-                    // if it's not marked as drums by bank MSB (line 47), then we DO NOT want the drums!
-                    if (controllerValue !== 127)
-                    {
-                        setBankSelect(channelObject, controllerValue);
-                    }
-                }
-            }
-            else if (this.system === "gm2")
-            {
-                setBankSelect(channelObject, controllerValue);
-            }
-            break;
-        
-        // check for RPN and NPRN and data entry
-        case midiControllers.RPNLsb:
-            channelObject.RPValue = channelObject.RPValue << 7 | controllerValue;
-            channelObject.dataEntryState = dataEntryStates.RPFine;
-            break;
-        
-        case midiControllers.RPNMsb:
-            channelObject.RPValue = controllerValue;
-            channelObject.dataEntryState = dataEntryStates.RPCoarse;
-            break;
-        
-        case midiControllers.NRPNMsb:
-            channelObject.NRPCoarse = controllerValue;
-            channelObject.dataEntryState = dataEntryStates.NRPCoarse;
-            break;
-        
-        case midiControllers.NRPNLsb:
-            channelObject.NRPFine = controllerValue;
-            channelObject.dataEntryState = dataEntryStates.NRPFine;
-            break;
-        
-        case midiControllers.dataEntryMsb:
-            this.dataEntryCoarse(channel, controllerValue);
-            break;
-        
-        case midiControllers.lsbForControl6DataEntry:
-            this.dataEntryFine(channel, controllerValue);
-            break;
-        
-        case midiControllers.resetAllControllers:
-            this.resetControllers(channel);
-            break;
-        
-        case midiControllers.sustainPedal:
-            if (controllerValue >= 64)
-            {
-                channelObject.holdPedal = true;
-            }
-            else
-            {
-                channelObject.holdPedal = false;
-                channelObject.sustainedVoices.forEach(v =>
-                {
-                    this.releaseVoice(v);
-                });
-                channelObject.sustainedVoices = [];
-            }
-            break;
-        
-        // default: apply the controller to the table
-        default:
-            if (channelObject.lockedControllers[controllerNumber])
-            {
-                return;
-            }
-            channelObject.midiControllers[controllerNumber] = controllerValue << 7;
-            channelObject.voices.forEach(v => computeModulators(v, channelObject.midiControllers, 1, controllerNumber));
-            break;
-    }
-    this.callEvent("controllerchange", {
-        channel: channel,
-        controllerNumber: controllerNumber,
-        controllerValue: controllerValue
-    });
-}
-
-/**
- * @param volume {number} 0 to 1
- * @this {SpessaSynthProcessor}
- */
-export function setMIDIVolume(volume)
-{
-    this.midiVolume = volume;
-    this.setMasterPan(this.pan);
-}
-
-/**
- * @param volume {number} 0-1
- * @this {SpessaSynthProcessor}
- */
-export function setMasterGain(volume)
-{
-    this.masterGain = volume * SYNTHESIZER_GAIN;
-    this.setMasterPan(this.pan);
-}
-
-/**
- * @param pan {number} -1 to one
- * @this {SpessaSynthProcessor}
- */
-export function setMasterPan(pan)
-{
-    this.pan = pan;
-    // clamp to 0-1 (0 is left)
-    pan = (pan / 2) + 0.5;
-    this.panLeft = (1 - pan);
-    this.panRight = (pan);
-}
-
-/**
- * @param channel {number}
- * @param isMuted {boolean}
- * @this {SpessaSynthProcessor}
- */
-export function muteChannel(channel, isMuted)
-{
-    if (isMuted)
-    {
-        this.stopAll(channel, true);
-    }
-    this.workletProcessorChannels[channel].isMuted = isMuted;
-    this.sendChannelProperties();
-    this.callEvent("mutechannel", {
-        channel: channel,
-        isMuted: isMuted
-    });
-}

package/synthetizer/worklet_system/worklet_methods/note_off.js

@@ -1,119 +0,0 @@
-import { consoleColors } from "../../../utils/other.js";
-import { SpessaSynthInfo, SpessaSynthWarn } from "../../../utils/loggin.js";
-import { generatorTypes } from "../../../soundfont/basic_soundfont/generator.js";
-
-/**
- * Release a note
- * @param channel {number}
- * @param midiNote {number}
- * @this {SpessaSynthProcessor}
- */
-export function noteOff(channel, midiNote)
-{
-    if (midiNote > 127 || midiNote < 0)
-    {
-        SpessaSynthWarn(`Received a noteOn for note`, midiNote, "Ignoring.");
-        return;
-    }
-    
-    let realKey = midiNote + this.workletProcessorChannels[channel].channelTransposeKeyShift;
-    
-    // if high performance mode, kill notes instead of stopping them
-    if (this.highPerformanceMode)
-    {
-        // if the channel is percussion channel, do not kill the notes
-        if (!this.workletProcessorChannels[channel].drumChannel)
-        {
-            this.killNote(channel, realKey);
-            return;
-        }
-    }
-    
-    const channelVoices = this.workletProcessorChannels[channel].voices;
-    channelVoices.forEach(v =>
-    {
-        if (v.realKey !== realKey || v.isInRelease === true)
-        {
-            return;
-        }
-        // if hold pedal, move to sustain
-        if (this.workletProcessorChannels[channel].holdPedal)
-        {
-            this.workletProcessorChannels[channel].sustainedVoices.push(v);
-        }
-        else
-        {
-            this.releaseVoice(v);
-        }
-    });
-    this.callEvent("noteoff", {
-        midiNote: midiNote,
-        channel: channel
-    });
-}
-
-/**
- * Stops a note nearly instantly
- * @param channel {number}
- * @param midiNote {number}
- * @this {SpessaSynthProcessor}
- */
-export function killNote(channel, midiNote)
-{
-    this.workletProcessorChannels[channel].voices.forEach(v =>
-    {
-        if (v.realKey !== midiNote)
-        {
-            return;
-        }
-        v.modulatedGenerators[generatorTypes.releaseVolEnv] = -12000; // set release to be very short
-        this.releaseVoice(v);
-    });
-}
-
-/**
- * stops all notes on a given channel
- * @param channel {number}
- * @param force {boolean}
- * @this {SpessaSynthProcessor}
- */
-export function stopAll(channel, force = false)
-{
-    const channelVoices = this.workletProcessorChannels[channel].voices;
-    if (force)
-    {
-        // force stop all
-        channelVoices.length = 0;
-        this.workletProcessorChannels[channel].sustainedVoices.length = 0;
-        this.sendChannelProperties();
-    }
-    else
-    {
-        channelVoices.forEach(v =>
-        {
-            if (v.isInRelease)
-            {
-                return;
-            }
-            this.releaseVoice(v);
-        });
-        this.workletProcessorChannels[channel].sustainedVoices.forEach(v =>
-        {
-            this.releaseVoice(v);
-        });
-    }
-}
-
-/**
- * @this {SpessaSynthProcessor}
- * @param force {boolean}
- */
-export function stopAllChannels(force = false)
-{
-    SpessaSynthInfo("%cStop all received!", consoleColors.info);
-    for (let i = 0; i < this.workletProcessorChannels.length; i++)
-    {
-        this.stopAll(i, force);
-    }
-    this.callEvent("stopall", undefined);
-}