pixi-effects 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,79 @@
+import { I as ImageSequenceSpec } from './Movie-Bp66rkaC.cjs';
+export { A as AssetSpec, a as AudioSequenceSpec, C as ChromaKeyFilterSpec, b as CircleShapeSpec, c as CompositionSequenceSpec, d as CompositionSpec, e as CrossfadeTransition, f as CustomFilterSpec, D as DipTransition, g as DissolveTransition, E as EllipseShapeSpec, h as Expr, F as FilterSpec, i as FrameEvent, j as IrisTransition, K as Keyframe, L as LineShapeSpec, M as Movie, k as MovieOptions, P as PathShapeSpec, l as PolygonShapeSpec, m as ProgressEvent, n as PropValue, o as Props, R as RectShapeSpec, p as RenderOptions, S as SequenceCommon, q as SequenceSpec, r as ShapeSequenceSpec, s as SlideTransition, T as TextSequenceSpec, t as TransitionCommon, u as TransitionSpec, V as VideoSequenceSpec, W as WipeTransition, Z as ZoomTransition } from './Movie-Bp66rkaC.cjs';
+import 'pixi.js';
+import 'gsap';
+
+/**
+ * Ken Burns preset for a single image. Returns an `ImageSequenceSpec` ready
+ * to drop into a composition's `sequences[]`.
+ *
+ * Four motion modes:
+ *   - `still`    : just sit at the canvas centre, fitted but unanimated.
+ *   - `scale`    : zoom in or out around an arbitrary 9-point pivot.
+ *   - `rotation` : gentle rotation while keeping the image filling the
+ *                  canvas (the scale is over-set so even at the steepest
+ *                  rotation the bounding box still covers).
+ *   - `position` : pan the image between two points within its over-scaled
+ *                  bounds (corner-to-corner by default).
+ *
+ * The image fits the canvas by `cover` (default) or `contain` — both
+ * computed at runtime from the texture's intrinsic size, so you don't pass
+ * `imageWidth` / `imageHeight`. Position keyframes assume the image is
+ * anchored at its centre (anchor 0.5/0.5).
+ *
+ * Note: this preset emits no fade keyframes; pair it with `crossfade` /
+ * `dip` / etc. transitions to chain images.
+ */
+type KenBurnsOptions = KenBurnsBase & ({
+    motion: 'still';
+} | KenBurnsScale | KenBurnsRotation | KenBurnsPosition);
+interface KenBurnsBase {
+    /** Image asset name (registered via `Movie.init({ assets })`). */
+    asset: string;
+    /** Optional sequence name for transitions / addressing. */
+    name?: string;
+    /** Start time in seconds (parent-relative). */
+    at?: number;
+    /** Length of the animation in seconds. Required. */
+    duration: number;
+    /** How the image fills the canvas. Default `'cover'`. */
+    fit?: 'cover' | 'contain';
+    /** GSAP easing name. Default `'sine.inOut'`. */
+    ease?: string;
+}
+interface KenBurnsScale {
+    motion: 'scale';
+    /**
+     * Pivot point inside the image, in [0..1] coords. The pivot stays pinned
+     * to the canvas while the rest of the image zooms around it. Default
+     * `[0.5, 0.5]` (centre). The original Yajima-Motion convention uses the
+     * 9-point grid `0.25 / 0.5 / 0.75`.
+     */
+    origin?: [number, number];
+    /** Zoom factor relative to the fitted base. Default 1.15. */
+    zoom?: number;
+    /** `'in'`: 1 → zoom (default). `'out'`: zoom → 1. */
+    direction?: 'in' | 'out';
+}
+interface KenBurnsRotation {
+    motion: 'rotation';
+    /** Total rotation in degrees. Default 8. Capped at 30. */
+    angle?: number;
+    /** `'cw'`: 0 → +angle (default). `'ccw'`: 0 → -angle. Either way it pivots through 0. */
+    direction?: 'cw' | 'ccw' | 'through';
+}
+interface KenBurnsPosition {
+    motion: 'position';
+    /**
+     * Pan start/end in [0..1] of the over-scaled bounds. `[0, 0]` = look at
+     * top-left, `[1, 1]` = look at bottom-right. Defaults to diagonal
+     * `[0.25, 0.25]` → `[0.75, 0.75]` (matches the Yajima-Motion preset).
+     */
+    from?: [number, number];
+    to?: [number, number];
+    /** Over-scale factor. Must be > 1 for any pan to be visible. Default 1.15. */
+    zoom?: number;
+}
+declare function kenBurns(opts: KenBurnsOptions): ImageSequenceSpec;
+
+export { ImageSequenceSpec, type KenBurnsOptions, kenBurns };

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+import { I as ImageSequenceSpec } from './Movie-Bp66rkaC.js';
+export { A as AssetSpec, a as AudioSequenceSpec, C as ChromaKeyFilterSpec, b as CircleShapeSpec, c as CompositionSequenceSpec, d as CompositionSpec, e as CrossfadeTransition, f as CustomFilterSpec, D as DipTransition, g as DissolveTransition, E as EllipseShapeSpec, h as Expr, F as FilterSpec, i as FrameEvent, j as IrisTransition, K as Keyframe, L as LineShapeSpec, M as Movie, k as MovieOptions, P as PathShapeSpec, l as PolygonShapeSpec, m as ProgressEvent, n as PropValue, o as Props, R as RectShapeSpec, p as RenderOptions, S as SequenceCommon, q as SequenceSpec, r as ShapeSequenceSpec, s as SlideTransition, T as TextSequenceSpec, t as TransitionCommon, u as TransitionSpec, V as VideoSequenceSpec, W as WipeTransition, Z as ZoomTransition } from './Movie-Bp66rkaC.js';
+import 'pixi.js';
+import 'gsap';
+
+/**
+ * Ken Burns preset for a single image. Returns an `ImageSequenceSpec` ready
+ * to drop into a composition's `sequences[]`.
+ *
+ * Four motion modes:
+ *   - `still`    : just sit at the canvas centre, fitted but unanimated.
+ *   - `scale`    : zoom in or out around an arbitrary 9-point pivot.
+ *   - `rotation` : gentle rotation while keeping the image filling the
+ *                  canvas (the scale is over-set so even at the steepest
+ *                  rotation the bounding box still covers).
+ *   - `position` : pan the image between two points within its over-scaled
+ *                  bounds (corner-to-corner by default).
+ *
+ * The image fits the canvas by `cover` (default) or `contain` — both
+ * computed at runtime from the texture's intrinsic size, so you don't pass
+ * `imageWidth` / `imageHeight`. Position keyframes assume the image is
+ * anchored at its centre (anchor 0.5/0.5).
+ *
+ * Note: this preset emits no fade keyframes; pair it with `crossfade` /
+ * `dip` / etc. transitions to chain images.
+ */
+type KenBurnsOptions = KenBurnsBase & ({
+    motion: 'still';
+} | KenBurnsScale | KenBurnsRotation | KenBurnsPosition);
+interface KenBurnsBase {
+    /** Image asset name (registered via `Movie.init({ assets })`). */
+    asset: string;
+    /** Optional sequence name for transitions / addressing. */
+    name?: string;
+    /** Start time in seconds (parent-relative). */
+    at?: number;
+    /** Length of the animation in seconds. Required. */
+    duration: number;
+    /** How the image fills the canvas. Default `'cover'`. */
+    fit?: 'cover' | 'contain';
+    /** GSAP easing name. Default `'sine.inOut'`. */
+    ease?: string;
+}
+interface KenBurnsScale {
+    motion: 'scale';
+    /**
+     * Pivot point inside the image, in [0..1] coords. The pivot stays pinned
+     * to the canvas while the rest of the image zooms around it. Default
+     * `[0.5, 0.5]` (centre). The original Yajima-Motion convention uses the
+     * 9-point grid `0.25 / 0.5 / 0.75`.
+     */
+    origin?: [number, number];
+    /** Zoom factor relative to the fitted base. Default 1.15. */
+    zoom?: number;
+    /** `'in'`: 1 → zoom (default). `'out'`: zoom → 1. */
+    direction?: 'in' | 'out';
+}
+interface KenBurnsRotation {
+    motion: 'rotation';
+    /** Total rotation in degrees. Default 8. Capped at 30. */
+    angle?: number;
+    /** `'cw'`: 0 → +angle (default). `'ccw'`: 0 → -angle. Either way it pivots through 0. */
+    direction?: 'cw' | 'ccw' | 'through';
+}
+interface KenBurnsPosition {
+    motion: 'position';
+    /**
+     * Pan start/end in [0..1] of the over-scaled bounds. `[0, 0]` = look at
+     * top-left, `[1, 1]` = look at bottom-right. Defaults to diagonal
+     * `[0.25, 0.25]` → `[0.75, 0.75]` (matches the Yajima-Motion preset).
+     */
+    from?: [number, number];
+    to?: [number, number];
+    /** Over-scale factor. Must be > 1 for any pan to be visible. Default 1.15. */
+    zoom?: number;
+}
+declare function kenBurns(opts: KenBurnsOptions): ImageSequenceSpec;
+
+export { ImageSequenceSpec, type KenBurnsOptions, kenBurns };