pixi-effects 0.34.0 → 0.35.0

package/dist/{chunk-FVZEBYLW.cjs → chunk-7TTCPHAV.cjs}

@@ -2645,6 +2645,10 @@ var Movie = class {
   _silent = 0;
   /** render() / peek() in flight: a rebuild does not swap the composition under them. */
   _busy = 0;
+  /** > 0 while the movie is moving its scene to another moment (a seek, a motion-blurred frame, the poster): a thumbnail does not start then. */
+  _moving = 0;
+  /** The thumbnail being drawn, if any: a seek waits for it (it has the scene on another moment for a few microtasks). */
+  _thumbRun = null;
   _idleWaiters = [];
   /** What went into the mix, and its peak before limiting — kept for inspectAudio(). */
   _audioSources = [];
@@ -2692,6 +2696,7 @@ var Movie = class {
     if (this._posterFrame === null || !this.timeline) return;
     const back = this.currentFrame;
     this.currentFrame = this._posterFrame;
+    this._moving++;
     try {
       this.timeline.time(this._timeOf(this._posterFrame));
       await this._awaitVideoFrames();
@@ -2699,6 +2704,7 @@ var Movie = class {
       this._renderNow();
     } finally {
       this.currentFrame = back;
+      this._moving--;
     }
     this._atPoster = true;
   }
@@ -3085,12 +3091,18 @@ var Movie = class {
     this.emit("error", { where, message: error instanceof Error ? error.message : String(error), error });
   }
   async _goto(frame) {
-    this._atPoster = false;
-    this.currentFrame = Math.max(0, Math.min(frame, this.totalFrames));
-    this.timeline.time(this._timeOf(this.currentFrame));
-    await this._awaitVideoFrames();
-    this._updateSpace();
-    this._renderNow();
+    if (this._thumbRun) await this._thumbRun;
+    this._moving++;
+    try {
+      this._atPoster = false;
+      this.currentFrame = Math.max(0, Math.min(frame, this.totalFrames));
+      this.timeline.time(this._timeOf(this.currentFrame));
+      await this._awaitVideoFrames();
+      this._updateSpace();
+      this._renderNow();
+    } finally {
+      this._moving--;
+    }
     this.emit("frame", { frame: this.currentFrame, totalFrames: this.totalFrames });
   }
   /**
@@ -3138,6 +3150,69 @@ var Movie = class {
     if (o.as === "imageData") return out.getContext("2d").getImageData(0, 0, out.width, out.height);
     return encodeCanvas(out, o.type, o.as, o.quality);
   }
+  /**
+   * Why `thumbnail()` is off for this movie: `'variables'` (it declares `vars`: the picture depends on them and changes when they do) or `'video'` (a video
+   * layer: its frame must be waited for, which would seek the playing video). `null`: it works.
+   */
+  get thumbnailsOff() {
+    if (this._declared.size > 0) return "variables";
+    if (!this._rootSequence) return null;
+    const found = [];
+    collectVideoSequences(this._rootSequence, found);
+    return found.some((v) => v.spec?.type === "video") ? "video" : null;
+  }
+  /**
+   * A small picture of any frame, drawn WITHOUT moving the playhead or changing what is on the canvas, so it can be made while the movie plays or is
+   * paused (a seek-bar preview). The scene is put on that moment, drawn, copied, and put back, all within the microtasks of one task: the browser never
+   * shows the in-between. Gives `null` when it cannot be made right now: the movie has thumbnails off (see `thumbnailsOff`), is moving somewhere else
+   * (a seek, a render, a peek), or is another thumbnail's turn. It is the picture `snapshot()` gives at that size (without motion blur).
+   */
+  async thumbnail(frame, opts = {}) {
+    chunkTWZNOUM7_cjs.warnUnknownOptions("movie.thumbnail()", opts, ["width", "scale"]);
+    this._requireReady("thumbnail");
+    if (opts.width !== void 0 && !(opts.width > 0 && opts.width <= this.width * 4)) throw new Error(`pixi-effects: movie.thumbnail(): width must be above 0 and at most ${this.width * 4} px, got ${opts.width}`);
+    if (opts.scale !== void 0 && !(opts.scale > 0 && opts.scale <= 4)) throw new Error(`pixi-effects: movie.thumbnail(): scale must be above 0 and at most 4, got ${opts.scale}`);
+    if (this.thumbnailsOff || this._moving > 0 || this._busy > 0 || this._thumbRun) return null;
+    const w = Math.max(1, Math.round(opts.width ?? (opts.scale !== void 0 ? this.width * opts.scale : 160)));
+    const h = Math.max(1, Math.round(w * this.height / this.width));
+    let done;
+    this._thumbRun = new Promise((r) => {
+      done = r;
+    });
+    try {
+      return await this._drawThumbnail(clampFrame(frame, this.totalFrames), w, h);
+    } finally {
+      this._thumbRun = null;
+      done();
+    }
+  }
+  async _drawThumbnail(frame, w, h) {
+    const stage = this.app.canvas;
+    const out = document.createElement("canvas");
+    out.width = w;
+    out.height = h;
+    const keep = this.timeline.time();
+    const t = this._timeOf(frame);
+    this._nominalTime = t;
+    try {
+      this.timeline.time(t);
+      await this._awaitVideoFrames(t);
+      this._updateSpace(t);
+      this._renderNow();
+      out.getContext("2d").drawImage(stage, 0, 0, w, h);
+    } finally {
+      this._nominalTime = keep;
+      try {
+        this.timeline.time(keep);
+        await this._awaitVideoFrames(keep);
+        this._updateSpace(keep);
+        this._renderNow();
+      } finally {
+        this._nominalTime = null;
+      }
+    }
+    return out;
+  }
   async onionSkin(opts = {}) {
     chunkTWZNOUM7_cjs.warnUnknownOptions("movie.onionSkin()", opts, ["from", "to", "count", "scale", "as", "motionBlur"]);
     this._requireReady("onionSkin");
@@ -3316,9 +3391,11 @@ var Movie = class {
   async _exposeFrame(frame, mb, target, settle) {
     const g = target.getContext("2d");
     const stage = this.app.canvas;
+    if (this._thumbRun) await this._thumbRun;
     this._atPoster = false;
     const times = blurTimes(frame, this.frameRate, mb, Math.max(0, this.duration - END_MARGIN));
     this._nominalTime = this._timeOf(Math.max(0, Math.min(frame, this.totalFrames)));
+    this._moving++;
     try {
       for (let k = 0; k < times.length; k++) {
         const t = times[k];
@@ -3332,6 +3409,7 @@ var Movie = class {
       }
     } finally {
       this._nominalTime = null;
+      this._moving--;
     }
     g.globalAlpha = 1;
     if (settle) await this._goto(frame);
@@ -4644,5 +4722,5 @@ exports.splitText = splitText;
 exports.stagger = stagger;
 exports.wiggle = wiggle;
 exports.withFade = withFade;
-//# sourceMappingURL=chunk-FVZEBYLW.cjs.map
-//# sourceMappingURL=chunk-FVZEBYLW.cjs.map
+//# sourceMappingURL=chunk-7TTCPHAV.cjs.map
+//# sourceMappingURL=chunk-7TTCPHAV.cjs.map