@takumi-rs/wasm 0.70.3 → 0.71.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takumi-rs/wasm",
-  "version": "0.70.3",
+  "version": "0.71.0",
   "keywords": [
     "image",
     "rendering",

package/pkg/takumi_wasm.cjs

@@ -61,6 +61,17 @@ class Renderer {
   clearImageStore() {
     wasm.renderer_clearImageStore(this.__wbg_ptr);
   }
+  encodeFrames(frames, options) {
+    const ptr0 = passArrayJsValueToWasm0(frames, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.renderer_encodeFrames(this.__wbg_ptr, ptr0, len0, options);
+    if (ret[3]) {
+      throw takeFromExternrefTable0(ret[2]);
+    }
+    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v2;
+  }
   loadFont(font) {
     const ret = wasm.renderer_loadFont(this.__wbg_ptr, font);
     if (ret[1]) {
@@ -104,16 +115,14 @@ class Renderer {
     wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
     return v1;
   }
-  renderAnimation(frames, options) {
-    const ptr0 = passArrayJsValueToWasm0(frames, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.renderer_renderAnimation(this.__wbg_ptr, ptr0, len0, options);
+  renderAnimation(options) {
+    const ret = wasm.renderer_renderAnimation(this.__wbg_ptr, options);
     if (ret[3]) {
       throw takeFromExternrefTable0(ret[2]);
     }
-    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
     wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v2;
+    return v1;
   }
   renderAsDataUrl(node, options) {
     let deferred2_0;

package/pkg/takumi_wasm.d.ts

@@ -40,13 +40,63 @@ export type RenderOptions = {
      * @default 1.0
      */
     devicePixelRatio?: number,
+    /**
+     * The animation timeline time in milliseconds.
+     */
+    timeMs?: number,
 };
 
 export type RenderAnimationOptions = {
+    scenes: AnimationSceneSource[],
     width: number,
     height: number,
-    format?: "webp" | "apng",
+    format?: "webp" | "apng" | "gif",
+    /**
+     * The quality of WebP format (0-100). Ignored for APNG and GIF.
+     */
+    quality?: number,
+    /**
+     * The resources fetched externally. You should collect the fetch tasks first using `extractResourceUrls` and then pass the resources here.
+     */
+    fetchedResources?: ImageSource[],
     drawDebugBorder?: boolean,
+    /**
+     * CSS stylesheets to apply before rendering.
+     */
+    stylesheets?: string[],
+    /**
+     * Defines the ratio resolution of the image to the physical pixels.
+     * @default 1.0
+     */
+    devicePixelRatio?: number,
+    /**
+     * Frames per second for timeline sampling.
+     */
+    fps: number,
+};
+
+export type EncodeFramesOptions = {
+    width: number,
+    height: number,
+    format?: "webp" | "apng" | "gif",
+    /**
+     * The quality of WebP format (0-100). Ignored for APNG and GIF.
+     */
+    quality?: number,
+    /**
+     * The resources fetched externally. You should collect the fetch tasks first using `extractResourceUrls` and then pass the resources here.
+     */
+    fetchedResources?: ImageSource[],
+    drawDebugBorder?: boolean,
+    /**
+     * CSS stylesheets to apply before rendering.
+     */
+    stylesheets?: string[],
+    /**
+     * Defines the ratio resolution of the image to the physical pixels.
+     * @default 1.0
+     */
+    devicePixelRatio?: number,
 };
 
 export type FontDetails = {
@@ -95,6 +145,11 @@ export type AnimationFrameSource = {
     durationMs: number,
 };
 
+export type AnimationSceneSource = {
+    node: AnyNode,
+    durationMs: number,
+};
+
 
 
 /**
@@ -107,6 +162,10 @@ export class Renderer {
      * Clears the renderer's internal image store.
      */
     clearImageStore(): void;
+    /**
+     * Encodes a precomputed frame sequence into an animated image buffer.
+     */
+    encodeFrames(frames: AnimationFrameSource[], options: EncodeFramesOptions): Uint8Array;
     /**
      * Loads a font into the renderer.
      */
@@ -132,9 +191,9 @@ export class Renderer {
      */
     render(node: AnyNode, options?: RenderOptions | null): Uint8Array;
     /**
-     * Renders an animation sequence into a buffer.
+     * Renders a sequential animation timeline into a buffer.
      */
-    renderAnimation(frames: AnimationFrameSource[], options: RenderAnimationOptions): Uint8Array;
+    renderAnimation(options: RenderAnimationOptions): Uint8Array;
     /**
      * Renders a node tree into a data URL.
      *
@@ -161,13 +220,14 @@ export interface InitOutput {
     readonly __wbg_renderer_free: (a: number, b: number) => void;
     readonly collectNodeFetchTasks: (a: any) => [number, number, number, number];
     readonly renderer_clearImageStore: (a: number) => void;
+    readonly renderer_encodeFrames: (a: number, b: number, c: number, d: any) => [number, number, number, number];
     readonly renderer_loadFont: (a: number, b: any) => [number, number];
     readonly renderer_loadFontWithInfo: (a: number, b: any) => [number, number];
     readonly renderer_measure: (a: number, b: any, c: number) => [number, number, number];
     readonly renderer_new: (a: number) => [number, number, number];
     readonly renderer_putPersistentImage: (a: number, b: any) => [number, number];
     readonly renderer_render: (a: number, b: any, c: number) => [number, number, number, number];
-    readonly renderer_renderAnimation: (a: number, b: number, c: number, d: any) => [number, number, number, number];
+    readonly renderer_renderAnimation: (a: number, b: any) => [number, number, number, number];
     readonly renderer_renderAsDataUrl: (a: number, b: any, c: any) => [number, number, number, number];
     readonly extractResourceUrls: (a: any) => [number, number, number, number];
     readonly __wbindgen_malloc: (a: number, b: number) => number;

package/pkg/takumi_wasm.js

@@ -20,6 +20,23 @@ export class Renderer {
     clearImageStore() {
         wasm.renderer_clearImageStore(this.__wbg_ptr);
     }
+    /**
+     * Encodes a precomputed frame sequence into an animated image buffer.
+     * @param {AnimationFrameSource[]} frames
+     * @param {EncodeFramesOptions} options
+     * @returns {Uint8Array}
+     */
+    encodeFrames(frames, options) {
+        const ptr0 = passArrayJsValueToWasm0(frames, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.renderer_encodeFrames(this.__wbg_ptr, ptr0, len0, options);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v2;
+    }
     /**
      * Loads a font into the renderer.
      * @param {Font} font
@@ -92,21 +109,18 @@ export class Renderer {
         return v1;
     }
     /**
-     * Renders an animation sequence into a buffer.
-     * @param {AnimationFrameSource[]} frames
+     * Renders a sequential animation timeline into a buffer.
      * @param {RenderAnimationOptions} options
      * @returns {Uint8Array}
      */
-    renderAnimation(frames, options) {
-        const ptr0 = passArrayJsValueToWasm0(frames, wasm.__wbindgen_malloc);
-        const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.renderer_renderAnimation(this.__wbg_ptr, ptr0, len0, options);
+    renderAnimation(options) {
+        const ret = wasm.renderer_renderAnimation(this.__wbg_ptr, options);
         if (ret[3]) {
             throw takeFromExternrefTable0(ret[2]);
         }
-        var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
         wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-        return v2;
+        return v1;
     }
     /**
      * Renders a node tree into a data URL.

package/pkg/takumi_wasm_bg.wasm.d.ts

@@ -4,13 +4,14 @@ export const memory: WebAssembly.Memory;
 export const __wbg_renderer_free: (a: number, b: number) => void;
 export const collectNodeFetchTasks: (a: any) => [number, number, number, number];
 export const renderer_clearImageStore: (a: number) => void;
+export const renderer_encodeFrames: (a: number, b: number, c: number, d: any) => [number, number, number, number];
 export const renderer_loadFont: (a: number, b: any) => [number, number];
 export const renderer_loadFontWithInfo: (a: number, b: any) => [number, number];
 export const renderer_measure: (a: number, b: any, c: number) => [number, number, number];
 export const renderer_new: (a: number) => [number, number, number];
 export const renderer_putPersistentImage: (a: number, b: any) => [number, number];
 export const renderer_render: (a: number, b: any, c: number) => [number, number, number, number];
-export const renderer_renderAnimation: (a: number, b: number, c: number, d: any) => [number, number, number, number];
+export const renderer_renderAnimation: (a: number, b: any) => [number, number, number, number];
 export const renderer_renderAsDataUrl: (a: number, b: any, c: any) => [number, number, number, number];
 export const extractResourceUrls: (a: any) => [number, number, number, number];
 export const __wbindgen_malloc: (a: number, b: number) => number;