pixi-effects 0.40.0 → 0.41.0

package/dist/{chunk-CT5CZVT5.js → chunk-Y2N6U3X5.js}

@@ -1,5 +1,5 @@
-import { CompositionSequence, maskSourceOf } from './chunk-26Z544SH.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-LMWXR5OC.js';
+import { CompositionSequence, maskSourceOf } from './chunk-ICI6ACHY.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-4QVQ5UJJ.js';
 import { analyzeAudio, fft, resampleThrough, playSpan } from './chunk-UHNSL2KJ.js';
 import { usesAdvancedBlend, enableAdvancedBlend } from './chunk-VNP7QCJE.js';
 import { describeLayer } from './chunk-32MMNDDN.js';
@@ -1729,6 +1729,80 @@ function inspectScene(root, frame, time, canvas, opts = {}) {
   return { frame, time, canvas, summary: { layers: layers.length, visible: layers.filter((l) => l.visible).length }, issues, layers: listed };
 }
 
+// src/core/pick.ts
+function pointInQuad(q, x, y) {
+  let pos = 0, neg = 0;
+  for (let i = 0; i < 4; i++) {
+    const ax = q[i * 2], ay = q[i * 2 + 1], bx = q[(i + 1) % 4 * 2], by = q[(i + 1) % 4 * 2 + 1];
+    const cross = (bx - ax) * (y - ay) - (by - ay) * (x - ax);
+    if (cross > 0) pos++;
+    else if (cross < 0) neg++;
+  }
+  return pos === 0 || neg === 0;
+}
+function orderOf(node) {
+  const key = [];
+  for (let n = node; n && n.parent; n = n.parent) {
+    key.unshift([n.zIndex ?? 0, Math.max(0, n.parent.children?.indexOf(n) ?? 0)]);
+  }
+  return key;
+}
+var above = (a, b) => {
+  for (let i = 0; i < Math.min(a.length, b.length); i++) {
+    if (a[i][0] !== b[i][0]) return b[i][0] - a[i][0];
+    if (a[i][1] !== b[i][1]) return b[i][1] - a[i][1];
+  }
+  return b.length - a.length;
+};
+function pickScene(root, x, y, opts = {}) {
+  const found = [];
+  const wanted = (name, path) => {
+    if (opts.ignore && (opts.ignore.includes(path) || name !== void 0 && opts.ignore.includes(name))) return false;
+    if (opts.only && !(opts.only.includes(path) || name !== void 0 && opts.only.includes(name))) return false;
+    return true;
+  };
+  const inside = (b, p) => p.x >= b.x && p.x <= b.x + b.width && p.y >= b.y && p.y <= b.y + b.height;
+  const walk2 = (comp, prefix, parentVisible) => {
+    comp.layers().forEach(({ seq, display, threeD, carriers, quad }, i) => {
+      const d = display;
+      if (!d) return;
+      const t = seq.target;
+      const name = seq.spec.name;
+      const path = prefix + (name ?? `${seq.spec.type}#${i}`);
+      const alpha = (t?.alpha ?? 1) * carriers.reduce((a, c) => a * (c.target?.alpha ?? 1), 1);
+      const alive = (threeD ? d.visible : t?.renderable ?? true) && carriers.every((c) => c.target?.renderable ?? true);
+      const visible = parentVisible && alive && alpha > 0;
+      if (!visible) return;
+      const isComposition = seq instanceof CompositionSequence;
+      if (isComposition && !threeD) {
+        walk2(seq, path + "/", visible);
+        return;
+      }
+      if (!wanted(name, path)) return;
+      const point = { x, y };
+      let hit = null;
+      if (threeD) {
+        if (quad && pointInQuad(quad, d.toLocal(point).x, d.toLocal(point).y)) hit = { name, path, type: seq.spec.type, kind: "card", point };
+      } else {
+        const local = d.toLocal(point);
+        const lb = d.getLocalBounds();
+        if (inside(lb, local)) {
+          const three = typeof seq.pickAt === "function" ? seq.pickAt((local.x - lb.x) / lb.width, (local.y - lb.y) / lb.height) : void 0;
+          if (three) hit = { name, path, type: seq.spec.type, kind: "three", point, three };
+          else if (three === void 0 && (typeof d.containsPoint !== "function" || d.containsPoint(local))) hit = { name, path, type: seq.spec.type, kind: "flat", point, local: { x: local.x - lb.x, y: local.y - lb.y } };
+        }
+      }
+      if (!hit) return;
+      const maskTarget = seq.maskSequence?.target;
+      const maskSrc = maskSourceOf(seq.spec.mask);
+      if (maskTarget && !(maskSrc.kind === "inline" && maskSrc.invert) && !inside(maskTarget.getBounds(), point)) return;
+      found.push({ hit, order: orderOf(d) });
+    });
+  };
+  walk2(root, "", true);
+  return found.sort((a, b) => above(a.order, b.order)).map((f) => f.hit);
+}
+
 // src/core/timelineChart.ts
 var GROUP_MIN = 4;
 var MAX_KEYS = 200;
@@ -2986,6 +3060,29 @@ var Movie = class {
    * Where every layer is drawn at `frame` (canvas pixels, visibility) plus `issues` — text that is off
    * the canvas, cut by an edge, empty, or overlapping other text. Seeks there and stays there.
    */
+  /**
+   * What is under the canvas point (x, y) (canvas pixels: the movie's own `width` x `height`; `canvasPoint(event)` makes them from a pointer event) at the frame on screen: the layer on
+   * top, or null. A flat layer is hit by its own shape, a `threeD` card by its projected quad, a `three` layer by a ray through its camera (`hit.three` has the object). It reads the
+   * frame as the last draw left it, so after `await movie.snapshot(frame)` or any seek it answers for that frame. `opts.only` / `opts.ignore`: layer names or paths.
+   */
+  pick(x, y, opts = {}) {
+    return this.pickAll(x, y, opts)[0] ?? null;
+  }
+  /** Every layer under the canvas point, the one on top first (see `pick`). */
+  pickAll(x, y, opts = {}) {
+    warnUnknownOptions("movie.pick()", opts, ["only", "ignore"]);
+    this._requireReady("pick");
+    if (!Number.isFinite(x) || !Number.isFinite(y)) throw new Error(`pixi-effects: movie.pick(x, y) needs two numbers (canvas pixels), got ${x}, ${y}. For a pointer event: movie.pick(...movie.canvasPoint(event))`);
+    return pickScene(this._rootSequence, x, y, opts);
+  }
+  /** A pointer event's place in canvas pixels (the canvas may be shown larger or smaller than its own size): `movie.pick(...movie.canvasPoint(event))`. */
+  canvasPoint(event) {
+    this._requireReady("canvasPoint");
+    const canvas = this.app?.canvas;
+    if (!canvas) throw new Error("pixi-effects: movie.canvasPoint needs the movie's canvas");
+    const r = canvas.getBoundingClientRect();
+    return [(event.clientX - r.left) * this.width / (r.width || this.width), (event.clientY - r.top) * this.height / (r.height || this.height)];
+  }
   async inspect(frame = this.currentFrame, opts = { layers: "visible" }) {
     warnUnknownOptions("movie.inspect()", opts, ["layers"]);
     this._requireReady("inspect");
@@ -4485,5 +4582,5 @@ function withFade(spec, opts) {
 }
 
 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-CT5CZVT5.js.map
-//# sourceMappingURL=chunk-CT5CZVT5.js.map
+//# sourceMappingURL=chunk-Y2N6U3X5.js.map
+//# sourceMappingURL=chunk-Y2N6U3X5.js.map