spessasynth_core 1.1.3 → 1.1.5

package/src/synthetizer/audio_engine/engine_methods/tuning_control/channel_pressure.js

@@ -0,0 +1,24 @@
+import { NON_CC_INDEX_OFFSET } from "../../engine_components/controller_tables.js";
+import { modulatorSources } from "../../../../soundfont/basic_soundfont/modulator.js";
+import { computeModulators } from "../../engine_components/compute_modulator.js";
+
+/**
+ * Sets the pressure of the given channel
+ * @this {MidiAudioChannel}
+ * @param pressure {number} the pressure of the channel
+ */
+export function channelPressure(pressure)
+{
+    this.midiControllers[NON_CC_INDEX_OFFSET + modulatorSources.channelPressure] = pressure << 7;
+    this.voices.forEach(v =>
+        computeModulators(
+            v,
+            this.midiControllers,
+            0,
+            modulatorSources.channelPressure
+        ));
+    this.synth.callEvent("channelpressure", {
+        channel: this.channelNumber,
+        pressure: pressure
+    });
+}

package/src/synthetizer/audio_engine/engine_methods/tuning_control/pitch_wheel.js

@@ -0,0 +1,33 @@
+import { NON_CC_INDEX_OFFSET } from "../../engine_components/controller_tables.js";
+import { modulatorSources } from "../../../../soundfont/basic_soundfont/modulator.js";
+import { computeModulators } from "../../engine_components/compute_modulator.js";
+
+/**
+ * Sets the pitch of the given channel
+ * @this {MidiAudioChannel}
+ * @param MSB {number} SECOND byte of the MIDI pitchWheel message
+ * @param LSB {number} FIRST byte of the MIDI pitchWheel message
+ */
+export function pitchWheel(MSB, LSB)
+{
+    if (this.lockedControllers[NON_CC_INDEX_OFFSET + modulatorSources.pitchWheel])
+    {
+        return;
+    }
+    const bend = (LSB | (MSB << 7));
+    this.synth.callEvent("pitchwheel", {
+        channel: this.channelNumber,
+        MSB: MSB,
+        LSB: LSB
+    });
+    this.midiControllers[NON_CC_INDEX_OFFSET + modulatorSources.pitchWheel] = bend;
+    this.voices.forEach(v =>
+        // compute pitch modulators
+        computeModulators(
+            v,
+            this.midiControllers,
+            0,
+            modulatorSources.pitchWheel
+        ));
+    this.sendChannelProperty();
+}

package/src/synthetizer/audio_engine/engine_methods/tuning_control/poly_pressure.js

@@ -0,0 +1,31 @@
+import { computeModulators } from "../../engine_components/compute_modulator.js";
+import { modulatorSources } from "../../../../soundfont/basic_soundfont/modulator.js";
+
+/**
+ * Sets the pressure of the given note on a specific channel
+ * @this {MidiAudioChannel}
+ * @param midiNote {number} 0-127
+ * @param pressure {number} the pressure of the note
+ */
+export function polyPressure(midiNote, pressure)
+{
+    this.voices.forEach(v =>
+    {
+        if (v.midiNote !== midiNote)
+        {
+            return;
+        }
+        v.pressure = pressure;
+        computeModulators(
+            v,
+            this.midiControllers,
+            0,
+            modulatorSources.polyPressure
+        );
+    });
+    this.synth.callEvent("polypressure", {
+        channel: this.channelNumber,
+        midiNote: midiNote,
+        pressure: pressure
+    });
+}

package/src/synthetizer/audio_engine/engine_methods/tuning_control/set_master_tuning.js

@@ -0,0 +1,15 @@
+import { customControllers } from "../../engine_components/controller_tables.js";
+
+/**
+ * Sets the worklet's primary tuning
+ * @this {SpessaSynthProcessor}
+ * @param cents {number}
+ */
+export function setMasterTuning(cents)
+{
+    cents = Math.round(cents);
+    for (let i = 0; i < this.midiAudioChannels.length; i++)
+    {
+        this.midiAudioChannels[i].setCustomController(customControllers.masterTuning, cents);
+    }
+}

package/src/synthetizer/audio_engine/engine_methods/tuning_control/set_modulation_depth.js

@@ -0,0 +1,27 @@
+import { SpessaSynthInfo } from "../../../../utils/loggin.js";
+import { consoleColors } from "../../../../utils/other.js";
+import { customControllers } from "../../engine_components/controller_tables.js";
+
+/**
+ * @this {MidiAudioChannel}
+ * @param cents {number}
+ */
+export function setModulationDepth(cents)
+{
+    cents = Math.round(cents);
+    SpessaSynthInfo(
+        `%cChannel ${this.channelNumber} 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 dividing 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.
+     ================ */
+    this.setCustomController(customControllers.modulationMultiplier, cents / 50);
+}

package/src/synthetizer/audio_engine/engine_methods/tuning_control/set_octave_tuning.js

@@ -0,0 +1,19 @@
+/**
+ * Sets the octave tuning for a given channel
+ * @this {MidiAudioChannel}
+ * @param tuning {Int8Array} LENGTH of 12!
+ * relative cent tuning.
+ * min -128 max 127.
+ */
+export function setOctaveTuning(tuning)
+{
+    if (tuning.length !== 12)
+    {
+        throw new Error("Tuning is not the length of 12.");
+    }
+    this.channelOctaveTuning = new Int8Array(128);
+    for (let i = 0; i < 128; i++)
+    {
+        this.channelOctaveTuning[i] = tuning[i % 12];
+    }
+}

package/src/synthetizer/audio_engine/engine_methods/tuning_control/set_tuning.js

@@ -0,0 +1,27 @@
+import { customControllers } from "../../engine_components/controller_tables.js";
+import { SpessaSynthInfo } from "../../../../utils/loggin.js";
+import { consoleColors } from "../../../../utils/other.js";
+
+/**
+ * Sets the channel's tuning
+ * @this {MidiAudioChannel}
+ * @param cents {number}
+ * @param log {boolean}
+ */
+export function setTuning(cents, log = true)
+{
+    cents = Math.round(cents);
+    this.setCustomController(customControllers.channelTuning, cents);
+    if (!log)
+    {
+        return;
+    }
+    SpessaSynthInfo(
+        `%cFine tuning for %c${this.channelNumber}%c is now set to %c${cents}%c cents.`,
+        consoleColors.info,
+        consoleColors.recognized,
+        consoleColors.info,
+        consoleColors.value,
+        consoleColors.info
+    );
+}

package/src/synthetizer/audio_engine/engine_methods/tuning_control/transpose_all_channels.js

@@ -0,0 +1,15 @@
+/**
+ * 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.midiAudioChannels.length; i++)
+    {
+        this.midiAudioChannels[i].transposeChannel(semitones, force);
+    }
+    this.transposition = semitones;
+}

package/src/synthetizer/audio_engine/engine_methods/tuning_control/transpose_channel.js

@@ -0,0 +1,34 @@
+import { customControllers } from "../../engine_components/controller_tables.js";
+import { midiControllers } from "../../../../midi/midi_message.js";
+
+/**
+ * Transposes the channel by given amount of semitones
+ * @this {MidiAudioChannel}
+ * @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(semitones, force = false)
+{
+    if (!this.drumChannel)
+    {
+        semitones += this.synth.transposition;
+    }
+    const keyShift = Math.trunc(semitones);
+    const currentTranspose = this.channelTransposeKeyShift + this.customControllers[customControllers.channelTransposeFine] / 100;
+    if (
+        (this.drumChannel && !force)
+        || semitones === currentTranspose
+    )
+    {
+        return;
+    }
+    if (keyShift !== this.channelTransposeKeyShift)
+    {
+        // stop all (and emit cc change)
+        this.controllerChange(midiControllers.allNotesOff, 127);
+    }
+    // apply transpose
+    this.channelTransposeKeyShift = keyShift;
+    this.setCustomController(customControllers.channelTransposeFine, (semitones - keyShift) * 100);
+    this.sendChannelProperty();
+}