@openheart/tavio-renderer 2.6.6 → 2.6.8

package/build/esm/types/viewer/canvas.d.ts

@@ -100,6 +100,16 @@ export declare class Core extends EventEmitter {
      * @param quality - 画質(0〜1)。"image/jpeg" や "image/webp" のときのみ有効
      */
     captureImage(type?: string, quality?: number): Promise<Blob>;
+    /**
+     * 現在の描画内容を ImageBitmap として取得する(動画の書き出しなど、フレーム単位で連続して取得する用途)。
+     * OffscreenCanvas(Worker)で描画している場合も取得できる。
+     * 使い終わった ImageBitmap は呼び出し側で close() すること
+     * @param options.cameraPathProgress - 指定すると、描画の前にカメラパス上のこの位置(0.0 ～ 1.0)へ
+     *   イージングなしでカメラを移動する(カメラパスのコントロールが有効なときのみ反映される)
+     */
+    captureFrame(options?: {
+        cameraPathProgress?: number;
+    }): Promise<ImageBitmap>;
     addTavioMesh(name: string): void;
     removeTavioMesh(name: string, renderViewName?: string | Symbol): void;
     removeTavioMeshAllRenderView(name: string): void;

package/build/esm/types/viewer/driver/coreDriver.d.ts

@@ -334,6 +334,48 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param format - ファイル形式
      */
     exportMeshWasm(name: string, format: Parameters<typeof TavioMesh.prototype.exportMeshWasm>[0]): Promise<Uint8Array>;
+    /**
+     * 描画内容の取得(captureImage / captureFrame)のために、その場で1フレーム描画する
+     * 一時停止中でも取得できるよう、この1フレームだけ描画してから一時停止状態に戻す
+     * @private
+     */
+    private _renderOnceForCapture;
+    /**
+     * いずれかのレンダービューで、スプラットのソート(深度の焼き込みを含む)が進行中かどうか
+     * @private
+     */
+    private _isAnySortInProgress;
+    /**
+     * 進行中のスプラットのソートがすべて終わるまで待つ。進行中でなければすぐに返る。
+     * ソートの完了は TavioMesh の "sort" イベントで検知する(イベントの直後にソート中フラグが下りる)。
+     * worker の異常などで完了しない場合に備えて、timeoutMs を過ぎたら待つのをやめる
+     * @param timeoutMs - 待ち時間の上限(ms)
+     * @private
+     */
+    private _waitForSortSettled;
+    /**
+     * 直前に発行した GPU コマンドが完了するまで待つ(GPU フェンスをポーリングする)。
+     * WebGL2 でない環境やフェンスが無い場合はすぐに返る。timeoutMs を過ぎたら待つのをやめる
+     * @param timeoutMs - 待ち時間の上限(ms)
+     * @private
+     */
+    private _waitForGpuIdle;
+    /**
+     * 現在の描画内容を ImageBitmap として取得する(動画の書き出しなど、フレーム単位で連続して取得する用途)
+     * 描画の途中経過ではなく確定した内容を返すために、取得の前に次の順で描画を落ち着かせる
+     * 1. カメラを移動し、1フレーム描画する(カメラの行列を更新し、視野が変わっていれば深度の焼き込みとソートが始まる)
+     * 2. 進行中のソートを待つ。描画でソートが始まらなかった(視野の変化が小さい)場合は、現在のカメラで強制的にソートして待つ
+     * 3. ソート結果を反映して1フレーム描画し、GPU の処理完了を待つ
+     * 4. 同じタスク内で canvas の内容を複製する(createImageBitmap は canvas を元にする場合、呼び出し時点の内容を複製する)
+     * OffscreenCanvas(Worker)では OffscreenDriver から RPC で呼び出され、ImageBitmap は transfer で返る
+     * @param options.cameraPathProgress - 指定すると、描画の前にカメラパス上のこの位置(0.0 ～ 1.0)へ
+     *   イージングなしでカメラを移動する(カメラパスのコントロールが有効なときのみ反映される)。
+     *   数値でない値・NaN は無視する。animatePath 等のアニメーション中に呼ぶとアニメーション側の
+     *   更新で上書きされるため、呼び出し側でアニメーションを止めてから使うこと
+     */
+    captureFrame(options?: {
+        cameraPathProgress?: number;
+    }): Promise<ImageBitmap>;
     /**
      * 現在の描画内容を画像として取得する
      * preserveDrawingBuffer が無効でも取得できるよう、その場で1フレーム描画し、同じタスク内で
@@ -828,6 +870,15 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param force - イージング（補間）を行わず即座にカメラへ反映するかどうか [default: false]
      */
     updateCameraPath(time: number, force?: boolean): void;
+    /**
+     * カメラパスが有効な場合、指定された時間の位置と姿勢を TransferControls(force 時はカメラ本体にも)へ設定する。
+     * 描画の再開(start)は行わないため、その場で描画する captureFrame のように呼び出し側で描画を制御したい場合に使う
+     * @param time - 設定する時間（0.0 ～ 1.0）
+     * @param force - イージング（補間）を行わず即座にカメラへ反映するかどうか
+     * @returns カメラパスが有効で値を設定できた場合は true
+     * @private
+     */
+    private _applyCameraPath;
     /**
      * カメラパスを名前と座標データで追加登録する
      * @param name - カメラパスの識別名

package/build/esm/types/viewer/driver/iCoreDriver.d.ts

@@ -66,6 +66,14 @@ export interface iCoreDriver extends EventEmitter {
      * @param quality - 画質(0〜1)。"image/jpeg" や "image/webp" のときのみ有効
      */
     captureImage(type?: string, quality?: number): Promise<Blob>;
+    /**
+     * 現在の描画内容を ImageBitmap として取得する(動画の書き出しなど、フレーム単位で連続して取得する用途)
+     * @param options.cameraPathProgress - 指定すると、描画の前にカメラパス上のこの位置(0.0 ～ 1.0)へ
+     *   イージングなしでカメラを移動する(カメラパスのコントロールが有効なときのみ反映される)
+     */
+    captureFrame(options?: {
+        cameraPathProgress?: number;
+    }): Promise<ImageBitmap>;
     addTavioMesh(name: string): void;
     removeTavioMesh(name: string, renderViewName?: string | Symbol): void;
     removeTavioMeshAllRenderView(name: string): void;

package/build/esm/types/viewer/driver/offscreenDriver.d.ts

@@ -153,6 +153,13 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
      * (Blob は構造化複製で Worker からメインスレッドへ返る)
      */
     captureImage(type?: string, quality?: number): Promise<Blob>;
+    /**
+     * Worker 内の OffscreenCanvas で描画した内容を ImageBitmap として取得する
+     * (ImageBitmap は Worker からメインスレッドへ transfer で返るため複製は発生しない)
+     */
+    captureFrame(options?: {
+        cameraPathProgress?: number;
+    }): Promise<ImageBitmap>;
     addTavioMesh(name: string): void;
     getFirstMeshName(): Promise<string | null>;
     createRenderView(name: string | Symbol): void;

package/build/esm/types/viewer/tavioMesh/tavioMesh.d.ts

@@ -275,6 +275,11 @@ export declare class TavioMesh extends EventEmitter {
      * 点描画用の Points インスタンスを返す
      */
     getPoints(): Points | null;
+    /**
+     * 指定のレンダービュー向けのソート(深度の焼き込みから並び順の反映まで)が進行中かどうかを返す
+     * @param renderViewName - レンダービューの名前
+     */
+    isSorting(renderViewName: string | Symbol): boolean;
     /**
      * メッシュのインスタンスを返す
      */

package/build/esm/wasm/pkg/no-thread/tavio.d.ts

@@ -92,8 +92,8 @@ export interface InitOutput {
     readonly registerEventHandler: (a: number) => number;
     readonly resolveGaussianEdits: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
     readonly sort: (a: number, b: number, c: number) => number;
-    readonly __wasm_bindgen_func_elem_2979: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_2981: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_2978: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_2980: (a: number, b: number, c: number, d: number) => void;
     readonly __wasm_bindgen_func_elem_1190: (a: number, b: number, c: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;

package/build/esm/wasm/pkg/no-thread/tavio.js

@@ -618,7 +618,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_2981(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_2980(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -762,7 +762,7 @@ function __wbg_get_imports() {
         },
         __wbindgen_generic_0000000000000002: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 632, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_2979);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_2978);
             return addHeapObject(ret);
         },
         __wbindgen_generic_0000000000000003: function(arg0) {
@@ -831,14 +831,14 @@ function __wasm_bindgen_func_elem_1190(arg0, arg1, arg2) {
     wasm.__wasm_bindgen_func_elem_1190(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_2981(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_2981(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_2980(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_2980(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
-function __wasm_bindgen_func_elem_2979(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_2978(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_2979(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_2978(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {

package/build/esm/wasm/pkg/no-thread/tavio_bg.wasm.d.ts

@@ -27,8 +27,8 @@ export const main: () => void;
 export const registerEventHandler: (a: number) => number;
 export const resolveGaussianEdits: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
 export const sort: (a: number, b: number, c: number) => number;
-export const __wasm_bindgen_func_elem_2979: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_2981: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_2978: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_2980: (a: number, b: number, c: number, d: number) => void;
 export const __wasm_bindgen_func_elem_1190: (a: number, b: number, c: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;

package/build/esm/wasm/pkg/thread/tavio.d.ts

@@ -110,10 +110,10 @@ export interface InitOutput {
     readonly wbg_rayon_poolbuilder_numThreads: (a: number) => number;
     readonly wbg_rayon_poolbuilder_receiver: (a: number) => number;
     readonly wbg_rayon_start_worker: (a: number) => void;
-    readonly __wasm_bindgen_func_elem_3151: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_3154: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_3149: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_3152: (a: number, b: number, c: number, d: number) => void;
     readonly __wasm_bindgen_func_elem_1228: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_3153: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_3151: (a: number, b: number, c: number) => void;
     readonly memory: WebAssembly.Memory;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;

package/build/esm/wasm/pkg/thread/tavio.js

@@ -690,7 +690,7 @@ function __wbg_get_imports(memory) {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_3154(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_3152(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -728,7 +728,7 @@ function __wbg_get_imports(memory) {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_3154(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_3152(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -906,12 +906,12 @@ function __wbg_get_imports(memory) {
         },
         __wbindgen_generic_0000000000000002: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 640, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3151);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3149);
             return addHeapObject(ret);
         },
         __wbindgen_generic_0000000000000003: function(arg0, arg1) {
             // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 659, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3153);
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3151);
             return addHeapObject(ret);
         },
         __wbindgen_generic_0000000000000004: function(arg0) {
@@ -995,18 +995,18 @@ function __wasm_bindgen_func_elem_1228(arg0, arg1, arg2) {
     wasm.__wasm_bindgen_func_elem_1228(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_3153(arg0, arg1, arg2) {
-    wasm.__wasm_bindgen_func_elem_3153(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_3151(arg0, arg1, arg2) {
+    wasm.__wasm_bindgen_func_elem_3151(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_3154(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_3154(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_3152(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_3152(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
-function __wasm_bindgen_func_elem_3151(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_3149(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_3151(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_3149(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {

package/build/esm/wasm/pkg/thread/tavio_bg.wasm.d.ts

@@ -32,10 +32,10 @@ export const wbg_rayon_poolbuilder_build: (a: number) => void;
 export const wbg_rayon_poolbuilder_numThreads: (a: number) => number;
 export const wbg_rayon_poolbuilder_receiver: (a: number) => number;
 export const wbg_rayon_start_worker: (a: number) => void;
-export const __wasm_bindgen_func_elem_3151: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_3154: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_3149: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_3152: (a: number, b: number, c: number, d: number) => void;
 export const __wasm_bindgen_func_elem_1228: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_3153: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_3151: (a: number, b: number, c: number) => void;
 export const memory: WebAssembly.Memory;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openheart/tavio-renderer",
-  "version": "2.6.6",
+  "version": "2.6.8",
   "author": "OpenHeart Inc.",
   "license": "UNLICENSED",
   "description": "Rendering Engine for Tavio Format 3D data",