@openheart/tavio-renderer 2.2.12-without-wasm → 2.3.1-withWasm

package/build/esm/types/camera/orbitControls.d.ts

@@ -1,9 +1,15 @@
-import { PerspectiveCamera, Vector3 } from 'three';
+import { PerspectiveCamera, Vector2, Vector3 } from 'three';
 import { default as EventEmitter } from 'eventemitter3';
 interface iOrbitState {
     position: Vector3;
     target: Vector3;
 }
+interface iThetaPhi {
+    theta: number;
+    phi: number;
+    eye?: Vector3;
+    eyeXZ?: Vector2;
+}
 /**
  * カメラを中心に首振りや仰角方向の視線制御を可能とするカメラコントロール
  * @class
@@ -64,15 +70,16 @@ export declare class OrbitControls extends EventEmitter {
     private _quatX;
     private _quatY;
     static EVENTS: string[];
+    /**
+     * 与えられた三次元ベクトル（要正規化）から theta と phi を計算する
+     * @param eye - 正規化されたベクトル
+     */
+    static calcThetaPhi(eye: Vector3): iThetaPhi;
     /**
      * @constructor
      * @param camera - 制御の対象となるカメラ
      */
     constructor(camera: PerspectiveCamera);
-    /**
-     * 現在の視線から theta と phi を計算する
-     */
-    private _getTP;
     /**
      * 大きなラジアンをクランプする
      * @param value - 処理対象となる値
@@ -116,6 +123,10 @@ export declare class OrbitControls extends EventEmitter {
      * 注視点とカメラの距離を設定する
      */
     setDistance(distance: number): void;
+    /**
+     * 現在の向き（ラジアンでの緯度経度）
+     */
+    getAngle(): iThetaPhi;
     /**
      * 前後移動（相対指定）
      * @param value - 距離

package/build/esm/types/types/global.d.ts

@@ -1,9 +1,13 @@
-declare module '*.vert' {
-  const content: any;
+declare module '*.vert?raw' {
+  const content: string;
   export default content;
 }
-declare module '*.frag' {
-  const content: any;
+declare module '*.frag?raw' {
+  const content: string;
+  export default content;
+}
+declare module '*.glsl?raw' {
+  const content: string;
   export default content;
 }
 

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

@@ -14,6 +14,7 @@ import { iBoxSelectorOption } from '../editor/selector/boxSelector';
 import { Selector } from '../editor/selector/selector';
 import { TavioMesh } from './tavioMesh';
 import { iAnimationConfig } from '../animation/animationController';
+import { iMaterialOption } from './materialGenerator';
 /**
  * Tavio Viewer のエラーコード
  */
@@ -59,6 +60,7 @@ interface iCameraPathOption {
 interface iCameraParameter {
     position?: number[];
     eye?: number[];
+    target?: number[];
     fov?: number;
 }
 /**
@@ -94,6 +96,13 @@ export interface iViewerOption {
     enableOrbitCursor?: boolean;
     orbitCursorScale?: number;
 }
+/**
+ * ビューアのマテリアルオプション
+ */
+export interface iViewerMaterialOption {
+    materialOption: iMaterialOption | iMaterialOption[];
+    isDebug?: boolean;
+}
 /**
  * セレクターの情報
  */
@@ -208,6 +217,32 @@ export declare class Core extends EventEmitter {
      * 対応する Controls 種別
      */
     static CONTROLS: string[];
+    /**
+     * シェーダチャンク関連（定義は MaterialGenerator.ts 内）
+     */
+    static CHUNK_TARGET: {
+        readonly ANY: 0;
+        readonly BASIC: 1;
+        readonly PICKING: 2;
+    };
+    static SHADER_STAGE: {
+        readonly VERTEX_PRECISION: 0;
+        readonly VERTEX_DECLARATION: 1;
+        readonly VERTEX_FUNCTION: 2;
+        readonly VERTEX_MAIN_BEGIN: 3;
+        readonly VERTEX_MAIN_TRANSFORM: 4;
+        readonly VERTEX_MAIN_SIGMA: 5;
+        readonly VERTEX_MAIN_OUT: 6;
+        readonly VERTEX_MAIN_END: 7;
+        readonly FRAGMENT_PRECISION: 8;
+        readonly FRAGMENT_DECLARATION: 9;
+        readonly FRAGMENT_FUNCTION: 10;
+        readonly FRAGMENT_MAIN_BEGIN: 11;
+        readonly FRAGMENT_MAIN_IN: 12;
+        readonly FRAGMENT_MAIN_OUT: 13;
+        /** Float16Array 未対応環境 */
+        readonly FRAGMENT_MAIN_END: 14;
+    };
     /**
      * @constructor
      * @param viewerOption - ビューア実装の初期化オプション
@@ -228,8 +263,14 @@ export declare class Core extends EventEmitter {
     /**
      * 各種初期化処理を行う
      * @param canvas - WebGL コンテキストを取得する対象となる canvas 要素
+     * @param materialOption - シェーダチャンクなどの情報を含むマテリアルオプション
      */
-    init(canvas: HTMLCanvasElement): void;
+    init(canvas: HTMLCanvasElement, materialOption?: iViewerMaterialOption): void;
+    /**
+     * マテリアルをセットアップする
+     * @param option - シェーダチャンクなどの情報を含むマテリアルオプション
+     */
+    setupMaterial(option?: iViewerMaterialOption): void;
     /**
      * カメラコントロール・カメラコライダーをセットアップする
      */
@@ -307,7 +348,7 @@ export declare class Core extends EventEmitter {
     /**
      * 既存の TavioMesh のインスタンスにデータを統合する
      * @param name - このメッシュの固有名
-     * @param url - 読み込む .tavio ファイル
+     * @param url - 読み込む .ply ファイル
      * @param option - ロード・パース関連のオプション
      */
     concatPly(name: string, url: string, option?: iLoadingOption): Promise<void>;
@@ -320,10 +361,33 @@ export declare class Core extends EventEmitter {
     /**
      * 既存の TavioMesh のインスタンスにデータを統合する
      * @param name - このメッシュの固有名
-     * @param url - 読み込む .tavio ファイル
-     * @param option - ロード・パース関連のオプション
+     * @param url - 読み込む .splat ファイル
      */
     concatSplat(name: string, url: string): Promise<void>;
+    /**
+     * TavioMesh のインスタンスを生成し画像形式のリソースをロード、シーンに追加する
+     * @param name - このメッシュの固有名
+     * @param url - 読み込む画像ファイル
+     */
+    loadImage(name: string, url: string): Promise<void>;
+    /**
+     * 既存の TavioMesh のインスタンスにデータを統合する
+     * @param name - このメッシュの固有名
+     * @param url - 読み込む画像ファイル
+     */
+    concatImage(name: string, url: string): Promise<void>;
+    /**
+     * canvas 要素から TavioMesh のインスタンスを生成し、シーンに追加する
+     * @param name - このメッシュの固有名
+     * @param canvas - 処理の対象となる canvas 要素
+     */
+    loadCanvas(name: string, canvas: HTMLCanvasElement): Promise<void>;
+    /**
+     * 既存の TavioMesh のインスタンスにデータを統合する
+     * @param name - このメッシュの固有名
+     * @param canvas - 処理の対象となる canvas 要素
+     */
+    concatCanvas(name: string, canvas: HTMLCanvasElement): Promise<void>;
     /**
      * tavio 形式のリソースをロードする
      * @param name - このメッシュの固有名
@@ -335,13 +399,49 @@ export declare class Core extends EventEmitter {
      * @param name - このメッシュの固有名
      * @see {@link TavioMesh.prototype.loadPlyWasm}
      */
-    loadPlyWasm(name: string, ...args: Parameters<typeof TavioMesh.prototype.loadPlyWasm>): Promise<void>;
+    loadPlyWasm(name: string, url: string, options?: Parameters<typeof TavioMesh.prototype.loadMeshWasm>[2]): Promise<void>;
+    /**
+     * splat 形式のリソースをロードする
+     * @param name - このメッシュの固有名
+     * @see {@link TavioMesh.prototype.loadSplatWasm}
+     */
+    loadSplatWasm(name: string, url: string, options?: Parameters<typeof TavioMesh.prototype.loadMeshWasm>[2]): Promise<void>;
     /**
-     * tavio 形式のリソースをセーブする
+     * spz 形式のリソースをロードする
      * @param name - このメッシュの固有名
-     * @see {@link TavioMesh.prototype.saveTavioWasm}
+     * @see {@link TavioMesh.prototype.loadSpzWasm}
      */
-    saveTavioWasm(name: string, ...args: Parameters<typeof TavioMesh.prototype.saveTavioWasm>): Promise<void>;
+    loadSpzWasm(name: string, url: string, options?: Parameters<typeof TavioMesh.prototype.loadMeshWasm>[2]): Promise<void>;
+    /**
+     * sog 形式のリソースをロードする
+     * @param name - このメッシュの固有名
+     * @see {@link TavioMesh.prototype.loadSogWasm}
+     */
+    loadSogWasm(name: string, url: string, options?: Parameters<typeof TavioMesh.prototype.loadMeshWasm>[2]): Promise<void>;
+    /**
+     * tavio 形式のリソースを保存する
+     * @param name - このメッシュの固有名
+     * @param fileName - 保存ファイル名
+     */
+    saveTavioWasm(name: string, fileName: string): Promise<void>;
+    /**
+     * splat 形式のリソースを保存する
+     * @param name - このメッシュの固有名
+     * @param fileName - 保存ファイル名
+     */
+    saveSplatWasm(name: string, fileName: string): Promise<void>;
+    /**
+     * ply 形式のリソースを保存する
+     * @param name - このメッシュの固有名
+     * @param fileName - 保存ファイル名
+     */
+    savePlyWasm(name: string, fileName: string): Promise<void>;
+    /**
+     * spz 形式のリソースを保存する
+     * @param name - このメッシュの固有名
+     * @param fileName - 保存ファイル名
+     */
+    saveSpzWasm(name: string, fileName: string): Promise<void>;
     /**
      * 名前を指定してロード済み TavioMesh をシーンに追加する
      * @param name - 対象の名前
@@ -376,14 +476,14 @@ export declare class Core extends EventEmitter {
     setBackgroundOpacity(opacity: number): void;
     /**
      * 名前を指定した TavioMesh に含まれるインスタンスを、インデックスで指定して動かす
-     * ※ここでいうインデックスとは load/concat した順番を意味する整数値
+     * ※ここでいうインデックスとは load/concat した順番を意味する整数値（concat していない場合常に 0）
      * @param name - 対象の名前
      * @param index - インデックス
      * @param translation - 平行移動
      * @param rotation - 回転（オイラー角）
      * @param scale - 拡大縮小（XYZ で統一のスケール）
      */
-    setTransform(name: string, index: number, translation: Vector3, rotation: Euler, scale: number): void;
+    setTransform(name: string, index: number, translation: iVectorLike, rotation: iVectorLike, scale: number): void;
     /**
      * 名前を指定した TavioMesh に含まれるインスタンスの、指定されたインデックスの座標変換情報を返す
      * ※ここでいうインデックスとは load/concat した順番を意味する整数値
@@ -391,6 +491,14 @@ export declare class Core extends EventEmitter {
      * @param index - インデックス
      */
     getTransform(name: string, index: number): iTransform;
+    /**
+     * 名前を指定した TavioMesh に含まれるインスタンスをビルボードとして扱うかどうかを設定する
+     * ※ここでいうインデックスとは load/concat した順番を意味する整数値
+     * @param name - 対象の名前
+     * @param index - インデックス
+     * @param flag - ビルボードとして扱うかどうか
+     */
+    setBillboard(name: string, index: number, flag: boolean): void;
     /**
      * ==========================================================================
      * general
@@ -458,22 +566,28 @@ export declare class Core extends EventEmitter {
      * @private
      */
     private _updateViewportUniforms;
+    /**
+     * 座標を焼き込むレンダリング処理を実行しソートを実行させる
+     * @param isForce - 強制的に実行するかどうか
+     */
+    private _renderDepthRenderTarget;
     /**
      * ==========================================================================
      * camera
      * ==========================================================================
      */
     /**
-     * カメラの現在の座標と注視点、視野角を取得する
+     * カメラの現在の座標と視線方向、視野角を取得する
      */
     getCameraParameter(): iCameraParameter;
     /**
-     * カメラの現在の座標と注視点、視野角を取得する
+     * カメラの現在の座標と注視点、視野角を設定する
+     * ※このメソッドは設定時、その値が即座に反映される
      * @param position - 設定する座標
-     * @param eye - 設定する注視点
+     * @param target - 設定する注視点
      * @param fov - 設定する視野角
      */
-    setCameraParameter(position: iVectorLike, eye: iVectorLike, fov?: number): void;
+    setCameraParameter(position: iVectorLike | null, target?: iVectorLike | null, fov?: number | null): void;
     /**
      * ==========================================================================
      * controls
@@ -498,23 +612,6 @@ export declare class Core extends EventEmitter {
      * orbit controls
      * ==========================================================================
      */
-    /**
-     * オービットコントロールの注視点の座標を取得する
-     * @returns 注視点の座標
-     */
-    getOrbitTarget(): iVectorLike;
-    /**
-     * オービットコントロールの注視点と座標を設定する
-     * @param position - カメラの座標
-     * @param target - 注視点の座標
-     * setTransferPositionのみ呼び出した場合、見た目が変わらなかったため本関数を作成。
-     */
-    setOrbitPositionAndTarget(position: iVectorLike, target: iVectorLike): void;
-    /**
-     * オービットコントロールの注視点を設定する
-     * @param target - 注視点の座標
-     */
-    setOrbitTarget(target: iVectorLike): void;
     /**
      * オービットコントロールのズーム使用可否を設定する
      * @param enable - 使用可否を意味する真偽値
@@ -731,6 +828,12 @@ export declare class Core extends EventEmitter {
      * @param isForce - トランジションせず即座に強制上書きするかどうか
      */
     setTransferRelativePosition(position: iVectorLike, isForce?: boolean): void;
+    /**
+     * TransferControls に fov を設定する
+     * @param fov - 設定する fov
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setTransferFov(fov: number, isForce?: boolean): void;
     /**
      * TransferControls に、現在の位置と向きに応じて移動するよう設定する
      * @param offset - 移動する量
@@ -758,12 +861,6 @@ export declare class Core extends EventEmitter {
      * @param isForce - トランジションせず即座に強制上書きするかどうか
      */
     moveTransferToBottom(scale: number, isForce?: boolean): void;
-    /**
-     * TransferControls に fov を設定する
-     * @param fov - 設定する fov
-     * @param isForce - トランジションせず即座に強制上書きするかどうか
-     */
-    setTransferFov(fov: number, isForce?: boolean): void;
     /**
      * ==========================================================================
      * camera collider
@@ -791,6 +888,11 @@ export declare class Core extends EventEmitter {
      * @param uniforms - 設定する値を定義したオブジェクト
      */
     private _setPointUniforms;
+    /**
+     * MaterialGenerator で独自に拡張した uniform 変数を更新する
+     * @param customUniforms - 設定・更新する uniform 変数
+     */
+    setCustomUniforms(customUniforms: any): void;
     /**
      * ガウシアンの大きさの基本係数を設定する
      * @param value - 設定する係数（0.0 to 1.0）

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

@@ -0,0 +1,120 @@
+import { RawShaderMaterial } from 'three';
+/**
+ * MaterialGenerator は原則として static なメソッドのみで実装しステートを持たない。
+ *
+ * ビューアの基本機能については src/shaderChunk 以下にシェーダのチャンクとなる各部品を置く。
+ * src/shaderChunk/common 以下にあるシェーダは 3DGS を描画するのみで色もつかない、最もシンプルな形。
+ * src/shaderChunk/viewer は直流成分および交流成分の計算など、ビューアの基本機能を拡張する。
+ * src/shaderChunk/editor はカラーグレーディングなどのエディタ用機能。
+ * src/shaderChunk/picking は座標をレンダリングするピッキング用のシェーダ。
+ *
+ * 独自に拡張する場合は、iMaterialOption 単体またはその配列を定義し MaterialGenerator.generate() に渡す。
+ * iMaterialOption.target で、ベーシックやピッキングなどのシェーダを結合する対象を（CHUNK_TARGET の論理和で）指定する。
+ * iMaterialOption.uniforms で拡張部分で用いる uniform 変数を定義。
+ * iMaterialOption.vertex / fragment でシェーダのチャンク情報を iShaderChunk 単体または配列で指定する。
+ *
+ * iShaderChunk.stage は SHADER_STAGE で定義されているシェーダ内のステージの指定。
+ * iShaderChunk.source はシェーダのソースコード。
+ *
+ * このファイル内で定義されているシェーダのチャンクは src/shaderChunk/common 以下にあるもののみ。
+ * それ以外のチャンクは canvas.ts など、ビューア実装側で付与する。
+ */
+/**
+ * チャンクをどのシェーダに反映するかを表す
+ * これらの値は論理和を用いて組み合わせて指定できる
+ */
+export declare const CHUNK_TARGET: {
+    readonly ANY: 0;
+    readonly BASIC: 1;
+    readonly PICKING: 2;
+};
+export type tChunkTarget = typeof CHUNK_TARGET[keyof typeof CHUNK_TARGET];
+/**
+ * チャンクがどのステージにあたるかを表す
+ * 指定されたステージの末尾に処理が追加される
+ */
+export declare const SHADER_STAGE: {
+    readonly VERTEX_PRECISION: 0;
+    readonly VERTEX_DECLARATION: 1;
+    readonly VERTEX_FUNCTION: 2;
+    readonly VERTEX_MAIN_BEGIN: 3;
+    readonly VERTEX_MAIN_TRANSFORM: 4;
+    readonly VERTEX_MAIN_SIGMA: 5;
+    readonly VERTEX_MAIN_OUT: 6;
+    readonly VERTEX_MAIN_END: 7;
+    readonly FRAGMENT_PRECISION: 8;
+    readonly FRAGMENT_DECLARATION: 9;
+    readonly FRAGMENT_FUNCTION: 10;
+    readonly FRAGMENT_MAIN_BEGIN: 11;
+    readonly FRAGMENT_MAIN_IN: 12;
+    readonly FRAGMENT_MAIN_OUT: 13;
+    readonly FRAGMENT_MAIN_END: 14;
+};
+export type tShaderStage = typeof SHADER_STAGE[keyof typeof SHADER_STAGE];
+/**
+ * シェーダのソースコード定義
+ */
+export interface iShaderSource {
+    vertex: string;
+    fragment: string;
+}
+/**
+ * 生成したマテリアル群
+ */
+export interface iMaterials {
+    basic: RawShaderMaterial;
+    picking: RawShaderMaterial;
+}
+/**
+ * マテリアル生成に使われるシェーダチャンク
+ */
+export interface iShaderChunk {
+    stage: tShaderStage;
+    source: string;
+}
+/**
+ * マテリアルを生成するためのオプション
+ */
+export interface iMaterialOption {
+    target: tChunkTarget;
+    uniforms?: any;
+    vertex?: iShaderChunk | iShaderChunk[];
+    fragment?: iShaderChunk | iShaderChunk[];
+}
+/**
+ * 複数のシェーダチャンクを組み合わせてマテリアルを生成する
+ */
+export declare class MaterialGenerator {
+    /**
+     * shaderChunk/common に含まれる頂点シェーダのチャンクをセットした Map オブジェクトを生成する
+     */
+    private static _createVertexMap;
+    /**
+     * shaderChunk/common に含まれるフラグメントシェーダのチャンクをセットした Map オブジェクトを生成する
+     */
+    private static _createFragmentMap;
+    /**
+     * シェーダチャンクに iMaterialOption.vertex / fragment に含まれるソースコードを結合する
+     * @param option - シェーダチャンクを含むマテリアルオプション
+     * @param vsMap - 頂点シェーダ用
+     * @param fsMap - フラグメントシェーダ用
+     * @return 各ステージに何回チャンクが結合されたかを表す配列
+     */
+    private static _mergeShaderSource;
+    /**
+     * uniform 変数用の雛形を生成する（src/shderChunk/common 以下で定義される最低限のもの）
+     */
+    private static _createUniforms;
+    /**
+     * Map オブジェクトに含まれるソースコードを結合する
+     * @param map - 処理の対象となる Map オブジェクト
+     * @param isDebug - デバッグ用にコンソールにソースコードを出力するかどうか
+     */
+    private static _createShaderSource;
+    /**
+     * マテリアルを生成する
+     * @param option - シェーダチャンクなどの情報を含むマテリアルオプション
+     * @param isDebug - デバッグ用にコンソールにソースコードを出力するかどうか
+     */
+    static generate(option?: iMaterialOption | iMaterialOption[], isDebug?: boolean): iMaterials;
+}

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

@@ -1,8 +1,29 @@
 import { CubeTexture, DataTexture, Euler, PerspectiveCamera, Points, RawShaderMaterial, Texture, Vector3, WebGLRenderer } from 'three';
 import { default as EventEmitter } from 'eventemitter3';
-import { iLoadingOption, iViewerOption, iHeaderInfo, iTransform } from './canvas';
+import { iLoadingOption, iViewerOption, iHeaderInfo, iTransform, iVectorLike } from './canvas';
 import { iCollisionTarget } from '../worker/tavioWorker';
 import { InstancedMeshEX } from '../extension/InstancedMeshEX';
+/**
+ * 画素情報として扱えるオブジェクト
+ */
+type tImageSource = HTMLImageElement | HTMLCanvasElement;
+/**
+ * 画像や canvas 要素をパースした結果
+ */
+interface iSplatSource {
+    count: number;
+    position32: Float32Array;
+    color8: Uint8ClampedArray;
+    converted: Uint8Array;
+    min: {
+        alpha: number;
+        scale: iVectorLike;
+    };
+    max: {
+        alpha: number;
+        scale: iVectorLike;
+    };
+}
 export declare class TavioMesh extends EventEmitter {
     private perspectiveCamera;
     private worker;
@@ -61,6 +82,7 @@ export declare class TavioMesh extends EventEmitter {
     private useWasmSort;
     private wasmSortClient;
     private isSorting;
+    private hasBillboard;
     private lastViewProjectionMatrix;
     private depthRenderTarget;
     private depthRenderScene;
@@ -98,7 +120,7 @@ export declare class TavioMesh extends EventEmitter {
      * @param material - メッシュの生成に使うマテリアルは上の層から指定されたものを使う
      * @param pickingMaterial - メッシュの生成に使うマテリアルは上の層から指定されたものを使う
      */
-    constructor(index: number, camera: PerspectiveCamera, material: RawShaderMaterial, pinckingMaterial: RawShaderMaterial, viewerOption: iViewerOption);
+    constructor(index: number, camera: PerspectiveCamera, material: RawShaderMaterial, pickingMaterial: RawShaderMaterial, viewerOption: iViewerOption);
     /**
      * ==========================================================================
      * loader
@@ -121,6 +143,11 @@ export declare class TavioMesh extends EventEmitter {
      * @param url - 読み込む .splat ファイル
      */
     loadSplat(url: string): Promise<void>;
+    /**
+     * 画像形式のリソースをロードする
+     * @param url - 読み込む画像ファイル
+     */
+    loadImage(url: string): Promise<void>;
     /**
      * tavio 形式のリソースをロードする
      * @param url - 読み込む .tavio ファイル
@@ -142,38 +169,36 @@ export declare class TavioMesh extends EventEmitter {
         isEncodeEnabled?: boolean;
     }): Promise<void>;
     /**
-     * ply 形式のリソースをロードする
-     * @param url - 読み込む .ply ファイル
-     * @param option - ロード・パース関連のオプション
-     * @param options.decodeMode - デコードモード. "sync", "concurrent", "parallel" を指定
-     * @param options.maxThreads - decodeMode が "parallel" のときに使用されるスレッド数の上限
-     * @param options.maxDecodePoints - 最大デコード点数. これを超える点は読み込まれない
+     * 様々な形式のリソースをロードする
+     * @param url - 読み込むファイル
+     * @param format - ファイル形式
+     * @param options - ロード・パース関連のオプション
      * @param options.useSphericalHarmonics - 球面調和関数を使用
      */
-    loadPlyWasm(url: string, options?: ({
-        decodeMode?: "sync" | "concurrent";
-    } | {
-        decodeMode: "parallel";
-        maxThreads?: number;
-    }) & {
-        maxDecodePoints?: number;
+    loadMeshWasm(url: string, format: "splat" | "ply" | "spz" | "sog", options?: {
         useSphericalHarmonics?: boolean;
     }): Promise<void>;
     /**
-     * tavio 形式のリソースをセーブする
-     * @param filename - 保存する .tavio ファイル名
-     * @param option - セーブ関連のオプション
-     * @param option.version - バージョン番号
-     * @param option.useSphericalHarmonics - 球面調和関数を使用する
-     * @param option.useGeneralData - 編集データを反映する
-     * @param option.featureFlags - tavio形式のフィーチャーフラグ
+     * 様々な形式のリソースをセーブする
+     * @param filename - 保存ファイル名
      */
-    saveTavioWasm(filename: string, options?: {
-        version?: String;
-        useSphericalHarmonics?: boolean;
-        useGeneralData?: boolean;
-        featureFlags?: number;
-    }): Promise<void>;
+    saveTavioWasm(filename: string): Promise<void>;
+    /**
+    * 様々な形式のリソースをセーブする
+    * @param filename - 保存ファイル名
+     * @param format - ファイル形式
+     */
+    saveMeshWasm(filename: string, format: "splat" | "ply" | "spz" | "sog"): Promise<void>;
+    /**
+     * canvas 要素からガウシアンを生成してシーンに追加する
+     * @param canvas - 対象となる canvas 要素
+     */
+    loadCanvas(canvas: HTMLCanvasElement): Promise<void>;
+    /**
+     * 画像や canvas 要素をパースし変換する
+     * @param imageSource - 対象となる画像や canvas
+     */
+    convertImageSource(imageSource: tImageSource): iSplatSource;
     /**
      * ==========================================================================
      * getter / setter
@@ -264,13 +289,30 @@ export declare class TavioMesh extends EventEmitter {
      * @param translation - 平行移動
      * @param rotation - 回転（オイラー角）
      * @param scale - 拡大縮小（XYZ で統一のスケール）
+     * @param force - 同時にテクスチャの内容を強制的に書き換えるかどうか
      */
-    setTransform(index: number, translation: Vector3, rotation: Euler, scale: number): void;
+    setTransform(index: number, translation: Vector3, rotation: Euler, scale: number, isForce?: boolean): void;
     /**
      * 指定されたインデックスの座標変換情報を返す
      * @param index - インデックス
      */
     getTransform(index: number): iTransform;
+    /**
+     * インデックスを指定してビルボードの設定を行う
+     * @param index - インデックス
+     * @param flag - ビルボードとして扱うかどうか
+     */
+    setBillboard(index: number, flag: boolean): void;
+    /**
+     * ビルボードのための transform 情報の更新を行う
+     * @param camera - カメラのワールド空間上の位置
+     */
+    updateBillboard(camera: PerspectiveCamera): void;
+    /**
+     * インスタンスごとの transform 情報をテクスチャに適用し更新する
+     * @private
+     */
+    private _updateTransformData;
     /**
      * 自身のプロパティの状態に応じて球面調和関数に関連する uniform 変数の更新を行う
      * @private
@@ -325,6 +367,10 @@ export declare class TavioMesh extends EventEmitter {
      * setup
      * ==========================================================================
      */
+    /**
+     * データのロード前に各種フラグをセットアップする
+     */
+    setupFlags(): void;
     /**
      * tavio 形式用の worker をセットアップする
      */