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

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

@@ -0,0 +1,1402 @@
+import { RawShaderMaterial, WebGLRenderTarget, WebGLRenderer, PMREMGenerator, MeshStandardMaterialParameters } from 'three';
+import { iSphereSelectorOption } from '../../editor/selector/sphereSelector';
+import { iBoxSelectorOption } from '../../editor/selector/boxSelector';
+import { iSelectorInfo, tControlsType, tMaskSource, tSelectionMode, iVectorLike, iCameraPathOption, iCameraParameter, iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iPickingInfo, tUniformValue, tCustomDefines, tCustomUniforms } from '../types';
+import { iCollisionTarget } from '../../worker/tavioWorker';
+import { WorkerElementAdapter } from './workerElementAdapter';
+import { default as EventEmitter } from 'eventemitter3';
+import { CameraPath } from '../../camera/cameraPath';
+import { iLatitudeLongitude } from '../../camera/flightControls';
+import { ConsoleOutput } from '../../utility/console';
+import { TavioMesh } from '../tavioMesh/tavioMesh';
+import { RenderView } from '../renderView';
+import { iCoreDriver } from './iCoreDriver';
+export declare class CoreDriver extends EventEmitter implements iCoreDriver {
+    canvas: HTMLCanvasElement | OffscreenCanvas;
+    viewerOption: iViewerOption;
+    elementAdapter?: WorkerElementAdapter;
+    getElementAdapter(): HTMLCanvasElement | OffscreenCanvas | WorkerElementAdapter;
+    /** WebGL コンテキスト（WebGL 2.0） */
+    gl: WebGL2RenderingContext;
+    /** Three.js レンダラー */
+    renderer: WebGLRenderer;
+    /** 背景生成用ジェネレータ */
+    pmremGenerator: PMREMGenerator;
+    /** ワールド座標のピックを行うために座標を書き込むレンダーターゲット */
+    pickingRenderTarget: WebGLRenderTarget;
+    /** インデックス選択を行うために座標を書き込むレンダーターゲット */
+    indexSelectionRenderTarget: WebGLRenderTarget;
+    /** インデックス選択用オフスクリーンバッファの解像度縮小率 */
+    indexSelectionDivisor: number;
+    /** レンダービューを保持する Map */
+    renderViewMap: Map<Symbol | string, RenderView>;
+    /** 既定のレンダービューを意味する Symbol */
+    defaultRenderViewSymbol: Symbol;
+    /** 現在アクティブなレンダービューの名前 */
+    currentRenderViewName: Symbol | string;
+    /** 現在アクティブなレンダービュー */
+    currentRenderView: RenderView;
+    /** 各種 TavioMesh を保持する Map */
+    meshMap: Map<string, TavioMesh>;
+    /** コンソール出力のラッパークラスのインスタンス */
+    console: ConsoleOutput;
+    /** uniform 変数管理 */
+    uniforms: any;
+    /** カメラの可動域制御用コライダーが有効かどうか */
+    cameraColliderEnabled: boolean;
+    /** TavioMesh から取得した全スプラットの最大距離 */
+    maxDistance: number;
+    /** レンダリングをインタラクティブに行うかどうか */
+    isInteractive: boolean;
+    /** レンダリングを行うかどうか */
+    isRendering: boolean;
+    /** 読み込みと初期化が現在進行中かどうか */
+    isLoading: boolean;
+    /** pause() によって描画が一時停止されているかどうか */
+    isPaused: boolean;
+    /** レンダリングを開始した瞬間のタイムスタンプ */
+    startRendering: number;
+    private localTransformGizmoParent?;
+    private localTransformGizmoTarget?;
+    private localTransformGizmo?;
+    private localTransformGizmoEnabled;
+    private localTransformInitialQuaternion;
+    private cursorMap;
+    private previousTargetMap;
+    private torusGeometry?;
+    private torusMaterial?;
+    private sphereGeometry?;
+    private sphereMaterial?;
+    private shaderRegistry;
+    /** WebGLRenderer.getSize 用（RenderView は論理ピクセル。canvas バッファ実寸とは別） */
+    private readonly _rendererLogicalSize;
+    /** 3DGS 用のマテリアル */
+    get gaussianMaterial(): RawShaderMaterial;
+    /** ワールド座標のピック用シェーダのマテリアル */
+    get gaussianPickingMaterial(): RawShaderMaterial;
+    /** 影の描画用シェーダのマテリアル */
+    get gaussianShadowingMaterial(): RawShaderMaterial;
+    /** インデックス選択用シェーダのマテリアル */
+    get gaussianIndexSelectionMaterial(): RawShaderMaterial;
+    /** 点描画用シェーダのマテリアル */
+    get gaussianPointMaterial(): RawShaderMaterial;
+    /** setFrameRateLimit で設定される1フレームあたりの最小間隔（ms）。0 の場合は上限なし */
+    private _frameIntervalMs;
+    /** 直前にフレームを描画した時刻（Date.now()） */
+    private _lastFrameTimestamp;
+    /**
+     * 対応する Controls 種別
+     */
+    static CONTROLS: string[];
+    /**
+     * シェーダチャンク関連（定義は MaterialGenerator.ts 内）
+     */
+    static CHUNK_TARGET: {
+        readonly ANY: 0;
+        readonly ANY_SPLAT: 1;
+        readonly BASIC: 2;
+        readonly PICKING: 4;
+        readonly SHADOWING: 8;
+        readonly INDEX_SELECTION: 16;
+        readonly POINTS: 32;
+    };
+    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_CLIPPING: 5;
+        readonly VERTEX_MAIN_SIGMA: 6;
+        readonly VERTEX_MAIN_OUT: 7;
+        readonly VERTEX_MAIN_END: 8;
+        readonly FRAGMENT_PRECISION: 9;
+        readonly FRAGMENT_DECLARATION: 10;
+        readonly FRAGMENT_FUNCTION: 11;
+        readonly FRAGMENT_MAIN_BEGIN: 12;
+        readonly FRAGMENT_MAIN_IN: 13;
+        readonly FRAGMENT_MAIN_OUT: 14;
+        readonly FRAGMENT_MAIN_END: 15;
+    };
+    /**
+     * @constructor
+     * @param viewerOption - ビューア実装の初期化オプション
+     * @throws Float16Array 未対応環境ではエラーをスローする
+     */
+    constructor(viewerOption?: iViewerOption);
+    /**
+     * ==========================================================================
+     * setup
+     * ==========================================================================
+     */
+    /**
+     * コンストラクタ内のセットアップ
+     * ※一度 dispose した場合、コンストラクタを再度実行することはできないのでこのメソッドで復帰させる
+     * @param viewerOption - ビューア実装の初期化オプション
+     */
+    setupOnConstructor(viewerOption?: iViewerOption): void;
+    /**
+     * 各種初期化処理を行う
+     * @param canvas - WebGL コンテキストを取得する対象となる canvas 要素
+     * @param materialOption - シェーダチャンクなどの情報を含むマテリアルオプション
+     */
+    init(canvas: HTMLCanvasElement | OffscreenCanvas, materialOption?: iViewerMaterialOption): void;
+    /**
+     * レンダービューをセットアップする
+     */
+    setupRenderView(): void;
+    /**
+     * カメラコントロール・カメラコライダーをセットアップする
+     * @param renderView - セットアップの対象となるレンダービュー
+     */
+    setupControls(renderView: RenderView): void;
+    /**
+     * OrbitControls をセットアップする
+     * @param renderView - セットアップの対象となるレンダービュー
+     */
+    setupOrbitControls(renderView: RenderView): void;
+    /**
+     * CameraPathControls をセットアップする
+     * @param renderView - セットアップの対象となるレンダービュー
+     */
+    setupCameraPathControls(renderView: RenderView): void;
+    /**
+     * FlightControls をセットアップする
+     * @param renderView - セットアップの対象となるレンダービュー
+     */
+    setupFlightControls(renderView: RenderView): void;
+    /**
+     * TransferControls をセットアップする
+     * @param renderView - セットアップの対象となるレンダービュー
+     */
+    setupTransferControls(renderView: RenderView): void;
+    /**
+     * CameraCollider をセットアップする
+     * @param renderView - セットアップの対象となるレンダービュー
+     */
+    setupCameraCollider(renderView: RenderView): void;
+    /**
+     * マテリアルをセットアップする
+     * @param option - シェーダチャンクなどの情報を含むマテリアルオプション
+     */
+    setupMaterial(option?: iViewerMaterialOption): void;
+    /**
+     * ==========================================================================
+     * TavioMesh / loader
+     * ==========================================================================
+     */
+    /**
+     * TavioMesh を生成しロード前の共通処理を行う
+     * @private
+     * @param name - このメッシュの固有名
+     * @param option - ロード・パース関連のオプション
+     */
+    private _beforeLoadMesh;
+    /**
+     * TavioMesh のロード後の共通処理を行う
+     * @private
+     * @param name - 設定する名前
+     * @param option - ロード・パース関連のオプション
+     */
+    private _afterLoadMesh;
+    /**
+     * TavioMesh のインスタンスを生成し tavio 形式のリソースをロード、シーンに追加する
+     * @param name - このメッシュの固有名
+     * @param source - 読み込む .tavio ファイル。URL 文字列に加え、事前に取得済みの
+     *   Blob / ArrayBuffer を渡すこともできる
+     * @param option - ロード・パース関連のオプション
+     */
+    loadTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    /**
+     * 既存の TavioMesh のインスタンスにデータを統合する
+     * @param name - このメッシュの固有名
+     * @param source - 読み込む .tavio ファイル。URL 文字列に加え、事前に取得済みの
+     *   Blob / ArrayBuffer を渡すこともできる
+     * @param option - ロード・パース関連のオプション
+     */
+    concatTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    /**
+     * TavioMesh のインスタンスを生成し ply 形式のリソースをロード、シーンに追加する
+     * @param name - このメッシュの固有名
+     * @param source - 読み込む .ply ファイル（URL文字列、Blob、または ArrayBuffer）
+     * @param option - ロード・パース関連のオプション
+     */
+    loadPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    /**
+     * 既存の TavioMesh のインスタンスにデータを統合する
+     * @param name - このメッシュの固有名
+     * @param source - 読み込む .ply ファイル（URL文字列、Blob、または ArrayBuffer）
+     * @param option - ロード・パース関連のオプション
+     */
+    concatPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    /**
+     * TavioMesh のインスタンスを生成し splat 形式のリソースをロード、シーンに追加する
+     * @param name - このメッシュの固有名
+     * @param source - 読み込む .splat ファイル（URL文字列、Blob、または ArrayBuffer）
+     * @param option - ロード・パース関連のオプション
+     */
+    loadSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    /**
+     * 既存の TavioMesh のインスタンスにデータを統合する
+     * @param name - このメッシュの固有名
+     * @param source - 読み込む .splat ファイル（URL文字列、Blob、または ArrayBuffer）
+     * @param option - ロード・パース関連のオプション
+     */
+    concatSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    /**
+     * TavioMesh のインスタンスを生成し画像形式のリソースをロード、シーンに追加する
+     * @param name - このメッシュの固有名
+     * @param source - 読み込む画像ファイル（URL文字列、Blob、または ArrayBuffer）
+     * @param option - ロード・パース関連のオプション
+     */
+    loadImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    /**
+     * 既存の TavioMesh のインスタンスにデータを統合する
+     * @param name - このメッシュの固有名
+     * @param source - 読み込む画像ファイル（URL文字列、Blob、ArrayBuffer、または ImageBitmap）
+     * @param option - ロード・パース関連のオプション
+     */
+    concatImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    /**
+     * canvas 要素から TavioMesh のインスタンスを生成し、シーンに追加する
+     * @param name - このメッシュの固有名
+     * @param canvas - 処理の対象となる canvas 要素、または OffscreenCanvas / ImageBitmap
+     * @param option - ロード・パース関連のオプション
+     */
+    loadCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    /**
+     * 既存の TavioMesh のインスタンスにデータを統合する
+     * @param name - このメッシュの固有名
+     * @param canvas - 処理の対象となる canvas 要素、または OffscreenCanvas / ImageBitmap
+     * @param option - ロード・パース関連のオプション
+     */
+    concatCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    /**
+     * tavio 形式のリソースをロードする
+     * @param name - このメッシュの固有名
+     * @see {@link TavioMesh.prototype.loadTavioWasm}
+     */
+    loadTavioWasm(name: string, ...args: Parameters<typeof TavioMesh.prototype.loadTavioWasm>): Promise<void>;
+    /**
+     * ply 形式のリソースをロードする
+     * @param name - このメッシュの固有名
+     * @see {@link TavioMesh.prototype.loadPlyWasm}
+     */
+    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>;
+    /**
+     * spz 形式のリソースをロードする
+     * @param name - このメッシュの固有名
+     * @see {@link TavioMesh.prototype.loadSpzWasm}
+     */
+    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 options.exportSphericalHarmonics - 球面調和関数の交流成分をエンコードする [default: true]
+     * @param options.exportCelestialSphere - 天体球の画像をエンコードする [default: true]
+     * @param options.sphericalHarmonicsSampleRate - 球面調和関数の交流成分の計算のサンプル率 [default: 0.1]
+     * @param options.celestialSphereDistanceRatio - 天体球の画像に使用する点の距離の比率 [default: 0.99]
+     */
+    exportTavioWasm(name: string, options?: Parameters<typeof TavioMesh.prototype.exportTavioWasm>[0]): Promise<{
+        bytes: Uint8Array;
+        version: string;
+    }>;
+    /**
+     * tavio 形式のリソースを保存する
+     * @param name - このメッシュの固有名
+     * @param fileName - 保存ファイル名
+     * @param options.exportSphericalHarmonics - 球面調和関数の交流成分をエンコードする [default: true]
+     * @param options.exportCelestialSphere - 天体球の画像をエンコードする [default: true]
+     * @param options.sphericalHarmonicsSampleRate - 球面調和関数の交流成分の計算のサンプル率 [default: 0.1]
+     * @param options.celestialSphereDistanceRatio - 天体球の画像に使用する点の距離の比率 [default: 0.99]
+     */
+    saveTavioWasm(name: string, fileName: string, options?: Parameters<typeof TavioMesh.prototype.exportTavioWasm>[0]): 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 - 対象の名前
+     */
+    addTavioMesh(name: string): void;
+    /**
+     * 名前を指定してロード済み TavioMesh をシーンから取り除く
+     * @param name - 対象の名前
+     * @param renderViewName - 対象となるレンダービューの名前
+     */
+    removeTavioMesh(name: string, renderViewName?: string | Symbol): void;
+    /**
+     * 名前を指定してロード済み TavioMesh をシーンから取り除く
+     * @param name - 対象の名前
+     */
+    removeTavioMeshAllRenderView(name: string): void;
+    /**
+     * 名前を指定して TavioMesh を削除・解放する
+     * @param name - 対象の名前
+     */
+    disposeTavioMesh(name: string): void;
+    /**
+     * 名前を指定して TavioMesh の表示・非表示を設定する
+     * @param name - 対象の名前
+     * @param visibility - 可視状態
+     */
+    setVisibilityTavioMesh(name: string, visibility: boolean): void;
+    /**
+     * 名前を指定して TavioMesh の点描画用 Points の表示・非表示を設定する
+     * @param name - 対象の名前
+     * @param visibility - 可視状態
+     */
+    setVisibilityPoints(name: string, visibility: boolean): void;
+    /**
+     * 背景球（シーンの背景）の透明度を指定する（0.0 ～ 1.0）
+     * @param opacity - 透明度
+     */
+    setBackgroundOpacity(opacity: number): void;
+    /**
+     * 名前を指定してロード済み TavioMesh から背景を設定する
+     * @param name - 対象の名前
+     */
+    setBackgroundByTavioMesh(name: string): void;
+    /**
+     * 名前を指定した TavioMesh に含まれるメッシュに対して座標変換を適用する
+     * @param name - 対象の名前
+     * @param translation - 平行移動
+     * @param rotation - 回転（オイラー角）
+     * @param scale - 拡大縮小（XYZ で統一のスケール）
+     */
+    setModelTransform(name: string, translation: iVectorLike, rotation: iVectorLike, scale: number): void;
+    /**
+     * 名前を指定した TavioMesh に含まれるメッシュの座標変換情報を返す
+     * @param name - 対象の名前
+     */
+    getModelTransform(name: string): iTransform | null;
+    /**
+     * 名前を指定した TavioMesh に含まれるインスタンスを、インデックスで指定して動かす
+     * ※ここでいうインデックスとは load/concat した順番を意味する整数値（concat していない場合常に 0）
+     * @param name - 対象の名前
+     * @param index - インデックス
+     * @param translation - 平行移動
+     * @param rotation - 回転（オイラー角）
+     * @param scale - 拡大縮小（XYZ で統一のスケール）
+     */
+    setTransform(name: string, index: number, translation: iVectorLike, rotation: iVectorLike, scale: number): void;
+    /**
+     * 名前を指定した TavioMesh に含まれるインスタンスの、指定されたインデックスの座標変換情報を返す
+     * ※ここでいうインデックスとは load/concat した順番を意味する整数値
+     * @param name - 対象の名前
+     * @param index - インデックス
+     */
+    getTransform(name: string, index: number): iTransform | null;
+    /**
+     * 名前を指定した TavioMesh に含まれるインスタンスをビルボードとして扱うかどうかを設定する
+     * ※ここでいうインデックスとは load/concat した順番を意味する整数値
+     * @param name - 対象の名前
+     * @param index - インデックス
+     * @param flag - ビルボードとして扱うかどうか
+     */
+    setBillboard(name: string, index: number, flag: boolean): void;
+    /**
+     * ==========================================================================
+     * general
+     * ==========================================================================
+     */
+    /**
+     * ウィンドウのリサイズ処理
+     * @param width - 幅（CSS／論理ピクセル。Three.js setSize にそのまま渡す）
+     * @param height - 高さ（同上）
+     * @param start - リサイズと同時に描画を開始するかどうか
+     */
+    resize(width?: number, height?: number, start?: boolean): void;
+    /**
+     * 描画を開始する
+     * ※ pause() によって一時停止中の場合は何もしない（再開するには resume() を呼ぶ）
+     */
+    start(): void;
+    /**
+     * 描画を一時停止する
+     * ※ resume() を呼ぶまで、start() を呼び出す内部処理があっても描画は再開されない
+     */
+    pause(): void;
+    /**
+     * pause() によって一時停止した描画を再開する
+     */
+    resume(): void;
+    /**
+     * フレームレートの上限を設定する
+     * @param fps - 1秒あたりの上限フレーム数。0以下を指定すると上限を解除する
+     */
+    setFrameRateLimit(fps: number): void;
+    /**
+     * 描画処理
+     * @private
+     */
+    private _render;
+    /**
+     * 登録されている最初のメッシュの名前を取得する
+     */
+    getFirstMeshName(): string | null;
+    /**
+     * DevicePixelRatio をレンダラーに対して設定する
+     * @param value - 設定する DevicePixelRatio
+     */
+    setDevicePixelRatio(value: number): void;
+    /**
+     * 現在設定されている DevicePixelRatio を返す
+     */
+    getDevicePixelRatio(): number | null;
+    /**
+     * インタラクティブに描画するモードを用いるかどうかを設定する
+     * @param isInteractive - 有効とするかどうか
+     */
+    setInteractiveMode(isInteractive: boolean): void;
+    /**
+     * インタラクティブに描画するモードを用いているかどうかを返す
+     */
+    getInteractiveMode(): boolean;
+    /**
+     * 球面調和関数の交流成分を利用するかどうかを設定する
+     * @param isUsing - 利用するかどうかのフラグ
+     */
+    setUsingSphericalHarmonics(isUsing: boolean): void;
+    /**
+     * 球面調和関数の交流成分に対する係数を設定する（0.0 ～ 1.0）
+     * @param intensity - 0.0 で交流成分の効果が完全に不可視化される
+     */
+    setSphericalHarmonicsIntensity(intensity: number): void;
+    /**
+     * レンダラーに対して影の有効・無効を設定する
+     * @param enabled - 有効化するかどうか
+     */
+    setDropShadow(enabled: boolean): void;
+    /**
+     * ファイルに含まれるヘッダ情報及び頂点の情報などを取得する
+     */
+    getHeaderInfo(name: string): iHeaderInfo | null;
+    /**
+     * フレームバッファに 3DGS のワールド座標をレンダリングし指定されたスクリーン座標から取得する
+     * @param x - 取得する X 座標（スクリーン空間を -1.0 ～ 1.0 に正規化した座標）
+     * @param y - 取得する Y 座標（スクリーン空間を -1.0 ～ 1.0 に正規化した座標, Y-down）
+     * @param isDebug - デバッグモード（有効化するとピッキングバッファを可視化）
+     */
+    getWorldPositionByRenderView(x: number, y: number, isDebug?: boolean): Promise<iPickingInfo | null>;
+    /**
+     * スクリーン空間上の矩形またはドローイングマスクの範囲にあるスプラットを選択する
+     * @param x - 正規化された選択領域の左上 X 座標 (0.0 ~ 1.0)
+     * @param y - 正規化された選択領域の左上 Y 座標 (0.0 ~ 1.0)
+     * @param width - 正規化された選択領域の幅 (0.0 ~ 1.0)
+     * @param height - 正規化された選択領域の高さ (0.0 ~ 1.0)
+     * @param mode - 選択モード（SELECTION_MODE）
+     * @param maskSource - オプション：指定領域に対応するアルファマスク（Canvas, OffscreenCanvas, ImageData）
+     */
+    selectSplatByScreenArea(x: number, y: number, width: number, height: number, mode?: tSelectionMode, maskSource?: tMaskSource): Promise<void>;
+    /**
+     * 各種リソースを解放する
+     * ※このメソッドを呼び出すと、それまで利用していた canvas は再利用できなくなる
+     * ※別の canvas を渡して setupOnConstructor や init、render を呼ぶことで再度描画を行うことができる
+     * ※返り値の Promise は GPU プロセス側のコンテキスト消失（shared image の解放）が
+     *   確認できてから resolve する。forceContextLoss() 自体は同期的に返るが、実際の
+     *   コンテキスト消失は webglcontextlost イベントで非同期に通知されるため、これを
+     *   待たずに別の canvas で init() すると GPU プロセス側でリソース競合
+     *   （SharedImageManager の mailbox 不整合等）が起きうる。呼び出し側は
+     *   `await core.dispose()` してから次の init() を行うこと。
+     */
+    dispose(): Promise<void>;
+    /**
+     * ビューポートの情報を計算する
+     * @param projection - プロジェクション行列
+     * @param width - ビューポートの幅
+     * @param height - ビューポートの高さ
+     */
+    private _calcViewportUniforms;
+    /**
+     * ビューポートの情報を uniform 変数に設定する
+     * @param renderView - 対象となるレンダービュー
+     */
+    private _updateViewportUniforms;
+    /**
+     * 座標を焼き込むレンダリング処理を実行しソートを実行させる
+     * @param isForce - 強制的に実行するかどうか
+     */
+    private _renderDepthRenderTarget;
+    /**
+     * ==========================================================================
+     * renderview
+     * ==========================================================================
+     */
+    /**
+     * レンダービューを設定する
+     * @param renderViewName - 対象となるレンダービューの名前
+     */
+    setRenderView(renderViewName: string | Symbol | null): void;
+    /**
+     * レンダービューの個数を返す
+     */
+    getRenderViewCount(): number;
+    /**
+     * アクティブなレンダービューの名前を返す
+     * ※既定のレンダービューがアクティブな場合 null が返る
+     */
+    getCurrentRenderViewName(): string | null;
+    /**
+     * レンダービューを生成する（生成したインスタンスを呼び出し元に返さない）
+     * @param name - 生成されるレンダービューの固有名
+     */
+    createRenderView(name: string): void;
+    /**
+     * レンダービューに位置とサイズを設定する
+     * ※原点が左下角である点に注意（スクリーン座標系と上下が逆）
+     * @param renderViewName - 対象となるレンダービューの名前
+     * @param x - 矩形の左下角の横位置
+     * @param y - 矩形の左下角の縦位置
+     * @param width - 幅（論理ピクセル。未指定・null 時は renderer.getSize()）
+     * @param height - 高さ（論理ピクセル。未指定・null 時は renderer.getSize()）
+     * @param start - 同時に描画を開始するかどうか
+     */
+    setRenderViewSize(renderViewName?: string | Symbol | null, x?: number, y?: number, width?: number, height?: number, start?: boolean): void;
+    /**
+     * レンダービューを生成し、各種コントロールのセットアップも同時に行う
+     * @param name - 生成されるレンダービューの固有名
+     */
+    private _createRenderView;
+    /**
+     * 名前を指定してレンダービューを取得する
+     * @param renderViewName - 対象となるレンダービューの名前
+     */
+    private _getRenderView;
+    /**
+     * ==========================================================================
+     * camera
+     * ==========================================================================
+     */
+    /**
+     * カメラの現在の座標と視線方向、視野角を取得する
+     */
+    getCameraParameter(): iCameraParameter;
+    /**
+     * カメラの現在の座標と注視点、視野角を設定する
+     * ※このメソッドは設定時、その値が即座に反映される
+     * @param position - 設定する座標
+     * @param target - 設定する注視点
+     * @param fov - 設定する視野角
+     */
+    setCameraParameter(position?: iVectorLike | null, target?: iVectorLike | null, fov?: number | null): void;
+    /**
+     * ==========================================================================
+     * controls
+     * ==========================================================================
+     */
+    /**
+     * Controls タイプを設定する
+     * @param type - 設定するタイプを意味する文字列
+     */
+    setControlsType(type: tControlsType): void;
+    /**
+     * 現在のカメラコントロールを意味する文字列を返す
+     */
+    getControlsType(): tControlsType;
+    /**
+     * FlightControls と TransferControls に減衰を設定する
+     * @param attenuation - 減衰（0.0 以上 ～ 1.0 未満）
+     */
+    setControlsAttenuation(attenuation: number): void;
+    /**
+     * ==========================================================================
+     * orbit controls
+     * ==========================================================================
+     */
+    /**
+     * オービットコントロールのズーム使用可否を設定する
+     * @param enable - 使用可否を意味する真偽値
+     */
+    setOrbitEnableZoom(enable: boolean): void;
+    /**
+     * オービットコントロールの平行移動使用可否を設定する
+     * @param enable - 使用可否を意味する真偽値
+     */
+    setOrbitEnablePan(enable: boolean): void;
+    /**
+     * オービットコントロールの可動範囲制限の可否を設定する
+     * @param enable - 使用可否を意味する真偽値
+     */
+    setOrbitEnableLimit(enable: boolean): void;
+    /**
+     * オービットコントロールのズーム範囲制限の可否を設定する
+     * @param enable - 使用可否を意味する真偽値
+     */
+    setOrbitEnableZoomLimit(enable: boolean): void;
+    /**
+     * オービットコントロールの注視点と座標の距離を取得する
+     * @returns 注視点と座標の距離
+     */
+    getOrbitDistance(): number;
+    /**
+     * オービットコントロールの注視点から位置までの距離を設定する
+     * @param distance - 設定する距離
+     */
+    setOrbitDistance(distance: number): void;
+    /**
+     * オービットコントロールのピッチとヨーを設定する
+     * @param pitch - ピッチ角度の変化量（ラジアン）
+     * @param yaw - ヨー角度の変化量（ラジアン）
+     */
+    setOrbitRotation(pitch: number, yaw: number, isForce?: boolean): void;
+    /**
+     * オービットコントロールのピッチとヨーを相対的に移動する
+     * @param pitch - ピッチ角度の変化量（ラジアン）
+     * @param yaw - ヨー角度の変化量（ラジアン）
+     */
+    setOrbitRelativeRotation(pitch: number, yaw: number): void;
+    /**
+     * オービットコントロールのドリー（前後移動）を相対的に設定する
+     * @param value - 設定する値
+     */
+    setOrbitRelativeDollyOut(value: number): void;
+    /**
+     * オービットコントロールの上下の回転を相対的に設定する
+     * @param value - 設定する値
+     */
+    setOrbitRelativeRotateUp(value: number): void;
+    /**
+     * オービットコントロールの左右の回転を相対的に設定する
+     * @param value - 設定する値
+     */
+    setOrbitRelativeRotateLeft(value: number): void;
+    /**
+     * オービットコントロールの上下の移動を相対的に設定する
+     * @param value - 設定する値
+     */
+    setOrbitRelativeTranslateUp(value: number): void;
+    /**
+     * オービットコントロールの左右の移動を相対的に設定する
+     * @param value - 設定する値
+     */
+    setOrbitRelativeTranslateLeft(value: number): void;
+    /**
+     * オービットコントロールへポインターが押下中かどうかを設定する
+     * @param isDown - 設定する値
+     */
+    setOrbitPointerDown(isDown: boolean): void;
+    /**
+     * オービットコントロールの範囲外へはみ出すことができる範囲を設定する
+     * @param value - 設定する値
+     */
+    setOrbitOverflow(value: number): void;
+    /**
+     * オービットコントロールの北緯方向の可動範囲を設定する
+     * @param value - 設定する値
+     */
+    setOrbitUpLimit(value: number): void;
+    /**
+     * オービットコントロールの南緯方向の可動範囲を設定する
+     * @param value - 設定する値
+     */
+    setOrbitDownLimit(value: number): void;
+    /**
+     * オービットコントロールの西経方向の可動範囲を設定する
+     * @param value - 設定する値
+     */
+    setOrbitLeftLimit(value: number): void;
+    /**
+     * オービットコントロールの西経方向の可動範囲を設定する
+     * @param value - 設定する値
+     */
+    setOrbitRightLimit(value: number): void;
+    /**
+     * オービットコントロールのズームの最短距離を設定する
+     * @param value - 設定する値
+     */
+    setOrbitZoomInLimit(value: number): void;
+    /**
+     * オービットコントロールのズームの最長距離を設定する
+     * @param value - 設定する値
+     */
+    setOrbitZoomOutLimit(value: number): void;
+    /**
+     * ==========================================================================
+     * camera path controls
+     * ==========================================================================
+     */
+    /**
+     * カメラパスを生成して返す
+     * @param position - カメラの座標（{x, y, z} のオブジェクト、または [x, y, z] の数値の配列）の配列
+     * @param target - 注視点の座標（{x, y, z} のオブジェクト、または [x, y, z] の数値の配列）の配列
+     * @param debug - デバッグモードをオンにすると、各点とその補間後の軌跡がシーンに追加される
+     */
+    createCameraPath(position: iVectorLike[] | number[][], target: iVectorLike[] | number[][], debug?: boolean): CameraPath;
+    /**
+     * カメラパスが有効な場合、指定された時間を設定し更新する
+     * @param time - 設定する時間（0.0 ～ 1.0）
+     */
+    updateCameraPath(time: number): void;
+    /**
+     * カメラパスを名前と座標データで追加登録する
+     * @param name - カメラパスの識別名
+     * @param position - カメラ移動経路の座標配列
+     * @param target - カメラ注視点経路の座標配列
+     * @param debug - デバッグ用軌跡描画を行うかどうか
+     */
+    addCameraPath(name: string, position: iVectorLike[] | number[][], target: iVectorLike[] | number[][], debug?: boolean): void;
+    /**
+     * カメラパスを名前で削除する
+     * @param name - 削除するカメラパスの名前
+     */
+    removeCameraPath(name: string): void;
+    /**
+     * アクティブなカメラパスを選択する
+     * @param name - 選択するカメラパスの名前
+     */
+    selectCameraPath(name: string): void;
+    /**
+     * 現在アクティブなカメラパスの名前を取得する
+     * @returns アクティブなカメラパスの名前、または null
+     */
+    getActiveCameraPathName(): string | null;
+    /**
+     * 指定したカメラパスの指定時刻における座標と注視点を取得する
+     * @param name - カメラパスの名前。省略時は現在アクティブなカメラパス
+     * @param time - 進行度 (0.0 ～ 1.0)。省略時は現在の再生時刻
+     * @returns 指定時刻での座標と注視点データ、または null
+     */
+    getCameraPathByTime(name?: string, time?: number): {
+        position: iVectorLike;
+        target: iVectorLike;
+    } | null;
+    /**
+     * カメラパスコントロールの現在時刻（progress）を取得する
+     * @returns 現在時刻（0.0 ～ 1.0）、または null
+     */
+    getCameraPathTime(): number | null;
+    /**
+     * すべてのカメラパス名を取得する
+     * @returns カメラパス名の配列
+     */
+    getPathNames(): string[];
+    /**
+     * カメラパスのオプションを設定する
+     * @param option - カメラパスに設定するオプション
+     */
+    setCameraPathOption(option: iCameraPathOption): void;
+    /**
+     * カメラパスのインタラクション用の座標を設定する
+     * @param x - 設定する X 座標（スクリーン空間を -1.0 ～ 1.0 に正規化した座標）
+     * @param y - 設定する Y 座標（スクリーン空間を -1.0 ～ 1.0 に正規化した座標, Y-down）
+     */
+    setCameraPathInteraction(x: number, y: number): void;
+    /**
+     * カメラパスの可動領域（カプセル型）の半径を設定する
+     * @param radius - 設定する半径
+     */
+    setCameraPathCollisionRadius(radius: number): void;
+    /**
+     * ==========================================================================
+     * flight controls
+     * ==========================================================================
+     */
+    /**
+     * FlightControls に緯度を設定する
+     * @param latitude - 緯度（-90 ～ 90）
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setFlightLatitude(latitude: number, isForce?: boolean): void;
+    /**
+     * FlightControls に経度を設定する
+     * @param longitude - 経度（0 ～ 360）
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setFlightLongitude(longitude: number, isForce?: boolean): void;
+    /**
+     * FlightControls に緯度を相対的に設定する
+     * @param latitude - 相対値
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setFlightRelativeLatitude(latitude: number, isForce?: boolean): void;
+    /**
+     * FlightControls に経度を相対的に設定する
+     * @param longitude - 相対値
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setFlightRelativeLongitude(longitude: number, isForce?: boolean): void;
+    /**
+     * FlightControls から緯度経度を取得する
+     */
+    getFlightParameter(): iLatitudeLongitude | null;
+    /**
+     * ==========================================================================
+     * transfer controls
+     * ==========================================================================
+     */
+    /**
+     * TransferControls に位置を設定する
+     * @param position - 位置
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setTransferPosition(position: iVectorLike, isForce?: boolean): void;
+    /**
+     * TransferControls に位置を相対的に設定する
+     * @param position - 相対値
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setTransferRelativePosition(position: iVectorLike, isForce?: boolean): void;
+    /**
+     * TransferControls に fov を設定する
+     * @param fov - 設定する fov
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setTransferFov(fov: number, isForce?: boolean): void;
+    /**
+     * TransferControls に、現在の位置と向きに応じて移動するよう設定する
+     * @param offset - 移動する量
+     * @param scale - 移動するスケール
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    moveTransferByDirection(offset: iVectorLike, scale: number, isForce?: boolean): void;
+    /**
+     * TransferControls に、現在の位置と向きに応じて水平に移動するよう設定する
+     * @param x - 右を正とした横方向
+     * @param y - 奥を正とした前後方向
+     * @param scale - 移動するスケール
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    moveTransferByHorizontalDirection(x: number, y: number, scale: number, isForce?: boolean): void;
+    /**
+     * TransferControls に、XZ 平面に対して上昇するよう設定する
+     * @param scale - 移動するスケール
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    moveTransferToTop(scale: number, isForce?: boolean): void;
+    /**
+     * TransferControls に、XZ 平面に対して下降するよう設定する
+     * @param scale - 移動するスケール
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    moveTransferToBottom(scale: number, isForce?: boolean): void;
+    /**
+     * ==========================================================================
+     * camera collider
+     * ==========================================================================
+     */
+    /**
+     * カメラコライダーの有効・無効を設定する
+     * @param enabled - 有効化するかどうか
+     */
+    setCameraColliderEnabled(enabled: boolean): void;
+    /**
+     * カメラコライダー処理の対象となるセレクター名の一覧を設定する
+     * @param selectorNames - セレクター名の配列
+     */
+    setCameraColliderSelector(selectorNames?: string[]): void;
+    /**
+     * カメラコライダーの有効・無効状態を取得する
+     * @returns カメラコライダーが有効かどうか
+     */
+    getCameraColliderEnabled(): boolean;
+    /**
+     * ==========================================================================
+     * Light and Shadow
+     * ==========================================================================
+     */
+    /**
+     * アンビエントライトをレンダービューに追加する
+     * @param color - 光の色
+     * @param intensity - 光の強さ
+     */
+    addAmbientLight(color: number, intensity: number): void;
+    /**
+     * スポットライトをレンダービューに追加する
+     * @param position - ライトの位置
+     * @param target - ライトの注視点
+     * @param color - 光の色
+     * @param intensity - 光の強さ
+     * @param distance - 光が届く距離
+     * @param angle - 光が届く範囲（Math.PI / 2 より小さな値を指定）
+     * @param penumbra - 光の輪郭のぼやけ具合
+     * @param decay - 光の減衰
+     * @param castShadow - 影を落とすかどうか
+     * @param isDebug - ヘルパーを表示するかどうか
+     */
+    addSpotLight(position: iVectorLike, target: iVectorLike, color: number, intensity: number, distance: number, angle: number, penumbra: number, decay: number, castShadow?: boolean, isDebug?: boolean): void;
+    /**
+     * ホワイトキューブの Mesh を追加する
+     * @param position - キューブの位置
+     * @param scale - キューブに対するスケール
+     * @param receiveShadow - 影が落ちるかどうか
+     * @param materialOption - MeshStandardMaterial の初期化オプション
+     */
+    addWhiteCube(position: iVectorLike, scale: iVectorLike, receiveShadow?: boolean, materialOption?: MeshStandardMaterialParameters): void;
+    /**
+     * 現在のレンダービューのアンビエントライトの強度を設定する
+     * @param intensity - 光の強度
+     */
+    setAmbientLightIntensity(intensity: number): void;
+    /**
+     * 現在のレンダービューのスポットライトの位置を設定する
+     * @param position - 位置
+     */
+    setSpotLightPosition(position: iVectorLike): void;
+    /**
+     * 現在のレンダービューのスポットライトのターゲット位置を設定する
+     * @param target - ターゲット位置
+     */
+    setSpotLightTargetPosition(target: iVectorLike): void;
+    /**
+     * 現在のレンダービューのスポットライトの強度を設定する
+     * @param intensity - 光の強度
+     */
+    setSpotLightIntensity(intensity: number): void;
+    /**
+     * 現在のレンダービューのスポットライトの照射距離を設定する
+     * @param distance - 照射距離
+     */
+    setSpotLightDistance(distance: number): void;
+    /**
+     * 現在のレンダービューのスポットライトの放射角を設定する
+     * @param angle - 放射角
+     */
+    setSpotLightAngle(angle: number): void;
+    /**
+     * 現在のレンダービューのスポットライトの半影を設定する
+     * @param penumbra - 半影の割合
+     */
+    setSpotLightPenumbra(penumbra: number): void;
+    /**
+     * 現在のレンダービューのスポットライトの減衰を設定する
+     * @param decay - 減衰の度合い
+     */
+    setSpotLightDecay(decay: number): void;
+    /**
+     * 影を描画・更新する
+     */
+    renderShadow(): void;
+    /**
+     * ==========================================================================
+     * shader effects
+     * ==========================================================================
+     */
+    /**
+     * MaterialGenerator で独自に拡張した defines を更新する
+     * @param customUniforms - 設定・更新する defines
+     */
+    setCustomDefines(customDefines: tCustomDefines): void;
+    /**
+     * MaterialGenerator で独自に拡張した uniform 変数を更新する
+     * @param customUniforms - 設定・更新する uniform 変数
+     */
+    setCustomUniforms(customUniforms: tCustomUniforms): void;
+    /**
+     * スプラットの大きさの基本係数を設定する
+     * @param value - 設定する係数（0.0 to 1.0）
+     */
+    setGaussianScale(value: number): void;
+    /**
+     * シェーダ上で作用する加減算アルファ値を設定する
+     * @param alpha - アルファ（適切な範囲はおよそ -3.0 ～ 3.0）
+     */
+    setOpacityAdditive(alpha: number): void;
+    /**
+     * シェーダ上で作用する乗算アルファ値を設定する
+     * @param alpha - アルファ（適切な範囲はおよそ -3.0 ～ 3.0）
+     */
+    setOpacityMultiplier(alpha: number): void;
+    /**
+     * 点描画用の Points に対してアルファを設定する
+     * @param alpha - アルファ（0.0 ～ 1.0）
+     */
+    setOpacityPoints(alpha: number): void;
+    /**
+     * シェーダ上で作用する blur を設定する
+     * @param blur - スプラット内で色をぼかす係数（適切な範囲はおよそ 0.0 ～ 1.0）
+     */
+    setColorBlur(blur: number): void;
+    /**
+     * シェーダ上で作用する sharpness を設定する
+     * @param sharpness - スプラット内で色を強調する係数（適切な範囲はおよそ 0.0 ～ 1.0）
+     */
+    setColorSharpness(sharpness: number): void;
+    /**
+     * シェーダ上で作用する色温度（Color Temperature）を設定する
+     * @param temperature - 色温度（-1.0 ～ 1.0）
+     */
+    setColorTemperature(temperature: number): void;
+    /**
+     * シェーダ上で作用する色合い（Color Tint）を設定する
+     * @param tint - ティント係数（-1.0 ～ 1.0）
+     */
+    setColorTint(tint: number): void;
+    /**
+     * シェーダ上で作用するコントラストを設定する
+     * @param contrast - コントラスト強調係数（標準: 0.5）
+     */
+    setColorContrast(contrast: number): void;
+    /**
+     * シェーダ上で作用する HSV カラーシフト（Hue, Saturation, Value）を設定する
+     * @param hsv - 色相・彩度・明度の変調ベクトル（x: Hue, y: Saturation, z: Value）
+     */
+    setHSVColor(hsv: iVectorLike): void;
+    /**
+     * シェーダ上で作用する RGB カラー倍数を設定する
+     * @param rgb - 赤・緑・青の乗算カラーベクトル（x: Red, y: Green, z: Blue）
+     */
+    setColorRGB(rgb: iVectorLike): void;
+    /**
+     * クリッピング（領域切り取り）機能の有効・無効を設定する
+     * @param enabled - クリッピングを有効にするかどうか
+     */
+    setClippingEnabled(enabled: boolean): void;
+    /**
+     * クリッピング球のワールド空間における位置とスケールを設定する
+     * @param position - クリッピング球の位置ベクトル
+     * @param scale - クリッピング球のスケールベクトル
+     */
+    setClippingSphere(position: iVectorLike, scale: iVectorLike): void;
+    /**
+     * クリッピング領域外のスプラット描画サイズを設定する
+     * @param size - 領域外スプラットのポイントサイズ
+     */
+    setOutsideClipPointSize(size: number): void;
+    /**
+     * クリッピング領域外のスプラット不透明度（アルファ）を設定する
+     * @param opacity - 領域外スプラットの不透明度（0.0 ～ 1.0）
+     */
+    setOutsideClipOpacity(opacity: number): void;
+    private activeAnimations;
+    private animationMaxRenderDistance;
+    private animationMainDistance;
+    private animationRemainingDistance;
+    private animationSplitPoint;
+    private _updateAnimation;
+    private _mapProgressToDistance;
+    /**
+     * 距離に応じたスプラットの大きさにおける最小値を設定する
+     * @param value - 設定する係数（0.0 to 1.0）
+     */
+    setEffectMinimumScale(value: number): void;
+    /**
+     * 距離に応じたスプラットの大きさ係数を設定する
+     * @param value - 設定する係数（0.0 ～ 1.0）
+     */
+    setEffectDistanceBase(value: number): void;
+    /**
+     * 距離に応じたスプラットの範囲係数を設定する
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectDistanceRange(value: number): void;
+    /**
+     * シェーダーで使用するワールド原点を設定する
+     * @param x - X座標
+     * @param y - Y座標
+     * @param z - Z座標
+     */
+    setWorldOrigin(x: number, y: number, z: number): void;
+    /**
+     * 点描画用の Points に対して距離に応じたエフェクトの範囲係数を設定する（外側）
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectDistancePoints(value: number): void;
+    /**
+     * 点描画用の Points に対して距離に応じたエフェクトの範囲係数を設定する (内側)
+     * @param value - 設定する係数（0.0 ～ 1.0）
+     */
+    setEffectDistanceNearPoints(value: number): void;
+    /**
+     * ソナーエフェクトを設定する（外側）
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectSonar(value: number): void;
+    /**
+     * ソナーエフェクトの範囲を設定する
+     * @param value - 設定する係数（0.0 ～ 1.0）
+     */
+    setEffectSonarRange(value: number): void;
+    /**
+     * 点描画の開花効果をアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    startBloomPoints(duration?: number): void;
+    /**
+     * 点描画からスプラットへの溶解効果をアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     * @param backgroundFadeInDelay - 溶解開始から fadeInBackground を開始するまでの遅延（ミリ秒）
+     * @param backgroundFadeInDuration - fadeInBackground の継続時間（ミリ秒）
+     */
+    startDissolveToGaussian(duration?: number, backgroundFadeInDelay?: number, backgroundFadeInDuration?: number): void;
+    /**
+     * ソナー波効果をアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    startSonarWave(duration?: number): void;
+    /**
+     * カメラパスをアニメーションする
+     * @param name - カメラパスの名前
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    animatePath(name?: string, duration?: number): void;
+    /**
+     * 背景の不透明度を0から1.0へアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     * @param startDelay - 開始までの遅延（ミリ秒、デフォルト0）
+     */
+    startFadeInBackground(duration?: number, startDelay?: number): void;
+    /**
+     * 背景の不透明度を1.0から0へアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    startFadeOutBackground(duration?: number): void;
+    /**
+     * 名前で指定したスプラットメッシュの選択領域に対してローカルトランスフォームを累積適用する
+     * @param name - 対象メッシュ名
+     * @param translation - 平行移動ベクトル
+     * @param rotation - 回転オイラー角
+     * @param scale - スケールベクトル
+     */
+    applyLocalTransformToSelected(name: string, translation: iVectorLike, rotation: iVectorLike, scale: iVectorLike): void;
+    /**
+     * 名前で指定したスプラットメッシュの選択中のローカルトランスフォームをリセットする
+     * @param name - 対象メッシュ名
+     */
+    resetLocalTransformOfSelected(name: string): void;
+    /**
+     * 名前で指定したスプラットメッシュのすべてのローカルトランスフォームを初期化・リセットする
+     * @param name - 対象メッシュ名
+     */
+    resetAllLocalTransforms(name: string): void;
+    /**
+     * ローカルトランスフォームのためのギズモをセットアップする
+     */
+    private setupLocalTransformGizmo;
+    /**
+     * ローカルトランスフォーム操作用ギズモの有効/無効を設定する
+     * @param enabled - 有効にするかどうか
+     */
+    setLocalTransformGizmoEnabled(enabled: boolean): void;
+    /**
+     * ローカルトランスフォーム操作用ギズモの操作モードを設定する
+     * @param mode - 操作モード ("translate" | "rotate" | "scale")
+     */
+    setLocalTransformGizmoMode(mode: "translate" | "rotate" | "scale"): void;
+    /**
+     * 選択中のスプラット情報に基づいてローカル変換ギズモの位置・姿勢を自動更新する
+     */
+    updateLocalTransformGizmo(): void;
+    /**
+     * ギズモのダミーオブジェクトのトランスフォームを、選択中のスプラットに一括同期反映する
+     */
+    private syncLocalTransformFromGizmo;
+    /**
+     * OrbitControlsの注視点カーソルを、注視点変更時に自動表示するかどうかを設定する
+     * @param enabled - 有効にするかどうか
+     */
+    setOrbitCursorAutoDisplay(enabled: boolean): void;
+    /**
+     * 注視点変更時のオービットカーソル自動表示が有効かどうかを取得する
+     * @returns 有効かどうか
+     */
+    isOrbitCursorAutoDisplayEnabled(): boolean;
+    /**
+     * オービットカーソルの常時表示が有効かどうかを取得する
+     * @returns 有効かどうか
+     */
+    isOrbitCursorDisplay(): boolean;
+    /**
+     * OrbitControlsの注視点カーソルを常に表示するかどうかを設定する
+     * @param enabled - 有効にするかどうか
+     */
+    setOrbitCursorDisplay(enabled: boolean): void;
+    /**
+     * OrbitControlsの注視点カーソルのスケールを設定する
+     * @param scale - スケール
+     */
+    setOrbitCursorScale(scale: number): void;
+    /**
+     * デバッグ用座標軸（AxesHelper）の表示・非表示を設定する
+     * @param visible - 表示するかどうか
+     */
+    setAxisVisible(visible: boolean): void;
+    /**
+     * デバッグ用座標軸（AxesHelper）が表示されているかどうかを取得する
+     * @returns 表示されているかどうか
+     */
+    isAxisVisible(): boolean;
+    /**
+     * 3D Orbit Cursor の表示・位置追従を更新する
+     */
+    private _updateOrbitCursor;
+    /**
+     * 全メッシュの Gaussian スプラットマテリアルに Uniforms を一括設定する
+     * @param uniforms - 設定する Uniforms オブジェクト
+     */
+    setUniforms(uniforms: Record<string, tUniformValue>): void;
+    /**
+     * 全メッシュの Points（点描画）マテリアルに Uniforms を一括設定する
+     * @param uniforms - 設定する Uniforms オブジェクト
+     */
+    setPointUniforms(uniforms: Record<string, tUniformValue>): void;
+    private selectorMap;
+    private reversedCollision;
+    /**
+     * セレクターによる衝突判定の反転フラグを設定する
+     * @param reversed - 設定する反転属性
+     */
+    setCollisionReversed(reversed: boolean): void;
+    /**
+     * 現在選択しているスプラットを削除状態とする
+     */
+    deleteSelectedGaussian(): void;
+    /**
+     * 削除状態を一世代前に戻す
+     */
+    undoDeletedGaussian(): void;
+    /**
+     * すべての削除状態をリセットする
+     */
+    resetDeletedGaussian(): void;
+    /**
+     * 現在の衝突判定を解除する
+     */
+    resetCollision(): void;
+    /**
+     * 衝突判定を設定する
+     * @param collision - 設定する衝突判定、またはその配列
+     * @param mode - 選択モード（SELECTION_MODE）
+     */
+    setCollision(collision: iCollisionTarget | iCollisionTarget[], mode?: tSelectionMode): void;
+    /**
+     * 球の衝突判定パラメータ（Worker に渡すフォーマット）を生成する
+     * @param radius - 半径
+     * @param position - ワールド空間における位置
+     * @param scale - ワールド空間における拡大縮小（スケール）
+     * @param inverseMatrix - ワールド変換の逆行列
+     * @param reversed - 判定の反転（球に内包されている状態を規定とし、それを反転するかどうか）
+     */
+    private createCollisionSphere;
+    /**
+     * 箱の衝突判定パラメータ（Worker に渡すフォーマット）を生成する
+     * @param width - 一辺の幅
+     * @param height - 一辺の高さ
+     * @param depth - 一辺の奥行き
+     * @param position - ワールド空間における位置
+     * @param scale - ワールド空間における拡大縮小（スケール）
+     * @param inverseMatrix - ワールド変換の逆行列
+     * @param reversed - 判定の反転（球に内包されている状態を規定とし、それを反転するかどうか）
+     */
+    private createCollisionBox;
+    /**
+     * 単一セレクターから Worker 用の CollisionTarget を生成するヘルパー
+     * @param selector - 対象のセレクター名
+     * @param reversed - 反転フラグ
+     */
+    private getCollisionTargetFromSelector;
+    /**
+     * 名前を指定してセレクターで衝突判定を行う
+     * @param name - 対象となるセレクターの名前
+     * @param mode - 選択モード（SELECTION_MODE）
+     */
+    checkCollisionBySelector(name: string, mode?: tSelectionMode): void;
+    /**
+     * 名前を複数（配列で）指定して対象のセレクターで衝突判定を行う
+     * @param names - 対象となるセレクターの名前の配列
+     * @param mode - 選択モード（SELECTION_MODE）
+     */
+    checkCollisionBySelectors(names: string[], mode?: tSelectionMode): void;
+    /**
+     * 現在追加されているすべてのセレクターで衝突判定を行う
+     * @param mode - 選択モード（SELECTION_MODE）
+     */
+    checkCollisionByAllSelectors(mode?: tSelectionMode): void;
+    /**
+     * ==========================================================================
+     * selector
+     * ==========================================================================
+     */
+    /**
+     * 単一セレクターの諸情報を取得するヘルパー
+     * @param name - 対象のセレクター名
+     */
+    private getSelectorInfo;
+    /**
+     * すべての生成済みセレクターの諸情報を返す
+     */
+    getAllSelectorInfo(): iSelectorInfo[];
+    /**
+     * 名前を指定してセレクターの可視性を設定する
+     * @param name - 対象セレクター名
+     * @param visible - 可視性
+     */
+    setSelectorVisible(name: string, visible: boolean): void;
+    /**
+     * 名前を指定してセレクターを平行移動モードにする
+     * @param name - 設定するセレクターの名前
+     */
+    setSelectorModeTranslate(name: string): void;
+    /**
+     * 名前を指定してセレクターを拡大縮小モードにする
+     * @param name - 設定するセレクターの名前
+     */
+    setSelectorModeScale(name: string): void;
+    /**
+     * 名前を指定してセレクターを回転モードにする
+     * @param name - 設定するセレクターの名前
+     */
+    setSelectorModeRotate(name: string): void;
+    /**
+     * 名前を指定してセレクターの位置を設定する
+     * @param name - 設定するセレクターの名前
+     * @param position - 設定する位置
+     */
+    setSelectorPosition(name: string, position: iVectorLike): void;
+    /**
+     * 名前を指定してセレクターの回転を設定する
+     * @param name - 設定するセレクターの名前
+     * @param rotation - 設定する回転（Euler）
+     */
+    setSelectorRotation(name: string, rotation: iVectorLike): void;
+    /**
+     * 名前を指定してセレクターのスケールを設定する
+     * @param name - 設定するセレクターの名前
+     * @param position - 設定するスケール
+     */
+    setSelectorScale(name: string, scale: iVectorLike): void;
+    /**
+     * 名前を指定してセレクターを削除する
+     * @param name - 削除するセレクターの名前
+     */
+    deleteSelector(name: string): void;
+    /**
+     * 名前を指定して球のセレクターを追加する（既定の状態では visible が false である点に注意）
+     * @param name - 追加するセレクターに付与する名前
+     * @param option - セレクターに対するオプション
+     */
+    addSphereSelector(name: string, option?: iSphereSelectorOption): void;
+    /**
+     * 名前を指定して箱のセレクターを追加する（既定の状態では visible が false である点に注意）
+     * @param name - 追加するセレクターに付与する名前
+     * @param option - セレクターに対するオプション
+     */
+    addBoxSelector(name: string, option?: iBoxSelectorOption): void;
+}