spessasynth_lib 3.21.9 → 3.21.11

package/@types/sequencer/sequencer.d.ts

@@ -84,6 +84,11 @@ export class Sequencer {
      * @private
      */
     private _skipToFirstNoteOn;
+    /**
+     * @type {boolean}
+     * @private
+     */
+    private _preservePlaybackState;
     /**
      * Indicates if the sequencer should skip to first note on
      * @param val {boolean}
@@ -94,6 +99,18 @@ export class Sequencer {
      * @return {boolean}
      */
     get skipToFirstNoteOn(): boolean;
+    /**
+     * if true,
+     * the sequencer will stay paused when seeking or changing the playback rate
+     * @param val {boolean}
+     */
+    set preservePlaybackState(val: boolean);
+    /**
+     * if true,
+     * the sequencer will stay paused when seeking or changing the playback rate
+     * @returns {boolean}
+     */
+    get preservePlaybackState(): boolean;
     set currentTime(time: number);
     /**
      * @returns {number} Current playback time, in seconds
@@ -211,6 +228,11 @@ export type SequencerOptions = {
      * - if true, the sequencer will automatically start playing the MIDI
      */
     autoPlay: boolean | undefined;
+    /**
+     * - if true,
+     * the sequencer will stay paused when seeking or changing the playback rate
+     */
+    preservePlaybackState: boolean | typeof unescape;
 };
 import { MidiData } from "../midi_parser/midi_data.js";
 import { Synthetizer } from "../synthetizer/synthetizer.js";

package/@types/sequencer/worklet_sequencer/sequencer_message.d.ts

@@ -14,6 +14,7 @@ export namespace WorkletSequencerMessageType {
     let changeSong: number;
     let getMIDI: number;
     let setSkipToFirstNote: number;
+    let setPreservePlaybackState: number;
 }
 export type WorkletSequencerReturnMessageType = number;
 export namespace WorkletSequencerReturnMessageType {

package/@types/synthetizer/worklet_system/worklet_utilities/worklet_processor_channel.d.ts

@@ -16,6 +16,7 @@
  * @property {number} NRPFine - the current fine value of the Non-Registered Parameter
  * @property {number} RPValue - the current value of the Registered Parameter
  *
+ * @property {number} bank - the channel's bank number
  * @property {BasicPreset} preset - the channel's preset
  * @property {boolean} lockPreset - indicates whether the program on the channel is locked
  * @property {boolean} presetUsesOverride - indcates if the channel uses a preset from the override soundfont.
@@ -36,6 +37,16 @@
  * @this {SpessaSynthProcessor}
  */
 export function createWorkletChannel(this: SpessaSynthProcessor, sendEvent?: boolean): void;
+/**
+ * @param channel {WorkletProcessorChannel}
+ * @param bank {number}
+ */
+export function setBankSelect(channel: WorkletProcessorChannel, bank: number): void;
+/**
+ * @param channel {WorkletProcessorChannel}
+ * @returns {number}
+ */
+export function getBankSelect(channel: WorkletProcessorChannel): number;
 /**
  * This is a channel configuration enum, it is internally sent from Synthetizer via controller change
  */
@@ -96,6 +107,10 @@ export type WorkletProcessorChannel = {
      * - the current value of the Registered Parameter
      */
     RPValue: number;
+    /**
+     * - the channel's bank number
+     */
+    bank: number;
     /**
      * - the channel's preset
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spessasynth_lib",
-  "version": "3.21.9",
+  "version": "3.21.11",
   "description": "MIDI and SoundFont2/DLS library with no compromises",
   "browser": "index.js",
   "types": "@types/index.d.ts",

package/sequencer/sequencer.js

@@ -28,6 +28,8 @@ import { DUMMY_MIDI_DATA, MidiData } from "../midi_parser/midi_data.js";
  * @typedef {Object} SequencerOptions
  * @property {boolean|undefined} skipToFirstNoteOn - if true, the sequencer will skip to the first note
  * @property {boolean|undefined} autoPlay - if true, the sequencer will automatically start playing the MIDI
+ * @property {boolean|unescape} preservePlaybackState - if true,
+ * the sequencer will stay paused when seeking or changing the playback rate
  */
 
 /**
@@ -35,7 +37,8 @@ import { DUMMY_MIDI_DATA, MidiData } from "../midi_parser/midi_data.js";
  */
 const DEFAULT_OPTIONS = {
     skipToFirstNoteOn: true,
-    autoPlay: true
+    autoPlay: true,
+    preservePlaybackState: false
 };
 
 export class Sequencer
@@ -138,7 +141,12 @@ export class Sequencer
          * @type {boolean}
          * @private
          */
-        this._skipToFirstNoteOn = options?.skipToFirstNoteOn ?? true;
+        this._skipToFirstNoteOn = options?.skipToFirstNoteOn || true;
+        /**
+         * @type {boolean}
+         * @private
+         */
+        this._preservePlaybackState = options?.preservePlaybackState || false;
         
         if (this._skipToFirstNoteOn === false)
         {
@@ -146,7 +154,12 @@ export class Sequencer
             this._sendMessage(WorkletSequencerMessageType.setSkipToFirstNote, false);
         }
         
-        this.loadNewSongList(midiBinaries, options?.autoPlay ?? false);
+        if (this._preservePlaybackState === true)
+        {
+            this._sendMessage(WorkletSequencerMessageType.setPreservePlaybackState, true);
+        }
+        
+        this.loadNewSongList(midiBinaries, options?.autoPlay || true);
         
         window.addEventListener("beforeunload", this.resetMIDIOut.bind(this));
     }
@@ -170,6 +183,27 @@ export class Sequencer
         this._sendMessage(WorkletSequencerMessageType.setSkipToFirstNote, this._skipToFirstNoteOn);
     }
     
+    /**
+     * if true,
+     * the sequencer will stay paused when seeking or changing the playback rate
+     * @returns {boolean}
+     */
+    get preservePlaybackState()
+    {
+        return this._preservePlaybackState;
+    }
+    
+    /**
+     * if true,
+     * the sequencer will stay paused when seeking or changing the playback rate
+     * @param val {boolean}
+     */
+    set preservePlaybackState(val)
+    {
+        this._preservePlaybackState = val;
+        this._sendMessage(WorkletSequencerMessageType.setPreservePlaybackState, val);
+    }
+    
     /**
      * @returns {number} Current playback time, in seconds
      */
@@ -186,7 +220,10 @@ export class Sequencer
     
     set currentTime(time)
     {
-        this.unpause();
+        if (!this._preservePlaybackState)
+        {
+            this.unpause();
+        }
         this._sendMessage(WorkletSequencerMessageType.setTime, time);
     }
     
@@ -395,8 +432,15 @@ export class Sequencer
                 // message data is absolute time
                 const time = this.synth.currentTime - messageData;
                 Object.entries(this.onTimeChange).forEach((callback) => callback[1](time));
-                this.unpause();
                 this._recalculateStartTime(time);
+                if (this.paused && this._preservePlaybackState)
+                {
+                    this.pausedTime = time;
+                }
+                else
+                {
+                    this.unpause();
+                }
                 break;
             
             case WorkletSequencerReturnMessageType.pause:

package/sequencer/worklet_sequencer/events.js

@@ -65,6 +65,9 @@ export function processMessage(messageType, messageData)
         case WorkletSequencerMessageType.setSkipToFirstNote:
             this._skipToFirstNoteOn = messageData;
             break;
+        
+        case WorkletSequencerMessageType.setPreservePlaybackState:
+            this.preservePlaybackState = messageData;
     }
 }
 

package/sequencer/worklet_sequencer/play.js

@@ -254,12 +254,14 @@ export function play(resetTime = false)
     // reset the time if necesarry
     if (resetTime)
     {
+        this.pausedTime = undefined;
         this.currentTime = 0;
         return;
     }
     
     if (this.currentTime >= this.duration)
     {
+        this.pausedTime = undefined;
         this.currentTime = 0;
         return;
     }

package/sequencer/worklet_sequencer/sequencer_message.js

@@ -11,6 +11,7 @@
  * @property {number} changeSong               - 8 -> goForwards<boolean> if true, next song, if false, previous
  * @property {number} getMIDI                  - 9 -> (no data)
  * @property {number} setSkipToFirstNote       -10 -> skipToFirstNoteOn<boolean>
+ * @property {number} setPreservePlaybackState -11 -> preservePlaybackState<boolean>
  */
 export const WorkletSequencerMessageType = {
     loadNewSongList: 0,
@@ -23,7 +24,8 @@ export const WorkletSequencerMessageType = {
     setLoop: 7,
     changeSong: 8,
     getMIDI: 9,
-    setSkipToFirstNote: 10
+    setSkipToFirstNote: 10,
+    setPreservePlaybackState: 11
 };
 
 /**

package/sequencer/worklet_sequencer/worklet_sequencer.js

@@ -104,6 +104,12 @@ class WorkletSequencer
          * @private
          */
         this._skipToFirstNoteOn = true;
+        
+        /**
+         * If true, seq will stay paused when seeking or changing the playback rate
+         * @type {boolean}
+         */
+        this.preservePlaybackState = false;
     }
     
     /**
@@ -152,15 +158,19 @@ class WorkletSequencer
         }
         this.stop();
         this.playingNotes = [];
+        const wasPaused = this.paused && this.preservePlaybackState;
         this.pausedTime = undefined;
         this.post(WorkletSequencerReturnMessageType.timeChange, currentTime - time);
-        const isNotFinished = this._playTo(time);
+        this._playTo(time);
         this._recalculateStartTime(time);
-        if (!isNotFinished)
+        if (wasPaused)
         {
-            return;
+            this.pause();
+        }
+        else
+        {
+            this.play();
         }
-        this.play();
     }
     
     /**