spessasynth_lib 3.25.3 → 3.25.4

package/package.json

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

package/sequencer/sequencer.js

@@ -66,11 +66,17 @@ export class Sequencer
     onTextEvent;
     
     /**
-     * The sequence's data, except for the track data.
+     * The current MIDI data, with the exclusion of the embedded sound bank and event data.
      *  @type {MIDIData}
      */
     midiData;
     
+    /**
+     * The current MIDI data for all songs, like the midiData property.
+     * @type {MIDIData[]}
+     */
+    songListData = [];
+    
     /**
      * @type {Object<string, function(MIDIData)>}
      * @private
@@ -285,11 +291,11 @@ export class Sequencer
         this._shuffleSongs = value;
         if (value)
         {
-            this._sendMessage(WorkletSequencerMessageType.changeSong, SongChangeType.shuffleOn);
+            this._sendMessage(WorkletSequencerMessageType.changeSong, [SongChangeType.shuffleOn]);
         }
         else
         {
-            this._sendMessage(WorkletSequencerMessageType.changeSong, SongChangeType.shuffleOff);
+            this._sendMessage(WorkletSequencerMessageType.changeSong, [SongChangeType.shuffleOff]);
         }
     }
     
@@ -476,14 +482,30 @@ export class Sequencer
         });
     }
     
+    /**
+     * Switch to the next song in the playlist
+     */
     nextSong()
     {
-        this._sendMessage(WorkletSequencerMessageType.changeSong, SongChangeType.forwards);
+        this._sendMessage(WorkletSequencerMessageType.changeSong, [SongChangeType.forwards]);
     }
     
+    /**
+     * Switch to the previous song in the playlist
+     */
     previousSong()
     {
-        this._sendMessage(WorkletSequencerMessageType.changeSong, SongChangeType.backwards);
+        this._sendMessage(WorkletSequencerMessageType.changeSong, [SongChangeType.backwards]);
+    }
+    
+    /**
+     * Sets the song index in the playlist
+     * @param index
+     */
+    setSongIndex(index)
+    {
+        const clamped = Math.max(Math.min(this.songsAmount - 1, index), 0);
+        this._sendMessage(WorkletSequencerMessageType.changeSong, [SongChangeType.index, clamped]);
     }
     
     /**
@@ -536,19 +558,15 @@ export class Sequencer
                 break;
             
             case WorkletSequencerReturnMessageType.songChange:
-                /**
-                 * messageData is expected to be {MIDIData}
-                 * @type {MIDIData}
-                 */
-                let songChangeData = messageData[0];
-                this.songIndex = messageData[1];
+                this.songIndex = messageData[0];
+                const songChangeData = this.songListData[this.songIndex];
                 this.midiData = songChangeData;
                 this.hasDummyData = false;
                 this.absoluteStartTime = 0;
                 this.duration = this.midiData.duration;
                 this._callEvents(this.onSongChange, songChangeData);
                 // if is auto played, unpause
-                if (messageData[2] === true)
+                if (messageData[1] === true)
                 {
                     this.unpause();
                 }
@@ -626,6 +644,10 @@ export class Sequencer
                 }
                 break;
             
+            case WorkletSequencerReturnMessageType.songListChange:
+                this.songListData = messageData;
+                break;
+            
             default:
                 break;
         }

package/sequencer/worklet_sequencer/events.js

@@ -61,7 +61,7 @@ export function processMessage(messageType, messageData)
             break;
         
         case WorkletSequencerMessageType.changeSong:
-            switch (messageData)
+            switch (messageData[0])
             {
                 case SongChangeType.forwards:
                     this.nextSong();
@@ -81,6 +81,12 @@ export function processMessage(messageType, messageData)
                     this.shuffleSongIndexes();
                     this.songIndex = 0;
                     this.loadCurrentSong();
+                    break;
+                
+                case SongChangeType.index:
+                    this.songIndex = messageData[1];
+                    this.loadCurrentSong();
+                    break;
             }
             break;
         

package/sequencer/worklet_sequencer/sequencer_message.js

@@ -1,8 +1,9 @@
 export const SongChangeType = {
-    backwards: 0,
-    forwards: 1,
-    shuffleOn: 2,
-    shuffleOff: 3
+    backwards: 0,   // no additional data
+    forwards: 1,    // no additional data
+    shuffleOn: 2,   // no additional data
+    shuffleOff: 3,  // no additional data
+    index: 4        // songIndex<number>
 };
 
 /**
@@ -14,8 +15,8 @@ export const SongChangeType = {
  * @property {number} setTime                  - 4 -> time<number>
  * @property {number} changeMIDIMessageSending - 5 -> sendMIDIMessages<boolean>
  * @property {number} setPlaybackRate          - 6 -> playbackRate<number>
- * @property {number} setLoop                  - 7 -> [loop<boolean>, count<number]
- * @property {number} changeSong               - 8 -> changeType<number> 0 - back, 1 - forward, 2 - shuffle ON, 3 - shuffle OFF
+ * @property {number} setLoop                  - 7 -> [loop<boolean>, count<number>]
+ * @property {number} changeSong               - 8 -> [changeType<SongChangeType>, data<number>]
  * @property {number} getMIDI                  - 9 -> (no data)
  * @property {number} setSkipToFirstNote       -10 -> skipToFirstNoteOn<boolean>
  * @property {number} setPreservePlaybackState -11 -> preservePlaybackState<boolean>
@@ -41,12 +42,13 @@ export const WorkletSequencerMessageType = {
  */
 export const WorkletSequencerReturnMessageType = {
     midiEvent: 0,               // [...midiEventBytes<number>]
-    songChange: 1,              // [midiData<MIDIData>, songIndex<number>, isAutoPlayed<boolean>]
+    songChange: 1,              // [songIndex<number>, isAutoPlayed<boolean>]
     textEvent: 2,               // [messageData<number[]>, statusByte<number>, lyricsIndex<number>]
     timeChange: 3,              // newAbsoluteTime<number>
     pause: 4,                   // no data
     getMIDI: 5,                 // midiData<MIDI>
     midiError: 6,               // errorMSG<string>
     metaEvent: 7,               // [messageType<number>, messageData<Uint8Array>, trackNum<number>]
-    loopCountChange: 8          // newLoopCount<number>
+    loopCountChange: 8,         // newLoopCount<number>
+    songListChange: 9          // songListData<MIDIData[]>
 };

package/sequencer/worklet_sequencer/song_control.js

@@ -127,7 +127,7 @@ export function loadNewSequence(parsedMidi, autoPlay = true)
     this.firstNoteTime = this.midiData.MIDIticksToSeconds(this.midiData.firstNoteOn);
     SpessaSynthInfo(`%cTotal song time: ${formatTime(Math.ceil(this.duration)).time}`, consoleColors.recognized);
     
-    this.post(WorkletSequencerReturnMessageType.songChange, [new MIDIData(this.midiData), this.songIndex, autoPlay]);
+    this.post(WorkletSequencerReturnMessageType.songChange, [this.songIndex, autoPlay]);
     
     if (this.duration <= 1)
     {
@@ -190,6 +190,8 @@ export function loadNewSongList(midiBuffers, autoPlay = true)
         this.loop = false;
     }
     this.shuffleSongIndexes();
+    const midiDatas = this.songs.map(s => new MIDIData(s));
+    this.post(WorkletSequencerReturnMessageType.songListChange, midiDatas);
     this.loadCurrentSong(autoPlay);
 }