@openheart/tavio-renderer 2.5.0 → 2.6.1

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

@@ -62,6 +62,18 @@ export declare class Core extends EventEmitter {
     loadTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadTavioWasm(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadPlyWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSplatWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSpzWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSogWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
     loadSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
     loadCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
@@ -75,6 +87,12 @@ export declare class Core extends EventEmitter {
     saveSpzWasm(name: string, fileName?: string): Promise<any>;
     saveTavioWasm(name: string, fileName?: string, options?: any): Promise<any>;
     exportTavioWasm(name: string, options?: any): Promise<any>;
+    /**
+     * 現在の描画内容を画像として取得する。OffscreenCanvas(Worker)で描画している場合も取得できる
+     * @param type - 画像の MIME タイプ [default: "image/png"]
+     * @param quality - 画質(0〜1)。"image/jpeg" や "image/webp" のときのみ有効
+     */
+    captureImage(type?: string, quality?: number): Promise<Blob>;
     addTavioMesh(name: string): void;
     removeTavioMesh(name: string, renderViewName?: string | Symbol): void;
     removeTavioMeshAllRenderView(name: string): void;

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

@@ -86,6 +86,16 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
     /** 直前にフレームを描画した時刻（Date.now()） */
     private _lastFrameTimestamp;
     private _rafId;
+    /**
+     * 直前に発行したフレームのGPU処理完了を検知するためのフェンス。
+     * requestAnimationFrame は GPU の完了を待たずに発火するため、1フレームのGPU処理時間が
+     * 表示間隔を超えると未処理のGPUコマンドが際限なく溜まり、同じGPUを使う他の描画
+     * (ブラウザのコンポジタや他タブのビデオ再生など)が停滞する。前フレームの完了を
+     * 確認できるまで次のフレームを発行しないことで、GPUの処理能力に描画頻度を合わせる
+     */
+    private _gpuFence;
+    /** 次回の _render でGPUフェンスの完了待ちを省略するか(リサイズ直後の即時描画用) */
+    private _bypassGpuFenceOnce;
     /**
      * 対応する Controls 種別
      */
@@ -315,6 +325,15 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
         bytes: Uint8Array;
         version: string;
     }>;
+    /**
+     * 現在の描画内容を画像として取得する
+     * preserveDrawingBuffer が無効でも取得できるよう、その場で1フレーム描画し、同じタスク内で
+     * canvas のスナップショットを取る(toBlob / convertToBlob は呼び出し時点の内容を複製する)
+     * OffscreenCanvas(Worker)では OffscreenDriver から RPC で呼び出され、Worker 内で convertToBlob する
+     * @param type - 画像の MIME タイプ [default: "image/png"]
+     * @param quality - 画質(0〜1)。"image/jpeg" や "image/webp" のときのみ有効
+     */
+    captureImage(type?: string, quality?: number): Promise<Blob>;
     /**
      * tavio 形式のリソースを保存する
      * @param name - このメッシュの固有名
@@ -467,6 +486,19 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @private
      */
     private _render;
+    /**
+     * 前フレームで発行したGPUフェンスがまだ完了していないかどうかを返す。
+     * 完了していればフェンスを破棄する。WebGL2 でない環境やフェンスが無い場合は false
+     */
+    private _isGpuBusy;
+    /**
+     * このフレームのGPUコマンドの末尾にフェンスを発行し、完了検知に使えるよう flush する
+     */
+    private _insertGpuFence;
+    /**
+     * レンダラーの WebGL2 コンテキストを返す。WebGL2 でない場合やコンテキスト喪失時は null
+     */
+    private _getWebGL2Context;
     /**
      * 登録されている最初のメッシュの名前を取得する
      */

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

@@ -34,6 +34,18 @@ export interface iCoreDriver extends EventEmitter {
     loadTavioWasm(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadPlyWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSplatWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSpzWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSogWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
     loadImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
     loadCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
     concatTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
@@ -46,6 +58,12 @@ export interface iCoreDriver extends EventEmitter {
     saveSpzWasm(name: string, fileName?: string): Promise<any>;
     saveTavioWasm(name: string, fileName?: string, options?: any): Promise<any>;
     exportTavioWasm(name: string, options?: any): Promise<any>;
+    /**
+     * 現在の描画内容を画像として取得する(描画内容の画像化・サムネイル生成用)
+     * @param type - 画像の MIME タイプ [default: "image/png"]
+     * @param quality - 画質(0〜1)。"image/jpeg" や "image/webp" のときのみ有効
+     */
+    captureImage(type?: string, quality?: number): Promise<Blob>;
     addTavioMesh(name: string): void;
     removeTavioMesh(name: string, renderViewName?: string | Symbol): void;
     removeTavioMeshAllRenderView(name: string): void;

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

@@ -78,6 +78,18 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     loadTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadTavioWasm(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadPlyWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSplatWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSpzWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSogWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
     loadSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
     loadCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
@@ -131,6 +143,11 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     saveSpzWasm(name: string, fileName?: string): Promise<any>;
     saveTavioWasm(name: string, fileName?: string, options?: any): Promise<any>;
     exportTavioWasm(name: string, options?: any): Promise<any>;
+    /**
+     * Worker 内の OffscreenCanvas で描画した内容を画像として取得する
+     * (Blob は構造化複製で Worker からメインスレッドへ返る)
+     */
+    captureImage(type?: string, quality?: number): Promise<Blob>;
     addTavioMesh(name: string): void;
     getFirstMeshName(): Promise<string | null>;
     createRenderView(name: string | Symbol): void;

package/package.json

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