pixi-effects 0.36.0 → 0.37.0

package/dist/{chunk-VF56PRAA.js → chunk-KNDEKWQO.js}

@@ -1,6 +1,7 @@
-import { CompositionSequence, maskSourceOf } from './chunk-AZ6AINSW.js';
-import { EXPRESSION_NAMES, createTimeline, lengthen, ensureFilterLibrary, checkEase, parseEase, homeDistance, DEFAULT_FOV, random, noise, flattenSvgPath, rand, DEG, timeRemapOf, contentLength, resolveAt, parseSpring, springDuration, spansMeta } from './chunk-G3DX65HO.js';
-import { usesAdvancedBlend, enableAdvancedBlend } from './chunk-WIIU42FH.js';
+import { CompositionSequence, maskSourceOf } from './chunk-IPQNT65V.js';
+import { EXPRESSION_NAMES, createTimeline, lengthen, ensureFilterLibrary, checkEase, parseEase, homeDistance, DEFAULT_FOV, random, noise, flattenSvgPath, trimPolylines, rand, DEG, timeRemapOf, contentLength, resolveAt, parseSpring, springDuration, spansMeta } from './chunk-SBR75G73.js';
+import { usesAdvancedBlend, enableAdvancedBlend } from './chunk-VNP7QCJE.js';
+import { describeLayer } from './chunk-32MMNDDN.js';
 import { warnUnknownOptions, suggestName } from './chunk-BXOCEZ4U.js';
 import { extensions, CullerPlugin, Application, Container, Rectangle, Culler, CanvasTextMetrics, TextStyle, Assets, ExtensionType, Filter, Texture, UniformGroup, GpuProgram, GlProgram, defaultFilterVert } from 'pixi.js';
 import { Output, BufferTarget, CanvasSource, AudioBufferSource, Input, ALL_FORMATS, BlobSource, WavOutputFormat, Conversion, VideoSampleSink, OggOutputFormat, QUALITY_VERY_HIGH, QUALITY_HIGH, QUALITY_MEDIUM, QUALITY_LOW, QUALITY_VERY_LOW, MkvOutputFormat, WebMOutputFormat, MovOutputFormat, Mp4OutputFormat, canEncodeVideo, getFirstEncodableAudioCodec } from 'mediabunny';
@@ -517,8 +518,8 @@ function analyzeAudio(mix, sources, stats, movieDuration, opts = {}) {
   });
   if (buried.length > 0) {
     const worst = buried.reduce((a, b) => b.belowMixDb > a.belowMixDb ? b : a);
-    const names = new Set(buried.map((x) => x.layer + x.source));
-    scoreNotes.push(`${names.size === 1 ? "1 sound effect is" : `${names.size} sound effects are`} buried (${BURIED_DB} dB or more under the loudest sample of the mix around its loudest moment${buried.length > names.size ? `, ${buried.length} times in all` : ""}): the worst is ${worst.layer} (${worst.source}), its own peak ${worst.ownDb} dBFS at volume ${worst.topVolume} against ${worst.around} dBFS at ${worst.at} s, ${worst.belowMixDb} dB louder. If it is meant to be heard, raise its volume (an accent over music needs 2 to 3) or lower what plays there; every source's belowMixDb has its own number`);
+    const distinct = new Set(buried.map((x) => (x.layer === "an audio layer" ? `#${buried.indexOf(x)}` : x.layer) + x.source)).size;
+    scoreNotes.push(`${distinct === 1 ? "1 sound effect is" : `${distinct} sound effects are`} buried (${BURIED_DB} dB or more under the loudest sample of the mix around its loudest moment${buried.length > distinct ? `, ${buried.length} times in all` : ""}): the worst is ${worst.layer} (${worst.source}), its own peak ${worst.ownDb} dBFS at volume ${Math.round(worst.topVolume * 100) / 100} against ${worst.around} dBFS at ${worst.at} s, ${worst.belowMixDb} dB louder. If it is meant to be heard, raise its volume (an accent over music needs 2 to 3) or lower what plays there; every source's belowMixDb has its own number`);
   }
   const whole = measureLoudness(chans, sr);
   const silences = findSilences(chans, sr, { minLength: 1 });
@@ -693,12 +694,14 @@ async function reviewMovie(movie, opts = {}) {
     if (r.issues.length) perFrame.push({ frame, issues: r.issues });
   }
   const grouped = splitIssues(groupIssues(perFrame), !!opts.strict);
+  const canvas = movie.canvasReport();
+  for (const r of canvas) if (!r.ok) grouped.problems.push({ message: r.problem, count: 1, firstFrame: 0, lastFrame: 0, kind: "canvas" });
   const fonts = movie.inspectFonts();
   for (const f of fonts.failedUnused) grouped.review.push({ message: `web font "${f}" failed to load, but no text layer uses it (a broken or unused @font-face)`, count: 1, firstFrame: 0, lastFrame: 0 });
   for (const m of fonts.missing) {
     (opts.strict ? grouped.problems : grouped.review).push({ message: `layer "${m.layer}": none of the fonts "${m.family}" is available here (it is drawn in a fallback font)`, count: 1, firstFrame: 0, lastFrame: 0 });
   }
-  return { frames: frames.length, problems: grouped.problems, review: grouped.review, fonts, audio: movie.audioBuffer ? movie.inspectAudio() : null, at };
+  return { frames: frames.length, problems: grouped.problems, review: grouped.review, canvas, fonts, audio: movie.audioBuffer ? movie.inspectAudio() : null, at };
 }
 
 // src/core/onion.ts
@@ -1897,6 +1900,34 @@ function rejectReservedNameCollision(filters, seqName) {
   }
 }
 
+// src/core/canvasCheck.ts
+var isCanvas = (s) => typeof s.checkDeterminism === "function";
+var describeDiff = (d) => `${d.t} s${d.pixels >= 0 ? ` (${d.pixels} channel values differ, by up to ${d.maxDiff} of 255)` : ""}`;
+function canvasReport(root) {
+  const out = [];
+  const visit = (seq) => {
+    if (isCanvas(seq)) {
+      const length = seq.duration ?? 0;
+      const moments = [0.15, 0.4, 0.65, 0.9].map((f) => Math.round(f * length * 1e3) / 1e3);
+      const { differs, drawMs, threw } = seq.checkDeterminism(moments);
+      const name = describeLayer(seq.spec);
+      const problem = threw.length ? `${name} could not draw at ${threw.map((t) => `${t} s`).join(", ")} (its draw threw, or the layer failed to build): it shows a magenta checkerboard there; the warning above says why, so the layer cannot be called deterministic` : differs.length ? `${name} does not draw the same picture for the same time (checked at ${differs.map(describeDiff).join(", ")}; drawn in two orders after one draw that was thrown away): usually its draw uses Math.random, Date.now or state that outlives the call (a value it keeps from the last call), so playback, a seek and an export would not agree: use info.random() (seeded) and derive everything from t. If it uses none of these, look at the canvases it draws from: make sprites and masks with info.canvas(w, h) (not document.createElement) and draw them into the picture before the strokes that depend on them` : "";
+      out.push({ name: seq.spec.name ?? name, moments, drawMs, ok: !differs.length && !threw.length, problem });
+    }
+    if (seq instanceof CompositionSequence) walk2(seq);
+  };
+  const walk2 = (comp) => {
+    for (const { seq } of comp.layers()) {
+      visit(seq);
+      const mask = seq.maskSequence;
+      if (mask) visit(mask);
+    }
+  };
+  walk2(root);
+  return out;
+}
+var canvasProblems = (root) => canvasReport(root).filter((r) => !r.ok).map((r) => r.problem);
+
 // src/core/inspect.ts
 function chainOf(node) {
   const chain = [];
@@ -3360,6 +3391,16 @@ var Movie = class {
     await this.gotoFrame(f, true);
     return inspectScene(this._rootSequence, f, f / this.frameRate, { width: this.width, height: this.height }, opts);
   }
+  /** The canvas layers whose same frame is not the same picture (what `check` reports as a problem): one sentence each. */
+  canvasProblems() {
+    this._requireReady("canvasProblems");
+    return canvasProblems(this._rootSequence);
+  }
+  /** Every canvas layer as the determinism check saw it: the moments drawn, the usual time of a draw in ms, and whether the same time gave the same picture (`check` prints it even when all pass). */
+  canvasReport() {
+    this._requireReady("canvasReport");
+    return canvasReport(this._rootSequence);
+  }
   /**
    * Every layer as a row with absolute start / end / keyframe times (seconds), plus the transition windows. Runs of
    * similar layers (`pop-1` … `pop-12`) are one row with a `parts` span each. Read it, or draw it with `timelineChart()`.
@@ -4201,6 +4242,45 @@ function followPath(opts) {
   return out;
 }
 
+// src/core/pathSample.ts
+function samplePath(d) {
+  if (typeof d !== "string" || d.trim() === "") throw new Error('samplePath(): d must be SVG path data, e.g. "M 40 300 C 200 20 400 20 560 300"');
+  const lines = flattenSvgPath(d);
+  const segments = [];
+  let length = 0;
+  for (const line of lines) {
+    const p = line.closed ? [...line.pts, line.pts[0], line.pts[1]] : line.pts;
+    for (let i = 2; i < p.length; i += 2) {
+      const len = Math.hypot(p[i] - p[i - 2], p[i + 1] - p[i - 1]);
+      if (len === 0) continue;
+      segments.push({ x0: p[i - 2], y0: p[i - 1], x1: p[i], y1: p[i + 1], start: length, len });
+      length += len;
+    }
+  }
+  if (!(length > 0)) throw new Error(`samplePath(): the path "${d}" has no length (it needs at least two different points)`);
+  const find = (s) => {
+    let lo = 0, hi = segments.length - 1;
+    while (lo < hi) {
+      const mid = lo + hi >> 1;
+      if (segments[mid].start + segments[mid].len < s) lo = mid + 1;
+      else hi = mid;
+    }
+    return segments[lo];
+  };
+  return {
+    length,
+    at(u) {
+      const s = Math.min(Math.max(Number.isFinite(u) ? u : 0, 0), 1) * length;
+      const g = find(s);
+      const t = Math.min(Math.max((s - g.start) / g.len, 0), 1);
+      return { x: g.x0 + (g.x1 - g.x0) * t, y: g.y0 + (g.y1 - g.y0) * t, angle: Math.atan2(g.y1 - g.y0, g.x1 - g.x0) };
+    },
+    trim(start = 0, end = 1) {
+      return trimPolylines(lines, start, end).map((l) => l.closed ? [...l.pts, l.pts[0], l.pts[1]] : l.pts);
+    }
+  };
+}
+
 // src/presets/cameraPath.ts
 var KEYS4 = ["points", "at", "duration", "ease", "look", "lookAhead", "smooth", "from", "to", "frameRate"];
 var MAX_STEPS2 = 4e3;
@@ -4802,6 +4882,6 @@ function withFade(spec, opts) {
   return spec;
 }
 
-export { Movie, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, dismissLoader, failLoader, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, orbit, parseEase2 as parseEase, particles, react, resolveLoader, splitText, stagger, wiggle, withFade };
-//# sourceMappingURL=chunk-VF56PRAA.js.map
-//# sourceMappingURL=chunk-VF56PRAA.js.map
+export { Movie, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, dismissLoader, failLoader, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, orbit, parseEase2 as parseEase, particles, react, resolveLoader, samplePath, splitText, stagger, wiggle, withFade };
+//# sourceMappingURL=chunk-KNDEKWQO.js.map
+//# sourceMappingURL=chunk-KNDEKWQO.js.map