spessasynth_lib 3.25.8 → 3.25.9

package/midi_parser/README.md

@@ -1,4 +1,32 @@
 ## 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.
+All the events are defined in the `midi_message.js` file.
+
+### MIDI Classes hierarchy
+
+#### MIDI Sequence
+- The most basic class, containing all the metadata that inheritors have.
+- It does not contain track data or embedded sound bank.
+- Contains the function for calculating time from ticks.
+- Contains the copying code.
+
+#### MIDI Data
+- Inherits from MIDI Sequence.
+- Has an `isEmbedded` property to mark the existence of embedded bank. This is the class that is available in `sequencer.midiData`.
+
+#### Basic MIDI
+- Inherits from MIDI Sequence.
+- The actual MIDI representation, containing the track data and embedded sound banks.
+- Contains the code for parsing the MIDI and filling in the metadata automatically.
+- Contains the SMF/RMI writing functions.
+- Contains the code for determining used channels on tracks.
+
+#### MIDI Builder
+- Inherits from Basic MIDI.
+- Used for building MIDIs from scratch.
+
+### MIDI
+- Inherits from Basic MIDI.
+- The SMF/RMI/XMF file parser.
+- Called by the sequencer if an `ArrayBuffer` is provided.

package/midi_parser/midi_loader.js

@@ -155,7 +155,7 @@ class MIDI extends BasicMIDI
         {
             fileByteArray = binaryData;
         }
-        const headerChunk = this.readMIDIChunk(fileByteArray);
+        const headerChunk = this._readMIDIChunk(fileByteArray);
         if (headerChunk.type !== "MThd")
         {
             SpessaSynthGroupEnd();
@@ -181,7 +181,7 @@ class MIDI extends BasicMIDI
              * @type {MIDIMessage[]}
              */
             const track = [];
-            const trackChunk = this.readMIDIChunk(fileByteArray);
+            const trackChunk = this._readMIDIChunk(fileByteArray);
             
             if (trackChunk.type !== "MTrk")
             {
@@ -303,8 +303,9 @@ class MIDI extends BasicMIDI
     /**
      * @param fileByteArray {IndexedByteArray}
      * @returns {{type: string, size: number, data: IndexedByteArray}}
+     * @private
      */
-    readMIDIChunk(fileByteArray)
+    _readMIDIChunk(fileByteArray)
     {
         const chunk = {};
         // type

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spessasynth_lib",
-  "version": "3.25.8",
+  "version": "3.25.9",
   "description": "MIDI and SoundFont2/DLS library with no compromises",
   "browser": "index.js",
   "type": "module",

package/soundfont/basic_soundfont/basic_soundfont.js

@@ -166,11 +166,11 @@ class BasicSoundBank
         // MUST be a valid XG bank.
         // allowed banks: (see XG specification)
         // 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 16, 17, 24,
-        // 25, 27, 28, 29, 30, 31, 32, 33, 40, 41, 48,
+        // 25, 27, 28, 29, 30, 31, 32, 33, 40, 41, 48, 56, 57, 58,
         // 64, 65, 66, 126, 127
         const allowedPrograms = new Set([
             0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 16, 17, 24,
-            25, 27, 28, 29, 30, 31, 32, 33, 40, 41, 48,
+            25, 27, 28, 29, 30, 31, 32, 33, 40, 41, 48, 56, 57, 58,
             64, 65, 66, 126, 127
         ]);
         for (const preset of this.presets)
@@ -182,6 +182,12 @@ class BasicSoundBank
                 {
                     // not valid!
                     this.isXGBank = false;
+                    SpessaSynthInfo(
+                        `%cThis bank is not valid XG. Preset %c${preset.bank}:${preset.program}%c is not a valid XG drum. XG mode will use presets on bank 128.`,
+                        consoleColors.info,
+                        consoleColors.value,
+                        consoleColors.info
+                    );
                     break;
                 }
             }

package/synthetizer/synthetizer.js

@@ -77,6 +77,12 @@ export class Synthetizer
      */
     channelProperties = [];
     
+    /**
+     * The current preset list
+     * @type {{presetName: string, bank: number, program: number}[]}
+     */
+    presetList = [];
+    
     /**
      * Creates a new instance of the SpessaSynth synthesizer.
      * @param targetNode {AudioNode}
@@ -242,10 +248,16 @@ export class Synthetizer
         }
         
         // attach a new channel to keep track of channels count
-        this.eventHandler.addEvent("newchannel", "synth-new-channel", () =>
+        this.eventHandler.addEvent("newchannel", `synth-new-channel-${Math.random()}`, () =>
         {
             this.channelsAmount++;
         });
+        
+        // attach a new event for preset list change
+        this.eventHandler.addEvent("presetlistchange", `synth-preset-list-change-${Math.random()}`, e =>
+        {
+            this.presetList = e;
+        });
     }
     
     /**
@@ -396,11 +408,17 @@ export class Synthetizer
         const messageData = message.messageData;
         switch (message.messageType)
         {
-            case returnMessageType.channelProperties:
+            case returnMessageType.channelPropertyChange:
+                /**
+                 * @type {number}
+                 */
+                const channelNumber = messageData[0];
                 /**
-                 * @type {ChannelProperty[]}
+                 * @type {ChannelProperty}
                  */
-                this.channelProperties = messageData;
+                const property = messageData[1];
+                
+                this.channelProperties[channelNumber] = property;
                 
                 this._voicesAmount = this.channelProperties.reduce((sum, voices) => sum + voices.voicesAmount, 0);
                 break;
@@ -485,7 +503,9 @@ export class Synthetizer
             pitchBendRangeSemitones: 0,
             isMuted: false,
             isDrum: false,
-            transposition: 0
+            transposition: 0,
+            program: 0,
+            bank: this.channelsAmount % 16 === DEFAULT_PERCUSSION ? 128 : 0
         });
         if (!postMessage)
         {