spessasynth_lib 0.0.1

package/package/midi_handler/midi_handler.js

@@ -0,0 +1,118 @@
+import { Synthetizer } from '../synthetizer/synthetizer.js'
+import { consoleColors } from '../utils/other.js';
+import { SpessaSynthInfo, SpessaSynthWarn } from '../utils/loggin.js'
+
+/**
+ * midi_handler.js
+ * purpose: handles the connection between MIDI devices and synthesizer/sequencer via Web MIDI API
+ */
+
+const NO_INPUT = null;
+
+export class MIDIDeviceHandler
+{
+    constructor()
+    {}
+
+    /**
+     * @returns {Promise<boolean>} if succeded
+     */
+    async createMIDIDeviceHandler()
+    {
+        /**
+         * @type {MIDIInput}
+         */
+        this.selectedInput = NO_INPUT;
+        /**
+         * @type {MIDIOutput}
+         */
+        this.selectedOutput = NO_INPUT;
+        if(navigator.requestMIDIAccess) {
+            // prepare the midi access
+            try
+            {
+                const response = await navigator.requestMIDIAccess({ sysex: true, software: true });
+                this.inputs = response.inputs;
+                this.outputs = response.outputs;
+                SpessaSynthInfo("%cMIDI handler created!", consoleColors.recognized);
+                return true;
+            }
+            catch (e) {
+                SpessaSynthWarn(`Could not get MIDI Devices:`, e);
+                this.inputs = [];
+                this.outputs = [];
+                return false
+            }
+        }
+        else
+        {
+            SpessaSynthWarn("Web MIDI Api not supported!", consoleColors.unrecognized);
+            this.inputs = [];
+            this.outputs = [];
+            return false
+        }
+    }
+
+    /**
+     * Connects the sequencer to a given MIDI output port
+     * @param output {MIDIOutput}
+     * @param seq {Sequencer}
+     */
+    connectMIDIOutputToSeq(output, seq)
+    {
+        this.selectedOutput = output;
+        seq.connectMidiOutput(output);
+        SpessaSynthInfo(`%cPlaying MIDI to %c${output.name}`,
+            consoleColors.info,
+            consoleColors.recognized);
+    }
+
+    /**
+     * Disconnects a midi output port from the sequencer
+     * @param seq {Sequencer}
+     */
+    disconnectSeqFromMIDI(seq)
+    {
+        this.selectedOutput = NO_INPUT;
+        seq.connectMidiOutput(undefined);
+        SpessaSynthInfo("%cDisconnected from MIDI out.",
+            consoleColors.info);
+    }
+
+    /**
+     * Connects a MIDI input to the synthesizer
+     * @param input {MIDIInput}
+     * @param synth {Synthetizer}
+     */
+    connectDeviceToSynth(input, synth)
+    {
+        this.selectedInput = input;
+        input.onmidimessage = event => {
+            synth.sendMessage(event.data);
+        }
+        SpessaSynthInfo(`%cListening for messages on %c${input.name}`,
+            consoleColors.info,
+            consoleColors.recognized);
+    }
+
+    /**
+     * @param input {MIDIInput}
+     */
+    disconnectDeviceFromSynth(input)
+    {
+        this.selectedInput = NO_INPUT;
+        input.onmidimessage = undefined;
+        SpessaSynthInfo(`%cDisconnected from %c${input.name}`,
+            consoleColors.info,
+            consoleColors.recognized);
+    }
+
+    disconnectAllDevicesFromSynth()
+    {
+        this.selectedInput = NO_INPUT;
+        for(const i of this.inputs)
+        {
+            i[1].onmidimessage = undefined;
+        }
+    }
+}

package/package/midi_handler/web_midi_link.js

@@ -0,0 +1,41 @@
+import { Synthetizer } from '../synthetizer/synthetizer.js'
+import { consoleColors } from '../utils/other.js'
+import { SpessaSynthInfo } from '../utils/loggin.js'
+
+/**
+ * web_midi_link.js
+ * purpose: handles the web midi link connection to the synthesizer
+ * https://www.g200kg.com/en/docs/webmidilink/
+ */
+
+export class WebMidiLinkHandler
+{
+    /**
+     * @param synth {Synthetizer} the synth to play to
+     */
+    constructor(synth) {
+
+        window.addEventListener("message", msg => {
+            if(typeof  msg.data !== "string")
+            {
+                return
+            }
+            /**
+             * @type {string[]}
+             */
+            const data = msg.data.split(",");
+            if(data[0] !== "midi")
+            {
+                return;
+            }
+
+            data.shift(); // remove MIDI
+
+            const midiData = data.map(byte => parseInt(byte, 16));
+
+            synth.sendMessage(midiData);
+        });
+
+        SpessaSynthInfo("%cWeb MIDI Link handler created!", consoleColors.recognized);
+    }
+}

package/package/midi_parser/README.md

@@ -0,0 +1,3 @@
+## This is the MIDI file parsing folder.
+The code here is responsible for parsing the MIDI files and interpreting the messsages.
+All the events are defined in the `midi_message.js` file.

package/package/midi_parser/midi_data.js

@@ -0,0 +1,121 @@
+/**
+ * A simplified version of the MIDI, accessible at all times from the Sequencer. use getMIDI() to get the actual sequence
+ * This class contains all properties that MIDI does, except for tracks, which is the track data.
+ */
+export class MidiData
+{
+    /**
+     * @param midi {MIDI}
+     */
+    constructor(midi)
+    {
+        /**
+         * The time division of the sequence
+         * @type {number}
+         */
+        this.timeDivision = midi.timeDivision;
+        /**
+         * The duration of the sequence, in seconds
+         * @type {number}
+         */
+        this.duration = midi.duration;
+        /**
+         * The tempo changes in the sequence, ordered from last to first
+         * @type {{ticks: number, tempo: number}[]}
+         */
+        this.tempoChanges = midi.tempoChanges;
+        /**
+         * Contains the copyright strings
+         * @type {string}
+         */
+        this.copyright = midi.copyright;
+
+        /**
+         * The amount of tracks in the sequence
+         * @type {number}
+         */
+        this.tracksAmount = midi.tracksAmount;
+
+        /**
+         * The lyrics of the sequence as binary chunks
+         * @type {Uint8Array[]}
+         */
+        this.lyrics = midi.lyrics;
+
+        this.firstNoteOn = midi.firstNoteOn;
+
+        /**
+         * The MIDI's key range
+         * @type {{min: number, max: number}}
+         */
+        this.keyRange = midi.keyRange;
+
+        /**
+         * The last voice (note on, off, cc change etc.) event tick
+         * @type {number}
+         */
+        this.lastVoiceEventTick = midi.lastVoiceEventTick;
+
+        /**
+         * Midi port numbers for each track
+         * @type {number[]}
+         */
+        this.midiPorts = midi.midiPorts;
+
+        /**
+         * All channels that each track uses
+         * @type {Set<number>[]}
+         */
+        this.usedChannelsOnTrack = midi.usedChannelsOnTrack;
+
+        /**
+         * The loop points (in ticks) of the sequence
+         * @type {{start: number, end: number}}
+         */
+        this.loop = midi.loop;
+
+        /**
+         * The sequence's name
+         * @type {string}
+         */
+        this.midiName = midi.midiName;
+
+        /**
+         * The file name of the sequence, if provided in the MIDI class
+         * @type {string}
+         */
+        this.fileName = midi.fileName;
+
+        /**
+         * The raw, encoded MIDI name.
+         * @type {Uint8Array}
+         */
+        this.rawMidiName = midi.rawMidiName;
+    }
+}
+
+/**
+ *
+ * @type {MidiData}
+ */
+export const DUMMY_MIDI_DATA = {
+    duration: 99999,
+    firstNoteOn: 0,
+    loop: {
+        start: 0,
+        end: 123456
+    },
+
+    lastVoiceEventTick: 123456,
+    lyrics: [],
+    copyright: "",
+    midiPorts: [],
+    tracksAmount: 0,
+    tempoChanges: [{ticks: 0, tempo: 120}],
+    fileName: "NOT_LOADED.mid",
+    midiName: "Loading...",
+    rawMidiName: new Uint8Array([76, 111, 97, 100, 105, 110, 103, 46, 46, 46]), // "Loading..."
+    usedChannelsOnTrack: [],
+    timeDivision: 0,
+    keyRange: {min: 0, max: 127}
+};