spessasynth_lib 3.25.21 → 3.25.22

package/synthetizer/audio_engine/{worklet_utilities/worklet_processor_channel.js → engine_components/midi_audio_channel.js}

@@ -9,25 +9,25 @@ import {
     resetControllers,
     resetControllersRP15Compliant,
     resetParameters
-} from "../worklet_methods/controller_control/reset_controllers.js";
-import { renderVoice } from "../worklet_methods/render_voice.js";
+} from "../engine_methods/controller_control/reset_controllers.js";
+import { renderVoice } from "../engine_methods/render_voice.js";
 import { panVoice } from "./stereo_panner.js";
-import { killNote } from "../worklet_methods/stopping_notes/kill_note.js";
-import { setTuning } from "../worklet_methods/tuning_control/set_tuning.js";
-import { setModulationDepth } from "../worklet_methods/tuning_control/set_modulation_depth.js";
-import { dataEntryFine } from "../worklet_methods/data_entry/data_entry_fine.js";
-import { controllerChange } from "../worklet_methods/controller_control/controller_change.js";
-import { stopAllNotes } from "../worklet_methods/stopping_notes/stop_all_notes.js";
-import { muteChannel } from "../worklet_methods/mute_channel.js";
-import { transposeChannel } from "../worklet_methods/tuning_control/transpose_channel.js";
-import { dataEntryCoarse } from "../worklet_methods/data_entry/data_entry_coarse.js";
-import { noteOn } from "../worklet_methods/note_on.js";
-import { noteOff } from "../worklet_methods/stopping_notes/note_off.js";
-import { polyPressure } from "../worklet_methods/tuning_control/poly_pressure.js";
-import { channelPressure } from "../worklet_methods/tuning_control/channel_pressure.js";
-import { pitchWheel } from "../worklet_methods/tuning_control/pitch_wheel.js";
-import { setOctaveTuning } from "../worklet_methods/tuning_control/set_octave_tuning.js";
-import { programChange } from "../worklet_methods/program_change.js";
+import { killNote } from "../engine_methods/stopping_notes/kill_note.js";
+import { setTuning } from "../engine_methods/tuning_control/set_tuning.js";
+import { setModulationDepth } from "../engine_methods/tuning_control/set_modulation_depth.js";
+import { dataEntryFine } from "../engine_methods/data_entry/data_entry_fine.js";
+import { controllerChange } from "../engine_methods/controller_control/controller_change.js";
+import { stopAllNotes } from "../engine_methods/stopping_notes/stop_all_notes.js";
+import { muteChannel } from "../engine_methods/mute_channel.js";
+import { transposeChannel } from "../engine_methods/tuning_control/transpose_channel.js";
+import { dataEntryCoarse } from "../engine_methods/data_entry/data_entry_coarse.js";
+import { noteOn } from "../engine_methods/note_on.js";
+import { noteOff } from "../engine_methods/stopping_notes/note_off.js";
+import { polyPressure } from "../engine_methods/tuning_control/poly_pressure.js";
+import { channelPressure } from "../engine_methods/tuning_control/channel_pressure.js";
+import { pitchWheel } from "../engine_methods/tuning_control/pitch_wheel.js";
+import { setOctaveTuning } from "../engine_methods/tuning_control/set_octave_tuning.js";
+import { programChange } from "../engine_methods/program_change.js";
 import { chooseBank, isSystemXG, parseBankSelect } from "../../../utils/xg_hacks.js";
 import { DEFAULT_PERCUSSION } from "../../synth_constants.js";
 import { modulatorSources } from "../../../soundfont/basic_soundfont/modulator.js";
@@ -36,7 +36,7 @@ import { returnMessageType } from "../message_protocol/worklet_message.js";
 /**
  * This class represents a single MIDI Channel within the synthesizer.
  */
-class WorkletProcessorChannel
+class MidiAudioChannel
 {
     /**
      * An array of MIDI controller values and values used by modulators as the source (e.g., pitch bend, bend range, etc.).
@@ -177,13 +177,13 @@ class WorkletProcessorChannel
     
     /**
      * An array of voices currently active on the channel.
-     * @type {WorkletVoice[]}
+     * @type {Voice[]}
      */
     voices = [];
     
     /**
      * An array of voices that are sustained on the channel.
-     * @type {WorkletVoice[]}
+     * @type {Voice[]}
      */
     sustainedVoices = [];
     
@@ -440,32 +440,32 @@ class WorkletProcessorChannel
 }
 
 // voice
-WorkletProcessorChannel.prototype.renderVoice = renderVoice;
-WorkletProcessorChannel.prototype.panVoice = panVoice;
-WorkletProcessorChannel.prototype.killNote = killNote;
-WorkletProcessorChannel.prototype.stopAllNotes = stopAllNotes;
-WorkletProcessorChannel.prototype.muteChannel = muteChannel;
+MidiAudioChannel.prototype.renderVoice = renderVoice;
+MidiAudioChannel.prototype.panVoice = panVoice;
+MidiAudioChannel.prototype.killNote = killNote;
+MidiAudioChannel.prototype.stopAllNotes = stopAllNotes;
+MidiAudioChannel.prototype.muteChannel = muteChannel;
 
 // MIDI messages
-WorkletProcessorChannel.prototype.noteOn = noteOn;
-WorkletProcessorChannel.prototype.noteOff = noteOff;
-WorkletProcessorChannel.prototype.polyPressure = polyPressure;
-WorkletProcessorChannel.prototype.channelPressure = channelPressure;
-WorkletProcessorChannel.prototype.pitchWheel = pitchWheel;
-WorkletProcessorChannel.prototype.programChange = programChange;
+MidiAudioChannel.prototype.noteOn = noteOn;
+MidiAudioChannel.prototype.noteOff = noteOff;
+MidiAudioChannel.prototype.polyPressure = polyPressure;
+MidiAudioChannel.prototype.channelPressure = channelPressure;
+MidiAudioChannel.prototype.pitchWheel = pitchWheel;
+MidiAudioChannel.prototype.programChange = programChange;
 
 // Tuning
-WorkletProcessorChannel.prototype.setTuning = setTuning;
-WorkletProcessorChannel.prototype.setOctaveTuning = setOctaveTuning;
-WorkletProcessorChannel.prototype.setModulationDepth = setModulationDepth;
-WorkletProcessorChannel.prototype.transposeChannel = transposeChannel;
+MidiAudioChannel.prototype.setTuning = setTuning;
+MidiAudioChannel.prototype.setOctaveTuning = setOctaveTuning;
+MidiAudioChannel.prototype.setModulationDepth = setModulationDepth;
+MidiAudioChannel.prototype.transposeChannel = transposeChannel;
 
 // CC
-WorkletProcessorChannel.prototype.controllerChange = controllerChange;
-WorkletProcessorChannel.prototype.resetControllers = resetControllers;
-WorkletProcessorChannel.prototype.resetControllersRP15Compliant = resetControllersRP15Compliant;
-WorkletProcessorChannel.prototype.resetParameters = resetParameters;
-WorkletProcessorChannel.prototype.dataEntryFine = dataEntryFine;
-WorkletProcessorChannel.prototype.dataEntryCoarse = dataEntryCoarse;
+MidiAudioChannel.prototype.controllerChange = controllerChange;
+MidiAudioChannel.prototype.resetControllers = resetControllers;
+MidiAudioChannel.prototype.resetControllersRP15Compliant = resetControllersRP15Compliant;
+MidiAudioChannel.prototype.resetParameters = resetParameters;
+MidiAudioChannel.prototype.dataEntryFine = dataEntryFine;
+MidiAudioChannel.prototype.dataEntryCoarse = dataEntryCoarse;
 
-export { WorkletProcessorChannel };
+export { MidiAudioChannel };

package/synthetizer/audio_engine/{worklet_utilities → engine_components}/modulation_envelope.js

@@ -17,7 +17,7 @@ for (let i = 0; i < CONVEX_ATTACK.length; i++)
     CONVEX_ATTACK[i] = getModulatorCurveValue(0, modulatorCurveTypes.convex, i / 1000, 0);
 }
 
-export class WorkletModulationEnvelope
+export class ModulationEnvelope
 {
     /**
      * The attack duration, in seconds
@@ -83,15 +83,15 @@ export class WorkletModulationEnvelope
     
     /**
      * Starts the release phase in the envelope
-     * @param voice {WorkletVoice} the voice this envelope belongs to
+     * @param voice {Voice} the voice this envelope belongs to
      */
     static startRelease(voice)
     {
-        WorkletModulationEnvelope.recalculate(voice);
+        ModulationEnvelope.recalculate(voice);
     }
     
     /**
-     * @param voice {WorkletVoice} the voice to recalculate
+     * @param voice {Voice} the voice to recalculate
      */
     static recalculate(voice)
     {
@@ -100,7 +100,7 @@ export class WorkletModulationEnvelope
         // in release? Might need to recalculate the value as it can be modulated
         if (voice.isInRelease)
         {
-            env.releaseStartLevel = WorkletModulationEnvelope.getValue(voice, voice.releaseStartTime, true);
+            env.releaseStartLevel = ModulationEnvelope.getValue(voice, voice.releaseStartTime, true);
         }
         
         env.sustainLevel = 1 - (voice.modulatedGenerators[generatorTypes.sustainModEnv] / 1000);
@@ -130,7 +130,7 @@ export class WorkletModulationEnvelope
     
     /**
      * Calculates the current modulation envelope value for the given time and voice
-     * @param voice {WorkletVoice} the voice we are working on
+     * @param voice {Voice} the voice we are working on
      * @param currentTime {number} in seconds
      * @param ignoreRelease {boolean} if true, it will compute the value as if the voice was not released
      * @returns {number} modenv value, from 0 to 1

package/synthetizer/audio_engine/{worklet_utilities → engine_components}/stereo_panner.js

@@ -29,7 +29,7 @@ for (let pan = MIN_PAN; pan <= MAX_PAN; pan++)
 
 /**
  * Pans the voice to the given output buffers
- * @param voice {WorkletVoice} the voice to pan
+ * @param voice {Voice} the voice to pan
  * @param inputBuffer {Float32Array} the input buffer in mono
  * @param outputLeft {Float32Array} left output buffer
  * @param outputRight {Float32Array} right output buffer
@@ -37,7 +37,7 @@ for (let pan = MIN_PAN; pan <= MAX_PAN; pan++)
  * @param reverbRight {Float32Array} right reverb input
  * @param chorusLeft {Float32Array} left chorus buffer
  * @param chorusRight {Float32Array} right chorus buffer
- * @this {WorkletProcessorChannel}
+ * @this {MidiAudioChannel}
  */
 export function panVoice(voice,
                          inputBuffer,
@@ -65,7 +65,7 @@ export function panVoice(voice,
         pan = voice.currentPan;
     }
     
-    const gain = this.synth.currentGain;
+    const gain = this.synth.currentGain * voice.gain;
     const index = ~~(pan + 500);
     // get voice's gain levels for each channel
     const gainLeft = panTableLeft[index] * gain * this.synth.panLeft;

package/synthetizer/audio_engine/{worklet_utilities/worklet_voice.js → engine_components/voice.js}

@@ -1,13 +1,13 @@
 /**
- * worklet_voice.js
- * purpose: prepares workletvoices from sample and generator data and manages sample dumping
+ * voice.js
+ * purpose: prepares Voices from sample and generator data and manages sample dumping
  * note: sample dumping means sending it over to the AudioWorkletGlobalScope
  */
 import { MIN_EXCLUSIVE_LENGTH, MIN_NOTE_LENGTH } from "../main_processor.js";
 import { SpessaSynthWarn } from "../../../utils/loggin.js";
 import { WorkletLowpassFilter } from "./lowpass_filter.js";
-import { WorkletVolumeEnvelope } from "./volume_envelope.js";
-import { WorkletModulationEnvelope } from "./modulation_envelope.js";
+import { VolumeEnvelope } from "./volume_envelope.js";
+import { ModulationEnvelope } from "./modulation_envelope.js";
 import { addAndClampGenerator, generatorTypes } from "../../../soundfont/basic_soundfont/generator.js";
 import { Modulator } from "../../../soundfont/basic_soundfont/modulator.js";
 import { isSystemXG } from "../../../utils/xg_hacks.js";
@@ -15,7 +15,7 @@ import { isSystemXG } from "../../../utils/xg_hacks.js";
 const EXCLUSIVE_CUTOFF_TIME = -2320;
 const EXCLUSIVE_MOD_CUTOFF_TIME = -1130; // less because filter shenanigans
 
-class WorkletSample
+class AudioSample
 {
     /**
      * the sample's audio data
@@ -102,7 +102,7 @@ class WorkletSample
 
 
 /**
- * WorkletVoice represents a single instance of the
+ * Voice represents a single instance of the
  * SoundFont2 synthesis model.
  * That is:
  * A wavetable oscillator (sample)
@@ -112,11 +112,11 @@ class WorkletSample
  * Modulators (modulators)
  * And MIDI params such as channel, MIDI note, velocity
  */
-class WorkletVoice
+class Voice
 {
     /**
      * The sample of the voice.
-     * @type {WorkletSample}
+     * @type {AudioSample}
      */
     sample;
     
@@ -126,6 +126,12 @@ class WorkletVoice
      */
     filter;
     
+    /**
+     * Linear gain of the voice. Used with Key Modifiers.
+     * @type {number}
+     */
+    gain = 1;
+    
     /**
      * The unmodulated (copied to) generators of the voice.
      * @type {Int16Array}
@@ -189,13 +195,13 @@ class WorkletVoice
     
     /**
      * Modulation envelope.
-     * @type {WorkletModulationEnvelope}
+     * @type {ModulationEnvelope}
      */
-    modulationEnvelope = new WorkletModulationEnvelope();
+    modulationEnvelope = new ModulationEnvelope();
     
     /**
      * Volume envelope.
-     * @type {WorkletVolumeEnvelope}
+     * @type {VolumeEnvelope}
      */
     volumeEnvelope;
     
@@ -262,9 +268,9 @@ class WorkletVoice
     exclusiveClass = 0;
     
     /**
-     * Creates a workletVoice
+     * Creates a Voice
      * @param sampleRate {number}
-     * @param workletSample {WorkletSample}
+     * @param workletSample {AudioSample}
      * @param midiNote {number}
      * @param velocity {number}
      * @param channel {number}
@@ -300,19 +306,19 @@ class WorkletVoice
         this.startTime = currentTime;
         this.targetKey = targetKey;
         this.realKey = realKey;
-        this.volumeEnvelope = new WorkletVolumeEnvelope(sampleRate, generators[generatorTypes.sustainVolEnv]);
+        this.volumeEnvelope = new VolumeEnvelope(sampleRate, generators[generatorTypes.sustainVolEnv]);
     }
     
     /**
      * copies the voice
-     * @param voice {WorkletVoice}
+     * @param voice {Voice}
      * @param currentTime {number}
-     * @returns WorkletVoice
+     * @returns Voice
      */
     static copy(voice, currentTime)
     {
         const sampleToCopy = voice.sample;
-        const sample = new WorkletSample(
+        const sample = new AudioSample(
             sampleToCopy.sampleData,
             sampleToCopy.playbackStep,
             sampleToCopy.cursor,
@@ -322,7 +328,7 @@ class WorkletVoice
             sampleToCopy.end,
             sampleToCopy.loopingMode
         );
-        return new WorkletVoice(
+        return new Voice(
             voice.volumeEnvelope.sampleRate,
             sample,
             voice.midiNote,
@@ -345,8 +351,8 @@ class WorkletVoice
         this.release(currentTime, MIN_EXCLUSIVE_LENGTH);
         this.modulatedGenerators[generatorTypes.releaseVolEnv] = EXCLUSIVE_CUTOFF_TIME; // make the release nearly instant
         this.modulatedGenerators[generatorTypes.releaseModEnv] = EXCLUSIVE_MOD_CUTOFF_TIME;
-        WorkletVolumeEnvelope.recalculate(this);
-        WorkletModulationEnvelope.recalculate(this);
+        VolumeEnvelope.recalculate(this);
+        ModulationEnvelope.recalculate(this);
     }
     
     /**
@@ -371,17 +377,17 @@ class WorkletVoice
  * @param velocity {number} the velocity to use
  * @param realKey {number} the real MIDI note if the "midiNote" was changed by MIDI Tuning Standard
  * @this {SpessaSynthProcessor}
- * @returns {WorkletVoice[]} output is an array of WorkletVoices
+ * @returns {Voice[]} output is an array of Voices
  */
-export function getWorkletVoices(channel,
-                                 midiNote,
-                                 velocity,
-                                 realKey)
+export function getVoices(channel,
+                          midiNote,
+                          velocity,
+                          realKey)
 {
     /**
-     * @type {WorkletVoice[]}
+     * @type {Voice[]}
      */
-    let workletVoices;
+    let voices;
     const channelObject = this.midiAudioChannels[channel];
     
     // override patch
@@ -401,7 +407,7 @@ export function getWorkletVoices(channel,
     // if cached, return it!
     if (cached !== undefined)
     {
-        return cached.map(v => WorkletVoice.copy(v, this.currentSynthTime));
+        return cached.map(v => Voice.copy(v, this.currentSynthTime));
     }
     
     // not cached...
@@ -411,9 +417,9 @@ export function getWorkletVoices(channel,
         preset = this.soundfontManager.getPreset(bank, program, isSystemXG(this.system));
     }
     /**
-     * @returns {WorkletVoice[]}
+     * @returns {Voice[]}
      */
-    workletVoices = preset.getSamplesAndGenerators(midiNote, velocity)
+    voices = preset.getSamplesAndGenerators(midiNote, velocity)
         .reduce((voices, sampleAndGenerators) =>
         {
             if (sampleAndGenerators.sample.getAudioData() === undefined)
@@ -457,9 +463,9 @@ export function getWorkletVoices(channel,
             /**
              * create the worklet sample
              * offsets are calculated at note on time (to allow for modulation of them)
-             * @type {WorkletSample}
+             * @type {AudioSample}
              */
-            const workletSample = new WorkletSample(
+            const workletSample = new AudioSample(
                 sampleAndGenerators.sample.sampleData,
                 (sampleAndGenerators.sample.sampleRate / this.sampleRate) * Math.pow(
                     2,
@@ -486,12 +492,12 @@ export function getWorkletVoices(channel,
             //     Velocity: velocity,
             //     TargetKey: targetKey,
             //     MidiNote: midiNote,
-            //     WorkletSample: workletSample
+            //     AudioSample: workletSample
             // }]);
             
             
             voices.push(
-                new WorkletVoice(
+                new Voice(
                     this.sampleRate,
                     workletSample,
                     midiNote,
@@ -507,7 +513,7 @@ export function getWorkletVoices(channel,
             return voices;
         }, []);
     // cache the voice
-    this.setCachedVoice(bank, program, midiNote, velocity, workletVoices.map(v =>
-        WorkletVoice.copy(v, this.currentSynthTime)));
-    return workletVoices;
+    this.setCachedVoice(bank, program, midiNote, velocity, voices.map(v =>
+        Voice.copy(v, this.currentSynthTime)));
+    return voices;
 }

package/synthetizer/audio_engine/{worklet_utilities → engine_components}/volume_envelope.js

@@ -21,10 +21,10 @@ const PERCEIVED_GAIN_SILENCE = 0.000015; // can't go lower than that (see #50)
  * 2 - hold/peak
  * 3 - decay
  * 4 - sustain
- * release is indicated by isInRelease property
+ * release indicates by isInRelease property
  */
 
-export class WorkletVolumeEnvelope
+export class VolumeEnvelope
 {
     /**
      * The envelope's current time in samples
@@ -97,22 +97,22 @@ export class WorkletVolumeEnvelope
      */
     sustainDbRelative = 0;
     /**
-     * The time in samples to the end of delay stage, relative to start of the envelope
+     * The time in samples to the end of delay stage, relative to the start of the envelope
      * @type {number}
      */
     delayEnd = 0;
     /**
-     * The time in samples to the end of attack stage, relative to start of the envelope
+     * The time in samples to the end of attack stage, relative to the start of the envelope
      * @type {number}
      */
     attackEnd = 0;
     /**
-     * The time in samples to the end of hold stage, relative to start of the envelope
+     * The time in samples to the end of hold stage, relative to the start of the envelope
      * @type {number}
      */
     holdEnd = 0;
     /**
-     * The time in samples to the end of decay stage, relative to start of the envelope
+     * The time in samples to the end of decay stage, relative to the start of the envelope
      * @type {number}
      */
     decayEnd = 0;
@@ -127,7 +127,7 @@ export class WorkletVolumeEnvelope
         /**
          * if sustain stge is silent,
          * then we can turn off the voice when it is silent.
-         * We can't do that with modulated as it can silence the volume and then raise it again and the voice must keep playing
+         * We can't do that with modulated as it can silence the volume and then raise it again, and the voice must keep playing
          * @type {boolean}
          */
         this.canEndOnSilentSustain = initialDecay / 10 >= PERCEIVED_DB_SILENCE;
@@ -135,18 +135,18 @@ export class WorkletVolumeEnvelope
     
     /**
      * Starts the release phase in the envelope
-     * @param voice {WorkletVoice} the voice this envelope belongs to
+     * @param voice {Voice} the voice this envelope belongs to
      */
     static startRelease(voice)
     {
         voice.volumeEnvelope.releaseStartTimeSamples = voice.volumeEnvelope.currentSampleTime;
         voice.volumeEnvelope.currentReleaseGain = decibelAttenuationToGain(voice.volumeEnvelope.currentAttenuationDb);
-        WorkletVolumeEnvelope.recalculate(voice);
+        VolumeEnvelope.recalculate(voice);
     }
     
     /**
      * Recalculates the envelope
-     * @param voice {WorkletVoice} the voice this envelope belongs to
+     * @param voice {Voice} the voice this envelope belongs to
      */
     static recalculate(voice)
     {
@@ -167,8 +167,8 @@ export class WorkletVolumeEnvelope
         // calculate durations
         env.attackDuration = timecentsToSamples(voice.modulatedGenerators[generatorTypes.attackVolEnv]);
         
-        // decay: sfspec page 35: the time is for change from attenuation to -100dB
-        // therefore we need to calculate the real time
+        // decay: sfspec page 35: the time is for change from attenuation to -100dB,
+        // therefore, we need to calculate the real time
         // (changing from attenuation to sustain instead of -100dB)
         const fullChange = voice.modulatedGenerators[generatorTypes.decayVolEnv];
         const keyNumAddition = (60 - voice.targetKey) * voice.modulatedGenerators[generatorTypes.keyNumToVolEnvDecay];
@@ -181,7 +181,7 @@ export class WorkletVolumeEnvelope
         env.delayEnd = timecentsToSamples(voice.modulatedGenerators[generatorTypes.delayVolEnv]);
         env.attackEnd = env.attackDuration + env.delayEnd;
         
-        // make sure to take keyNumToVolEnvHold into account!!!
+        // make sure to take keyNumToVolEnvHold into account!
         const holdExcursion = (60 - voice.targetKey) * voice.modulatedGenerators[generatorTypes.keyNumToVolEnvHold];
         env.holdEnd = timecentsToSamples(voice.modulatedGenerators[generatorTypes.holdVolEnv]
                 + holdExcursion)
@@ -217,7 +217,7 @@ export class WorkletVolumeEnvelope
                     // (to make volume go down exponentially)
                     // attack is linear (in gain) so we need to do get db from that
                     let elapsed = 1 - ((env.attackEnd - env.releaseStartTimeSamples) / env.attackDuration);
-                    // calculate the gain that the attack would have
+                    // calculate the gain that the attack would have, so
                     // turn that into db
                     env.releaseStartDb = 20 * Math.log10(elapsed) * -1;
                     break;
@@ -241,8 +241,8 @@ export class WorkletVolumeEnvelope
             }
             env.currentReleaseGain = decibelAttenuationToGain(env.releaseStartDb);
             
-            // release: sfspec page 35: the time is for change from attenuation to -100dB
-            // therefore we need to calculate the real time
+            // release: sfspec page 35: the time is for change from attenuation to -100dB,
+            // therefore, we need to calculate the real time
             // (changing from release start to -100dB instead of from peak to -100dB)
             const releaseFraction = (DB_SILENCE - env.releaseStartDb) / DB_SILENCE;
             env.releaseDuration *= releaseFraction;
@@ -252,7 +252,7 @@ export class WorkletVolumeEnvelope
     
     /**
      * Applies volume envelope gain to the given output buffer
-     * @param voice {WorkletVoice} the voice we're working on
+     * @param voice {Voice} the voice we're working on
      * @param audioBuffer {Float32Array} the audio buffer to modify
      * @param centibelOffset {number} the centibel offset of volume, for modLFOtoVolume
      * @param smoothingFactor {number} the adjusted smoothing factor for the envelope

package/synthetizer/audio_engine/{worklet_utilities → engine_components}/wavetable_oscillator.js

@@ -19,7 +19,7 @@ export class WavetableOscillator
     
     /**
      * Fills the output buffer with raw sample data using linear interpolation
-     * @param voice {WorkletVoice} the voice we're working on
+     * @param voice {Voice} the voice we're working on
      * @param outputBuffer {Float32Array} the output buffer to write to
      */
     static getSampleLinear(voice, outputBuffer)
@@ -93,7 +93,7 @@ export class WavetableOscillator
     
     /**
      * Fills the output buffer with raw sample data using no interpolation (nearest neighbor)
-     * @param voice {WorkletVoice} the voice we're working on
+     * @param voice {Voice} the voice we're working on
      * @param outputBuffer {Float32Array} the output buffer to write to
      */
     static getSampleNearest(voice, outputBuffer)
@@ -154,7 +154,7 @@ export class WavetableOscillator
     
     /**
      * Fills the output buffer with raw sample data using cubic interpolation
-     * @param voice {WorkletVoice} the voice we're working on
+     * @param voice {Voice} the voice we're working on
      * @param outputBuffer {Float32Array} the output buffer to write to
      */
     static getSampleCubic(voice, outputBuffer)

package/synthetizer/audio_engine/{worklet_methods → engine_methods}/controller_control/controller_change.js

@@ -1,12 +1,12 @@
-import { midiControllers } from "../../../../midi_parser/midi_message.js";
-import { computeModulators } from "../../worklet_utilities/worklet_modulator.js";
-import { channelConfiguration, dataEntryStates } from "../../worklet_utilities/controller_tables.js";
+import { midiControllers } from "../../../../midi/midi_message.js";
+import { computeModulators } from "../../engine_components/compute_modulator.js";
+import { channelConfiguration, dataEntryStates } from "../../engine_components/controller_tables.js";
 
 /**
  * @param controllerNumber {number}
  * @param controllerValue {number}
  * @param force {boolean}
- * @this {WorkletProcessorChannel}
+ * @this {MidiAudioChannel}
  */
 export function controllerChange(controllerNumber, controllerValue, force = false)
 {

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

@@ -0,0 +1,48 @@
+import { SYNTHESIZER_GAIN } from "../../main_processor.js";
+
+/**
+ * @enum {number}
+ */
+export const masterParameterType = {
+    mainVolume: 0,
+    masterPan: 1,
+    voicesCap: 2,
+    interpolationType: 3,
+    midiSystem: 4
+};
+
+/**
+ * @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;
+            this.setMasterParameter(masterParameterType.masterPan, this.pan);
+            break;
+        
+        case masterParameterType.voicesCap:
+            this.voiceCap = value;
+            break;
+        
+        case masterParameterType.interpolationType:
+            this.interpolationType = value;
+            break;
+        
+        case masterParameterType.midiSystem:
+            this.setSystem(value);
+    }
+}