spessasynth_lib 3.24.13 → 3.24.16

package/synthetizer/worklet_system/worklet_methods/program_control.js

@@ -1,282 +0,0 @@
-import { returnMessageType } from "../message_protocol/worklet_message.js";
-import { SpessaSynthInfo, SpessaSynthWarn } from "../../../utils/loggin.js";
-import { consoleColors } from "../../../utils/other.js";
-import { loadSoundFont } from "../../../soundfont/load_soundfont.js";
-import { getBankSelect } from "../worklet_utilities/worklet_processor_channel.js";
-
-/**
- * executes a program change
- * @param channel {number}
- * @param programNumber {number}
- * @param userChange {boolean}
- * @this {SpessaSynthProcessor}
- */
-export function programChange(channel, programNumber, userChange = false)
-{
-    /**
-     * @type {WorkletProcessorChannel}
-     */
-    const channelObject = this.workletProcessorChannels[channel];
-    if (channelObject === undefined)
-    {
-        SpessaSynthWarn(`Trying to access channel ${channel} which does not exist... ignoring!`);
-        return;
-    }
-    if (channelObject.lockPreset)
-    {
-        return;
-    }
-    // always 128 for percussion
-    const bank = getBankSelect(channelObject);
-    let sentBank;
-    let preset;
-    
-    // check if override
-    if (this.overrideSoundfont)
-    {
-        const bankWithOffset = bank === 128 ? 128 : bank - this.soundfontBankOffset;
-        const p = this.overrideSoundfont.getPresetNoFallback(bankWithOffset, programNumber);
-        if (p)
-        {
-            sentBank = bank;
-            preset = p;
-            channelObject.presetUsesOverride = true;
-        }
-        else
-        {
-            preset = this.soundfontManager.getPreset(bank, programNumber);
-            sentBank = preset.bank;
-            channelObject.presetUsesOverride = false;
-        }
-    }
-    else
-    {
-        preset = this.soundfontManager.getPreset(bank, programNumber);
-        sentBank = preset.bank;
-        channelObject.presetUsesOverride = false;
-    }
-    this.setPreset(channel, preset);
-    this.callEvent("programchange", {
-        channel: channel,
-        program: preset.program,
-        bank: sentBank,
-        userCalled: userChange
-    });
-}
-
-/**
- * @this {SpessaSynthProcessor}
- * @param program {number}
- * @param bank {number}
- * @returns {BasicPreset}
- */
-export function getPreset(bank, program)
-{
-    if (this.overrideSoundfont)
-    {
-        // if overriden soundfont
-        const bankWithOffset = bank === 128 ? 128 : bank - this.soundfontBankOffset;
-        const preset = this.overrideSoundfont.getPresetNoFallback(bankWithOffset, program);
-        if (preset)
-        {
-            return preset;
-        }
-    }
-    return this.soundfontManager.getPreset(bank, program);
-}
-
-
-/**
- * @param channel {number}
- * @param preset {BasicPreset}
- * @this {SpessaSynthProcessor}
- */
-export function setPreset(channel, preset)
-{
-    if (this.workletProcessorChannels[channel].lockPreset)
-    {
-        return;
-    }
-    delete this.workletProcessorChannels[channel].preset;
-    this.workletProcessorChannels[channel].preset = preset;
-    
-    // reset cached voices
-    this.workletProcessorChannels[channel].cachedVoices = [];
-    for (let i = 0; i < 128; i++)
-    {
-        this.workletProcessorChannels[channel].cachedVoices.push([]);
-    }
-}
-
-/**
- * Toggles drums on a given channel
- * @param channel {number}
- * @param isDrum {boolean}
- * @this {SpessaSynthProcessor}
- */
-export function setDrums(channel, isDrum)
-{
-    const channelObject = this.workletProcessorChannels[channel];
-    if (channelObject.lockPreset)
-    {
-        return;
-    }
-    if (channelObject.drumChannel === isDrum)
-    {
-        return;
-    }
-    if (isDrum)
-    {
-        // clear transpose
-        channelObject.channelTransposeKeyShift = 0;
-        channelObject.drumChannel = true;
-        this.setPreset(channel, this.getPreset(getBankSelect(channelObject), channelObject.preset.program));
-    }
-    else
-    {
-        channelObject.drumChannel = false;
-        this.setPreset(
-            channel,
-            this.getPreset(
-                getBankSelect(channelObject),
-                channelObject.preset.program
-            )
-        );
-    }
-    channelObject.presetUsesOverride = false;
-    this.callEvent("drumchange", {
-        channel: channel,
-        isDrumChannel: channelObject.drumChannel
-    });
-    this.sendChannelProperties();
-}
-
-/**
- * @this {SpessaSynthProcessor}
- */
-export function sendPresetList()
-{
-    /**
-     * @type {{bank: number, presetName: string, program: number}[]}
-     */
-    const mainFont = this.soundfontManager.getPresetList();
-    if (this.overrideSoundfont !== undefined)
-    {
-        this.overrideSoundfont.presets.forEach(p =>
-        {
-            const bankCheck = p.bank === 128 ? 128 : p.bank + this.soundfontBankOffset;
-            const exists = mainFont.find(pr => pr.bank === bankCheck && pr.program === p.program);
-            if (exists !== undefined)
-            {
-                exists.presetName = p.presetName;
-            }
-            else
-            {
-                mainFont.push({
-                    presetName: p.presetName,
-                    bank: bankCheck,
-                    program: p.program
-                });
-            }
-        });
-    }
-    this.callEvent("presetlistchange", mainFont);
-}
-
-/**
- * @this {SpessaSynthProcessor}
- * @param sendPresets {boolean}
- * @param clearOverride {boolean}
- */
-export function clearSoundFont(sendPresets = true, clearOverride = true)
-{
-    this.stopAllChannels(true);
-    if (clearOverride)
-    {
-        delete this.overrideSoundfont;
-        this.overrideSoundfont = undefined;
-    }
-    this.defaultPreset = this.getPreset(0, 0);
-    this.drumPreset = this.getPreset(128, 0);
-    
-    for (let i = 0; i < this.workletProcessorChannels.length; i++)
-    {
-        const channelObject = this.workletProcessorChannels[i];
-        channelObject.cachedVoices = [];
-        for (let j = 0; j < 128; j++)
-        {
-            channelObject.cachedVoices.push([]);
-        }
-        if (!clearOverride || (clearOverride && channelObject.presetUsesOverride))
-        {
-            channelObject.lockPreset = false;
-        }
-        this.programChange(i, channelObject.preset.program);
-    }
-    if (sendPresets)
-    {
-        this.sendPresetList();
-    }
-}
-
-/**
- * @param buffer {ArrayBuffer}
- * @param isOverride {Boolean}
- * @this {SpessaSynthProcessor}
- */
-export function reloadSoundFont(buffer, isOverride = false)
-{
-    this.clearSoundFont(false, isOverride);
-    try
-    {
-        if (isOverride)
-        {
-            this.overrideSoundfont = loadSoundFont(buffer);
-            // assign sample offset
-            this.overrideSoundfont.setSampleIDOffset(this.soundfontManager.totalSoundfontOffset);
-        }
-        else
-        {
-            this.soundfontManager.reloadManager(buffer);
-        }
-    }
-    catch (e)
-    {
-        this.post({
-            messageType: returnMessageType.soundfontError,
-            messageData: e
-        });
-        return;
-    }
-    this.defaultPreset = this.getPreset(0, 0);
-    this.drumPreset = this.getPreset(128, 0);
-    this.workletProcessorChannels.forEach((c, cNum) =>
-    {
-        this.programChange(cNum, c.preset.program);
-    });
-    this.post({ messageType: returnMessageType.ready, messageData: undefined });
-    this.sendPresetList();
-    SpessaSynthInfo("%cSpessaSynth is ready!", consoleColors.recognized);
-}
-
-/**
- * Sets the embedded (RMI soundfont)
- * @param font {ArrayBuffer}
- * @param offset {number}
- * @this {SpessaSynthProcessor}
- */
-export function setEmbeddedSoundFont(font, offset)
-{
-    // set offet
-    this.soundfontBankOffset = offset;
-    this.reloadSoundFont(font, true);
-    // preload all samples
-    this.overrideSoundfont.samples.forEach(s => s.getAudioData());
-    
-    // apply snapshot again if applicable
-    if (this._snapshot !== undefined)
-    {
-        this.applySynthesizerSnapshot(this._snapshot);
-        this.resetAllControllers();
-    }
-}

package/synthetizer/worklet_system/worklet_methods/tuning_control.js

@@ -1,233 +0,0 @@
-import { consoleColors } from "../../../utils/other.js";
-import { computeModulators } from "../worklet_utilities/worklet_modulator.js";
-import { SpessaSynthInfo } from "../../../utils/loggin.js";
-import { modulatorSources } from "../../../soundfont/basic_soundfont/modulator.js";
-import { customControllers, NON_CC_INDEX_OFFSET } from "../worklet_utilities/controller_tables.js";
-
-/**
- * Transposes all channels by given amount of semitones
- * @this {SpessaSynthProcessor}
- * @param semitones {number} Can be float
- * @param force {boolean} defaults to false, if true transposes the channel even if it's a drum channel
- */
-export function transposeAllChannels(semitones, force = false)
-{
-    this.transposition = 0;
-    for (let i = 0; i < this.workletProcessorChannels.length; i++)
-    {
-        this.transposeChannel(i, semitones, force);
-    }
-    this.transposition = semitones;
-}
-
-/**
- * Transposes the channel by given amount of semitones
- * @this {SpessaSynthProcessor}
- * @param channel {number}
- * @param semitones {number} Can be float
- * @param force {boolean} defaults to false, if true transposes the channel even if it's a drum channel
- */
-export function transposeChannel(channel, semitones, force = false)
-{
-    const channelObject = this.workletProcessorChannels[channel];
-    if (!channelObject.drumChannel)
-    {
-        semitones += this.transposition;
-    }
-    const keyShift = Math.trunc(semitones);
-    const currentTranspose = channelObject.channelTransposeKeyShift + channelObject.customControllers[customControllers.channelTransposeFine] / 100;
-    if (
-        (channelObject.drumChannel && !force)
-        || semitones === currentTranspose
-    )
-    {
-        return;
-    }
-    if (keyShift !== channelObject.channelTransposeKeyShift)
-    {
-        this.stopAll(channel, false);
-    }
-    // apply transpose
-    channelObject.channelTransposeKeyShift = keyShift;
-    channelObject.customControllers[customControllers.channelTransposeFine] = (semitones - keyShift) * 100;
-}
-
-/**
- * Sets the channel's tuning
- * @this {SpessaSynthProcessor}
- * @param channel {number}
- * @param cents {number}
- * @param log {boolean}
- */
-export function setChannelTuning(channel, cents, log = true)
-{
-    const channelObject = this.workletProcessorChannels[channel];
-    cents = Math.round(cents);
-    channelObject.customControllers[customControllers.channelTuning] = cents;
-    if (!log)
-    {
-        return;
-    }
-    SpessaSynthInfo(
-        `%cChannel ${channel} fine tuning. Cents: %c${cents}`,
-        consoleColors.info,
-        consoleColors.value
-    );
-}
-
-/**
- * Sets the channel's tuning in semitones
- * @param channel {number}
- * @param semitones {number}
- * @this {SpessaSynthProcessor}
- */
-export function setChannelTuningSemitones(channel, semitones)
-{
-    const channelObject = this.workletProcessorChannels[channel];
-    semitones = Math.round(semitones);
-    channelObject.customControllers[customControllers.channelTuningSemitones] = semitones;
-    SpessaSynthInfo(
-        `%cChannel ${channel} coarse tuning. Semitones: %c${semitones}`,
-        consoleColors.info,
-        consoleColors.value
-    );
-}
-
-/**
- * Sets the worklet's master tuning
- * @this {SpessaSynthProcessor}
- * @param cents {number}
- */
-export function setMasterTuning(cents)
-{
-    cents = Math.round(cents);
-    for (let i = 0; i < this.workletProcessorChannels.length; i++)
-    {
-        this.workletProcessorChannels[i].customControllers[customControllers.masterTuning] = cents;
-    }
-}
-
-/**
- * @this {SpessaSynthProcessor}
- * @param channel {number}
- * @param cents {number}
- */
-export function setModulationDepth(channel, cents)
-{
-    let channelObject = this.workletProcessorChannels[channel];
-    cents = Math.round(cents);
-    SpessaSynthInfo(
-        `%cChannel ${channel} modulation depth. Cents: %c${cents}`,
-        consoleColors.info,
-        consoleColors.value
-    );
-    /* ==============
-        IMPORTANT
-        here we convert cents into a multiplier.
-        midi spec assumes the default is 50 cents,
-        but it might be different for the soundfont
-        so we create a multiplier by divinging cents by 50.
-        for example, if we want 100 cents, then multiplier will be 2,
-        which for a preset with depth of 50 will create 100.
-     ================ */
-    channelObject.customControllers[customControllers.modulationMultiplier] = cents / 50;
-}
-
-/**
- * Sets the pitch of the given channel
- * @this {SpessaSynthProcessor}
- * @param channel {number} usually 0-15: the channel to change pitch
- * @param MSB {number} SECOND byte of the MIDI pitchWheel message
- * @param LSB {number} FIRST byte of the MIDI pitchWheel message
- */
-export function pitchWheel(channel, MSB, LSB)
-{
-    if (this.workletProcessorChannels[channel].lockedControllers[NON_CC_INDEX_OFFSET + modulatorSources.pitchWheel])
-    {
-        return;
-    }
-    const bend = (LSB | (MSB << 7));
-    this.callEvent("pitchwheel", {
-        channel: channel,
-        MSB: MSB,
-        LSB: LSB
-    });
-    this.workletProcessorChannels[channel].midiControllers[NON_CC_INDEX_OFFSET + modulatorSources.pitchWheel] = bend;
-    this.workletProcessorChannels[channel].voices.forEach(v =>
-        // compute pitch modulators
-        computeModulators(
-            v,
-            this.workletProcessorChannels[channel].midiControllers,
-            0,
-            modulatorSources.pitchWheel
-        ));
-    this.sendChannelProperties();
-}
-
-/**
- * Sets the pressure of the given channel
- * @this {SpessaSynthProcessor}
- * @param channel {number} usually 0-15: the channel to change pitch
- * @param pressure {number} the pressure of the channel
- */
-export function channelPressure(channel, pressure)
-{
-    const channelObject = this.workletProcessorChannels[channel];
-    channelObject.midiControllers[NON_CC_INDEX_OFFSET + modulatorSources.channelPressure] = pressure << 7;
-    this.workletProcessorChannels[channel].voices.forEach(v =>
-        computeModulators(
-            v,
-            channelObject.midiControllers,
-            0,
-            modulatorSources.channelPressure
-        ));
-    this.callEvent("channelpressure", {
-        channel: channel,
-        pressure: pressure
-    });
-}
-
-/**
- * Sets the pressure of the given note on a specific channel
- * @this {SpessaSynthProcessor}
- * @param channel {number} usually 0-15: the channel to change pitch
- * @param midiNote {number} 0-127
- * @param pressure {number} the pressure of the note
- */
-export function polyPressure(channel, midiNote, pressure)
-{
-    this.workletProcessorChannels[channel].voices.forEach(v =>
-    {
-        if (v.midiNote !== midiNote)
-        {
-            return;
-        }
-        v.pressure = pressure;
-        computeModulators(
-            v,
-            this.workletProcessorChannels[channel].midiControllers,
-            0,
-            modulatorSources.polyPressure
-        );
-    });
-    this.callEvent("polypressure", {
-        channel: channel,
-        midiNote: midiNote,
-        pressure: pressure
-    });
-}
-
-/**
- * Sets the octave tuning for a given channel
- * @this {SpessaSynthProcessor}
- * @param channel {number} usually 0-15: the channel to use
- * @param tuning {Int8Array} LENGTH of 12!!! relative cent tuning. min -128 max 127.
- */
-export function setOctaveTuning(channel, tuning)
-{
-    if (tuning.length !== 12)
-    {
-        throw new Error("Tuning is not the length of 12.");
-    }
-    this.workletProcessorChannels[channel].channelOctaveTuning = tuning;
-}

package/synthetizer/worklet_system/worklet_methods/vibrato_control.js

@@ -1,29 +0,0 @@
-/**
- * @param channel {number}
- * @this {SpessaSynthProcessor}
- */
-export function disableAndLockGSNRPN(channel)
-{
-    this.workletProcessorChannels[channel].lockGSNRPNParams = true;
-    this.workletProcessorChannels[channel].channelVibrato.rate = 0;
-    this.workletProcessorChannels[channel].channelVibrato.delay = 0;
-    this.workletProcessorChannels[channel].channelVibrato.depth = 0;
-}
-
-/**
- * @param channel {number}
- * @param depth {number}
- * @param rate {number}
- * @param delay {number}
- * @this {SpessaSynthProcessor}
- */
-export function setVibrato(channel, depth, rate, delay)
-{
-    if (this.workletProcessorChannels[channel].lockGSNRPNParams)
-    {
-        return;
-    }
-    this.workletProcessorChannels[channel].channelVibrato.rate = rate;
-    this.workletProcessorChannels[channel].channelVibrato.delay = delay;
-    this.workletProcessorChannels[channel].channelVibrato.depth = depth;
-}