spessasynth_core 4.0.15 → 4.0.16

package/dist/index.d.ts

@@ -3743,6 +3743,7 @@ interface SequencerEventData {
     };
     /**
      * Called when the playback stops.
+     * @deprecated use songEnded instead.
      */
     pause: {
         /**
@@ -3750,6 +3751,10 @@ interface SequencerEventData {
          */
         isFinished: boolean;
     };
+    /**
+     * Called when the playback stops.
+     */
+    songEnded: object;
     /**
      * Called when the song changes.
      */
@@ -3828,6 +3833,15 @@ declare class SpessaSynthSequencer {
      * Defaults to true.
      */
     skipToFirstNoteOn: boolean;
+    /**
+     * Indicates if the sequencer has finished playing.
+     */
+    isFinished: boolean;
+    /**
+     * Indicates if the synthesizer should preload the voices for the newly loaded sequence.
+     * Recommended.
+     */
+    preload: boolean;
     /**
      * Called when the sequencer calls an event.
      * @param event The event

package/dist/index.js

@@ -3942,10 +3942,12 @@ function loadNewSequenceInternal(parsedMidi) {
   if (parsedMidi.duration === 0) {
     SpessaSynthWarn("This MIDI file has a duration of exactly 0 seconds.");
     this.pausedTime = 0;
+    this.isFinished = true;
     return;
   }
   this.oneTickToSeconds = 60 / (120 * parsedMidi.timeDivision);
   this._midiData = parsedMidi;
+  this.isFinished = false;
   this.synth.clearEmbeddedBank();
   if (this._midiData.embeddedSoundBank !== void 0) {
     SpessaSynthInfo(
@@ -3957,23 +3959,33 @@ function loadNewSequenceInternal(parsedMidi) {
       this._midiData.bankOffset
     );
   }
-  SpessaSynthGroupCollapsed("%cPreloading samples...", consoleColors.info);
-  const used = this._midiData.getUsedProgramsAndKeys(
-    this.synth.soundBankManager
-  );
-  used.forEach((combos, preset) => {
-    SpessaSynthInfo(
-      `%cPreloading used samples on %c${preset.name}%c...`,
-      consoleColors.info,
-      consoleColors.recognized,
+  if (this.preload) {
+    SpessaSynthGroupCollapsed(
+      "%cPreloading samples...",
       consoleColors.info
     );
-    for (const combo of combos) {
-      const [midiNote, velocity] = combo.split("-").map(Number);
-      this.synth.getVoicesForPreset(preset, midiNote, velocity, midiNote);
-    }
-  });
-  SpessaSynthGroupEnd();
+    const used = this._midiData.getUsedProgramsAndKeys(
+      this.synth.soundBankManager
+    );
+    used.forEach((combos, preset) => {
+      SpessaSynthInfo(
+        `%cPreloading used samples on %c${preset.name}%c...`,
+        consoleColors.info,
+        consoleColors.recognized,
+        consoleColors.info
+      );
+      for (const combo of combos) {
+        const [midiNote, velocity] = combo.split("-").map(Number);
+        this.synth.getVoicesForPreset(
+          preset,
+          midiNote,
+          velocity,
+          midiNote
+        );
+      }
+    });
+    SpessaSynthGroupEnd();
+  }
   this.currentMIDIPorts = this._midiData.tracks.map((t) => t.port);
   this.midiPortChannelOffset = 0;
   this.midiPortChannelOffsets = {};
@@ -4957,6 +4969,15 @@ var SpessaSynthSequencer = class {
    * Defaults to true.
    */
   skipToFirstNoteOn = true;
+  /**
+   * Indicates if the sequencer has finished playing.
+   */
+  isFinished = false;
+  /**
+   * Indicates if the synthesizer should preload the voices for the newly loaded sequence.
+   * Recommended.
+   */
+  preload = false;
   /**
    * Called when the sequencer calls an event.
    * @param event The event
@@ -5208,8 +5229,12 @@ var SpessaSynthSequencer = class {
     }
     this.stop();
     this.callEvent("pause", { isFinished });
+    if (isFinished) {
+      this.callEvent("songEnded", {});
+    }
   }
   songIsFinished() {
+    this.isFinished = true;
     if (this.songs.length === 1) {
       this.pauseInternal(true);
       return;