pixi-effects 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-export { F as FrameEvent, M as Movie, a as MovieOptions, P as ProgressEvent, R as RenderOptions } from './Movie-CcR6h2jO.cjs';
-import { S as Sequence } from './Base-B1Tdn0Cv.cjs';
-import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as SequenceCommon } from './types-CNBilhpz.cjs';
-export { A as AssetSpec, b as AudioSequenceSpec, c as CameraSequenceSpec, d as ChromaKeyFilterSpec, e as CircleShapeSpec, f as CompositionSequenceSpec, g as CompositionSpec, h as CrossfadeTransition, i as CustomFilterSpec, D as DipTransition, j as DissolveTransition, E as EllipseShapeSpec, k as Expr, F as FilterSpec, l as IrisTransition, K as Keyframe, L as LineShapeSpec, P as PathShapeSpec, m as PolygonShapeSpec, n as PropValue, o as Props, R as RectShapeSpec, p as ShapeSequenceSpec, q as SlideTransition, T as TextSequenceSpec, r as TransitionCommon, s as TransitionSpec, V as VideoSequenceSpec, W as WipeTransition, Z as ZoomTransition } from './types-CNBilhpz.cjs';
+export { C as ContactSheetOptions, F as FrameEvent, I as InspectOptions, a as InspectReport, L as LayerInfo, M as Movie, b as MovieOptions, P as ProgressEvent, R as RenderOptions, S as SnapshotOptions } from './Movie-CghFXprP.cjs';
+import { S as Sequence } from './Base-5R7C5pHR.cjs';
+import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as CameraSequenceSpec, b as SequenceCommon } from './types-CRE9WKd4.cjs';
+export { A as AssetSpec, c as AudioSequenceSpec, d as ChromaKeyFilterSpec, e as CircleShapeSpec, f as CompositionSequenceSpec, g as CompositionSpec, h as CrossfadeTransition, i as CustomFilterSpec, D as DipTransition, j as DissolveTransition, E as EllipseShapeSpec, k as Expr, F as FilterSpec, G as GradientSpec, l as IrisTransition, K as Keyframe, L as LineShapeSpec, P as PathShapeSpec, m as PolygonShapeSpec, n as PropValue, o as Props, R as RectShapeSpec, p as ShapeSequenceSpec, q as SlideTransition, T as TextSequenceSpec, r as TransitionCommon, s as TransitionSpec, V as VideoSequenceSpec, W as WipeTransition, Z as ZoomTransition } from './types-CRE9WKd4.cjs';
 import 'pixi.js';
 import 'gsap';
 
@@ -11,27 +11,6 @@ type SequenceCtor = {
 /** Register an external sequence type. Later registrations overwrite earlier ones. */
 declare function registerSequenceType(type: string, ctor: SequenceCtor): void;
 
-/**
- * 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);
@@ -84,10 +63,60 @@ interface KenBurnsPosition {
 }
 declare function kenBurns(opts: KenBurnsOptions): ImageSequenceSpec;
 
+interface OrbitOptions {
+    /** Length of the move in seconds. Required, > 0. */
+    duration: number;
+    /** Total sweep in degrees (negative = the other way). The camera passes straight-ahead (angle 0) in the middle when `start` is left at its default. */
+    degrees: number;
+    /** Angle the move starts at, in degrees (0 = straight in front of the centre). Default `-degrees / 2`. */
+    start?: number;
+    /** Distance from the centre. Default: the default camera distance for `height` and `fov` (so `z = 0` is 1:1 at angle 0). */
+    radius?: number;
+    /** The point to circle around and look at, in composition pixels. Default: the centre of `width` × `height`. */
+    center?: [number, number];
+    /** Composition size, used for the default `center` and `radius`. Default 1280 × 720. */
+    width?: number;
+    height?: number;
+    /** Vertical field of view, degrees. Default 40. Written to the camera. */
+    fov?: number;
+    /** Easing of the sweep as a whole (any GSAP ease). Default `'sine.inOut'`. */
+    ease?: string;
+    /**
+     * A dolly zoom while orbiting: `fov` animates from `from` to `to` (degrees) and the radius follows it
+     * (`R = (height/2) / tan(fov/2)`), so the `z = 0` plane keeps its size while the perspective changes.
+     * Cannot be combined with `radius`. `ease` defaults to the sweep's ease.
+     */
+    dollyZoom?: {
+        from: number;
+        to: number;
+        ease?: string;
+    };
+    /** Start time in seconds (composition time, like any layer). */
+    at?: number;
+    name?: string;
+    /** Sampling density. Default one segment per 0.1 s. */
+    stepsPerSecond?: number;
+}
+/**
+ * A camera that orbits a point. There is no per-frame expression in the DSL, so the circle is sampled
+ * into short linear keyframes (the easing is applied to the angle). Drop the result into `sequences[]`
+ * next to `threeD` layers.
+ *
+ * ```ts
+ * orbit({ duration: 6, degrees: 40 })                       // sweep ±20° around the centre
+ * orbit({ duration: 4, degrees: 90, start: 0, radius: 900 })
+ * ```
+ *
+ * `z` is specified, so it no longer follows `fov`. For a dolly zoom WHILE orbiting pass
+ * `dollyZoom: { from: 38, to: 64 }`: `fov` animates and the radius follows it (`z = (H/2) / tan(fov/2)`),
+ * keeping the `z = 0` plane the same size.
+ */
+declare function orbit(opts: OrbitOptions): CameraSequenceSpec;
+
 interface WithFadeOptions {
-    /** Fade-in duration (seconds), anchored to the sequence's `at`. */
+    /** Fade-in duration (seconds), at the start of the sequence. */
     in?: number;
-    /** Fade-out duration (seconds), anchored to `at + duration`. Requires `duration` to be set on the spec. */
+    /** Fade-out duration (seconds), ending at the end of the sequence. Requires `duration` to be set on the spec. */
     out?: number;
 }
 /**
@@ -111,10 +140,11 @@ interface WithFadeOptions {
  * The added keyframes are layered on top of any keyframes the spec already
  * has — kenBurns's scale / position / rotation tweens keep working.
  *
- * The keyframe `at` values use the sequence's own `at` and `at + duration`,
- * which the runtime interprets parent-relative. Works the same whether the
- * spec sits directly under the root composition or nested inside another.
+ * Keyframe `at` is sequence-local: the fade-in starts at 0 and the fade-out
+ * at `duration - out`, whatever the sequence's own `at` is. Works the same
+ * whether the spec sits directly under the root composition or nested inside
+ * another.
  */
 declare function withFade<T extends SequenceCommon>(spec: T, opts: WithFadeOptions): T;
 
-export { ImageSequenceSpec, type KenBurnsOptions, SequenceCommon, type SequenceCtor, SequenceSpec, type WithFadeOptions, kenBurns, registerSequenceType, withFade };
+export { CameraSequenceSpec, ImageSequenceSpec, type KenBurnsOptions, type OrbitOptions, SequenceCommon, type SequenceCtor, SequenceSpec, type WithFadeOptions, kenBurns, orbit, registerSequenceType, withFade };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export { F as FrameEvent, M as Movie, a as MovieOptions, P as ProgressEvent, R as RenderOptions } from './Movie-D-n8glA6.js';
-import { S as Sequence } from './Base-Bh_VSusi.js';
-import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as SequenceCommon } from './types-CNBilhpz.js';
-export { A as AssetSpec, b as AudioSequenceSpec, c as CameraSequenceSpec, d as ChromaKeyFilterSpec, e as CircleShapeSpec, f as CompositionSequenceSpec, g as CompositionSpec, h as CrossfadeTransition, i as CustomFilterSpec, D as DipTransition, j as DissolveTransition, E as EllipseShapeSpec, k as Expr, F as FilterSpec, l as IrisTransition, K as Keyframe, L as LineShapeSpec, P as PathShapeSpec, m as PolygonShapeSpec, n as PropValue, o as Props, R as RectShapeSpec, p as ShapeSequenceSpec, q as SlideTransition, T as TextSequenceSpec, r as TransitionCommon, s as TransitionSpec, V as VideoSequenceSpec, W as WipeTransition, Z as ZoomTransition } from './types-CNBilhpz.js';
+export { C as ContactSheetOptions, F as FrameEvent, I as InspectOptions, a as InspectReport, L as LayerInfo, M as Movie, b as MovieOptions, P as ProgressEvent, R as RenderOptions, S as SnapshotOptions } from './Movie-DRZtIGU7.js';
+import { S as Sequence } from './Base-DhY9oMxr.js';
+import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as CameraSequenceSpec, b as SequenceCommon } from './types-CRE9WKd4.js';
+export { A as AssetSpec, c as AudioSequenceSpec, d as ChromaKeyFilterSpec, e as CircleShapeSpec, f as CompositionSequenceSpec, g as CompositionSpec, h as CrossfadeTransition, i as CustomFilterSpec, D as DipTransition, j as DissolveTransition, E as EllipseShapeSpec, k as Expr, F as FilterSpec, G as GradientSpec, l as IrisTransition, K as Keyframe, L as LineShapeSpec, P as PathShapeSpec, m as PolygonShapeSpec, n as PropValue, o as Props, R as RectShapeSpec, p as ShapeSequenceSpec, q as SlideTransition, T as TextSequenceSpec, r as TransitionCommon, s as TransitionSpec, V as VideoSequenceSpec, W as WipeTransition, Z as ZoomTransition } from './types-CRE9WKd4.js';
 import 'pixi.js';
 import 'gsap';
 
@@ -11,27 +11,6 @@ type SequenceCtor = {
 /** Register an external sequence type. Later registrations overwrite earlier ones. */
 declare function registerSequenceType(type: string, ctor: SequenceCtor): void;
 
-/**
- * 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);
@@ -84,10 +63,60 @@ interface KenBurnsPosition {
 }
 declare function kenBurns(opts: KenBurnsOptions): ImageSequenceSpec;
 
+interface OrbitOptions {
+    /** Length of the move in seconds. Required, > 0. */
+    duration: number;
+    /** Total sweep in degrees (negative = the other way). The camera passes straight-ahead (angle 0) in the middle when `start` is left at its default. */
+    degrees: number;
+    /** Angle the move starts at, in degrees (0 = straight in front of the centre). Default `-degrees / 2`. */
+    start?: number;
+    /** Distance from the centre. Default: the default camera distance for `height` and `fov` (so `z = 0` is 1:1 at angle 0). */
+    radius?: number;
+    /** The point to circle around and look at, in composition pixels. Default: the centre of `width` × `height`. */
+    center?: [number, number];
+    /** Composition size, used for the default `center` and `radius`. Default 1280 × 720. */
+    width?: number;
+    height?: number;
+    /** Vertical field of view, degrees. Default 40. Written to the camera. */
+    fov?: number;
+    /** Easing of the sweep as a whole (any GSAP ease). Default `'sine.inOut'`. */
+    ease?: string;
+    /**
+     * A dolly zoom while orbiting: `fov` animates from `from` to `to` (degrees) and the radius follows it
+     * (`R = (height/2) / tan(fov/2)`), so the `z = 0` plane keeps its size while the perspective changes.
+     * Cannot be combined with `radius`. `ease` defaults to the sweep's ease.
+     */
+    dollyZoom?: {
+        from: number;
+        to: number;
+        ease?: string;
+    };
+    /** Start time in seconds (composition time, like any layer). */
+    at?: number;
+    name?: string;
+    /** Sampling density. Default one segment per 0.1 s. */
+    stepsPerSecond?: number;
+}
+/**
+ * A camera that orbits a point. There is no per-frame expression in the DSL, so the circle is sampled
+ * into short linear keyframes (the easing is applied to the angle). Drop the result into `sequences[]`
+ * next to `threeD` layers.
+ *
+ * ```ts
+ * orbit({ duration: 6, degrees: 40 })                       // sweep ±20° around the centre
+ * orbit({ duration: 4, degrees: 90, start: 0, radius: 900 })
+ * ```
+ *
+ * `z` is specified, so it no longer follows `fov`. For a dolly zoom WHILE orbiting pass
+ * `dollyZoom: { from: 38, to: 64 }`: `fov` animates and the radius follows it (`z = (H/2) / tan(fov/2)`),
+ * keeping the `z = 0` plane the same size.
+ */
+declare function orbit(opts: OrbitOptions): CameraSequenceSpec;
+
 interface WithFadeOptions {
-    /** Fade-in duration (seconds), anchored to the sequence's `at`. */
+    /** Fade-in duration (seconds), at the start of the sequence. */
     in?: number;
-    /** Fade-out duration (seconds), anchored to `at + duration`. Requires `duration` to be set on the spec. */
+    /** Fade-out duration (seconds), ending at the end of the sequence. Requires `duration` to be set on the spec. */
     out?: number;
 }
 /**
@@ -111,10 +140,11 @@ interface WithFadeOptions {
  * The added keyframes are layered on top of any keyframes the spec already
  * has — kenBurns's scale / position / rotation tweens keep working.
  *
- * The keyframe `at` values use the sequence's own `at` and `at + duration`,
- * which the runtime interprets parent-relative. Works the same whether the
- * spec sits directly under the root composition or nested inside another.
+ * Keyframe `at` is sequence-local: the fade-in starts at 0 and the fade-out
+ * at `duration - out`, whatever the sequence's own `at` is. Works the same
+ * whether the spec sits directly under the root composition or nested inside
+ * another.
  */
 declare function withFade<T extends SequenceCommon>(spec: T, opts: WithFadeOptions): T;
 
-export { ImageSequenceSpec, type KenBurnsOptions, SequenceCommon, type SequenceCtor, SequenceSpec, type WithFadeOptions, kenBurns, registerSequenceType, withFade };
+export { CameraSequenceSpec, ImageSequenceSpec, type KenBurnsOptions, type OrbitOptions, SequenceCommon, type SequenceCtor, SequenceSpec, type WithFadeOptions, kenBurns, orbit, registerSequenceType, withFade };