spessasynth_lib 3.25.3 → 3.25.5

package/README.md

@@ -55,7 +55,7 @@ Supported formats list:
 - **Easy to Use:** *Basic setup is just [two lines of code!](https://github.com/spessasus/SpessaSynth/wiki/Usage-As-Library#minimal-setup)*
 - **No dependencies:** *Batteries included!*
 
-### Powerful Synthesizer
+### Powerful MIDI Synthesizer
 - Suitable for both **real-time** and **offline** synthesis
 - **Excellent SoundFont support:**
   - **Full Generator Support**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spessasynth_lib",
-  "version": "3.25.3",
+  "version": "3.25.5",
   "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);
 }
 

package/soundfont/dls/dls_sources.js

@@ -20,8 +20,9 @@ export const DLSSources = {
     volume: 0x87,
     pan: 0x8a,
     expression: 0x8b,
-    chorus: 0xdb,
-    reverb: 0xdd,
+    // note: these are flipped unintentionally in DLS2 table 9. Argh!
+    chorus: 0xdd,
+    reverb: 0xdb,
     
     pitchWheelRange: 0x100,
     fineTune: 0x101,

package/synthetizer/synthetizer.js

@@ -155,6 +155,9 @@ export class Synthetizer
                     return new AudioWorkletNode(ctx, name, opts);
                 };
             }
+            /**
+             * @type {AudioWorkletNode}
+             */
             this.worklet = workletConstructor(this.context, WORKLET_PROCESSOR_NAME, {
                 outputChannelCount: processorChannelCount,
                 numberOfOutputs: processorOutputsCount,
@@ -526,6 +529,24 @@ export class Synthetizer
         }
     }
     
+    /**
+     * Disconnects the individual audio outputs to the given audio nodes. In the app, it's used by the renderer.
+     * @param audioNodes {AudioNode[]}
+     */
+    disconnectIndividualOutputs(audioNodes)
+    {
+        if (audioNodes.length !== this._outputsAmount)
+        {
+            throw new Error(`input nodes amount differs from the system's outputs amount!
+            Expected ${this._outputsAmount} got ${audioNodes.length}`);
+        }
+        for (let outputNumber = 0; outputNumber < this._outputsAmount; outputNumber++)
+        {
+            // + 2 because chorus and reverb come first!
+            this.worklet.disconnect(audioNodes[outputNumber], outputNumber + 2);
+        }
+    }
+    
     /*
      * Disables the GS NRPN parameters like vibrato or drum key tuning.
      */