@nodetool-ai/video-nodes 0.8.1

package/dist/nodes/timeline/rasterizers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasterizers.js","sourceRoot":"","sources":["../../../src/nodes/timeline/rasterizers.ts"],"names":[],"mappings":"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"}

package/dist/nodes/timeline/rawFrames.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Raw RGBA plumbing between ffmpeg and the timeline compositor.
+ *
+ * The compositor wants CPU-side straight-alpha RGBA for every layer of every
+ * frame, and hands back the composited frame in the same form. ffmpeg does the
+ * decoding and encoding on both ends:
+ *
+ * - {@link decodeImageRgba} decodes a still once.
+ * - {@link openVideoFrameStream} decodes a clip lazily, one frame at a time.
+ *   Frames are consumed in timeline order, which for a clip is source order, so
+ *   a single streaming decode covers the whole render — no seeking, and no
+ *   multi-gigabyte scratch file.
+ * - {@link openFrameEncoder} pipes composited frames into one long-running
+ *   encoder.
+ */
+/** Pixel dimensions of a decoded source. */
+interface RawSize {
+    width: number;
+    height: number;
+}
+/** Decoded straight-alpha RGBA8 pixels. */
+export interface RawImage extends RawSize {
+    rgba: Uint8Array;
+}
+/**
+ * Largest size that fits `source` inside `canvas` without upscaling and
+ * without changing its aspect ratio. Decoding beyond the frame the layer is
+ * composited into buys nothing; upscaling below it would change what a
+ * source-pixel unit (a blur radius, a corner radius) means.
+ */
+export declare function fitWithin(source: RawSize, canvas: RawSize): RawSize;
+/** Probe a media file's video dimensions, or `null` when it has no video. */
+export declare function probeVideoSize(filePath: string): Promise<RawSize | null>;
+/** Decode a still image to straight-alpha RGBA at `size`. */
+export declare function decodeImageRgba(filePath: string, size: RawSize): Promise<RawImage>;
+/**
+ * A clip's frames, decoded on demand in timeline order.
+ *
+ * `frameAt` may only move forward: intermediate frames are decoded and dropped,
+ * which is what happens when a layer is skipped for a few frames (a video layer
+ * past the simultaneous-layer cap, say). Once the source runs out, the last
+ * frame is held — the same thing a `<video>` element shows in the preview when
+ * a clip outlives its media.
+ */
+export interface VideoFrameStream extends RawSize {
+    frameAt(index: number): Promise<Uint8Array | null>;
+    close(): void;
+}
+interface VideoFrameStreamOptions {
+    filePath: string;
+    /** Decoded frame size (already fitted to the sequence frame). */
+    size: RawSize;
+    /** Timeline frame rate — one decoded frame per timeline frame. */
+    fps: number;
+    /** Source seconds to skip before the first frame (the clip's in point). */
+    startSec: number;
+    /** Playback rate: >1 consumes the source faster than the timeline. */
+    speed: number;
+}
+/**
+ * Start decoding `filePath` into RGBA frames at the timeline's frame rate.
+ * `setpts` applies the clip's speed so decoded frame *k* is exactly the source
+ * frame the preview shows at timeline frame *k* of the clip.
+ */
+export declare function openVideoFrameStream(opts: VideoFrameStreamOptions): VideoFrameStream;
+/**
+ * A clip's frames addressed by absolute source time rather than by frame index.
+ *
+ * The forward-only stream above is enough while a clip consumes its source at a
+ * constant rate: decoded frame *k* is the frame the timeline wants at clip
+ * frame *k*. A time remap breaks that — the source position is a curve, and a
+ * reverse curve walks it backwards. A bounded window retains decoded frames
+ * for descending requests and reopens the forward-only decode when a request
+ * falls outside that window.
+ */
+export interface SourceFrameStream extends RawSize {
+    /** The frame at absolute source time `sec`, or `null` past the media's end. */
+    frameAtSourceSec(sec: number): Promise<Uint8Array | null>;
+    /** Number of decoder reopens. */
+    readonly reopens: number;
+    /** Decoded bytes currently retained for reverse reads. */
+    readonly reverseWindowBytes: number;
+    close(): void;
+}
+/**
+ * Open a source-time-addressed decode of `filePath`, sampling the source on a
+ * `1/fps` grid when it matches a verified regular source grid. Other requests
+ * use a fresh FFmpeg seek to retain its timestamp and timebase behavior.
+ *
+ * The underlying decode always runs at the source's own rate (`speed: 1`): the
+ * remap curve, not `setpts`, decides which source instant a timeline frame
+ * shows.
+ */
+export declare function openSourceFrameStream(opts: {
+    filePath: string;
+    size: RawSize;
+    fps: number;
+    startSec: number;
+    /** Maximum decoded bytes retained in one reverse window. */
+    maxWindowBytes?: number;
+    /** Maximum source-time span retained in one reverse window. */
+    maxWindowMs?: number;
+}): SourceFrameStream;
+/** A running encoder that turns written RGBA frames into an output file. */
+export interface FrameEncoder {
+    write(rgba: Uint8Array): Promise<void>;
+    /** Close the input and wait for the file to be finalized. */
+    finish(): Promise<void>;
+    abort(): void;
+}
+/**
+ * Report whether this ffmpeg build ships `encoder`.
+ *
+ * ProRes 4444 and VP9 are both optional at build time — a distro ffmpeg may
+ * carry neither — and a render that discovers this after compositing every
+ * frame has burned the whole render. Probed once before the frame loop starts.
+ *
+ * A build that cannot be asked (no ffmpeg, an unparsable listing) answers
+ * `false`, so the caller refuses with a message naming the encoder rather than
+ * failing on ffmpeg's own output an hour later.
+ */
+export declare function ffmpegHasEncoder(encoder: string): Promise<boolean>;
+/**
+ * H.264 at `yuv420p`, converted to BT.709 and tagged as such.
+ *
+ * The same reasoning as `outputFormats.ts`: raw RGBA in, YUV out, and without
+ * the scaler and the tags ffmpeg uses BT.601 and records nothing, so the file
+ * plays back off-hue everywhere. A caller that passes its own `encoderArgs`
+ * owns its own colour handling.
+ */
+export declare function defaultEncoderArgs(): string[];
+/**
+ * Start encoding RGBA frames written at `fps` into `outPath`.
+ *
+ * `encoderArgs` decides the codec, profile and pixel format — the alpha-capable
+ * combinations are the table in `outputFormats.ts`. Frames arrive as
+ * straight-alpha RGBA either way; a `yuv*` pixel format drops the channel, a
+ * `yuva*` one keeps it.
+ */
+export declare function openFrameEncoder(opts: {
+    outPath: string;
+    width: number;
+    height: number;
+    fps: number;
+    /** Output codec arguments. Defaults to H.264 at `yuv420p`. */
+    encoderArgs?: readonly string[];
+}): FrameEncoder;
+export {};
+//# sourceMappingURL=rawFrames.d.ts.map

package/dist/nodes/timeline/rawFrames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawFrames.d.ts","sourceRoot":"","sources":["../../../src/nodes/timeline/rawFrames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,4CAA4C;AAC5C,UAAU,OAAO;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,QAAS,SAAQ,OAAO;IACvC,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAUnE;AAED,6EAA6E;AAC7E,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAe9E;AAkBD,6DAA6D;AAC7D,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,QAAQ,CAAC,CAyCnB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAiB,SAAQ,OAAO;IAC/C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAKD,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,IAAI,EAAE,OAAO,CAAC;IACd,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,uBAAuB,GAC5B,gBAAgB,CA4DlB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO;IAChD,+EAA+E;IAC/E,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC1D,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;CACf;AAkDD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,iBAAiB,CAuHpB;AAsGD,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,6DAA6D;IAC7D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAaxE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAiB7C;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,GAAG,YAAY,CAqFf"}