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

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

@@ -1,5 +1,5 @@
-import { Group, SpotLight, PerspectiveCamera, Quaternion, Scene, Vector3, AmbientLight, CameraHelper } 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';
@@ -23,7 +23,7 @@ export declare class RenderView {
      * このクラス内ではその中身が undefined でないかどうかは担保しない点に注意
      */
     scene: Scene;
-    pickingScene: Scene;
+    queryScene: Scene;
     shadowingScene: Scene;
     gaussianGroup: Group;
     meshGroup: Group;
@@ -43,9 +43,10 @@ export declare class RenderView {
     previousRotation: Quaternion;
     previousFov: number;
     orbitCursor: Group;
-    previousOrbitTarget: Vector3;
     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/{src/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/{src/viewer → viewer/tavioMesh}/tavioMesh.d.ts

@@ -1,30 +1,23 @@
-import { Camera, CubeTexture, DataTexture, Euler, PerspectiveCamera, Points, RawShaderMaterial, Texture, Vector2, Vector3, WebGLRenderer } from 'three';
+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 } 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,10 +42,26 @@ export declare class TavioMesh extends EventEmitter {
     private sortMap;
     private defaultRenderViewSymbol;
     private gaussianOrderData;
-    private gaussianGeneralData;
     private gaussianTransformData;
     private transformTextureWidth;
-    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;
@@ -60,7 +69,6 @@ export declare class TavioMesh extends EventEmitter {
     private gaussianCompressedDataTexture3;
     private currentVertexCount;
     private maxDistance;
-    private gaussianGeneralDataTexture;
     private gaussianTransformDataTexture;
     private initializedTexture;
     private initializedColorTexture;
@@ -74,13 +82,14 @@ export declare class TavioMesh extends EventEmitter {
     private gaussianMaterial;
     private gaussianPickingMaterial;
     private gaussianShadowingMaterial;
+    private gaussianIndexSelectionMaterial;
     private gaussianMesh;
     private gaussianPickingMesh;
     private gaussianShadowingMesh;
+    private gaussianIndexSelectionMesh;
     private gaussianPoints;
     private gaussianPointGeometry;
     private gaussianPointMaterial;
-    private gaussianPointUniforms;
     private mainProperties;
     private backgroundTexture;
     private environmentTexture;
@@ -113,6 +122,19 @@ export declare class TavioMesh extends EventEmitter {
      * B: クォータニオンの WX
      * A: クォータニオンの YZ
      */
+    /**
+     * this.gaussianLocalTransformData についての覚書
+     * RGBA がそれぞれ Uint32 で、１画素が１スプラットに対応する
+     * position.xyz はそれぞれ 16bit、scale.xyz も同様に 16bit で先頭から並ぶ（RGB に相当するチャンネル）
+     * 残りの A チャンネルの 32bit には convertQuaternion で変換したオクタへドラルクォータニオン 24bit が入る
+     */
+    /**
+     * this.temporaryLocalTransformData についての覚書
+     * RGBA がそれぞれ Uint32 で、１画素が１スプラットに対応する（つまり this.gaussianLocalTransformData と同じ）
+     * このバッファは「スプラットが複数選択された」場合に、その選択された瞬間の状態をステートとして保持しておくために利用される
+     * このような退避バッファを使わないと、複数回選択・移動されたときに、前回の状態からどれくらい動いたか、を考えることができなくなる
+     * スプラットが選択された際に内容が更新され、ギズモから手が離れた瞬間に、この退避バッファの内容を踏まえてローカルトランスフォームする
+     */
     /**
      * インスタンスが発火するイベント
      */
@@ -124,8 +146,14 @@ export declare class TavioMesh extends EventEmitter {
      * @param material - メッシュの生成に使うマテリアルは上の層から指定されたものを使う
      * @param pickingMaterial - メッシュの生成に使うマテリアルは上の層から指定されたものを使う
      * @param shadowingMaterial - メッシュの生成に使うマテリアルは上の層から指定されたものを使う
+     * @param indexSelectionMaterial - メッシュの生成に使うマテリアルは上の層から指定されたものを使う
+     * @param viewerOption - 上の層で用いているオプション
      */
-    constructor(index: number, material: RawShaderMaterial, pickingMaterial: RawShaderMaterial, shadowingMaterial: RawShaderMaterial, viewerOption: iViewerOption);
+    constructor(index: number, material: RawShaderMaterial, pickingMaterial: RawShaderMaterial, shadowingMaterial: RawShaderMaterial, indexSelectionMaterial: RawShaderMaterial, pointMaterial: RawShaderMaterial, viewerOption: iViewerOption);
+    /**
+     * マテリアルでローカル変換が有効化されているかどうか
+     */
+    get enableLocalTransform(): boolean;
     /**
      * ==========================================================================
      * loader
@@ -133,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(url: string): Promise<void>;
+    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
+     */
+    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" のときに使用されるスレッド数の上限
@@ -216,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
@@ -247,6 +280,10 @@ export declare class TavioMesh extends EventEmitter {
      * 影描画用メッシュのインスタンスを返す
      */
     getShadowingMesh(): InstancedMeshEX | null;
+    /**
+     * インデックス選択用メッシュのインスタンスを返す
+     */
+    getIndexSelectionMesh(): InstancedMeshEX | null;
     /**
      * 背景用テクスチャを返す
      */
@@ -267,11 +304,15 @@ export declare class TavioMesh extends EventEmitter {
      * uniform 変数を返す
      */
     getUniforms(): any;
+    /**
+     * 現在選択されているスプラットのトランスフォーム情報を返す
+     */
+    getSelectedSplatTransformInfo(): iLocalTransformInfo | null;
     /**
      * uniform 変数を設定する
      * @param values - 設定する uniform 変数をキーとするオブジェクト
      */
-    setUniforms(values: any): void;
+    setUniforms(values: Record<string, tUniformValue>): void;
     /**
      * 点描画用のマテリアルに紐づいている uniform 変数を返す
      */
@@ -280,7 +321,7 @@ export declare class TavioMesh extends EventEmitter {
      * 点描画用のマテリアルに uniform 変数を設定する
      * @param values - 設定する uniform 変数をキーとするオブジェクト
      */
-    setPointUniforms(values: any): void;
+    setPointUniforms(values: Record<string, any>): void;
     /**
      * defines の定義を返す
      */
@@ -289,7 +330,7 @@ export declare class TavioMesh extends EventEmitter {
      * defines を設定する
      * @param values - 設定する defines をキーとするオブジェクト
      */
-    setDefines(values: any): void;
+    setDefines(values: tCustomDefines): void;
     /**
      * 点描画用のマテリアルに紐づいている defines の定義を返す
      */
@@ -298,7 +339,7 @@ export declare class TavioMesh extends EventEmitter {
      * 点描画用のマテリアルに defines を設定する
      * @param values - 設定する defines をキーとするオブジェクト
      */
-    setPointDefines(values: any): void;
+    setPointDefines(values: tCustomDefines): void;
     /**
      * カメラ関係のパラメータを深度書き込み用に設定する
      * @param viewProjectionMatrix - 要素の配列
@@ -368,6 +409,46 @@ export declare class TavioMesh extends EventEmitter {
      * @private
      */
     private _updateTransformData;
+    /**
+     * ローカルモデル変換用のバッファを初期化する
+     * @param offset - 処理対象を限定するオフセット
+     * @param onlySelected - 現在選択状態のものだけを処理するかどうか
+     */
+    initLocalTransformData(offset?: number, onlySelected?: boolean): void;
+    /**
+     * ローカルモデル変換用のテクスチャを更新し uniform 変数へ反映する
+     */
+    updateLocalTransformTexture(): void;
+    /**
+     * スクリーン空間上の領域情報に基づいてスプラットを選択する
+     * @param buffer - ReadPixels の結果の Uint8Array をソースとする ArrayBuffer
+     * @param nw - フレームバッファ上の選択領域幅
+     * @param nh - フレームバッファ上の選択領域高さ
+     * @param mode - 選択モード
+     * @param maskBuffer - 範囲選択用のアルファマスクデータ (nw * nh * 4 バイト)
+     */
+    selectGaussiansByScreenArea(buffer: ArrayBuffer, nw: number, nh: number, mode: tSelectionMode, maskBuffer: ArrayBuffer): void;
+    /**
+     * 現在のローカル変換のデータを退避バッファにバックアップする。
+     * 複数選択時に、各スプラットの相対的な位置関係を維持したままトランスフォームを累積適用するための基準値となる。
+     * 非編集時はメモリを確保せず、必要になったタイミングで初めてバッファを遅延確保（Lazy Allocation）する。
+     */
+    backupLocalTransform(): void;
+    /**
+     * 現在選択しているスプラットに対してローカル変換を設定する（指定された値で完全に上書きする）
+     * @param translation - 平行移動
+     * @param rotation - 回転
+     * @param scale - スケール
+     */
+    applyLocalTransformToSelected(translation: Vector3, rotation: Quaternion, scale: Vector3): void;
+    /**
+     * 現在選択しているスプラットに対して、退避バッファを基準とした相対的なローカル変換を適用する
+     * @param translation - 相対平行移動
+     * @param rotation - 相対回転
+     * @param scale - 相対スケール
+     * @param initialQuaternion - 初期姿勢を意味するクォータニオン（単体選択時に考慮する必要がある）
+     */
+    applyLocalTransformToSelectedRelative(translation: Vector3, rotation: Quaternion, scale: Vector3, initialQuaternion?: Quaternion): void;
     /**
      * 自身のプロパティの状態に応じて球面調和関数に関連する uniform 変数の更新を行う
      * @private
@@ -393,6 +474,15 @@ export declare class TavioMesh extends EventEmitter {
      * shadowing 用マテリアルに uniform 変数を同期する
      */
     syncShadowingMaterial(): void;
+    /**
+     * indexSelection 用マテリアルに uniform 変数を同期する
+     * @param camera - 対象となるカメラ
+     */
+    syncIndexSelectionMaterial(camera: PerspectiveCamera): void;
+    /**
+     * gaussianMesh のモデル変換をすべての補助メッシュに同期する
+     */
+    syncModelTransform(): void;
     /**
      * shadowing 用マテリアルに uniform 変数を設定する
      * @param camera - 対象となるカメラ
@@ -417,7 +507,7 @@ export declare class TavioMesh extends EventEmitter {
      * @param pointCount - 該当ファイルのスプラットの個数
      * @param isEncodeEnable - エンコード可能とするかどうか（WASM 用）
      */
-    allocateSharedData(index: number, offset: number, chunkCount: number, pointCount: number, isEncodeEnabled: Boolean): SharedData;
+    allocateSharedData(index: number, offset: number, chunkCount: number, pointCount: number, isEncodeEnabled: boolean): SharedData;
     /**
      * テクスチャのセットアップが完了しているかどうかを返す
      * @private
@@ -514,8 +604,9 @@ export declare class TavioMesh extends EventEmitter {
     /**
      * 衝突判定を設定する
      * @param collision - 設定する衝突判定、またはその配列
+     * @param mode - 選択モード（SELECTION_MODE）
      */
-    setCollision(collision: iCollisionTarget | iCollisionTarget[]): void;
+    setCollision(collision: iCollisionTarget | iCollisionTarget[], mode: tSelectionMode): void;
     /**
      * 現在の衝突判定を解除する
      */
@@ -545,13 +636,15 @@ declare class SharedData {
     sharedSphericalHarmonicsData: SharedArrayBuffer;
     sharedSphericalHarmonicsLabel: SharedArrayBuffer;
     sharedSphericalHarmonicsMaxQuantizationIndex: SharedArrayBuffer;
-    constructor(gaussianDataSize: number, gaussianGeneralDataSize: number, chunkCount: number, pointCount: number, isEncodeEnabled: Boolean);
-    get gaussianData(): Uint8Array;
-    get gaussianOrderData(): Uint8Array;
-    get gaussianGeneralData(): Uint8Array;
-    get sphericalHarmonicsData(): Float32Array;
-    get sphericalHarmonicsLabel(): Uint16Array;
-    get sphericalHarmonicsMaxQuantizationIndex(): Uint32Array;
+    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 isEncodeEnabled(): boolean;
 }
 export {};