@openheart/tavio-renderer 1.0.12-with-wasm → 2.0.0

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

@@ -1,5 +1,5 @@
-import { Group, PerspectiveCamera, Quaternion, Scene, Vector3 } from 'three';
-import { tControlInstance, tControlsType } from './canvas';
+import { AxesHelper, Group, SpotLight, PerspectiveCamera, Quaternion, Scene, Vector3, AmbientLight, CameraHelper } from 'three';
+import { tControlInstance, tControlsType } from './types';
 import { CameraCollider } from '../camera/cameraCollider';
 import { TransferControls } from '../camera/transferControls';
 import { CameraPathManager } from '../camera/cameraPathManager';
@@ -18,8 +18,13 @@ export declare class RenderView {
     y: number;
     width: number;
     height: number;
+    /**
+     * 以下のプロパティ各種は RenderView のインスタンスを生成した側で代入される
+     * このクラス内ではその中身が undefined でないかどうかは担保しない点に注意
+     */
     scene: Scene;
-    pickingScene: Scene;
+    queryScene: Scene;
+    shadowingScene: Scene;
     gaussianGroup: Group;
     meshGroup: Group;
     interfaceGroup: Group;
@@ -31,12 +36,17 @@ export declare class RenderView {
     cameraCollider: CameraCollider;
     cameraPathCollisionRadius: number;
     cameraPathManager: CameraPathManager;
+    ambientLights: AmbientLight[];
+    spotLights: SpotLight[];
+    spotLightHelpers: CameraHelper[];
     previousPosition: Vector3;
     previousRotation: Quaternion;
     previousFov: number;
     orbitCursor: Group;
-    orbitCursorEnabled: boolean;
+    orbitCursorAutoDisplay: boolean;
+    orbitCursorDisplay: boolean;
     previousOrbitTarget: Vector3;
+    axesHelper?: AxesHelper;
     /**
      * @param name - レンダービューの名前
      */

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

@@ -0,0 +1,22 @@
+import { RawShaderMaterial } from 'three';
+import { iViewerMaterialOption, iViewerOption } from './types';
+/**
+ * シェーダマテリアルの生成およびレジストリ管理を行う
+ */
+export declare class ShaderRegistry {
+    gaussianMaterial: RawShaderMaterial;
+    gaussianPickingMaterial: RawShaderMaterial;
+    gaussianShadowingMaterial: RawShaderMaterial;
+    gaussianIndexSelectionMaterial: RawShaderMaterial;
+    gaussianPointMaterial: RawShaderMaterial;
+    /**
+     * マテリアルをセットアップする
+     * @param viewerOption - ビューアのオプション
+     * @param option - シェーダチャンクなどの情報を含むマテリアルオプション
+     */
+    setupMaterial(viewerOption: iViewerOption, option?: iViewerMaterialOption): void;
+    /**
+     * 保持しているマテリアルリソースを破棄する
+     */
+    dispose(): void;
+}

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,4 +1,6 @@
+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 {
     type: string;
     name: string;
@@ -17,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 データの１つあたりのバイトサイズ */
@@ -50,37 +40,19 @@ export declare class PlyDecoder {
     static SH_C0: number;
     /** .ply のプロパティのデータタイプと対応付けを行うためのデータ構造 */
     static PROPERTY_TYPE: {
-        double: string;
-        float: string;
-        int: string;
-        uint: string;
-        short: string;
-        ushort: string;
-        uchar: string;
+        [key: string]: string;
     };
     static PROPERTY_TYPED_ARRAY: {
-        double: Float64ArrayConstructor;
-        float: Float32ArrayConstructor;
-        int: Int32ArrayConstructor;
-        uint: Uint32ArrayConstructor;
-        short: Int16ArrayConstructor;
-        ushort: Uint16ArrayConstructor;
-        uchar: Uint8ArrayConstructor;
+        [key: string]: tTypedArrayConstructor;
     };
     static PROPERTY_BYTE_LENGTH: {
-        double: number;
-        float: number;
-        int: number;
-        uint: number;
-        short: number;
-        ushort: number;
-        uchar: number;
+        [key: string]: number;
     };
     /**
      * ply のヘッダ文字列をデコードする
      * @param buffer - ply 由来の ArrayBuffer データ
      */
-    static decodeHeader(buffer: ArrayBufferLike): iPlyData;
+    static decodeHeader(buffer: ArrayBufferLike): iPlyData | null;
     /**
      * ply のバイナリ部分をデコードする
      * @param out - ヘッダ情報（decodeHeader の戻り値）
@@ -98,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;
+}