spessasynth_lib 3.13.1 → 3.14.0

package/synthetizer/worklet_system/combine_class.js

@@ -0,0 +1,104 @@
+import { SpessaSynthProcessor } from './main_processor.js'
+import { releaseVoice, renderVoice, voiceKilling } from './worklet_methods/voice_control.js'
+import { handleMessage } from './message_protocol/handle_message.js'
+import { callEvent, post, sendChannelProperties } from './message_protocol/message_sending.js'
+import { systemExclusive } from './worklet_methods/system_exclusive.js'
+import { noteOn } from './worklet_methods/note_on.js'
+import { killNote, noteOff, stopAll, stopAllChannels } from './worklet_methods/note_off.js'
+import {
+    channelPressure, pitchWheel,
+    polyPressure, setChannelTuning, setChannelTuningSemitones, setMasterTuning, setModulationDepth, setOctaveTuning,
+    transposeAllChannels,
+    transposeChannel,
+} from './worklet_methods/tuning_control.js'
+import {
+    controllerChange,
+    muteChannel,
+    setMasterGain,
+    setMasterPan,
+    setMIDIVolume,
+} from './worklet_methods/controller_control.js'
+import { disableAndLockVibrato, setVibrato } from './worklet_methods/vibrato_control.js'
+import { dataEntryCoarse, dataEntryFine } from './worklet_methods/data_entry.js'
+import { createWorkletChannel } from './worklet_utilities/worklet_processor_channel.js'
+import { resetAllControllers, resetControllers, resetParameters } from './worklet_methods/reset_controllers.js'
+import {
+    clearSoundFont,
+    getPreset,
+    programChange,
+    reloadSoundFont, sampleDump, sendPresetList,
+    setDrums,
+    setPreset,
+} from './worklet_methods/program_control.js'
+import { applySynthesizerSnapshot, sendSynthesizerSnapshot } from './worklet_methods/snapshot.js'
+
+// include other methods
+// voice related
+SpessaSynthProcessor.prototype.renderVoice = renderVoice;
+SpessaSynthProcessor.prototype.releaseVoice = releaseVoice;
+SpessaSynthProcessor.prototype.voiceKilling = voiceKilling;
+
+// message port related
+SpessaSynthProcessor.prototype.handleMessage = handleMessage;
+SpessaSynthProcessor.prototype.post = post;
+SpessaSynthProcessor.prototype.sendChannelProperties = sendChannelProperties;
+SpessaSynthProcessor.prototype.callEvent = callEvent;
+
+// system exlcusive related
+SpessaSynthProcessor.prototype.systemExclusive = systemExclusive;
+
+// note messages related
+SpessaSynthProcessor.prototype.noteOn = noteOn;
+SpessaSynthProcessor.prototype.noteOff = noteOff;
+SpessaSynthProcessor.prototype.polyPressure = polyPressure;
+SpessaSynthProcessor.prototype.killNote = killNote;
+SpessaSynthProcessor.prototype.stopAll = stopAll;
+SpessaSynthProcessor.prototype.stopAllChannels = stopAllChannels;
+SpessaSynthProcessor.prototype.muteChannel = muteChannel;
+
+// custom vibrato related
+SpessaSynthProcessor.prototype.setVibrato = setVibrato;
+SpessaSynthProcessor.prototype.disableAndLockVibrato = disableAndLockVibrato;
+
+// data entry related
+SpessaSynthProcessor.prototype.dataEntryCoarse = dataEntryCoarse;
+SpessaSynthProcessor.prototype.dataEntryFine = dataEntryFine;
+
+// channel related
+SpessaSynthProcessor.prototype.createWorkletChannel = createWorkletChannel;
+SpessaSynthProcessor.prototype.controllerChange = controllerChange;
+SpessaSynthProcessor.prototype.channelPressure = channelPressure;
+SpessaSynthProcessor.prototype.resetAllControllers = resetAllControllers;
+SpessaSynthProcessor.prototype.resetControllers = resetControllers;
+SpessaSynthProcessor.prototype.resetParameters = resetParameters;
+
+// master parameter related
+SpessaSynthProcessor.prototype.setMasterGain = setMasterGain;
+SpessaSynthProcessor.prototype.setMasterPan = setMasterPan;
+SpessaSynthProcessor.prototype.setMIDIVolume = setMIDIVolume;
+
+// tuning related
+SpessaSynthProcessor.prototype.transposeAllChannels = transposeAllChannels;
+SpessaSynthProcessor.prototype.transposeChannel = transposeChannel;
+SpessaSynthProcessor.prototype.setChannelTuning = setChannelTuning;
+SpessaSynthProcessor.prototype.setChannelTuningSemitones = setChannelTuningSemitones;
+SpessaSynthProcessor.prototype.setMasterTuning = setMasterTuning;
+SpessaSynthProcessor.prototype.setModulationDepth = setModulationDepth;
+SpessaSynthProcessor.prototype.pitchWheel = pitchWheel;
+SpessaSynthProcessor.prototype.setOctaveTuning = setOctaveTuning;
+
+// program related
+SpessaSynthProcessor.prototype.programChange = programChange;
+SpessaSynthProcessor.prototype.getPreset = getPreset;
+SpessaSynthProcessor.prototype.setPreset = setPreset;
+SpessaSynthProcessor.prototype.setDrums = setDrums;
+SpessaSynthProcessor.prototype.reloadSoundFont = reloadSoundFont;
+SpessaSynthProcessor.prototype.clearSoundFont = clearSoundFont;
+SpessaSynthProcessor.prototype.sampleDump = sampleDump;
+SpessaSynthProcessor.prototype.sendPresetList = sendPresetList;
+
+// snapshot related
+SpessaSynthProcessor.prototype.sendSynthesizerSnapshot = sendSynthesizerSnapshot;
+SpessaSynthProcessor.prototype.applySynthesizerSnapshot = applySynthesizerSnapshot;
+
+export {SpessaSynthProcessor}

package/synthetizer/worklet_system/main_processor.js

@@ -1,45 +1,12 @@
 import { DEFAULT_PERCUSSION, DEFAULT_SYNTH_MODE, VOICE_CAP } from '../synthetizer.js'
-import {
-    createWorkletChannel,
-} from './worklet_utilities/worklet_processor_channel.js'
-
 import { SoundFont2 } from '../../soundfont/soundfont.js'
-import { handleMessage } from './message_protocol/handle_message.js'
-import { systemExclusive } from './worklet_methods/system_exclusive.js'
-import { noteOn } from './worklet_methods/note_on.js'
-import { dataEntryCoarse, dataEntryFine } from './worklet_methods/data_entry.js'
-import { killNote, noteOff, stopAll, stopAllChannels } from './worklet_methods/note_off.js'
-import {
-    controllerChange, muteChannel, setMasterGain, setMasterPan, setMIDIVolume,
-} from './worklet_methods/controller_control.js'
-import { callEvent, post, sendChannelProperties } from './message_protocol/message_sending.js'
-import {
-    channelPressure,
-    pitchWheel, polyPressure,
-    setChannelTuning, setChannelTuningSemitones,
-    setMasterTuning, setModulationDepth,
-    transposeAllChannels,
-    transposeChannel,
-} from './worklet_methods/tuning_control.js'
-import {
-    clearSoundFont, getPreset,
-    programChange,
-    reloadSoundFont,
-    sampleDump,
-    sendPresetList,
-    setDrums,
-    setPreset,
-} from './worklet_methods/program_control.js'
-import { disableAndLockVibrato, setVibrato } from './worklet_methods/vibrato_control.js'
 import { WorkletSequencer } from '../../sequencer/worklet_sequencer/worklet_sequencer.js'
 import { SpessaSynthInfo } from '../../utils/loggin.js'
-import { applySynthesizerSnapshot, sendSynthesizerSnapshot } from './worklet_methods/snapshot.js'
 import { consoleColors } from '../../utils/other.js'
-import { PAN_SMOOTHING_FACTOR, releaseVoice, renderVoice, voiceKilling } from './worklet_methods/voice_control.js'
-import { returnMessageType } from './message_protocol/worklet_message.js'
+import { PAN_SMOOTHING_FACTOR } from './worklet_methods/voice_control.js'
+import { ALL_CHANNELS_OR_DIFFERENT_ACTION, returnMessageType } from './message_protocol/worklet_message.js'
 import { stbvorbis } from '../../externals/stbvorbis_sync/stbvorbis_sync.min.js'
 import { VOLUME_ENVELOPE_SMOOTHING_FACTOR } from './worklet_utilities/volume_envelope.js'
-import { resetAllControllers, resetControllers, resetParameters } from './worklet_methods/reset_controllers.js'
 
 
 /**
@@ -51,7 +18,8 @@ export const MIN_NOTE_LENGTH = 0.07; // if the note is released faster than that
 
 export const SYNTHESIZER_GAIN = 1.0;
 
-class SpessaSynthProcessor extends AudioWorkletProcessor {
+export class SpessaSynthProcessor extends AudioWorkletProcessor
+{
     /**
      * Creates a new worklet synthesis system. contains all channels
      * @param options {{
@@ -66,13 +34,20 @@ class SpessaSynthProcessor extends AudioWorkletProcessor {
      *      }
      * }}}
      */
-    constructor(options) {
+    constructor(options)
+    {
         super();
         this.oneOutputMode = options.processorOptions?.startRenderingData?.oneOutput === true;
         this._outputsAmount = this.oneOutputMode ? 1 : options.processorOptions.midiChannels;
 
         this.enableEventSystem = options.processorOptions.enableEventSystem;
 
+        /**
+         * Synth's device id: -1 means all
+         * @type {number}
+         */
+        this.deviceID = ALL_CHANNELS_OR_DIFFERENT_ACTION;
+
         /**
          * @type {function}
          */
@@ -304,75 +279,4 @@ class SpessaSynthProcessor extends AudioWorkletProcessor {
         }
         return true;
     }
-}
-
-// include other methods
-// voice related
-SpessaSynthProcessor.prototype.renderVoice = renderVoice;
-SpessaSynthProcessor.prototype.releaseVoice = releaseVoice;
-SpessaSynthProcessor.prototype.voiceKilling = voiceKilling;
-
-// message port related
-SpessaSynthProcessor.prototype.handleMessage = handleMessage;
-SpessaSynthProcessor.prototype.post = post;
-SpessaSynthProcessor.prototype.sendChannelProperties = sendChannelProperties;
-SpessaSynthProcessor.prototype.callEvent = callEvent;
-
-// system exlcusive related
-SpessaSynthProcessor.prototype.systemExclusive = systemExclusive;
-
-// note messages related
-SpessaSynthProcessor.prototype.noteOn = noteOn;
-SpessaSynthProcessor.prototype.noteOff = noteOff;
-SpessaSynthProcessor.prototype.polyPressure = polyPressure;
-SpessaSynthProcessor.prototype.killNote = killNote;
-SpessaSynthProcessor.prototype.stopAll = stopAll;
-SpessaSynthProcessor.prototype.stopAllChannels = stopAllChannels;
-SpessaSynthProcessor.prototype.muteChannel = muteChannel;
-
-// custom vibrato related
-SpessaSynthProcessor.prototype.setVibrato = setVibrato;
-SpessaSynthProcessor.prototype.disableAndLockVibrato = disableAndLockVibrato;
-
-// data entry related
-SpessaSynthProcessor.prototype.dataEntryCoarse = dataEntryCoarse;
-SpessaSynthProcessor.prototype.dataEntryFine = dataEntryFine;
-
-// channel related
-SpessaSynthProcessor.prototype.createWorkletChannel = createWorkletChannel;
-SpessaSynthProcessor.prototype.controllerChange = controllerChange;
-SpessaSynthProcessor.prototype.channelPressure = channelPressure;
-SpessaSynthProcessor.prototype.resetAllControllers = resetAllControllers;
-SpessaSynthProcessor.prototype.resetControllers = resetControllers;
-SpessaSynthProcessor.prototype.resetParameters = resetParameters;
-
-// master parameter related
-SpessaSynthProcessor.prototype.setMasterGain = setMasterGain;
-SpessaSynthProcessor.prototype.setMasterPan = setMasterPan;
-SpessaSynthProcessor.prototype.setMIDIVolume = setMIDIVolume;
-
-// tuning related
-SpessaSynthProcessor.prototype.transposeAllChannels = transposeAllChannels;
-SpessaSynthProcessor.prototype.transposeChannel = transposeChannel;
-SpessaSynthProcessor.prototype.setChannelTuning = setChannelTuning;
-SpessaSynthProcessor.prototype.setChannelTuningSemitones = setChannelTuningSemitones;
-SpessaSynthProcessor.prototype.setMasterTuning = setMasterTuning;
-SpessaSynthProcessor.prototype.setModulationDepth = setModulationDepth;
-SpessaSynthProcessor.prototype.pitchWheel = pitchWheel;
-
-// program related
-SpessaSynthProcessor.prototype.programChange = programChange;
-SpessaSynthProcessor.prototype.getPreset = getPreset;
-SpessaSynthProcessor.prototype.setPreset = setPreset;
-SpessaSynthProcessor.prototype.setDrums = setDrums;
-SpessaSynthProcessor.prototype.reloadSoundFont = reloadSoundFont;
-SpessaSynthProcessor.prototype.clearSoundFont = clearSoundFont;
-SpessaSynthProcessor.prototype.sampleDump = sampleDump;
-SpessaSynthProcessor.prototype.sendPresetList = sendPresetList;
-
-// snapshot related
-SpessaSynthProcessor.prototype.sendSynthesizerSnapshot = sendSynthesizerSnapshot;
-SpessaSynthProcessor.prototype.applySynthesizerSnapshot = applySynthesizerSnapshot;
-
-
-export { SpessaSynthProcessor }
+}

package/synthetizer/worklet_system/worklet_methods/program_control.js

@@ -96,6 +96,7 @@ export function setPreset(channel, preset)
     {
         return;
     }
+    delete this.workletProcessorChannels[channel].preset;
     this.workletProcessorChannels[channel].preset = preset;
 
     // reset cached voices
@@ -235,6 +236,11 @@ export function reloadSoundFont(buffer, isOverride = false)
         });
         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);

package/synthetizer/worklet_system/worklet_methods/reset_controllers.js

@@ -131,6 +131,8 @@ export function resetControllers(channel)
         }
     });
 
+    channelObject.channelOctaveTuning.fill(0);
+
     // reset the array
     channelObject.midiControllers.set(resetArray);
     channelObject.channelVibrato = {rate: 0, depth: 0, delay: 0};

package/synthetizer/worklet_system/worklet_methods/snapshot.js

@@ -19,6 +19,7 @@
  * @property {number} channelVibrato.rate - vibrato rate in Hz
  *
  * @property {number} channelTransposeKeyShift - key shift for the channel
+ * @property {Int8Array} channelOctaveTuning - the channel's octave tuning in cents
  * @property {boolean} isMuted - indicates whether the channel is muted
  * @property {boolean} drumChannel - indicates whether the channel is a drum channel
  */
@@ -60,6 +61,7 @@ export function sendSynthesizerSnapshot()
             lockVibrato: channel.lockVibrato,
 
             channelTransposeKeyShift: channel.channelTransposeKeyShift,
+            channelOctaveTuning: channel.channelOctaveTuning,
             isMuted: channel.isMuted,
             drumChannel: channel.drumChannel
         }
@@ -118,6 +120,7 @@ export function applySynthesizerSnapshot(snapshot)
         channelObject.channelVibrato = channelSnapshot.channelVibrato;
         channelObject.lockVibrato = channelSnapshot.lockVibrato;
         channelObject.channelTransposeKeyShift = channelSnapshot.channelTransposeKeyShift;
+        channelObject.channelOctaveTuning = channelSnapshot.channelOctaveTuning;
 
         // restore preset and lock
         channelObject.lockPreset = false;

package/synthetizer/worklet_system/worklet_methods/system_exclusive.js

@@ -1,16 +1,56 @@
 import { arrayToHexString, consoleColors } from '../../../utils/other.js'
 import { SpessaSynthInfo, SpessaSynthWarn } from '../../../utils/loggin.js'
 import { midiControllers } from '../../../midi_parser/midi_message.js'
+import { ALL_CHANNELS_OR_DIFFERENT_ACTION } from '../message_protocol/worklet_message.js'
+
+
+/**
+ * Calculates freqency for MIDI Tuning Standard
+ * @param byte1 {number}
+ * @param byte2 {number}
+ * @param byte3 {number}
+ * @return {number|null}
+ */
+function calculateFrequency(byte1, byte2, byte3)
+{
+    // handle special case of "no change"
+    if (byte1 === 0x7F && byte2 === 0x7F && byte3 === 0x7F)
+    {
+        return null;
+    }
+
+    // Frequency base for MIDI note number 0
+    const baseFrequency = 8.1758;
+
+    const semitone = byte1;
+
+    // combine byte2 and byte3
+    const fraction = (byte2 << 7) | byte3;
+
+    // get total cents
+    const totalCents = semitone * 100 + (fraction / 16384) * 100;
+
+    return baseFrequency * Math.pow(2, totalCents / 1200);
+}
+
+
 /**
  * Executes a system exclusive
  * @param messageData {number[]|IndexedByteArray} - the message data without f0
  * @param channelOffset {number}
  * @this {SpessaSynthProcessor}
  */
-
 export function systemExclusive(messageData, channelOffset = 0)
 {
     const type = messageData[0];
+    if(this.deviceID !== ALL_CHANNELS_OR_DIFFERENT_ACTION && messageData[1] !== 0x7F)
+    {
+        if(this.deviceID !== messageData[1])
+        {
+            // not our device ID
+            return;
+        }
+    }
     switch (type)
     {
         default:
@@ -21,91 +61,188 @@ export function systemExclusive(messageData, channelOffset = 0)
 
         // non realtime
         case 0x7E:
-            // gm system
-            if(messageData[2] === 0x09)
-            {
-                if(messageData[3] === 0x01)
-                {
-                    SpessaSynthInfo("%cGM system on", consoleColors.info);
-                    this.system = "gm";
-                }
-                else if(messageData[3] === 0x03)
-                {
-                    SpessaSynthInfo("%cGM2 system on", consoleColors.info);
-                    this.system = "gm2";
-                }
-                else
-                {
-                    SpessaSynthInfo("%cGM system off, defaulting to GS", consoleColors.info);
-                    this.system = "gs";
-                }
-            }
-            break;
-
-        // realtime
-        // https://midi.org/midi-1-0-universal-system-exclusive-messages
         case 0x7F:
-            if(messageData[2] === 0x04)
+            switch(messageData[2])
             {
-                let cents
-                // device control
-                switch(messageData[3])
-                {
-                    case 0x01:
-                        // main volume
-                        const vol = messageData[5] << 7 | messageData[4];
-                        this.setMIDIVolume(vol / 16384);
-                        SpessaSynthInfo(`%cMaster Volume. Volume: %c${vol}`,
-                            consoleColors.info,
-                            consoleColors.value);
-                        break;
-
-                    case 0x02:
-                        // main balance
-                        // midi spec page 62
-                        const balance = messageData[5] << 7 | messageData[4];
-                        const pan = (balance - 8192) / 8192;
-                        this.setMasterPan(pan);
-                        SpessaSynthInfo(`%cMaster Pan. Pan: %c${pan}`,
-                            consoleColors.info,
-                            consoleColors.value);
-                        break;
+                case 0x04:
+                    let cents
+                    // device control
+                    switch(messageData[3])
+                    {
+                        case 0x01:
+                            // main volume
+                            const vol = messageData[5] << 7 | messageData[4];
+                            this.setMIDIVolume(vol / 16384);
+                            SpessaSynthInfo(`%cMaster Volume. Volume: %c${vol}`,
+                                consoleColors.info,
+                                consoleColors.value);
+                            break;
+
+                        case 0x02:
+                            // main balance
+                            // midi spec page 62
+                            const balance = messageData[5] << 7 | messageData[4];
+                            const pan = (balance - 8192) / 8192;
+                            this.setMasterPan(pan);
+                            SpessaSynthInfo(`%cMaster Pan. Pan: %c${pan}`,
+                                consoleColors.info,
+                                consoleColors.value);
+                            break;
 
 
-                    case 0x03:
-                        // fine tuning
-                        const tuningValue = ((messageData[5] << 7) | messageData[6]) - 8192;
-                        cents = Math.floor(tuningValue / 81.92); // [-100;+99] cents range
-                        this.setMasterTuning(cents);
-                        SpessaSynthInfo(`%cMaster Fine Tuning. Cents: %c${cents}`,
-                            consoleColors.info,
-                            consoleColors.value);
-                        break;
-
-                    case 0x04:
-                        // coarse tuning
-                        // lsb is ignored
-                        const semitones = messageData[5] - 64;
-                        cents = semitones * 100;
-                        this.setMasterTuning(cents);
-                        SpessaSynthInfo(`%cMaster Coarse Tuning. Cents: %c${cents}`,
-                            consoleColors.info,
-                            consoleColors.value)
-                        break;
-
-                    default:
-                        SpessaSynthWarn(
-                            `%cUnrecognized MIDI Device Control Real-time message: %c${arrayToHexString(messageData)}`,
-                            consoleColors.warn,
-                            consoleColors.unrecognized);
-                }
-            }
-            else
-            {
-                SpessaSynthWarn(
-                    `%cUnrecognized MIDI Real-time message: %c${arrayToHexString(messageData)}`,
-                    consoleColors.warn,
-                    consoleColors.unrecognized);
+                        case 0x03:
+                            // fine tuning
+                            const tuningValue = ((messageData[5] << 7) | messageData[6]) - 8192;
+                            cents = Math.floor(tuningValue / 81.92); // [-100;+99] cents range
+                            this.setMasterTuning(cents);
+                            SpessaSynthInfo(`%cMaster Fine Tuning. Cents: %c${cents}`,
+                                consoleColors.info,
+                                consoleColors.value);
+                            break;
+
+                        case 0x04:
+                            // coarse tuning
+                            // lsb is ignored
+                            const semitones = messageData[5] - 64;
+                            cents = semitones * 100;
+                            this.setMasterTuning(cents);
+                            SpessaSynthInfo(`%cMaster Coarse Tuning. Cents: %c${cents}`,
+                                consoleColors.info,
+                                consoleColors.value)
+                            break;
+
+                        default:
+                            SpessaSynthWarn(
+                                `%cUnrecognized MIDI Device Control Real-time message: %c${arrayToHexString(messageData)}`,
+                                consoleColors.warn,
+                                consoleColors.unrecognized);
+                    }
+                    break;
+
+                case 0x09:
+                    // gm system related
+                    if(messageData[3] === 0x01)
+                    {
+                        SpessaSynthInfo("%cGM system on", consoleColors.info);
+                        this.system = "gm";
+                    }
+                    else if(messageData[3] === 0x03)
+                    {
+                        SpessaSynthInfo("%cGM2 system on", consoleColors.info);
+                        this.system = "gm2";
+                    }
+                    else
+                    {
+                        SpessaSynthInfo("%cGM system off, defaulting to GS", consoleColors.info);
+                        this.system = "gs";
+                    }
+                    break;
+
+                // MIDI Tuning standard
+                // https://midi.org/midi-tuning-updated-specification
+                case 0x08:
+                    switch(messageData[3])
+                    {
+                        // single note change
+                        case 0x02:
+                            const tuningProgram = messageData[4];
+                            const numberOfChanges = messageData[5];
+                            const keys = [];
+                            let currentMessageIndex = 6
+                            for (let i = 0; i < numberOfChanges; i++)
+                            {
+                                keys.push(messageData[currentMessageIndex]);
+                                currentMessageIndex++;
+                            }
+                            const frequencies = [];
+                            for (let i = 0; i < numberOfChanges; i++)
+                            {
+                                frequencies.push(calculateFrequency(
+                                    messageData[currentMessageIndex++],
+                                    messageData[currentMessageIndex++],
+                                    messageData[currentMessageIndex++],
+                                ));
+                            }
+                            console.log(tuningProgram, numberOfChanges, keys, frequencies)
+                            break;
+
+                        // octave tuning (1 byte)
+                        // and octave tuning (2 bytes)
+                        case 0x09:
+                        case 0x08:
+                            // get tuning:
+                            const newOctaveTuning = new Int8Array(12);
+                            // start from bit 7
+                            if(messageData[3] === 0x08)
+                            {
+                                // 1 byte tuning: 0 is -64 cents, 64 is 0, 127 is +63
+                                for (let i = 0; i < 12; i++)
+                                {
+                                    newOctaveTuning[i] = messageData[7 + i] - 64;
+                                }
+                            }
+                            else
+                            {
+                                // 2 byte tuning. Like fine tune: 0 is -100 cents, 8192 is 0 cents, 16383 is +100 cents
+                                for (let i = 0; i < 24; i += 2)
+                                {
+                                    const tuning = ((messageData[7 + i] << 7) | messageData[8 + i]) - 8192;
+                                    newOctaveTuning[i / 2] = Math.floor(tuning / 81.92); // map to [-100;+99] cents
+                                }
+                            }
+                            // apply to channels (ordered from 0)
+                            // bit 1: 14 and 15
+                            if((messageData[4] & 1) === 1)
+                            {
+                                this.setOctaveTuning(14 + channelOffset, newOctaveTuning);
+                            }
+                            if(((messageData[4] >> 1) & 1) === 1)
+                            {
+                                this.setOctaveTuning(15 + channelOffset, newOctaveTuning);
+                            }
+
+                            // bit 2: channels 7 to 13
+                            for (let i = 0; i < 7; i++)
+                            {
+                                const bit = (messageData[5] >> i) & 1;
+                                if(bit === 1)
+                                {
+                                    this.setOctaveTuning(7 + i + channelOffset, newOctaveTuning);
+                                }
+                            }
+
+                            // bit 3: channels 0 to 16
+                            for (let i = 0; i < 7; i++)
+                            {
+                                const bit = (messageData[6] >> i) & 1;
+                                if(bit === 1)
+                                {
+                                    this.setOctaveTuning(i + channelOffset, newOctaveTuning);
+                                }
+                            }
+
+                            SpessaSynthInfo(`%cMIDI Octave Scale ${
+                                messageData[3] === 0x08 ? "(1 byte)" : "(2 bytes)"
+                                } tuning via Tuning: %c${newOctaveTuning.join(" ")}`,
+                                consoleColors.info,
+                                consoleColors.value);
+                            break;
+
+                        default:
+                            SpessaSynthWarn(
+                                `%cUnrecognized MIDI Tuning standard message: %c${arrayToHexString(messageData)}`,
+                                consoleColors.warn,
+                                consoleColors.unrecognized)
+                            break;
+                    }
+                    break;
+
+                default:
+                    SpessaSynthWarn(
+                        `%cUnrecognized MIDI Realtime/non realtime message: %c${arrayToHexString(messageData)}`,
+                        consoleColors.warn,
+                        consoleColors.unrecognized)
+
             }
             break;
 

package/synthetizer/worklet_system/worklet_methods/tuning_control.js

@@ -192,4 +192,19 @@ export function polyPressure(channel, midiNote, pressure)
         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/voice_control.js

@@ -60,7 +60,8 @@ export function renderVoice(
     let cents = voice.modulatedGenerators[generatorTypes.fineTune]
         + channel.customControllers[customControllers.channelTuning]
         + channel.customControllers[customControllers.channelTransposeFine]
-        + channel.customControllers[customControllers.masterTuning];
+        + channel.customControllers[customControllers.masterTuning]
+        + channel.channelOctaveTuning[voice.midiNote % 12];
     let semitones = voice.modulatedGenerators[generatorTypes.coarseTune]
         + channel.customControllers[customControllers.channelTuningSemitones];