@yume-chan/scrcpy-decoder-webcodecs 2.5.3 → 3.0.0-beta.0

package/esm/video/render/bitmap.d.ts

@@ -1,7 +1,7 @@
 import { CanvasVideoFrameRenderer } from "./canvas.js";
 export declare class BitmapVideoFrameRenderer extends CanvasVideoFrameRenderer {
     #private;
-    constructor(canvas?: HTMLCanvasElement | OffscreenCanvas);
-    draw(frame: VideoFrame): Promise<void>;
+    get type(): "software";
+    constructor(options?: CanvasVideoFrameRenderer.Options);
 }
 //# sourceMappingURL=bitmap.d.ts.map

package/esm/video/render/bitmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bitmap.d.ts","sourceRoot":"","sources":["../../../src/video/render/bitmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,wBAAyB,SAAQ,wBAAwB;;gBAGtD,MAAM,CAAC,EAAE,iBAAiB,GAAG,eAAe;IAQlD,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAI/C"}
+{"version":3,"file":"bitmap.d.ts","sourceRoot":"","sources":["../../../src/video/render/bitmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,wBAAyB,SAAQ,wBAAwB;;IAClE,IAAa,IAAI,IACN,UAAU,CACpB;gBAIW,OAAO,CAAC,EAAE,wBAAwB,CAAC,OAAO;CAsBzD"}

package/esm/video/render/bitmap.js

@@ -1,15 +1,25 @@
 import { CanvasVideoFrameRenderer } from "./canvas.js";
 export class BitmapVideoFrameRenderer extends CanvasVideoFrameRenderer {
+    get type() {
+        return "software";
+    }
     #context;
-    constructor(canvas) {
-        super(canvas);
-        this.#context = this.canvas.getContext("bitmaprenderer", {
-            alpha: false,
+    constructor(options) {
+        super(async (frame) => {
+            const bitmap = await createImageBitmap(frame);
+            this.#context.transferFromImageBitmap(bitmap);
+            bitmap.close();
+        }, options);
+        const context = this.canvas.getContext("bitmaprenderer", {
+            // Avoid alpha:false, which can be expensive
+            // https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices#avoid_alphafalse_which_can_be_expensive
+            alpha: true,
         });
-    }
-    async draw(frame) {
-        const bitmap = await createImageBitmap(frame);
-        this.#context.transferFromImageBitmap(bitmap);
+        if (!context) {
+            // This can happen if the canvas already has a context of a different type
+            throw new Error("Failed to create rendering context");
+        }
+        this.#context = context;
     }
 }
 //# sourceMappingURL=bitmap.js.map

package/esm/video/render/bitmap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bitmap.js","sourceRoot":"","sources":["../../../src/video/render/bitmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,OAAO,wBAAyB,SAAQ,wBAAwB;IAClE,QAAQ,CAA8B;IAEtC,YAAY,MAA4C;QACpD,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE;YACrD,KAAK,EAAE,KAAK;SACf,CAAE,CAAC;IACR,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAiB;QACxB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;CACJ"}
+{"version":3,"file":"bitmap.js","sourceRoot":"","sources":["../../../src/video/render/bitmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,OAAO,wBAAyB,SAAQ,wBAAwB;IAClE,IAAa,IAAI;QACb,OAAO,UAAmB,CAAC;IAC/B,CAAC;IAED,QAAQ,CAA8B;IAEtC,YAAY,OAA0C;QAClD,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAClB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC,EAAE,OAAO,CAAC,CAAC;QAEZ,MAAM,OAAO,GAAI,IAAI,CAAC,MAA4B,CAAC,UAAU,CACzD,gBAAgB,EAChB;YACI,4CAA4C;YAC5C,0HAA0H;YAC1H,KAAK,EAAE,IAAI;SACd,CACJ,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,0EAA0E;YAC1E,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC5B,CAAC;CACJ"}

package/esm/video/render/canvas.d.ts

@@ -1,9 +1,43 @@
+import type { MaybePromiseLike } from "@yume-chan/async";
+import type { ScrcpyVideoDecoder } from "@yume-chan/scrcpy-decoder-shared";
+import { WritableStream } from "@yume-chan/stream-extra";
 import type { VideoFrameRenderer } from "./type.js";
-export declare abstract class CanvasVideoFrameRenderer implements VideoFrameRenderer {
+export declare abstract class CanvasVideoFrameRenderer<TOptions extends CanvasVideoFrameRenderer.Options = CanvasVideoFrameRenderer.Options> implements VideoFrameRenderer {
     #private;
+    abstract get type(): ScrcpyVideoDecoder.RendererType;
     get canvas(): HTMLCanvasElement | OffscreenCanvas;
-    constructor(canvas?: HTMLCanvasElement | OffscreenCanvas);
-    setSize(width: number, height: number): void;
-    abstract draw(frame: VideoFrame): Promise<void>;
+    get options(): Readonly<TOptions> | undefined;
+    get lastFrame(): VideoFrame | undefined;
+    get writable(): WritableStream<VideoFrame>;
+    constructor(draw: (frame: VideoFrame) => MaybePromiseLike<undefined>, options?: TOptions);
+    /**
+     * Redraws the last drawn frame.
+     *
+     * If a draw or redraw is in progress, it waits for them to finish before redrawing.
+     *
+     * If a redraw is in progress and another one is in queue,
+     * it cancels the queued redraw and redraws the latest frame instead.
+     */
+    redraw(): Promise<undefined>;
+    snapshot(options?: ImageEncodeOptions): Promise<Blob | undefined>;
+    dispose(): undefined;
+}
+export declare namespace CanvasVideoFrameRenderer {
+    interface Options {
+        canvas?: HTMLCanvasElement | OffscreenCanvas;
+        /**
+         * Whether to update the canvas size (rendering resolution) automatically.
+         *
+         * * `"video"` (default): update the canvas size to match the video resolution
+         * * `"display"` (only for `HTMLCanvasElement`):
+         *    update the canvas size to match the display size.
+         *    The display size can be set using `canvas.style.width/height`,
+         *    and must be in correct aspect ratio.
+         * * `"external"`: use the canvas size as it is.
+         *    The size must be manually set using `canvas.width/height`,
+         *    and must be in correct aspect ratio.
+         */
+        canvasSize?: "video" | "display" | "external";
+    }
 }
 //# sourceMappingURL=canvas.d.ts.map

package/esm/video/render/canvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../../src/video/render/canvas.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,8BAAsB,wBAAyB,YAAW,kBAAkB;;IAExE,IAAI,MAAM,wCAET;gBAEW,MAAM,CAAC,EAAE,iBAAiB,GAAG,eAAe;IAQxD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAO5C,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAClD"}
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../../src/video/render/canvas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAKzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,8BAAsB,wBAAwB,CAC1C,QAAQ,SAAS,wBAAwB,CAAC,OAAO,GAC7C,wBAAwB,CAAC,OAAO,CACtC,YAAW,kBAAkB;;IAC3B,QAAQ,KAAK,IAAI,IAAI,kBAAkB,CAAC,YAAY,CAAC;IAGrD,IAAI,MAAM,wCAET;IAID,IAAI,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,SAAS,CAE5C;IAcD,IAAI,SAAS,2BAEZ;IAKD,IAAI,QAAQ,+BAEX;gBAGG,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,gBAAgB,CAAC,SAAS,CAAC,EACxD,OAAO,CAAC,EAAE,QAAQ;IAuEtB;;;;;;;OAOG;IACH,MAAM;IAIA,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IAOvE,OAAO,IAAI,SAAS;CASvB;AAED,yBAAiB,wBAAwB,CAAC;IACtC,UAAiB,OAAO;QACpB,MAAM,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAAC;QAE7C;;;;;;;;;;;WAWG;QACH,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;KACjD;CACJ"}

package/esm/video/render/canvas.js

@@ -1,22 +1,109 @@
-import { createCanvas } from "@yume-chan/scrcpy-decoder-tinyh264";
+import { createCanvas } from "@yume-chan/scrcpy-decoder-shared";
+import { WritableStream } from "@yume-chan/stream-extra";
+import { canvasToBlob } from "../utils/index.js";
+import { RedrawController } from "./redraw.js";
 export class CanvasVideoFrameRenderer {
     #canvas;
     get canvas() {
         return this.#canvas;
     }
-    constructor(canvas) {
-        if (canvas) {
-            this.#canvas = canvas;
+    #options;
+    #canvasSize;
+    get options() {
+        return this.#options;
+    }
+    #resizeObserver;
+    #displayWidth = Infinity;
+    #displayHeight = Infinity;
+    #draw;
+    #controller = new RedrawController((frame) => {
+        if (this.#canvasSize !== "external") {
+            this.#updateSize(frame);
+        }
+        return this.#draw(frame);
+    });
+    get lastFrame() {
+        return this.#controller.lastFrame;
+    }
+    #writable = new WritableStream({
+        write: (frame) => this.#controller.draw(frame),
+    });
+    get writable() {
+        return this.#writable;
+    }
+    constructor(draw, options) {
+        this.#draw = draw;
+        this.#canvas = options?.canvas ?? createCanvas();
+        this.#options = options;
+        this.#canvasSize = options?.canvasSize ?? "video";
+        if (this.#canvasSize === "display") {
+            if (typeof HTMLCanvasElement === "undefined" ||
+                !(this.#canvas instanceof HTMLCanvasElement)) {
+                throw new Error("`canvasSize: display` is only supported for HTMLCanvasElement");
+            }
+            this.#resizeObserver = new ResizeObserver((entries) => {
+                const entry = entries[0];
+                if (!entry) {
+                    return;
+                }
+                const devicePixelSize = entry.devicePixelContentBoxSize?.[0];
+                if (devicePixelSize) {
+                    this.#setDisplaySize(devicePixelSize.inlineSize, devicePixelSize.blockSize);
+                    return;
+                }
+                const cssSize = entry.contentBoxSize[0];
+                if (cssSize) {
+                    this.#setDisplaySize(Math.round(cssSize.inlineSize * devicePixelRatio), Math.round(cssSize.blockSize * devicePixelRatio));
+                }
+            });
+            this.#resizeObserver.observe(this.#canvas);
+        }
+    }
+    #setDisplaySize(width, height) {
+        if (this.#displayWidth === width && this.#displayHeight === height) {
+            return;
         }
-        else {
-            this.#canvas = createCanvas();
+        this.#displayWidth = width;
+        this.#displayHeight = height;
+        void this.#controller.redraw();
+    }
+    #updateSize(frame) {
+        let { codedWidth: width, codedHeight: height } = frame;
+        if (this.#canvasSize === "display") {
+            width = Math.min(width, this.#displayWidth);
+            height = Math.min(height, this.#displayHeight);
+        }
+        if (this.#canvas.width === width && this.#canvas.height === height) {
+            return false;
+        }
+        this.#canvas.width = width;
+        this.#canvas.height = height;
+        return true;
+    }
+    /**
+     * Redraws the last drawn frame.
+     *
+     * If a draw or redraw is in progress, it waits for them to finish before redrawing.
+     *
+     * If a redraw is in progress and another one is in queue,
+     * it cancels the queued redraw and redraws the latest frame instead.
+     */
+    redraw() {
+        return this.#controller.redraw();
+    }
+    async snapshot(options) {
+        if (this.#canvasSize !== "video") {
+            return undefined;
         }
+        return canvasToBlob(this.#canvas, options);
     }
-    setSize(width, height) {
-        if (this.#canvas.width !== width || this.#canvas.height !== height) {
-            this.#canvas.width = width;
-            this.#canvas.height = height;
+    dispose() {
+        if (this.#canvasSize !== "external") {
+            this.#canvas.width = 0;
+            this.#canvas.height = 0;
         }
+        this.#resizeObserver?.disconnect();
+        this.#controller.dispose();
     }
 }
 //# sourceMappingURL=canvas.js.map

package/esm/video/render/canvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../../src/video/render/canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAIlE,MAAM,OAAgB,wBAAwB;IAC1C,OAAO,CAAsC;IAC7C,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,YAAY,MAA4C;QACpD,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QAC1B,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,OAAO,GAAG,YAAY,EAAE,CAAC;QAClC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,KAAa,EAAE,MAAc;QACjC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACjE,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QACjC,CAAC;IACL,CAAC;CAGJ"}
+{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../../src/video/render/canvas.ts"],"names":[],"mappings":"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"}

package/esm/video/render/flow-control.d.ts

@@ -0,0 +1,32 @@
+import type { ScrcpyVideoRendererPerformanceCounterInterface } from "@yume-chan/scrcpy-decoder-shared";
+import type { ReadableStream, TransformStream } from "@yume-chan/stream-extra";
+import { WritableStream } from "@yume-chan/stream-extra";
+export declare class RendererController implements TransformStream<VideoFrame, VideoFrame>, ScrcpyVideoRendererPerformanceCounterInterface {
+    #private;
+    get readable(): ReadableStream<VideoFrame>;
+    get writable(): WritableStream<VideoFrame>;
+    get captureFrame(): VideoFrame | undefined;
+    /**
+     * Gets the number of frames that have been drawn on the renderer.
+     */
+    get framesRendered(): number;
+    /**
+     * Gets the number of frames that's visible to the user.
+     *
+     * Multiple frames might be rendered during one vertical sync interval,
+     * but only the last of them is represented to the user.
+     * This costs some performance but reduces latency by 1 frame.
+     *
+     * Might be `0` if the renderer is in a nested Web Worker on Chrome due to a Chrome bug.
+     * https://issues.chromium.org/issues/41483010
+     */
+    get framesDisplayed(): number;
+    /**
+     * Gets the number of frames that wasn't drawn on the renderer
+     * because the renderer can't keep up
+     */
+    get framesSkippedRendering(): number;
+    constructor();
+    dispose(): void;
+}
+//# sourceMappingURL=flow-control.d.ts.map

package/esm/video/render/flow-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-control.d.ts","sourceRoot":"","sources":["../../../src/video/render/flow-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8CAA8C,EAAE,MAAM,kCAAkC,CAAC;AAEvG,OAAO,KAAK,EAER,cAAc,EACd,eAAe,EAElB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGH,cAAc,EACjB,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,kBACT,YACI,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,EACvC,8CAA8C;;IAIlD,IAAI,QAAQ,+BAEX;IAID,IAAI,QAAQ,+BAEX;IAGD,IAAI,YAAY,2BAEf;IAOD;;OAEG;IACH,IAAI,cAAc,WAEjB;IACD;;;;;;;;;OASG;IACH,IAAI,eAAe,WAElB;IACD;;;OAGG;IACH,IAAI,sBAAsB,WAEzB;;IAmGD,OAAO;CAgBV"}

package/esm/video/render/flow-control.js

@@ -0,0 +1,139 @@
+import { ScrcpyVideoRendererPerformanceCounter } from "@yume-chan/scrcpy-decoder-shared";
+import { PushReadableStream, tryClose, WritableStream, } from "@yume-chan/stream-extra";
+export class RendererController {
+    #readable;
+    #readableController;
+    get readable() {
+        return this.#readable;
+    }
+    #writable;
+    #writableController;
+    get writable() {
+        return this.#writable;
+    }
+    #captureFrame;
+    get captureFrame() {
+        return this.#captureFrame;
+    }
+    #nextFrame;
+    #drawTask;
+    #counter = new ScrcpyVideoRendererPerformanceCounter();
+    /**
+     * Gets the number of frames that have been drawn on the renderer.
+     */
+    get framesRendered() {
+        return this.#counter.framesRendered;
+    }
+    /**
+     * Gets the number of frames that's visible to the user.
+     *
+     * Multiple frames might be rendered during one vertical sync interval,
+     * but only the last of them is represented to the user.
+     * This costs some performance but reduces latency by 1 frame.
+     *
+     * Might be `0` if the renderer is in a nested Web Worker on Chrome due to a Chrome bug.
+     * https://issues.chromium.org/issues/41483010
+     */
+    get framesDisplayed() {
+        return this.#counter.framesDisplayed;
+    }
+    /**
+     * Gets the number of frames that wasn't drawn on the renderer
+     * because the renderer can't keep up
+     */
+    get framesSkippedRendering() {
+        return this.#counter.framesSkippedRendering;
+    }
+    constructor() {
+        this.#readable = new PushReadableStream((controller) => {
+            this.#readableController = controller;
+        });
+        this.#writable = new WritableStream({
+            start: (controller) => {
+                this.#writableController = controller;
+                // Propagate `readable` error back to `writable`
+                const signal = this.#readableController.abortSignal;
+                signal.addEventListener("abort", () => controller.error(signal.reason));
+            },
+            write: (frame) => {
+                this.#captureFrame?.close();
+                // `#captureFrame` and `#nextFrame` must not be the same object
+                // because they need to be closed at different times
+                this.#captureFrame = frame.clone();
+                // Frame A is drawing, frame B (`#nextFrame`) is waiting,
+                // then frame C (`frame`) arrives.
+                // Skip frame B and queue frame C
+                if (this.#nextFrame) {
+                    this.#nextFrame.close();
+                    this.#counter.increaseFramesSkippedRendering();
+                }
+                this.#nextFrame = frame;
+                // Don't `await` because this writable needs to
+                // accept incoming frames as fast as produced.
+                // The `#draw` method then draws the frames
+                // as fast as the renderer can keep up
+                void this.#tryStartDrawing();
+            },
+            close: async () => {
+                // Normally `WritableStream` only calls `close` after `write` finishes,
+                // but because our `write` doesn't wait for `#draw`,
+                // we might still need to send `#nextFrame` to `readable`.
+                // So wait for `#drawTask` before closing `readable`
+                await this.#drawTask;
+                // `#nextFrame` must be `undefined` at this point
+                // Propagate `writable` close to `readable`
+                this.#readableController.close();
+                this.#counter.dispose();
+                // Don't close `#captureFrame` to allow using `snapshot` on the last frame
+            },
+            abort: async (reason) => {
+                // See `close` above
+                await this.#drawTask;
+                // Propagate `writable` error to `readable`
+                this.#readableController.error(reason);
+                this.#counter.dispose();
+            },
+        });
+    }
+    async #draw() {
+        // PERF: Draw every frame to minimize latency at cost of performance.
+        // When multiple frames are drawn in one vertical sync interval,
+        // only the last one is visible to users.
+        // But this ensures users can always see the most up-to-date screen.
+        // This is also the behavior of official Scrcpy client.
+        // https://github.com/Genymobile/scrcpy/issues/3679
+        let frame;
+        while ((frame = this.#nextFrame)) {
+            this.#nextFrame = undefined;
+            if (await this.#readableController.enqueue(frame)) {
+                // The consumer is responsible for closing `frame`
+                this.#counter.increaseFramesRendered();
+            }
+            else {
+                // `enqueue` returning `false` means the consumer has called `readable.cancel()`,
+                // before consuming the `frame`. So close it here.
+                frame.close();
+                // Continue looping to close all `#nextFrame`s
+                // In the mean time the `writable` is erroring out its source
+                // so no more frames will arrive
+            }
+        }
+        this.#drawTask = undefined;
+    }
+    #tryStartDrawing() {
+        if (!this.#drawTask) {
+            this.#drawTask = this.#draw();
+        }
+    }
+    dispose() {
+        this.#captureFrame?.close();
+        this.#captureFrame = undefined;
+        this.#nextFrame?.close();
+        this.#nextFrame = undefined;
+        this.#counter.dispose();
+        tryClose(this.#readableController);
+        // Throw an error similar to native TransformStream
+        this.#writableController.error(new TypeError("The transform stream has been terminated"));
+    }
+}
+//# sourceMappingURL=flow-control.js.map

package/esm/video/render/flow-control.js.map

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

package/esm/video/render/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./bitmap.js";
 export * from "./canvas.js";
+export * from "./auto-canvas.js";
+export * from "./flow-control.js";
 export * from "./insertable-stream.js";
 export * from "./type.js";
 export * from "./webgl.js";

package/esm/video/render/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/video/render/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/video/render/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/esm/video/render/index.js

@@ -1,6 +1,8 @@
 // cspell: ignore insertable
 export * from "./bitmap.js";
 export * from "./canvas.js";
+export * from "./auto-canvas.js";
+export * from "./flow-control.js";
 export * from "./insertable-stream.js";
 export * from "./type.js";
 export * from "./webgl.js";

package/esm/video/render/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/video/render/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/video/render/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/esm/video/render/insertable-stream.d.ts

@@ -1,10 +1,22 @@
+import type { WritableStream } from "@yume-chan/stream-extra";
 import type { VideoFrameRenderer } from "./type.js";
 export declare class InsertableStreamVideoFrameRenderer implements VideoFrameRenderer {
     #private;
     static get isSupported(): boolean;
+    get type(): "hardware";
     get element(): HTMLVideoElement;
-    constructor(element?: HTMLVideoElement);
-    setSize(width: number, height: number): void;
-    draw(frame: VideoFrame): Promise<void>;
+    get options(): InsertableStreamVideoFrameRenderer.Options | undefined;
+    get writable(): WritableStream<VideoFrame>;
+    get stream(): MediaStream;
+    constructor(element?: HTMLVideoElement, options?: InsertableStreamVideoFrameRenderer.Options);
+    dispose(): undefined;
+}
+export declare namespace InsertableStreamVideoFrameRenderer {
+    interface Options {
+        /**
+         * Whether to update the size of the video element when the size of the video frame changes.
+         */
+        updateSize?: boolean;
+    }
 }
 //# sourceMappingURL=insertable-stream.d.ts.map

package/esm/video/render/insertable-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insertable-stream.d.ts","sourceRoot":"","sources":["../../../src/video/render/insertable-stream.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAQpD,qBAAa,kCAAmC,YAAW,kBAAkB;;IACzE,MAAM,KAAK,WAAW,YAErB;IAGD,IAAI,OAAO,qBAEV;gBAMW,OAAO,CAAC,EAAE,gBAAgB;IAyBtC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAOtC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C"}
+{"version":3,"file":"insertable-stream.d.ts","sourceRoot":"","sources":["../../../src/video/render/insertable-stream.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAQpD,qBAAa,kCAAmC,YAAW,kBAAkB;;IACzE,MAAM,KAAK,WAAW,YAErB;IAED,IAAI,IAAI,IACG,UAAU,CACpB;IAGD,IAAI,OAAO,qBAEV;IAGD,IAAI,OAAO,2DAEV;IAGD,IAAI,QAAQ,+BAEX;IAGD,IAAI,MAAM,gBAET;gBAKG,OAAO,CAAC,EAAE,gBAAgB,EAC1B,OAAO,CAAC,EAAE,kCAAkC,CAAC,OAAO;IAuCxD,OAAO,IAAI,SAAS;CAMvB;AAED,yBAAiB,kCAAkC,CAAC;IAChD,UAAiB,OAAO;QACpB;;WAEG;QACH,UAAU,CAAC,EAAE,OAAO,CAAC;KACxB;CACJ"}

package/esm/video/render/insertable-stream.js

@@ -3,14 +3,27 @@ export class InsertableStreamVideoFrameRenderer {
     static get isSupported() {
         return typeof MediaStreamTrackGenerator !== "undefined";
     }
+    get type() {
+        return "hardware";
+    }
     #element;
     get element() {
         return this.#element;
     }
+    #options;
+    get options() {
+        return this.#options;
+    }
     #generator;
-    #writer;
+    get writable() {
+        return this.#generator.writable;
+    }
     #stream;
-    constructor(element) {
+    get stream() {
+        return this.#stream;
+    }
+    #abortController = new AbortController();
+    constructor(element, options) {
         if (element) {
             this.#element = element;
         }
@@ -22,24 +35,29 @@ export class InsertableStreamVideoFrameRenderer {
         }
         this.#element.muted = true;
         this.#element.autoplay = true;
+        this.#element.playsInline = true;
         this.#element.disablePictureInPicture = true;
         this.#element.disableRemotePlayback = true;
+        this.#options = options;
+        if (options?.updateSize) {
+            this.#element.addEventListener("resize", () => {
+                this.#element.width = this.#element.videoWidth;
+                this.#element.height = this.#element.videoHeight;
+            }, { signal: this.#abortController.signal });
+        }
         // The spec replaced `MediaStreamTrackGenerator` with `VideoTrackGenerator`.
         // But Chrome has not implemented it yet.
         // https://issues.chromium.org/issues/40058895
         this.#generator = new MediaStreamTrackGenerator({ kind: "video" });
-        this.#writer = this.#generator.writable.getWriter();
+        this.#generator.contentHint = "motion";
         this.#stream = new MediaStream([this.#generator]);
         this.#element.srcObject = this.#stream;
     }
-    setSize(width, height) {
-        if (this.#element.width !== width || this.#element.height !== height) {
-            this.#element.width = width;
-            this.#element.height = height;
-        }
-    }
-    async draw(frame) {
-        await this.#writer.write(frame);
+    dispose() {
+        this.#abortController.abort();
+        this.#generator.stop();
+        this.#stream.removeTrack(this.#generator);
+        this.#element.srcObject = null;
     }
 }
 //# sourceMappingURL=insertable-stream.js.map

package/esm/video/render/insertable-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"insertable-stream.js","sourceRoot":"","sources":["../../../src/video/render/insertable-stream.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAU5B,MAAM,OAAO,kCAAkC;IAC3C,MAAM,KAAK,WAAW;QAClB,OAAO,OAAO,yBAAyB,KAAK,WAAW,CAAC;IAC5D,CAAC;IAED,QAAQ,CAAmB;IAC3B,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,UAAU,CAA4B;IACtC,OAAO,CAA0C;IACjD,OAAO,CAAc;IAErB,YAAY,OAA0B;QAClC,IAAI,OAAO,EAAE,CAAC;YACV,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5B,CAAC;aAAM,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CACX,mEAAmE,CACtE,CAAC;QACN,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,uBAAuB,GAAG,IAAI,CAAC;QAC7C,IAAI,CAAC,QAAQ,CAAC,qBAAqB,GAAG,IAAI,CAAC;QAE3C,4EAA4E;QAC5E,yCAAyC;QACzC,8CAA8C;QAC9C,IAAI,CAAC,UAAU,GAAG,IAAI,yBAAyB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAEpD,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,KAAa,EAAE,MAAc;QACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACnE,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;QAClC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAiB;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACJ"}
+{"version":3,"file":"insertable-stream.js","sourceRoot":"","sources":["../../../src/video/render/insertable-stream.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAY5B,MAAM,OAAO,kCAAkC;IAC3C,MAAM,KAAK,WAAW;QAClB,OAAO,OAAO,yBAAyB,KAAK,WAAW,CAAC;IAC5D,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,UAAmB,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAmB;IAC3B,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,QAAQ,CAAyD;IACjE,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,UAAU,CAA4B;IACtC,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED,OAAO,CAAc;IACrB,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,gBAAgB,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,YACI,OAA0B,EAC1B,OAAoD;QAEpD,IAAI,OAAO,EAAE,CAAC;YACV,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5B,CAAC;aAAM,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CACX,mEAAmE,CACtE,CAAC;QACN,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,uBAAuB,GAAG,IAAI,CAAC;QAC7C,IAAI,CAAC,QAAQ,CAAC,qBAAqB,GAAG,IAAI,CAAC;QAE3C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;YACtB,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAC1B,QAAQ,EACR,GAAG,EAAE;gBACD,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC/C,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YACrD,CAAC,EACD,EAAE,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAC3C,CAAC;QACN,CAAC;QAED,4EAA4E;QAC5E,yCAAyC;QACzC,8CAA8C;QAC9C,IAAI,CAAC,UAAU,GAAG,IAAI,yBAAyB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,UAAU,CAAC,WAAW,GAAG,QAAQ,CAAC;QAEvC,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC;IAC3C,CAAC;IAED,OAAO;QACH,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;IACnC,CAAC;CACJ"}

package/esm/video/render/redraw.d.ts

@@ -0,0 +1,31 @@
+import type { MaybePromiseLike } from "@yume-chan/async";
+/**
+ * Manages drawing and redrawing of video frames.
+ */
+export declare class RedrawController {
+    #private;
+    get lastFrame(): VideoFrame | undefined;
+    constructor(draw: (frame: VideoFrame) => MaybePromiseLike<undefined>);
+    /**
+     * Draws a new frame.
+     *
+     * If a redraw is in progress, it waits for the redraw to finish before drawing the new frame.
+     *
+     * If a redraw is in progress and another one is in queue,
+     * it cancels the queued redraw and draws the new frame instead.
+     *
+     * @param frame A `VideoFrame` to draw. The frame will be closed after drawing.
+     */
+    draw(frame: VideoFrame): Promise<undefined>;
+    /**
+     * Redraws the last drawn frame.
+     *
+     * If a draw or redraw is in progress, it waits for them to finish before redrawing.
+     *
+     * If a redraw is in progress and another one is in queue,
+     * it cancels the queued redraw and redraws the latest frame instead.
+     */
+    redraw(): Promise<undefined>;
+    dispose(): void;
+}
+//# sourceMappingURL=redraw.d.ts.map

package/esm/video/render/redraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redraw.d.ts","sourceRoot":"","sources":["../../../src/video/render/redraw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD;;GAEG;AACH,qBAAa,gBAAgB;;IAOzB,IAAI,SAAS,2BAEZ;gBAEW,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,gBAAgB,CAAC,SAAS,CAAC;IAIpE;;;;;;;;;OASG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU;IAgBtB;;;;;;;OAOG;IACG,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAwBlC,OAAO;CAQV"}