pixi-effects 0.18.0 → 0.19.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-export { A as AudioInspectOptions, a as AudioReport, b as AudioSourceReport, C as ContactSheetOptions, F as FontReport, c as FrameEvent, I as InspectOptions, d as InspectReport, e as IssueGroup, L as LayerInfo, f as LoaderOption, M as MotionBlurOptions, g as MotionBlurSpec, h as Movie, i as MovieErrorEvent, j as MovieOptions, O as OnionSkinOptions, P as ProgressEvent, R as RenderOptions, k as ReviewOptions, l as ReviewReport, S as SnapshotOptions, m as SoundMeasure, n as StopEvent, o as StopImage, p as StopImagesOptions, T as TimelineData, q as TimelineHtmlOptions, r as TimelineRow, s as TimelineSvgOptions, t as TimelineTransition, V as VolumeEvent, u as dismissLoader, v as failLoader, w as resolveLoader } from './Movie-K2YuVAdg.cjs';
-import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as CameraSequenceSpec, K as Keyframe, T as TextSequenceSpec, M as MusicOptions, P as Props, b as TransitionSpec, c as CompositionSpec, d as SequenceCommon } from './types-SS51lP6O.cjs';
-export { A as ArcShapeSpec, e as AssetSpec, f as AudioAssetSpec, g as AudioMusicSpec, h as AudioSequenceSpec, i as AudioSfxSpec, j as ChromaKeyFilterSpec, k as CircleShapeSpec, l as CompositionSequenceSpec, m as CrossfadeTransition, n as CustomFilterSpec, D as DipTransition, o as DissolveTransition, E as EllipseShapeSpec, p as Expr, F as FilterSpec, G as GradientSpec, q as IrisTransition, L as LineShapeSpec, r as MusicDrum, s as MusicDrums, t as MusicInstrument, u as MusicLevel, v as MusicTrack, N as NullSequenceSpec, w as PathShapeSpec, x as PolygonShapeSpec, y as PropValue, R as RectShapeSpec, z as SfxKnobs, B as SfxOptions, H as SfxPreset, J as SfxVoice, O as ShapeSequenceSpec, Q as SlideTransition, U as Stop, V as StopSpec, W as TransitionCommon, X as VideoSequenceSpec, Y as WipeTransition, Z as ZoomTransition, _ as normalizeStops, $ as pictureStops } from './types-SS51lP6O.cjs';
-import { S as Sequence } from './Base-OHqp8qvX.cjs';
+export { A as AudioInspectOptions, a as AudioReport, b as AudioSourceReport, C as ContactSheetOptions, F as FontReport, c as FrameEvent, I as InspectOptions, d as InspectReport, e as IssueGroup, L as LayerInfo, f as LoaderOption, M as MotionBlurOptions, g as MotionBlurSpec, h as Movie, i as MovieErrorEvent, j as MovieOptions, O as OnionSkinOptions, P as ProgressEvent, R as RenderOptions, k as ReviewOptions, l as ReviewReport, S as SnapshotOptions, m as SoundMeasure, n as StopEvent, o as StopImage, p as StopImagesOptions, T as TimelineData, q as TimelineHtmlOptions, r as TimelineRow, s as TimelineSvgOptions, t as TimelineTransition, V as VolumeEvent, u as dismissLoader, v as failLoader, w as resolveLoader } from './Movie-CpmdNadg.cjs';
+import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as CameraSequenceSpec, K as Keyframe, T as TextSequenceSpec, M as MusicOptions, P as Props, b as TransitionSpec, c as CompositionSpec, d as SequenceCommon } from './types-bzLJ7aUx.cjs';
+export { A as ArcShapeSpec, e as AssetSpec, f as AudioAssetSpec, g as AudioMusicSpec, h as AudioSequenceSpec, i as AudioSfxSpec, j as ChromaKeyFilterSpec, k as CircleShapeSpec, l as CompositionSequenceSpec, m as CrossfadeTransition, n as CustomFilterSpec, D as DipTransition, o as DissolveTransition, E as EllipseShapeSpec, p as Expr, F as FilterSpec, G as GradientSpec, q as IrisTransition, L as LineShapeSpec, r as MusicDrum, s as MusicDrums, t as MusicInstrument, u as MusicLevel, v as MusicTrack, N as NullSequenceSpec, w as PathShapeSpec, x as PolygonShapeSpec, y as PropValue, R as RectShapeSpec, z as SfxKnobs, B as SfxOptions, H as SfxPreset, J as SfxVoice, O as ShapeSequenceSpec, Q as SlideTransition, U as Stop, V as StopSpec, W as TransitionCommon, X as VideoSequenceSpec, Y as WipeTransition, Z as ZoomTransition, _ as normalizeStops, $ as pictureStops } from './types-bzLJ7aUx.cjs';
+import { S as Sequence } from './Base-i88XXaiP.cjs';
 import 'pixi.js';
 import 'gsap';
 
@@ -419,7 +419,7 @@ interface AnimateTextOptions {
     duration: number;
     /** How a piece arrives: a preset (`'rise'` default, `'drop'`, `'fade'`, `'pop'`, `'zoom'`, `'slide'`, `'spin'`), your own tween, or `false` for none. */
     in?: TextPreset | AnimateTextTween | false;
-    /** How a piece leaves, in the same wave (the entrance backwards, eased the other way). Default none. */
+    /** How a piece leaves, in the same wave (the entrance backwards, eased the other way). It leaves from the END of the layer (`at + duration`) and has no `at` of its own: to be gone at time T, set `duration` to T − `at`. Default none. */
     out?: TextPreset | AnimateTextTween | false;
     /** The wave: see {@link stagger}. Default `{ each: 0.04 }`. */
     stagger?: StaggerOptions;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export { A as AudioInspectOptions, a as AudioReport, b as AudioSourceReport, C as ContactSheetOptions, F as FontReport, c as FrameEvent, I as InspectOptions, d as InspectReport, e as IssueGroup, L as LayerInfo, f as LoaderOption, M as MotionBlurOptions, g as MotionBlurSpec, h as Movie, i as MovieErrorEvent, j as MovieOptions, O as OnionSkinOptions, P as ProgressEvent, R as RenderOptions, k as ReviewOptions, l as ReviewReport, S as SnapshotOptions, m as SoundMeasure, n as StopEvent, o as StopImage, p as StopImagesOptions, T as TimelineData, q as TimelineHtmlOptions, r as TimelineRow, s as TimelineSvgOptions, t as TimelineTransition, V as VolumeEvent, u as dismissLoader, v as failLoader, w as resolveLoader } from './Movie-DlHQ9C02.js';
-import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as CameraSequenceSpec, K as Keyframe, T as TextSequenceSpec, M as MusicOptions, P as Props, b as TransitionSpec, c as CompositionSpec, d as SequenceCommon } from './types-SS51lP6O.js';
-export { A as ArcShapeSpec, e as AssetSpec, f as AudioAssetSpec, g as AudioMusicSpec, h as AudioSequenceSpec, i as AudioSfxSpec, j as ChromaKeyFilterSpec, k as CircleShapeSpec, l as CompositionSequenceSpec, m as CrossfadeTransition, n as CustomFilterSpec, D as DipTransition, o as DissolveTransition, E as EllipseShapeSpec, p as Expr, F as FilterSpec, G as GradientSpec, q as IrisTransition, L as LineShapeSpec, r as MusicDrum, s as MusicDrums, t as MusicInstrument, u as MusicLevel, v as MusicTrack, N as NullSequenceSpec, w as PathShapeSpec, x as PolygonShapeSpec, y as PropValue, R as RectShapeSpec, z as SfxKnobs, B as SfxOptions, H as SfxPreset, J as SfxVoice, O as ShapeSequenceSpec, Q as SlideTransition, U as Stop, V as StopSpec, W as TransitionCommon, X as VideoSequenceSpec, Y as WipeTransition, Z as ZoomTransition, _ as normalizeStops, $ as pictureStops } from './types-SS51lP6O.js';
-import { S as Sequence } from './Base-BQUodYZK.js';
+export { A as AudioInspectOptions, a as AudioReport, b as AudioSourceReport, C as ContactSheetOptions, F as FontReport, c as FrameEvent, I as InspectOptions, d as InspectReport, e as IssueGroup, L as LayerInfo, f as LoaderOption, M as MotionBlurOptions, g as MotionBlurSpec, h as Movie, i as MovieErrorEvent, j as MovieOptions, O as OnionSkinOptions, P as ProgressEvent, R as RenderOptions, k as ReviewOptions, l as ReviewReport, S as SnapshotOptions, m as SoundMeasure, n as StopEvent, o as StopImage, p as StopImagesOptions, T as TimelineData, q as TimelineHtmlOptions, r as TimelineRow, s as TimelineSvgOptions, t as TimelineTransition, V as VolumeEvent, u as dismissLoader, v as failLoader, w as resolveLoader } from './Movie-8IrqL3kO.js';
+import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as CameraSequenceSpec, K as Keyframe, T as TextSequenceSpec, M as MusicOptions, P as Props, b as TransitionSpec, c as CompositionSpec, d as SequenceCommon } from './types-bzLJ7aUx.js';
+export { A as ArcShapeSpec, e as AssetSpec, f as AudioAssetSpec, g as AudioMusicSpec, h as AudioSequenceSpec, i as AudioSfxSpec, j as ChromaKeyFilterSpec, k as CircleShapeSpec, l as CompositionSequenceSpec, m as CrossfadeTransition, n as CustomFilterSpec, D as DipTransition, o as DissolveTransition, E as EllipseShapeSpec, p as Expr, F as FilterSpec, G as GradientSpec, q as IrisTransition, L as LineShapeSpec, r as MusicDrum, s as MusicDrums, t as MusicInstrument, u as MusicLevel, v as MusicTrack, N as NullSequenceSpec, w as PathShapeSpec, x as PolygonShapeSpec, y as PropValue, R as RectShapeSpec, z as SfxKnobs, B as SfxOptions, H as SfxPreset, J as SfxVoice, O as ShapeSequenceSpec, Q as SlideTransition, U as Stop, V as StopSpec, W as TransitionCommon, X as VideoSequenceSpec, Y as WipeTransition, Z as ZoomTransition, _ as normalizeStops, $ as pictureStops } from './types-bzLJ7aUx.js';
+import { S as Sequence } from './Base-B4WbUJO2.js';
 import 'pixi.js';
 import 'gsap';
 
@@ -419,7 +419,7 @@ interface AnimateTextOptions {
     duration: number;
     /** How a piece arrives: a preset (`'rise'` default, `'drop'`, `'fade'`, `'pop'`, `'zoom'`, `'slide'`, `'spin'`), your own tween, or `false` for none. */
     in?: TextPreset | AnimateTextTween | false;
-    /** How a piece leaves, in the same wave (the entrance backwards, eased the other way). Default none. */
+    /** How a piece leaves, in the same wave (the entrance backwards, eased the other way). It leaves from the END of the layer (`at + duration`) and has no `at` of its own: to be gone at time T, set `duration` to T − `at`. Default none. */
     out?: TextPreset | AnimateTextTween | false;
     /** The wave: see {@link stagger}. Default `{ each: 0.04 }`. */
     stagger?: StaggerOptions;

package/dist/index.js

@@ -1,6 +1,6 @@
-import { CompositionSequence } from './chunk-UXDR3ZDU.js';
-import { ensureFilterLibrary, homeDistance, DEFAULT_FOV, random, noise, flattenSvgPath, rand, DEG, resolveAt, checkEase, collectPropKeys } from './chunk-SG3Y66FN.js';
-export { noise, rand, random, registerSequenceType } from './chunk-SG3Y66FN.js';
+import { CompositionSequence } from './chunk-B3YB2TNY.js';
+import { ensureFilterLibrary, homeDistance, DEFAULT_FOV, random, noise, flattenSvgPath, rand, DEG, resolveAt, checkEase, collectPropKeys } from './chunk-YRXTKOV5.js';
+export { noise, rand, random, registerSequenceType } from './chunk-YRXTKOV5.js';
 import { warnUnknownOptions, suggestName } from './chunk-DKGG7WD4.js';
 import * as PIXI from 'pixi.js';
 import { extensions, CullerPlugin, Application, Container, Rectangle, Culler, CanvasTextMetrics, TextStyle, Assets, ExtensionType, Filter, UniformGroup, GpuProgram, GlProgram, defaultFilterVert } from 'pixi.js';
@@ -469,6 +469,14 @@ function namedScenes(rows) {
   return rows.filter((r) => r.depth === 0 && r.type === "composition" && !/[#×]/.test(r.name) && r.end - r.start >= 1).map((r) => ({ name: r.name, start: r.start, end: r.end }));
 }
 
+// src/core/timeFilters.ts
+function collectTimeFilters(seq, out = []) {
+  for (const f of seq.filters ?? []) if (typeof f.setTime === "function") out.push(f);
+  if (seq.maskSequence) collectTimeFilters(seq.maskSequence, out);
+  for (const child of seq._children ?? []) collectTimeFilters(child, out);
+  return out;
+}
+
 // src/core/review.ts
 function sampleFrames({ totalFrames, frameRate, scenes = [], step = 0.25, cap = 240 }) {
   const last = totalFrames;
@@ -2074,6 +2082,15 @@ var Movie = class {
   background = "#000000";
   _audioContext = null;
   _rootSequence = null;
+  /** The filters that take the time of the frame they draw (`grain`), collected once after the build. */
+  _timeFilters = [];
+  /** While a motion-blurred frame is exposed: the frame's own time, so all its sub-frames share one grain frame (and not the playhead's). */
+  _nominalTime = null;
+  _feedTimeFilters() {
+    if (!this._timeFilters.length) return;
+    const t = this._nominalTime ?? this._timeOf(this.currentFrame);
+    for (const f of this._timeFilters) f.setTime(t);
+  }
   _rootContainer = null;
   _raf = null;
   /** What went into the mix, and its peak before limiting — kept for inspectAudio(). */
@@ -2205,6 +2222,7 @@ var Movie = class {
       this._rootSequence = composition;
       if (composition.target) root.addChild(composition.target);
       composition.bindTimeline(this.timeline);
+      this._timeFilters = collectTimeFilters(composition);
       const audios = [];
       composition.collectAudio(audios, 0);
       if (audios.length > 0) {
@@ -2542,6 +2560,7 @@ var Movie = class {
     if (!app?.renderer) return;
     if (!this._synced) this._rootSequence?.syncFrame();
     this._synced = false;
+    this._feedTimeFilters();
     Culler.shared.cull(app.stage, app.renderer.screen, false);
     app.renderer.render({ container: app.stage });
   }
@@ -2558,6 +2577,7 @@ var Movie = class {
    * the frame before (after a jump seek, a card whose children were animated showed a stale picture).
    */
   _updateSpace(t = this._timeOf(this.currentFrame)) {
+    this._feedTimeFilters();
     if (!this._rootSequence || !this.app) return;
     this._rootSequence.syncFrame();
     this._synced = true;
@@ -2576,15 +2596,20 @@ var Movie = class {
     const stage = this.app.canvas;
     this._atPoster = false;
     const times = blurTimes(frame, this.frameRate, mb, Math.max(0, this.duration - END_MARGIN));
-    for (let k = 0; k < times.length; k++) {
-      const t = times[k];
-      this.timeline.time(t);
-      await this._awaitVideoFrames(t);
-      this._updateSpace(t);
-      this._renderNow();
-      if (k === 0) g.clearRect(0, 0, target.width, target.height);
-      g.globalAlpha = 1 / (k + 1);
-      g.drawImage(stage, 0, 0, target.width, target.height);
+    this._nominalTime = this._timeOf(Math.max(0, Math.min(frame, this.totalFrames)));
+    try {
+      for (let k = 0; k < times.length; k++) {
+        const t = times[k];
+        this.timeline.time(t);
+        await this._awaitVideoFrames(t);
+        this._updateSpace(t);
+        this._renderNow();
+        if (k === 0) g.clearRect(0, 0, target.width, target.height);
+        g.globalAlpha = 1 / (k + 1);
+        g.drawImage(stage, 0, 0, target.width, target.height);
+      }
+    } finally {
+      this._nominalTime = null;
     }
     g.globalAlpha = 1;
     if (settle) await this._goto(frame);
@@ -2806,6 +2831,7 @@ var Movie = class {
   }
   async destroy() {
     safeRun(() => this.pause());
+    this._timeFilters = [];
     safeRun(() => this._rootSequence?.destroy());
     this._rootSequence = null;
     safeRun(() => this.timeline?.kill());
@@ -3324,7 +3350,8 @@ function stagger(items, options = {}) {
   const max = dist2.reduce((m, d) => Math.max(m, d), 0);
   const total = amount !== void 0 ? amount : (each ?? 0.1) * max;
   const shape = parseEase(ease);
-  const delays = dist2.map((d) => max === 0 ? 0 : Math.round(total * shape(d / max) * 1e6) / 1e6);
+  const clamp01 = (v) => Math.min(1, Math.max(0, v));
+  const delays = dist2.map((d) => max === 0 ? 0 : Math.round(total * clamp01(shape(d / max)) * 1e6) / 1e6);
   if (isCount) return delays;
   return items.map((layer, i) => ({ ...layer, at: Math.round(((layer.at ?? 0) + delays[i]) * 1e6) / 1e6 }));
 }
@@ -3403,6 +3430,8 @@ function wiggle(opts) {
 }
 
 // src/presets/animateText.ts
+var TWEEN_KEYS = ["preset", "from", "to", "duration", "ease"];
+var TIME_KEYS = ["at", "delay", "start", "begin", "time"];
 var KEYS5 = ["by", "x", "y", "align", "name", "at", "duration", "in", "out", "stagger", "idle", "styleFor"];
 var PRESETS = {
   rise: { from: { y: 40, alpha: 0 }, duration: 0.5, ease: "back.out(2)" },
@@ -3486,6 +3515,14 @@ function animateText(text, style, options) {
 }
 function resolveTween(spec, which) {
   const t = typeof spec === "string" ? { preset: spec } : spec;
+  if (typeof spec === "object" && spec) {
+    for (const key of Object.keys(spec)) {
+      if (TWEEN_KEYS.includes(key)) continue;
+      if (TIME_KEYS.includes(key)) {
+        console.warn(`pixi-effects: animateText(): ${which}.${key} ("${key}") is ignored: ${which === "out" ? "an out leaves from the END of the layer (at + duration), so to make the text gone at a time T set duration to T \u2212 at" : "the entrance starts when the piece starts (the options' at, plus the stagger)"}`);
+      } else warnUnknownOptions(`animateText() ${which}`, { [key]: 1 }, TWEEN_KEYS);
+    }
+  }
   if (t.preset !== void 0 && !(t.preset in PRESETS)) {
     const guess = suggestName(String(t.preset), PRESET_NAMES);
     throw new Error(`animateText(): ${which} "${t.preset}" is not a preset${guess ? `; did you mean "${guess}"?` : ""} (presets: ${PRESET_NAMES.map((n) => `"${n}"`).join(", ")})`);