pixi-effects 0.13.0 → 0.14.0

package/dist/index.cjs

@@ -1648,6 +1648,16 @@ function pictureStops(stops, opts = {}) {
   }
   return picks;
 }
+function changedFraction(a, b, threshold = 12) {
+  const n = Math.min(a.length, b.length) >> 2;
+  if (n === 0) return 0;
+  let changed = 0;
+  for (let i = 0; i < n; i++) {
+    const k = i << 2;
+    if (Math.abs(a[k] - b[k]) > threshold || Math.abs(a[k + 1] - b[k + 1]) > threshold || Math.abs(a[k + 2] - b[k + 2]) > threshold) changed++;
+  }
+  return changed / n;
+}
 
 // src/core/loader.ts
 var FADE_FALLBACK_MS = 900;
@@ -1935,18 +1945,28 @@ var Movie = class {
     this._requireReady("snapshot");
     return this._captureFrame(clampFrame(frame, this.totalFrames), { scale: opts.scale ?? 1, type: opts.type ?? "image/png", as: opts.as ?? "blob", motionBlur: opts.motionBlur });
   }
-  /** Seek to `frame` (quietly, and stay there) and encode the canvas as a picture. */
-  async _captureFrame(frame, o) {
-    const mb = this._blurFor(o.motionBlur, "a picture");
+  /** Seek to `frame` (quietly, and stay there) and draw the canvas on a new canvas of `scale` times its size. */
+  async _frameCanvas(frame, scale, motionBlur) {
+    const mb = this._blurFor(motionBlur, "a picture");
     let source = this.app.canvas;
     if (mb) {
       source = this._blurCanvas();
       await this._quietly(() => this._exposeFrame(frame, mb, source, true));
     } else await this._quietly(() => this.gotoFrame(frame, true));
     const out = document.createElement("canvas");
-    out.width = Math.max(1, Math.round(this.width * o.scale));
-    out.height = Math.max(1, Math.round(this.height * o.scale));
+    out.width = Math.max(1, Math.round(this.width * scale));
+    out.height = Math.max(1, Math.round(this.height * scale));
     out.getContext("2d").drawImage(source, 0, 0, out.width, out.height);
+    return out;
+  }
+  /** The pixels of `frame`, small (about 320 px wide) and without motion blur, to compare pictures. */
+  async _framePixels(frame) {
+    const c = await this._frameCanvas(frame, Math.min(1, 320 / Math.max(1, this.width)), false);
+    return c.getContext("2d").getImageData(0, 0, c.width, c.height).data;
+  }
+  /** Seek to `frame` (quietly, and stay there) and encode the canvas as a picture. */
+  async _captureFrame(frame, o) {
+    const out = await this._frameCanvas(frame, o.scale, o.motionBlur);
     return encodeCanvas(out, o.type, o.as, o.quality);
   }
   async stopImages(opts = {}) {
@@ -1976,6 +1996,40 @@ var Movie = class {
     }
     return out;
   }
+  /**
+   * Look at every stop: is the picture there still changing? A stop is compared with the picture `lookback` frames before it (default 3):
+   * when more than `tolerance` (default 0.4 %) of the picture differs, the audience, a page overview and a PDF all see a half-finished
+   * animation. `issues` says which stop, which page and what to do; leaves the playhead where it was.
+   */
+  async inspectStops(opts = {}) {
+    chunkUQBGW5DO_cjs.warnUnknownOptions("movie.inspectStops()", opts, ["lookback", "tolerance"]);
+    this._requireReady("inspectStops");
+    const out = { stops: [], issues: [] };
+    if (this.stops.length === 0) return out;
+    const lookback = Math.max(1, Math.round(opts.lookback ?? 3));
+    const tolerance = opts.tolerance ?? 4e-3;
+    this.pause();
+    const back = this.currentFrame, wasAtPoster = this._atPoster;
+    try {
+      for (const stop of this.stops) {
+        const before = Math.max(0, stop.frame - lookback);
+        let moving = 0;
+        if (before < stop.frame) {
+          const now = await this._framePixels(stop.frame);
+          moving = changedFraction(now, await this._framePixels(before));
+        }
+        const settled = moving <= tolerance;
+        out.stops.push({ index: stop.index, page: stop.page, at: stop.at, frame: stop.frame, moving, settled });
+        if (!settled) {
+          out.issues.push(`stop ${stop.index + 1}${stop.page ? ` (page "${stop.page}")` : ""} at ${stop.at.toFixed(1)} s: the picture is still changing there (${moving < 0.1 ? (moving * 100).toFixed(1) : Math.round(moving * 100)}% of it changed in the last ${stop.frame - before} frames), so the audience, the page overview and a PDF see it mid-animation. Move the stop to after the animation has finished, or flag a settled stop of the page with \`pdf: true\`.`);
+        }
+      }
+    } finally {
+      if (wasAtPoster) await this._showPoster();
+      else await this._quietly(() => this.gotoFrame(back, true));
+    }
+    return out;
+  }
   /**
    * The deck as a PDF: one page per page of the talk (the page's last stop, fully built, unless a stop says `pdf: true` or `pdf: false`;
    * `which: 'stops'` makes a page of every stop that is not `pdf: false`), each a