@openheart/tavio-renderer 2.6.4 → 2.6.6

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

@@ -274,6 +274,30 @@ export declare class Core extends EventEmitter {
     removeGuideLine(name: string): void;
     setVisibleAreaHelper(name: string, option: iVisibleAreaHelperOption): void;
     removeVisibleAreaHelper(name: string): void;
+    /**
+     * glb(glTF)のモデルを読み込み、ガウシアンより先に描画するグループに追加する(スプラットとの前後関係が正しく表示される)。
+     * 不透明なマテリアルのみ対象で、半透明のマテリアルは前後関係が正しくならない。
+     * 追加しただけでは表示せず、setGltfModelTransformsで配置する。同じ名前で呼ぶと置き換える
+     * @param name - モデルの識別名
+     * @param source - glbのURL、またはglbのバイナリ
+     */
+    addGltfModel(name: string, source: string | ArrayBuffer): Promise<void>;
+    /**
+     * 画像を貼った板を、addGltfModelのモデルと同じグループに追加する(スプラットとの前後関係が正しく表示される)。
+     * 板はXY平面上で+Z方向を向き、長辺の長さが1で画像の縦横比に合わせる。画像の上が+Yになる。
+     * 照明の影響は受けず、半透明の画素は切り抜く(縁はギザギザになる)。
+     * 追加しただけでは表示せず、setGltfModelTransformsで配置し、removeGltfModelで削除する。同じ名前で呼ぶと置き換える
+     * @param name - モデルの識別名
+     * @param source - 画像(png/jpeg/webpなど)のURL・Blob・バイナリ、またはImageBitmap
+     */
+    addImageModel(name: string, source: string | Blob | ArrayBuffer | ImageBitmap): Promise<void>;
+    /**
+     * addGltfModelで読み込んだモデルを、行列の数だけ複製して配置する。空の配列を渡すと非表示になる
+     * @param name - モデルの識別名
+     * @param matrices - 各モデルのワールド行列(Matrix4.fromArrayと同じ列優先の16要素)
+     */
+    setGltfModelTransforms(name: string, matrices: number[][]): void;
+    removeGltfModel(name: string): void;
     pickSelector(ndcX: number, ndcY: number): Promise<string | null> | string | null;
     setSelectorScale(name: string, scale: iVectorLike): void;
     deleteSelector(name: string): void;

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

@@ -1492,6 +1492,47 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param name - 削除するクロップ領域の表示の識別名
      */
     removeVisibleAreaHelper(name: string): void;
+    private gltfModelMap;
+    private gltfModelLoadIds;
+    private gltfModelLoadCounter;
+    private gltfModelEnvironment;
+    /**
+     * glb(glTF)のモデルを読み込み、ガウシアンと同じシーンに追加する。
+     * ガウシアンより先に描画して深度を書き込むため、スプラットとの前後関係が正しく表示される。
+     * 半透明のマテリアル(transparent)はガウシアンの後に描画されるため、前後関係が正しくならない点に注意。
+     * 追加した時点では何も表示せず、setGltfModelTransformsで配置した数だけ表示する。
+     * 同じ名前で呼ぶと置き換える。読み込み中に同じ名前で追加・削除された場合、古い読み込み結果は破棄する
+     * @param name - モデルの識別名
+     * @param source - glbのURL、またはglbのバイナリ
+     */
+    addGltfModel(name: string, source: string | ArrayBuffer): Promise<void>;
+    /**
+     * 画像を貼った板を、addGltfModelのモデルと同じグループに追加する(スプラットとの前後関係が正しく表示される)。
+     * 板はXY平面上で+Z方向を向き、長辺の長さが1で画像の縦横比に合わせる。画像の上が+Yになる。
+     * 照明の影響は受けず、アルファがIMAGE_MODEL_ALPHA_TEST未満の画素は切り抜く(半透明の縁はギザギザになる)。
+     * 配置・削除はsetGltfModelTransforms・removeGltfModelで行う。同じ名前で呼ぶと置き換える
+     * @param name - モデルの識別名
+     * @param source - 画像(png/jpeg/webpなど)のURL・Blob・バイナリ、またはImageBitmap(渡したImageBitmapは削除時にcloseする)
+     */
+    addImageModel(name: string, source: string | Blob | ArrayBuffer | ImageBitmap): Promise<void>;
+    /**
+     * addGltfModelで読み込んだモデルを、行列の数だけ複製して配置する。空の配列を渡すと非表示になる
+     * @param name - モデルの識別名
+     * @param matrices - 各モデルのワールド行列(Matrix4.fromArrayと同じ列優先の16要素)
+     */
+    setGltfModelTransforms(name: string, matrices: number[][]): void;
+    /**
+     * 名前を指定してglbのモデルを削除する。読み込み中の場合は読み込み結果を破棄する
+     * @param name - 削除するモデルの識別名
+     */
+    removeGltfModel(name: string): void;
+    /** モデルをシーンから外して破棄する。破棄したかどうかを返す */
+    private releaseGltfModel;
+    private getGltfModelEnvironment;
+    /** 画像のソースからImageBitmapを作る。Workerでも使えるよう、HTMLImageElementは使わない */
+    private static loadImageBitmap;
+    /** glbのモデルのジオメトリ・マテリアル・テクスチャを破棄する。共有している環境マップ(keep)は残す */
+    private static disposeGltfObject;
     /**
      * 画面上の位置(正規化デバイス座標)からレイを飛ばし、最初に当たる表示中のセレクターの名前を返す。
      * 各セレクターを包む境界球で判定し、遠くにある小さなセレクターでもクリックしやすいよう、

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

@@ -241,6 +241,14 @@ export interface iCoreDriver extends EventEmitter {
     setVisibleAreaHelper(name: string, option: iVisibleAreaHelperOption): void;
     /** クロップ領域の表示を削除する */
     removeVisibleAreaHelper(name: string): void;
+    /** glbのモデルを読み込み、ガウシアンとの前後関係を保って描画するグループに追加する。同じ名前で呼ぶと置き換える */
+    addGltfModel(name: string, source: string | ArrayBuffer): Promise<void>;
+    /** 画像を貼った板(長辺1、+Z向き)を、glbのモデルと同じグループに追加する。配置・削除はglbのモデルと同じAPIで行う */
+    addImageModel(name: string, source: string | Blob | ArrayBuffer | ImageBitmap): Promise<void>;
+    /** addGltfModelで読み込んだモデルを、ワールド行列(列優先の16要素)の数だけ複製して配置する */
+    setGltfModelTransforms(name: string, matrices: number[][]): void;
+    /** glbのモデルを削除する */
+    removeGltfModel(name: string): void;
     /** 画面上の位置(正規化デバイス座標)にある、表示中のセレクターの名前を返す(無ければnull) */
     pickSelector(ndcX: number, ndcY: number): Promise<string | null> | string | null;
     setSelectorScale(name: string, scale: iVectorLike): void;

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

@@ -247,6 +247,10 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     removeGuideLine(name: string): void;
     setVisibleAreaHelper(name: string, option: iVisibleAreaHelperOption): void;
     removeVisibleAreaHelper(name: string): void;
+    addGltfModel(name: string, source: string | ArrayBuffer): Promise<void>;
+    addImageModel(name: string, source: string | Blob | ArrayBuffer | ImageBitmap): Promise<void>;
+    setGltfModelTransforms(name: string, matrices: number[][]): void;
+    removeGltfModel(name: string): void;
     pickSelector(ndcX: number, ndcY: number): Promise<string | null>;
     setSelectorScale(name: string, scale: iVectorLike): void;
     deleteSelector(name: string): void;

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

@@ -27,6 +27,7 @@ export declare class RenderView {
     shadowingScene: Scene;
     gaussianGroup: Group;
     meshGroup: Group;
+    modelGroup: Group;
     interfaceGroup: Group;
     perspectiveCamera: PerspectiveCamera;
     controlsMap: Map<string, tControlInstance>;

package/package.json

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