@openheart/tavio-renderer 2.3.30-with-wasm → 2.4.0

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

@@ -0,0 +1,65 @@
+import { Vector3, Quaternion, DataTexture, RawShaderMaterial } from 'three';
+import { iLocalTransformInfo, iSourceProperty } from '../types';
+import { InstancedMeshEX } from '../../extension/InstancedMeshEX';
+/**
+ * スプラット個別のローカル座標変換（平行移動・回転・スケール）を管理するクラス
+ */
+export declare class LocalTransform {
+    /** ローカルモデル変換用データ */
+    data: Uint32Array | null;
+    /** 複数選択時の相対変形基準用退避バッファ */
+    temporaryData: Uint32Array | null;
+    /** ローカルモデル変換データ用の GPU テクスチャ */
+    texture: DataTexture | null;
+    /** テクスチャの一辺の幅 */
+    textureWidth: number;
+    /** ローカル変換が更新されたかどうかのフラグ（ソート同期用） */
+    updated: boolean;
+    /**
+     * ローカル変換バッファを初期化する
+     * @param count - 全スプラット数
+     * @param generalData - 汎用データバッファ（選択状態の判定用）
+     * @param offset - 処理開始オフセット
+     * @param onlySelected - 選択中のスプラットのみ初期化するかどうか
+     */
+    init(count: number, generalData: Uint8Array | null, offset?: number, onlySelected?: boolean): void;
+    /**
+     * ローカル変換用テクスチャを生成・更新し、対象マテリアルの uniform 変数へ反映する
+     * @param count - 全スプラット数
+     * @param materials - 反映対象の RawShaderMaterial の配列
+     */
+    updateTexture(count: number, materials: (RawShaderMaterial | null)[]): void;
+    /**
+     * 現在のローカル変換データを退避バッファへバックアップする
+     */
+    backup(): void;
+    /**
+     * 選択中のスプラットに対してローカル変換を絶対値で設定する
+     * @param count - 全スプラット数
+     * @param generalData - 汎用データバッファ（選択判定用）
+     * @param translation - 平行移動量
+     * @param rotation - クォータニオン回転
+     * @param scale - 3軸スケール
+     */
+    applyToSelected(count: number, generalData: Uint8Array, translation: Vector3, rotation: Quaternion, scale: Vector3): void;
+    /**
+     * 選択中のスプラットに対して、退避バッファを基準とした相対的なローカル変換を適用する
+     * @param count - 全スプラット数
+     * @param generalData - 汎用データバッファ
+     * @param sourceProperty - 各ソースファイルのプロパティ
+     * @param mesh - メインメッシュ（スケール計算用）
+     * @param translation - 相対平行移動
+     * @param rotation - 相対回転
+     * @param scale - 相対スケール
+     * @param initialQuaternion - 単体選択時の初期クォータニオン
+     */
+    applyToSelectedRelative(count: number, generalData: Uint8Array, sourceProperty: iSourceProperty[], mesh: InstancedMeshEX | null, translation: Vector3, rotation: Quaternion, scale: Vector3, initialQuaternion?: Quaternion): void;
+    /**
+     * 現在選択されているスプラットのトランスフォーム情報を計算して返す
+     */
+    getSelectedTransformInfo(count: number, generalData: Uint8Array, dataTexture: DataTexture, sourceProperty: iSourceProperty[], mesh: InstancedMeshEX | null): iLocalTransformInfo | null;
+    /**
+     * リソースを解放する
+     */
+    dispose(): void;
+}

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

@@ -0,0 +1,47 @@
+import { iParsedSplatData } from '../types';
+export interface iMinMaxMergeProps {
+    scale: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+    alpha: {
+        min: [number];
+        max: [number];
+    };
+    previousScale: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+    previousAlpha: {
+        min: [number];
+        max: [number];
+    };
+}
+/**
+ * スプラットの min-max をマテリアルの uniform に反映し、
+ * 既存データとの統合時（isFirst === false）に必要な再スケーリング用プロパティを生成する。
+ *
+ * @param uniforms - gaussianMaterial の uniforms オブジェクト
+ * @param minMax - パースされた新規スプラットの minMax
+ * @param isFirst - これが最初のデータかどうか
+ * @returns 既存データとの統合時に Worker へ送る再スケーリング用パラメータ（初回は null）
+ */
+export declare function applyMinMax(uniforms: {
+    [key: string]: any;
+    scaleAlphaMin?: {
+        value: {
+            x: number;
+            y: number;
+            z: number;
+            w: number;
+        };
+    };
+    scaleAlphaMax?: {
+        value: {
+            x: number;
+            y: number;
+            z: number;
+            w: number;
+        };
+    };
+}, minMax: iParsedSplatData["minMax"], isFirst: boolean): iMinMaxMergeProps | null;

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

@@ -0,0 +1,14 @@
+import { iParsedSplatData, tImageSource } from '../../types';
+/**
+ * 画像および Canvas 要素（ビットマップソース）のパーサー
+ */
+export declare class ImageParser {
+    /**
+     * 画像や canvas のビットマップからスプラット用のデータを生成する
+     * ※ OffscreenCanvas 環境（Worker スレッド）およびメインスレッド環境の双方に対応
+     * @param imageSource - 対象となる画像や canvas、ImageBitmap
+     */
+    static parse(imageSource: tImageSource | ImageBitmap | OffscreenCanvas): iParsedSplatData;
+}
+/** 互換用の関数エクスポート */
+export declare const convertImageSource: typeof ImageParser.parse;

package/build/esm/types/{utility/plyDecoder.d.ts → viewer/tavioMesh/parsers/plyParser.d.ts}

@@ -1,3 +1,4 @@
+import { iParsedSplatData } from '../../types';
 type tTypedArray = Float64Array | Float32Array | Int32Array | Uint32Array | Int16Array | Uint16Array | Uint8Array;
 type tTypedArrayConstructor = Float64ArrayConstructor | Float32ArrayConstructor | Int32ArrayConstructor | Uint32ArrayConstructor | Int16ArrayConstructor | Uint16ArrayConstructor | Uint8ArrayConstructor;
 export interface iPlyElement {
@@ -18,22 +19,10 @@ export interface iSplatData {
     sphericalHarmonicsBuffer: Float32Array;
     sphericalHarmonicsDegrees: number;
 }
-export interface iTavioData extends iSplatData {
-    position: Float32Array;
-    color: Uint8ClampedArray;
-    scaleMinX: number;
-    scaleMinY: number;
-    scaleMinZ: number;
-    alphaMin: number;
-    scaleMaxX: number;
-    scaleMaxY: number;
-    scaleMaxZ: number;
-    alphaMax: number;
-}
 /**
- * PLY 形式の中身確認用簡易デコーダ
+ * PLY 形式の中身確認用簡易パーサー
  */
-export declare class PlyDecoder {
+export declare class PlyParser {
     /** ヘッダとして読み込むバイト長 */
     static HEADER_READ_BYTE_LENGTH: number;
     /** splat データの１つあたりのバイトサイズ */
@@ -81,6 +70,6 @@ export declare class PlyDecoder {
      * @param start - 対象のスプラットの開始インデックス
      * @param end - 対象のスプラットの終了インデックス
      */
-    static createTavio(data: iPlyData): iTavioData;
+    static createTavio(data: iPlyData): iParsedSplatData;
 }
 export {};

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

@@ -0,0 +1,12 @@
+import { iParsedSplatData } from '../../types';
+/**
+ * .splat 形式（32 バイト/スプラット）のバイナリパーサー
+ */
+export declare class SplatParser {
+    /**
+     * .splat 形式のバイナリデータをパースし、ROW_LENGTH_TAVIO 形式のバッファおよび min-max を生成する
+     * @param source - .splat バイナリ全体の ArrayBufferLike または Uint8Array
+     * @param count - スプラットの総数（省略時は byteLength / ROW_LENGTH_SPLAT）
+     */
+    static parse(source: ArrayBufferLike | Uint8Array, count?: number): iParsedSplatData;
+}

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

@@ -0,0 +1,39 @@
+import { DataTexture, RawShaderMaterial } from 'three';
+/**
+ * スプラットの選択状態（R チャンネル）および削除世代（G チャンネル）を管理するクラス
+ */
+export declare class Selection {
+    /** 汎用データバッファ（RGBA Uint8） */
+    generalData: Uint8Array | null;
+    /** 汎用データテクスチャ */
+    generalDataTexture: DataTexture | null;
+    /** 現在選択されているスプラットの総数 */
+    selectionCount: number;
+    /**
+     * 汎用データテクスチャを生成・更新し、対象マテリアルの uniform 変数へ反映する
+     * @param count - 全スプラット数
+     * @param materials - 反映対象の RawShaderMaterial の配列
+     */
+    updateTexture(count: number, materials: (RawShaderMaterial | null)[]): void;
+    /**
+     * 現在の衝突判定・選択状態を解除する
+     */
+    resetCollision(): void;
+    /**
+     * 現在選択しているスプラットを削除状態とする
+     * @returns 削除が実行されたかどうか（選択スプラットが存在したか）
+     */
+    deleteSelected(): boolean;
+    /**
+     * 削除状態を一世代前に戻す（Undo）
+     */
+    undoDeleted(): void;
+    /**
+     * すべての削除状態をリセットする
+     */
+    resetDeleted(): void;
+    /**
+     * リソースを解放する
+     */
+    dispose(): void;
+}

package/build/esm/types/viewer/{tavioMesh.d.ts → tavioMesh/tavioMesh.d.ts}

@@ -1,30 +1,23 @@
 import { Camera, CubeTexture, DataTexture, Euler, PerspectiveCamera, Points, Quaternion, RawShaderMaterial, Texture, Vector2, Vector3, WebGLRenderer } from 'three';
 import { default as EventEmitter } from 'eventemitter3';
-import { iLoadingOption, iViewerOption, iHeaderInfo, iTransform, iVectorLike, tSelectionMode, iLocalTransformInfo } from './canvas';
-import { iCollisionTarget } from '../worker/tavioWorker';
-import { InstancedMeshEX } from '../extension/InstancedMeshEX';
-import { RenderView } from './renderView';
+import { iLoadingOption, iViewerOption, iHeaderInfo, iTransform, tSelectionMode, iLocalTransformInfo, tUniformValue, tCustomDefines } from '../types';
+import { iCollisionTarget } from '../../worker/tavioWorker';
+import { InstancedMeshEX } from '../../extension/InstancedMeshEX';
+import { RenderView } from '../renderView';
 /**
- * 画素情報として扱えるオブジェクト
+ * 32bit 符号なし整数テクスチャ (RGBA32UI) を生成する
+ * @param data - 書き込むデータ
+ * @param width - テクスチャの幅
+ * @param height - テクスチャの高さ
  */
-type tImageSource = HTMLImageElement | HTMLCanvasElement;
+export declare const createUint32DataTexture: (data: Uint32Array, width: number, height: number) => DataTexture;
 /**
- * 画像や canvas 要素をパースした結果
+ * 8bit 符号なし整数テクスチャ (RGBA8UI) を生成する
+ * @param data - 書き込むデータ
+ * @param width - テクスチャの幅
+ * @param height - テクスチャの高さ
  */
-interface iSplatSource {
-    count: number;
-    position32: Float32Array;
-    color8: Uint8ClampedArray;
-    converted: Uint8Array;
-    min: {
-        alpha: number;
-        scale: iVectorLike;
-    };
-    max: {
-        alpha: number;
-        scale: iVectorLike;
-    };
-}
+export declare const createUint8DataTexture: (data: Uint8Array, width: number, height: number) => DataTexture;
 export declare class TavioMesh extends EventEmitter {
     private worker;
     private meshIndex;
@@ -49,13 +42,26 @@ export declare class TavioMesh extends EventEmitter {
     private sortMap;
     private defaultRenderViewSymbol;
     private gaussianOrderData;
-    private gaussianGeneralData;
     private gaussianTransformData;
-    private gaussianLocalTransformData;
-    private temporaryLocalTransformData;
     private transformTextureWidth;
-    private localTransformTextureWidth;
-    private currentSelectionCount;
+    private localTransform;
+    private selection;
+    private get gaussianLocalTransformData();
+    private set gaussianLocalTransformData(value);
+    private get temporaryLocalTransformData();
+    private set temporaryLocalTransformData(value);
+    private get localTransformTextureWidth();
+    private set localTransformTextureWidth(value);
+    private get gaussianLocalTransformTexture();
+    private set gaussianLocalTransformTexture(value);
+    private get localTransformUpdated();
+    private set localTransformUpdated(value);
+    private get gaussianGeneralData();
+    private set gaussianGeneralData(value);
+    private get currentSelectionCount();
+    private set currentSelectionCount(value);
+    private get gaussianGeneralDataTexture();
+    private set gaussianGeneralDataTexture(value);
     private gaussianDataTexture;
     private gaussianCompressedDataTexture0;
     private gaussianCompressedDataTexture1;
@@ -63,12 +69,9 @@ export declare class TavioMesh extends EventEmitter {
     private gaussianCompressedDataTexture3;
     private currentVertexCount;
     private maxDistance;
-    private gaussianGeneralDataTexture;
     private gaussianTransformDataTexture;
-    private gaussianLocalTransformTexture;
     private initializedTexture;
     private initializedColorTexture;
-    private localTransformUpdated;
     initialized: boolean;
     initializedPoints: boolean;
     initializedBackground: boolean;
@@ -87,7 +90,6 @@ export declare class TavioMesh extends EventEmitter {
     private gaussianPoints;
     private gaussianPointGeometry;
     private gaussianPointMaterial;
-    private gaussianPointUniforms;
     private mainProperties;
     private backgroundTexture;
     private environmentTexture;
@@ -147,7 +149,11 @@ export declare class TavioMesh extends EventEmitter {
      * @param indexSelectionMaterial - メッシュの生成に使うマテリアルは上の層から指定されたものを使う
      * @param viewerOption - 上の層で用いているオプション
      */
-    constructor(index: number, material: RawShaderMaterial, pickingMaterial: RawShaderMaterial, shadowingMaterial: RawShaderMaterial, indexSelectionMaterial: RawShaderMaterial, viewerOption: iViewerOption);
+    constructor(index: number, material: RawShaderMaterial, pickingMaterial: RawShaderMaterial, shadowingMaterial: RawShaderMaterial, indexSelectionMaterial: RawShaderMaterial, pointMaterial: RawShaderMaterial, viewerOption: iViewerOption);
+    /**
+     * マテリアルでローカル変換が有効化されているかどうか
+     */
+    get enableLocalTransform(): boolean;
     /**
      * ==========================================================================
      * loader
@@ -155,31 +161,46 @@ export declare class TavioMesh extends EventEmitter {
      */
     /**
      * tavio 形式のリソースをロードする
-     * @param source - 読み込む .tavio ファイル。URL 文字列に加え、事前に取得済みの
-     *   Blob / ArrayBuffer を渡すこともできる
+     * ※ply や splat、画像・canvas 要素などのリソースは CPU 側で TavioMesh 用のバイナリを生成する処理を行うが、
+     *   tavio 形式の場合はバイナリから TavioMesh 用のデータを生成する部分が worker 側にあるため、他のロード系
+     *   メソッドと比較するとやや固有の処理が多いことに注意する
+     * @param source - 読み込む .tavio ファイル。URL 文字列に加え、事前に取得済みの Blob / ArrayBuffer を渡すこともできる
      * @param option - ロード・パース関連のオプション
      */
     loadTavio(source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     /**
      * ply 形式のリソースをロードする
-     * @param url - 読み込む .ply ファイル
+     * @param source - 読み込む .ply ファイル（URL文字列、Blob、または ArrayBuffer）
      * @param option - ロード・パース関連のオプション
      */
-    loadPly(url: string, option?: iLoadingOption): Promise<void>;
+    loadPly(source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     /**
      * splat 形式のリソースをロードする
-     * @param url - 読み込む .splat ファイル
+     * @param source - 読み込む .splat ファイル（URL文字列、Blob、または ArrayBuffer）
      */
-    loadSplat(url: string): Promise<void>;
+    loadSplat(source: string | Blob | ArrayBuffer): Promise<void>;
     /**
      * 画像形式のリソースをロードする
-     * @param url - 読み込む画像ファイル
+     * @param source - 読み込む画像ファイル（URL文字列、Blob、ArrayBuffer、または ImageBitmap）
+     */
+    loadImage(source: string | Blob | ArrayBuffer | ImageBitmap): Promise<void>;
+    /**
+     * canvas 形式のリソースをロードする
+     * @param canvas - 対象となる canvas 要素、または OffscreenCanvas / ImageBitmap
+     */
+    loadCanvas(canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap): Promise<void>;
+    /**
+     * 画像や Canvas などのビットマップソースからスプラットを共通シーケンスで生成・ロードする
+     * ※ OffscreenCanvas モード（Worker スレッド）およびメインスレッドの双方に対応
+     * @param source - 画像・Canvas・ImageBitmap などのソース
+     * @param type - ソース種別（'image' | 'canvas'）
+     * @param byte - リソースのバイト長（不明時は null）
+     * @private
      */
-    loadImage(url: string): Promise<void>;
+    private _loadFromBitmapSource;
     /**
      * tavio 形式のリソースをロードする
-     * @param source - 読み込む .tavio ファイル。URL 文字列に加え、事前に取得済みの
-     *   Blob / ArrayBuffer を渡すこともできる（内部で Object URL 化して WASM デコーダに渡す）
+     * @param source - 読み込む .tavio ファイル。URL 文字列に加え、事前に取得済みの Blob / ArrayBuffer を渡すこともできる（内部で Object URL 化して WASM デコーダに渡す）
      * @param option - ロード・パース関連のオプション
      * @param options.decodeMode - デコードモード. "sync", "concurrent", "parallel" を指定
      * @param options.maxThreads - decodeMode が "parallel" のときに使用されるスレッド数の上限
@@ -238,16 +259,6 @@ export declare class TavioMesh extends EventEmitter {
      * @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
@@ -301,7 +312,7 @@ export declare class TavioMesh extends EventEmitter {
      * uniform 変数を設定する
      * @param values - 設定する uniform 変数をキーとするオブジェクト
      */
-    setUniforms(values: any): void;
+    setUniforms(values: Record<string, tUniformValue>): void;
     /**
      * 点描画用のマテリアルに紐づいている uniform 変数を返す
      */
@@ -310,7 +321,7 @@ export declare class TavioMesh extends EventEmitter {
      * 点描画用のマテリアルに uniform 変数を設定する
      * @param values - 設定する uniform 変数をキーとするオブジェクト
      */
-    setPointUniforms(values: any): void;
+    setPointUniforms(values: Record<string, any>): void;
     /**
      * defines の定義を返す
      */
@@ -319,7 +330,7 @@ export declare class TavioMesh extends EventEmitter {
      * defines を設定する
      * @param values - 設定する defines をキーとするオブジェクト
      */
-    setDefines(values: any): void;
+    setDefines(values: tCustomDefines): void;
     /**
      * 点描画用のマテリアルに紐づいている defines の定義を返す
      */
@@ -328,7 +339,7 @@ export declare class TavioMesh extends EventEmitter {
      * 点描画用のマテリアルに defines を設定する
      * @param values - 設定する defines をキーとするオブジェクト
      */
-    setPointDefines(values: any): void;
+    setPointDefines(values: tCustomDefines): void;
     /**
      * カメラ関係のパラメータを深度書き込み用に設定する
      * @param viewProjectionMatrix - 要素の配列
@@ -626,14 +637,14 @@ declare class SharedData {
     sharedSphericalHarmonicsLabel: SharedArrayBuffer;
     sharedSphericalHarmonicsMaxQuantizationIndex: SharedArrayBuffer;
     sharedGaussianLocalTransformData: SharedArrayBuffer;
+    gaussianData: Uint8Array;
+    gaussianOrderData: Uint8Array;
+    gaussianGeneralData: Uint8Array;
+    sphericalHarmonicsData: Float32Array;
+    sphericalHarmonicsLabel: Uint16Array;
+    sphericalHarmonicsMaxQuantizationIndex: Uint32Array;
+    gaussianLocalTransformData: Uint32Array;
     constructor(gaussianDataSize: number, gaussianGeneralDataSize: number, chunkCount: number, pointCount: number, isEncodeEnabled: boolean, enableLocalTransform: boolean);
-    get gaussianData(): Uint8Array;
-    get gaussianOrderData(): Uint8Array;
-    get gaussianGeneralData(): Uint8Array;
-    get sphericalHarmonicsData(): Float32Array;
-    get sphericalHarmonicsLabel(): Uint16Array;
-    get sphericalHarmonicsMaxQuantizationIndex(): Uint32Array;
-    get gaussianLocalTransformData(): Uint32Array;
     get isEncodeEnabled(): boolean;
 }
 export {};