pixi-effects 0.7.0 → 0.9.0

package/dist/{Movie-B0OUKlZI.d.ts → Movie-QMlFyHkf.d.ts}

@@ -140,6 +140,12 @@ interface MovieOptions {
     canvas?: HTMLCanvasElement;
     assets?: AssetSpec[];
     composition?: CompositionSpec;
+    /**
+     * The poster time in seconds: the moment that stands for the movie before it plays. The canvas shows that frame once the movie is
+     * ready, the playhead stays at 0 and play starts from 0 (like `<video poster>`); `movie.posterImage()` is that picture. A negative
+     * value counts back from the end. Default: none (the first frame).
+     */
+    poster?: number;
 }
 interface RenderOptions {
     format?: 'mp4' | 'mov' | 'webm' | 'mkv';
@@ -182,6 +188,17 @@ interface ProgressEvent {
     frame: number;
     totalFrames: number;
 }
+/** `volumechange`: the values after the change. */
+interface VolumeEvent {
+    volume: number;
+    muted: boolean;
+}
+/** `error`: something failed in `init()`, `render()` or during playback. The call that failed still rejects / warns as before. */
+interface MovieErrorEvent {
+    where: 'init' | 'render' | 'playback';
+    message: string;
+    error: unknown;
+}
 type Listener = (...args: any[]) => void;
 declare class Movie {
     private _events;
@@ -192,6 +209,13 @@ declare class Movie {
     audioSource: AudioBufferSourceNode | null;
     gainNode: GainNode | null;
     private _cancelAudioStart;
+    /** The poster time in seconds (`movie.init({ poster })`), or null. */
+    poster: number | null;
+    private _posterFrame;
+    /** The canvas shows the poster picture while the playhead is still at frame 0 (like `<video poster>`): the first seek or play replaces it. */
+    private _atPoster;
+    /** > 0 while the movie moves its own playhead (playback, render, snapshot, contactSheet): those are not the seeks `seeking` / `seeked` report. */
+    private _quiet;
     private _volume;
     private _muted;
     isPlaying: boolean;
@@ -211,15 +235,39 @@ declare class Movie {
     private _mixStats;
     on(event: 'ready', fn: () => void): this;
     on(event: 'frame', fn: (e: FrameEvent) => void): this;
+    /** A jump to another frame (`gotoFrame`, a seek bar) starts / finishes. Not emitted for playback ticks, `render()`, `snapshot()` or `contactSheet()`. */
+    on(event: 'seeking' | 'seeked', fn: (e: FrameEvent) => void): this;
+    /** Playback ran off the end (after `pause`). Pausing by hand does not emit it. */
+    on(event: 'ended', fn: () => void): this;
+    on(event: 'volumechange', fn: (e: VolumeEvent) => void): this;
+    on(event: 'error', fn: (e: MovieErrorEvent) => void): this;
     on(event: 'progress', fn: (e: ProgressEvent) => void): this;
     on(event: 'play', fn: () => void): this;
     on(event: 'pause', fn: () => void): this;
     off(event: string, fn: Listener): this;
     emit(event: string, ...args: unknown[]): void;
     get isReady(): boolean;
+    /** The poster time as a frame number, or null. */
+    get posterFrame(): number | null;
+    /** Draw the poster frame on the canvas and leave the playhead where it is (frame 0): the picture before the movie plays. */
+    private _showPoster;
+    /**
+     * The picture at the poster time (frame 0 if the movie has none), as `snapshot()` returns it, and the movie is left as it was:
+     * still showing the poster, or back at the frame it was at.
+     */
+    posterImage(opts?: SnapshotOptions & {
+        as?: 'blob';
+    }): Promise<Blob>;
+    posterImage(opts: SnapshotOptions & {
+        as: 'dataURL';
+    }): Promise<string>;
     private _ensureAudioContext;
     init(options?: MovieOptions): Promise<void>;
     gotoFrame(frame: number, force?: boolean): Promise<void>;
+    /** Run `fn` with `seeking` / `seeked` silenced: the movie is moving its own playhead, not answering a seek. */
+    private _quietly;
+    private _emitError;
+    private _goto;
     private _awaitVideoFrames;
     /**
      * A picture of one frame (the canvas only: the player bar is not included). Seeks there first and
@@ -282,4 +330,4 @@ declare class Movie {
     destroy(): Promise<void>;
 }
 
-export { type AudioInspectOptions as A, type ContactSheetOptions as C, type FrameEvent as F, type InspectOptions as I, type LayerInfo as L, Movie as M, type ProgressEvent as P, type RenderOptions as R, type SnapshotOptions as S, type TimelineData as T, type AudioReport as a, type AudioSourceReport as b, type InspectReport as c, type MovieOptions as d, type SoundMeasure as e, type TimelineHtmlOptions as f, type TimelineRow as g, type TimelineSvgOptions as h, type TimelineTransition as i };
+export { type AudioInspectOptions as A, type ContactSheetOptions as C, type FrameEvent as F, type InspectOptions as I, type LayerInfo as L, Movie as M, type ProgressEvent as P, type RenderOptions as R, type SnapshotOptions as S, type TimelineData as T, type VolumeEvent as V, type AudioReport as a, type AudioSourceReport as b, type InspectReport as c, type MovieErrorEvent as d, type MovieOptions as e, type SoundMeasure as f, type TimelineHtmlOptions as g, type TimelineRow as h, type TimelineSvgOptions as i, type TimelineTransition as j };

package/dist/{Movie-BK9daiTt.d.cts → Movie-qGHp15c_.d.cts}

@@ -140,6 +140,12 @@ interface MovieOptions {
     canvas?: HTMLCanvasElement;
     assets?: AssetSpec[];
     composition?: CompositionSpec;
+    /**
+     * The poster time in seconds: the moment that stands for the movie before it plays. The canvas shows that frame once the movie is
+     * ready, the playhead stays at 0 and play starts from 0 (like `<video poster>`); `movie.posterImage()` is that picture. A negative
+     * value counts back from the end. Default: none (the first frame).
+     */
+    poster?: number;
 }
 interface RenderOptions {
     format?: 'mp4' | 'mov' | 'webm' | 'mkv';
@@ -182,6 +188,17 @@ interface ProgressEvent {
     frame: number;
     totalFrames: number;
 }
+/** `volumechange`: the values after the change. */
+interface VolumeEvent {
+    volume: number;
+    muted: boolean;
+}
+/** `error`: something failed in `init()`, `render()` or during playback. The call that failed still rejects / warns as before. */
+interface MovieErrorEvent {
+    where: 'init' | 'render' | 'playback';
+    message: string;
+    error: unknown;
+}
 type Listener = (...args: any[]) => void;
 declare class Movie {
     private _events;
@@ -192,6 +209,13 @@ declare class Movie {
     audioSource: AudioBufferSourceNode | null;
     gainNode: GainNode | null;
     private _cancelAudioStart;
+    /** The poster time in seconds (`movie.init({ poster })`), or null. */
+    poster: number | null;
+    private _posterFrame;
+    /** The canvas shows the poster picture while the playhead is still at frame 0 (like `<video poster>`): the first seek or play replaces it. */
+    private _atPoster;
+    /** > 0 while the movie moves its own playhead (playback, render, snapshot, contactSheet): those are not the seeks `seeking` / `seeked` report. */
+    private _quiet;
     private _volume;
     private _muted;
     isPlaying: boolean;
@@ -211,15 +235,39 @@ declare class Movie {
     private _mixStats;
     on(event: 'ready', fn: () => void): this;
     on(event: 'frame', fn: (e: FrameEvent) => void): this;
+    /** A jump to another frame (`gotoFrame`, a seek bar) starts / finishes. Not emitted for playback ticks, `render()`, `snapshot()` or `contactSheet()`. */
+    on(event: 'seeking' | 'seeked', fn: (e: FrameEvent) => void): this;
+    /** Playback ran off the end (after `pause`). Pausing by hand does not emit it. */
+    on(event: 'ended', fn: () => void): this;
+    on(event: 'volumechange', fn: (e: VolumeEvent) => void): this;
+    on(event: 'error', fn: (e: MovieErrorEvent) => void): this;
     on(event: 'progress', fn: (e: ProgressEvent) => void): this;
     on(event: 'play', fn: () => void): this;
     on(event: 'pause', fn: () => void): this;
     off(event: string, fn: Listener): this;
     emit(event: string, ...args: unknown[]): void;
     get isReady(): boolean;
+    /** The poster time as a frame number, or null. */
+    get posterFrame(): number | null;
+    /** Draw the poster frame on the canvas and leave the playhead where it is (frame 0): the picture before the movie plays. */
+    private _showPoster;
+    /**
+     * The picture at the poster time (frame 0 if the movie has none), as `snapshot()` returns it, and the movie is left as it was:
+     * still showing the poster, or back at the frame it was at.
+     */
+    posterImage(opts?: SnapshotOptions & {
+        as?: 'blob';
+    }): Promise<Blob>;
+    posterImage(opts: SnapshotOptions & {
+        as: 'dataURL';
+    }): Promise<string>;
     private _ensureAudioContext;
     init(options?: MovieOptions): Promise<void>;
     gotoFrame(frame: number, force?: boolean): Promise<void>;
+    /** Run `fn` with `seeking` / `seeked` silenced: the movie is moving its own playhead, not answering a seek. */
+    private _quietly;
+    private _emitError;
+    private _goto;
     private _awaitVideoFrames;
     /**
      * A picture of one frame (the canvas only: the player bar is not included). Seeks there first and
@@ -282,4 +330,4 @@ declare class Movie {
     destroy(): Promise<void>;
 }
 
-export { type AudioInspectOptions as A, type ContactSheetOptions as C, type FrameEvent as F, type InspectOptions as I, type LayerInfo as L, Movie as M, type ProgressEvent as P, type RenderOptions as R, type SnapshotOptions as S, type TimelineData as T, type AudioReport as a, type AudioSourceReport as b, type InspectReport as c, type MovieOptions as d, type SoundMeasure as e, type TimelineHtmlOptions as f, type TimelineRow as g, type TimelineSvgOptions as h, type TimelineTransition as i };
+export { type AudioInspectOptions as A, type ContactSheetOptions as C, type FrameEvent as F, type InspectOptions as I, type LayerInfo as L, Movie as M, type ProgressEvent as P, type RenderOptions as R, type SnapshotOptions as S, type TimelineData as T, type VolumeEvent as V, type AudioReport as a, type AudioSourceReport as b, type InspectReport as c, type MovieErrorEvent as d, type MovieOptions as e, type SoundMeasure as f, type TimelineHtmlOptions as g, type TimelineRow as h, type TimelineSvgOptions as i, type TimelineTransition as j };

package/dist/{chunk-6I55T4OH.cjs → chunk-AGMNSJJH.cjs}

@@ -825,6 +825,14 @@ function colorMatrix(params) {
   if (Array.isArray(params.matrix)) f.matrix = params.matrix;
   return f;
 }
+var GRADIENT_TYPES = ["linear", "radial", "conic"];
+function colorGradientParams(params) {
+  const { gradientType, ...rest } = params;
+  if (gradientType === void 0) return rest;
+  const i = GRADIENT_TYPES.indexOf(String(gradientType));
+  if (i < 0) throw new Error(`pixi-effects: colorGradient gradientType "${gradientType}" is not one of linear, radial or conic`);
+  return { ...rest, type: i };
+}
 function createNamedFilter(type, params) {
   if (lower(type) === "colormatrix") return colorMatrix(params);
   const core = Object.entries(CORE).find(([k]) => lower(k) === lower(type));
@@ -833,7 +841,8 @@ function createNamedFilter(type, params) {
   const Ctor = library?.get(lower(type));
   if (!Ctor) throw MISSING(type, library ? "not found in the loaded package" : "not loaded yet");
   const single = SINGLE_VALUE[Object.keys(SINGLE_VALUE).find((k) => lower(k) === lower(type)) ?? ""];
-  return single ? new Ctor(params[single]) : new Ctor(params);
+  if (single) return new Ctor(params[single]);
+  return new Ctor(lower(type) === "colorgradient" ? colorGradientParams(params) : params);
 }
 
 // src/filters/index.ts
@@ -2525,7 +2534,7 @@ function numOrZero(v, scope) {
 var _CompositionSequence = null;
 async function getCompositionSequence() {
   if (!_CompositionSequence) {
-    _CompositionSequence = (await import('./Composition-3KHQPRBA.cjs')).CompositionSequence;
+    _CompositionSequence = (await import('./Composition-CM62XJKT.cjs')).CompositionSequence;
   }
   return _CompositionSequence;
 }
@@ -2582,5 +2591,5 @@ exports.projectLayer = projectLayer;
 exports.registerSequenceType = registerSequenceType;
 exports.resolveAt = resolveAt;
 exports.summarizeWarnings = summarizeWarnings;
-//# sourceMappingURL=chunk-6I55T4OH.cjs.map
-//# sourceMappingURL=chunk-6I55T4OH.cjs.map
+//# sourceMappingURL=chunk-AGMNSJJH.cjs.map
+//# sourceMappingURL=chunk-AGMNSJJH.cjs.map