@openheart/tavio-renderer 2.6.1 → 2.6.3

package/build/esm/types/camera/orbitControls.d.ts

@@ -119,6 +119,11 @@ export declare class OrbitControls extends EventEmitter {
      * 設定されているカメラの情報を各プロパティに反映する
      */
     syncCameraParameter(): void;
+    /**
+     * 操作の慣性（ズーム・回転・平行移動の残り、バウンス）を打ち消して、現在のカメラの状態で静止させる
+     * カメラを外部から動かす間に、直前の操作の慣性でカメラが引き戻されないようにするために使う
+     */
+    stopMotion(): void;
     /**
      * 注視点とカメラの距離を返す
      */

package/build/esm/types/editor/visibleAreaHelper.d.ts

@@ -0,0 +1,36 @@
+import { Group } from 'three';
+import { iVectorLike } from '../viewer/types';
+export interface iVisibleAreaHelperOption {
+    /** "sphere": 楕円体 / "cube": 直方体 */
+    type: "sphere" | "cube";
+    /** 領域の中心（ワールド座標） */
+    position: iVectorLike | [number, number, number];
+    /** 各軸の大きさ（sphere は直径、cube は辺の長さ） */
+    size: iVectorLike | [number, number, number];
+    /** 回転（ラジアン、オイラー角 XYZ 順）。省略時は回転なし */
+    rotation?: iVectorLike | [number, number, number];
+    /** 線と面の色（デフォルト: 0x13acfc） */
+    color?: number;
+}
+/**
+ * クロップ領域(表示領域)を、輪郭の線と薄い半透明の面で表示するヘルパー。
+ * 単位サイズの形を position / rotation / size で変換して表示する。
+ * 点群に埋もれても見えるよう深度テストは行わない
+ */
+export declare class VisibleAreaHelper extends Group {
+    private areaType;
+    private fill;
+    private lines;
+    constructor(option: iVisibleAreaHelperOption, resolution: {
+        x: number;
+        y: number;
+    });
+    /** 形・位置・大きさ・回転・色を更新する。形が変わった場合だけジオメトリを作り直す */
+    update(option: iVisibleAreaHelperOption): void;
+    /** 線の太さ(px)を計算するための描画領域のサイズを設定する */
+    setResolution(resolution: {
+        x: number;
+        y: number;
+    }): void;
+    dispose(): void;
+}

package/build/esm/types/math/plane.d.ts

@@ -0,0 +1,8 @@
+import { Vector3 } from 'three';
+/**
+ * 点群に最もよく当てはまる平面の法線を主成分分析で求める
+ * 点が 3 つ未満、または直線状・一点に集中していて平面が定まらない場合は null を返す
+ * @param points - 平面を推定する点群
+ * @returns 正規化された法線（向きは不定）
+ */
+export declare function estimatePlaneNormal(points: Vector3[]): Vector3 | null;

package/build/esm/types/module.d.ts

@@ -1,7 +1,9 @@
 import { Core } from './viewer/canvas';
-import { TavioError, tSelectionMode, tMaskSource, iLoadingOption, iViewerOption, iHeaderInfo, iDistanceInfo, iTransform, iVectorLike, tUniformPlainValue, tCustomDefines, tCustomUniformValue, tCustomUniforms } from './viewer/types';
+import { TavioError, tSelectionMode, tMaskSource, iLoadingOption, iViewerOption, iHeaderInfo, iDistanceInfo, iTransform, iVectorLike, iSurfaceInfo, iFocusMarkerOption, tUniformPlainValue, tCustomDefines, tCustomUniformValue, tCustomUniforms } from './viewer/types';
 import { TAVIO_ERROR_CODE, SELECTION_MODE } from './viewer/constants';
 import { CHUNK_TARGET, SHADER_STAGE, iMaterialOption } from './viewer/materialGenerator';
-export { Core, TavioError, TAVIO_ERROR_CODE, SELECTION_MODE, CHUNK_TARGET, SHADER_STAGE, };
-export type { iMaterialOption, tSelectionMode, tMaskSource, iLoadingOption, iViewerOption, iHeaderInfo, iDistanceInfo, iTransform, iVectorLike, tUniformPlainValue, tCustomDefines, tCustomUniformValue, tCustomUniforms, };
+import { iVisibleAreaHelperOption } from './editor/visibleAreaHelper';
+import { setWasmBaseUrl } from './wasm-bindings/wasm-worker-client';
+export { Core, TavioError, TAVIO_ERROR_CODE, SELECTION_MODE, CHUNK_TARGET, SHADER_STAGE, setWasmBaseUrl, };
+export type { iMaterialOption, iVisibleAreaHelperOption, tSelectionMode, tMaskSource, iLoadingOption, iViewerOption, iHeaderInfo, iDistanceInfo, iTransform, iVectorLike, iSurfaceInfo, iFocusMarkerOption, tUniformPlainValue, tCustomDefines, tCustomUniformValue, tCustomUniforms, };
 export default Core;

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

@@ -3,11 +3,12 @@ import { MeshStandardMaterialParameters } from 'three';
 import { iLatitudeLongitude } from '../camera/flightControls';
 import { WorkerElementAdapter } from './driver/workerElementAdapter';
 import { CameraPath } from '../camera/cameraPath';
-import { iVectorLike, iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iSelectorInfo, iPickingInfo, iCameraPathOption, iCameraParameter, tSelectionMode, tMaskSource, tControlsType, tCustomDefines, tCustomUniforms } from './types';
+import { iVectorLike, iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iSelectorInfo, iPickingInfo, iSurfaceInfo, iFocusMarkerOption, iCameraPathOption, iCameraParameter, tSelectionMode, tMaskSource, tControlsType, tCustomDefines, tCustomUniforms } from './types';
 import { iCollisionTarget } from '../worker/tavioWorker';
 import { iSphereSelectorOption } from '../editor/selector/sphereSelector';
 import { iBoxSelectorOption } from '../editor/selector/boxSelector';
 import { iCameraSelectorOption } from '../editor/selector/cameraSelector';
+import { iVisibleAreaHelperOption } from '../editor/visibleAreaHelper';
 export declare class Core extends EventEmitter {
     private driver;
     static CHUNK_TARGET: {
@@ -87,6 +88,12 @@ export declare class Core extends EventEmitter {
     saveSpzWasm(name: string, fileName?: string): Promise<any>;
     saveTavioWasm(name: string, fileName?: string, options?: any): Promise<any>;
     exportTavioWasm(name: string, options?: any): Promise<any>;
+    /**
+     * splat / ply / spz / sog 形式のバイナリデータを取得する。OffscreenCanvas(Worker)で描画している場合も取得できる
+     * @param name - このメッシュの固有名
+     * @param format - ファイル形式
+     */
+    exportMeshWasm(name: string, format: "splat" | "ply" | "spz" | "sog"): Promise<Uint8Array>;
     /**
      * 現在の描画内容を画像として取得する。OffscreenCanvas(Worker)で描画している場合も取得できる
      * @param type - 画像の MIME タイプ [default: "image/png"]
@@ -108,6 +115,7 @@ export declare class Core extends EventEmitter {
     getRenderViewCount(): Promise<number> | number;
     setRenderViewSize(renderViewName?: string | Symbol, x?: number, y?: number, width?: number, height?: number, start?: boolean): void;
     getWorldPositionByRenderView(x: number, y: number, isDebug?: boolean): Promise<iPickingInfo | null> | iPickingInfo | null;
+    getSurfaceByRenderView(x: number, y: number, sampleRadius?: number): Promise<iSurfaceInfo | null> | iSurfaceInfo | null;
     setCustomDefines(defines: tCustomDefines): void;
     setCustomUniforms(uniforms: tCustomUniforms): void;
     setGaussianScale(scale: number): void;
@@ -139,6 +147,9 @@ export declare class Core extends EventEmitter {
     startDissolveToGaussian(duration?: number, backgroundFadeInDelay?: number, backgroundFadeInDuration?: number): void;
     startSonarWave(duration?: number): void;
     animatePath(name?: string, duration?: number): void;
+    animateCameraTo(position: iVectorLike, target: iVectorLike, duration?: number): void;
+    showFocusMarker(position: iVectorLike, normal: iVectorLike, option?: iFocusMarkerOption): void;
+    hideFocusMarker(): void;
     startFadeInBackground(duration?: number): void;
     startFadeOutBackground(duration?: number): void;
     applyLocalTransformToSelected(name: string, translation: iVectorLike, rotation: iVectorLike, scale: iVectorLike): void;
@@ -162,8 +173,18 @@ export declare class Core extends EventEmitter {
     setControlsType(controlsType: string): void;
     getControlsType(): Promise<tControlsType> | tControlsType;
     setControlsAttenuation(attenuation: number): void;
-    selectCameraPath(name: string): void;
-    updateCameraPath(time?: number): void;
+    /**
+     * アクティブなカメラパスを選択する
+     * @param name - 選択するカメラパスの名前
+     * @param force - 切り替え時にイージング（補間）を行わず、即座に新しいパスの始点へ移動するかどうか [default: false]
+     */
+    selectCameraPath(name: string, force?: boolean): void;
+    /**
+     * カメラパスが有効な場合、指定された時間を設定し更新する
+     * @param time - 設定する時間（0.0 ～ 1.0）
+     * @param force - イージング（補間）を行わず即座にカメラへ反映するかどうか [default: false]
+     */
+    updateCameraPath(time?: number, force?: boolean): void;
     createCameraPath(position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean, times?: number[] | null): CameraPath | void;
     addCameraPath(name: string, position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean, times?: number[] | null): void;
     removeCameraPath(name: string): void;
@@ -251,6 +272,8 @@ export declare class Core extends EventEmitter {
     setSelectorColor(name: string, color: number): void;
     setGuideLine(name: string, from: iVectorLike, to: iVectorLike, color?: number): void;
     removeGuideLine(name: string): void;
+    setVisibleAreaHelper(name: string, option: iVisibleAreaHelperOption): void;
+    removeVisibleAreaHelper(name: string): void;
     pickSelector(ndcX: number, ndcY: number): Promise<string | null> | string | null;
     setSelectorScale(name: string, scale: iVectorLike): void;
     deleteSelector(name: string): void;

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

@@ -2,7 +2,8 @@ import { RawShaderMaterial, WebGLRenderTarget, WebGLRenderer, PMREMGenerator, Me
 import { iSphereSelectorOption } from '../../editor/selector/sphereSelector';
 import { iBoxSelectorOption } from '../../editor/selector/boxSelector';
 import { iCameraSelectorOption } from '../../editor/selector/cameraSelector';
-import { iSelectorInfo, tControlsType, tMaskSource, tSelectionMode, iVectorLike, iCameraPathOption, iCameraParameter, iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iPickingInfo, tUniformValue, tCustomDefines, tCustomUniforms } from '../types';
+import { iVisibleAreaHelperOption } from '../../editor/visibleAreaHelper';
+import { iSelectorInfo, tControlsType, tMaskSource, tSelectionMode, iVectorLike, iCameraPathOption, iCameraParameter, iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iPickingInfo, iSurfaceInfo, iFocusMarkerOption, tUniformValue, tCustomDefines, tCustomUniforms } from '../types';
 import { iCollisionTarget } from '../../worker/tavioWorker';
 import { WorkerElementAdapter } from './workerElementAdapter';
 import { default as EventEmitter } from 'eventemitter3';
@@ -68,6 +69,8 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
     private torusMaterial?;
     private sphereGeometry?;
     private sphereMaterial?;
+    private cameraAnimationToken;
+    private focusMarker;
     private shaderRegistry;
     /** WebGLRenderer.getSize 用（RenderView は論理ピクセル。canvas バッファ実寸とは別） */
     private readonly _rendererLogicalSize;
@@ -325,6 +328,12 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
         bytes: Uint8Array;
         version: string;
     }>;
+    /**
+     * splat / ply / spz / sog 形式のバイナリデータを生成する
+     * @param name - このメッシュの固有名
+     * @param format - ファイル形式
+     */
+    exportMeshWasm(name: string, format: Parameters<typeof TavioMesh.prototype.exportMeshWasm>[0]): Promise<Uint8Array>;
     /**
      * 現在の描画内容を画像として取得する
      * preserveDrawingBuffer が無効でも取得できるよう、その場で1フレーム描画し、同じタスク内で
@@ -547,6 +556,27 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param isDebug - デバッグモード（有効化するとピッキングバッファを可視化）
      */
     getWorldPositionByRenderView(x: number, y: number, isDebug?: boolean): Promise<iPickingInfo | null>;
+    /**
+     * getWorldPositionByRenderView と同じくスクリーン座標にある 3DGS のワールド座標を取得し、
+     * あわせて周辺のスプラットの位置から推定した面の法線を返す
+     * @param x - 取得する X 座標（スクリーン空間を -1.0 ～ 1.0 に正規化した座標）
+     * @param y - 取得する Y 座標（スクリーン空間を -1.0 ～ 1.0 に正規化した座標, Y-down）
+     * @param sampleRadius - 法線の推定に使う周辺の範囲（ピクセル、デフォルト 8）
+     */
+    getSurfaceByRenderView(x: number, y: number, sampleRadius?: number): Promise<iSurfaceInfo | null>;
+    /**
+     * ピッキング用のレンダーターゲットに、指定したレンダービューから見た 3DGS のワールド座標を描画する
+     * @param renderView - 描画するレンダービュー
+     * @param alphaThreshold - この不透明度に満たない部分はピッキングの対象にしない（0.0 ならスプラットの矩形全体）
+     */
+    private _renderPickingTarget;
+    /**
+     * ピッキング用のレンダーターゲットから読み出した 1 ピクセル分の値を解釈する
+     * @param floatBuffer - 読み出した RGBA の値
+     * @param offset - 解釈するピクセルの先頭のインデックス
+     * @returns 何も描画されていないピクセルなら null
+     */
+    private _resolvePickingPixel;
     /**
      * スクリーン空間上の矩形またはドローイングマスクの範囲にあるスプラットを選択する
      * @param x - 正規化された選択領域の左上 X 座標 (0.0 ~ 1.0)
@@ -795,8 +825,9 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
     /**
      * カメラパスが有効な場合、指定された時間を設定し更新する
      * @param time - 設定する時間（0.0 ～ 1.0）
+     * @param force - イージング（補間）を行わず即座にカメラへ反映するかどうか [default: false]
      */
-    updateCameraPath(time: number): void;
+    updateCameraPath(time: number, force?: boolean): void;
     /**
      * カメラパスを名前と座標データで追加登録する
      * @param name - カメラパスの識別名
@@ -821,8 +852,9 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
     /**
      * アクティブなカメラパスを選択する
      * @param name - 選択するカメラパスの名前
+     * @param force - 切り替え時にイージング（補間）を行わず、即座に新しいパスの始点へ移動するかどうか [default: false]
      */
-    selectCameraPath(name: string): void;
+    selectCameraPath(name: string, force?: boolean): void;
     /**
      * 現在アクティブなカメラパスの名前を取得する
      * @returns アクティブなカメラパスの名前、または null
@@ -1207,6 +1239,27 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param duration - アニメーションの継続時間（ミリ秒）
      */
     animatePath(name?: string, duration?: number): void;
+    /**
+     * カメラの位置と注視点を、指定した値へ補間しながら移動する
+     * 移動中に再度呼ばれた場合は、その時点の状態から新しい移動に切り替える
+     * 移動が完了すると cameraanimationend イベントを発火する（途中で切り替えられた移動では発火しない）
+     * @param position - 移動先のカメラの位置
+     * @param target - 移動先の注視点
+     * @param duration - アニメーションの継続時間（ミリ秒、デフォルト 800）
+     */
+    animateCameraTo(position: iVectorLike, target: iVectorLike, duration?: number): void;
+    /**
+     * 注視点を示すマーカー（平面のドーナツ）を、指定した位置に面の向きに合わせて一定時間表示する
+     * 表示中に再度呼ばれた場合は、前のマーカーを消して新しいマーカーを表示する
+     * @param position - 表示する位置
+     * @param normal - ドーナツの面の法線
+     * @param option - 表示オプション
+     */
+    showFocusMarker(position: iVectorLike, normal: iVectorLike, option?: iFocusMarkerOption): void;
+    /**
+     * showFocusMarker で表示したマーカーを直ちに消す
+     */
+    hideFocusMarker(): void;
     /**
      * 背景の不透明度を0から1.0へアニメーションする
      * @param duration - アニメーションの継続時間（ミリ秒）
@@ -1309,6 +1362,7 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
     setPointUniforms(uniforms: Record<string, tUniformValue>): void;
     private selectorMap;
     private guideLineMap;
+    private visibleAreaHelperMap;
     private reversedCollision;
     /**
      * セレクターによる衝突判定の反転フラグを設定する
@@ -1426,6 +1480,18 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param name - 削除するガイド線の識別名
      */
     removeGuideLine(name: string): void;
+    /**
+     * クロップ領域(表示領域)を、輪郭の線と薄い半透明の面で表示する。同じ名前で呼ぶと形・位置・大きさ・回転・色を更新する。
+     * 表示のみで、セレクターの選択・衝突判定やガウシアンのピッキングには影響しない
+     * @param name - クロップ領域の表示の識別名
+     * @param option - 形・位置・大きさ・回転・色
+     */
+    setVisibleAreaHelper(name: string, option: iVisibleAreaHelperOption): void;
+    /**
+     * 名前を指定してクロップ領域の表示を削除する
+     * @param name - 削除するクロップ領域の表示の識別名
+     */
+    removeVisibleAreaHelper(name: string): void;
     /**
      * 画面上の位置(正規化デバイス座標)からレイを飛ばし、最初に当たる表示中のセレクターの名前を返す。
      * 各セレクターを包む境界球で判定し、遠くにある小さなセレクターでもクリックしやすいよう、

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

@@ -1,9 +1,10 @@
 import { default as EventEmitter } from 'eventemitter3';
-import { iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iVectorLike, iSelectorInfo, iPickingInfo, iCameraPathOption, iCameraParameter, tSelectionMode, tMaskSource, tControlsType, tUniformValue, tCustomDefines, tCustomUniforms } from '../types';
+import { iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iVectorLike, iSelectorInfo, iPickingInfo, iSurfaceInfo, iFocusMarkerOption, iCameraPathOption, iCameraParameter, tSelectionMode, tMaskSource, tControlsType, tUniformValue, tCustomDefines, tCustomUniforms } from '../types';
 import { iCollisionTarget } from '../../worker/tavioWorker';
 import { iSphereSelectorOption } from '../../editor/selector/sphereSelector';
 import { iBoxSelectorOption } from '../../editor/selector/boxSelector';
 import { iCameraSelectorOption } from '../../editor/selector/cameraSelector';
+import { iVisibleAreaHelperOption } from '../../editor/visibleAreaHelper';
 import { MeshStandardMaterialParameters } from 'three';
 import { iLatitudeLongitude } from '../../camera/flightControls';
 import { WorkerElementAdapter } from './workerElementAdapter';
@@ -58,6 +59,7 @@ export interface iCoreDriver extends EventEmitter {
     saveSpzWasm(name: string, fileName?: string): Promise<any>;
     saveTavioWasm(name: string, fileName?: string, options?: any): Promise<any>;
     exportTavioWasm(name: string, options?: any): Promise<any>;
+    exportMeshWasm(name: string, format: "splat" | "ply" | "spz" | "sog"): Promise<Uint8Array>;
     /**
      * 現在の描画内容を画像として取得する(描画内容の画像化・サムネイル生成用)
      * @param type - 画像の MIME タイプ [default: "image/png"]
@@ -79,6 +81,7 @@ export interface iCoreDriver extends EventEmitter {
     getRenderViewCount(): Promise<number> | number;
     setRenderViewSize(renderViewName?: string | Symbol, x?: number, y?: number, width?: number, height?: number, start?: boolean): void;
     getWorldPositionByRenderView(x: number, y: number, isDebug?: boolean): Promise<iPickingInfo | null> | iPickingInfo | null;
+    getSurfaceByRenderView(x: number, y: number, sampleRadius?: number): Promise<iSurfaceInfo | null> | iSurfaceInfo | null;
     setUniforms(uniforms: Record<string, tUniformValue>): void;
     setPointUniforms(uniforms: Record<string, tUniformValue>): void;
     setCustomDefines(defines: tCustomDefines): void;
@@ -112,6 +115,9 @@ export interface iCoreDriver extends EventEmitter {
     startDissolveToGaussian(duration?: number, backgroundFadeInDelay?: number, backgroundFadeInDuration?: number): void;
     startSonarWave(duration?: number): void;
     animatePath(name?: string, duration?: number): void;
+    animateCameraTo(position: iVectorLike, target: iVectorLike, duration?: number): void;
+    showFocusMarker(position: iVectorLike, normal: iVectorLike, option?: iFocusMarkerOption): void;
+    hideFocusMarker(): void;
     startFadeInBackground(duration?: number): void;
     startFadeOutBackground(duration?: number): void;
     setOrbitCursorAutoDisplay(enabled: boolean): void;
@@ -142,8 +148,8 @@ export interface iCoreDriver extends EventEmitter {
     setControlsType(controlsType: string): void;
     getControlsType(): Promise<tControlsType> | tControlsType;
     setControlsAttenuation(attenuation: number): void;
-    selectCameraPath(name: string): void;
-    updateCameraPath(time?: number): void;
+    selectCameraPath(name: string, force?: boolean): void;
+    updateCameraPath(time?: number, force?: boolean): void;
     createCameraPath(position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean, times?: number[] | null): CameraPath | void;
     /** times: 各制御点に対応する時刻（0.0 ～ 1.0）。省略時は等間隔 */
     addCameraPath(name: string, position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean, times?: number[] | null): void;
@@ -231,6 +237,10 @@ export interface iCoreDriver extends EventEmitter {
     setGuideLine(name: string, from: iVectorLike, to: iVectorLike, color?: number): void;
     /** 編集用のガイド線を削除する */
     removeGuideLine(name: string): void;
+    /** クロップ領域(表示領域)を輪郭の線と薄い半透明の面で表示する。同じ名前で呼ぶと更新する */
+    setVisibleAreaHelper(name: string, option: iVisibleAreaHelperOption): void;
+    /** クロップ領域の表示を削除する */
+    removeVisibleAreaHelper(name: string): void;
     /** 画面上の位置(正規化デバイス座標)にある、表示中のセレクターの名前を返す(無ければnull) */
     pickSelector(ndcX: number, ndcY: number): Promise<string | null> | string | null;
     setSelectorScale(name: string, scale: iVectorLike): void;

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

@@ -1,11 +1,12 @@
 import { default as EventEmitter } from 'eventemitter3';
 import { iCoreDriver } from './iCoreDriver';
-import { iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iVectorLike, iSelectorInfo, iPickingInfo, iCameraPathOption, iCameraParameter, tSelectionMode, tMaskSource, tControlsType, tUniformValue, tCustomDefines, tCustomUniforms } from '../types';
+import { iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iVectorLike, iSelectorInfo, iPickingInfo, iSurfaceInfo, iFocusMarkerOption, iCameraPathOption, iCameraParameter, tSelectionMode, tMaskSource, tControlsType, tUniformValue, tCustomDefines, tCustomUniforms } from '../types';
 import { iCollisionTarget } from '../../worker/tavioWorker';
 import { iLatitudeLongitude } from '../../camera/flightControls';
 import { iSphereSelectorOption } from '../../editor/selector/sphereSelector';
 import { iBoxSelectorOption } from '../../editor/selector/boxSelector';
 import { iCameraSelectorOption } from '../../editor/selector/cameraSelector';
+import { iVisibleAreaHelperOption } from '../../editor/visibleAreaHelper';
 import { MeshStandardMaterialParameters } from 'three';
 import { WorkerElementAdapter } from './workerElementAdapter';
 /**
@@ -59,6 +60,9 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     startDissolveToGaussian(duration?: number, backgroundFadeInDelay?: number, backgroundFadeInDuration?: number): void;
     startSonarWave(duration?: number): void;
     animatePath(name?: string, duration?: number): void;
+    animateCameraTo(position: iVectorLike, target: iVectorLike, duration?: number): void;
+    showFocusMarker(position: iVectorLike, normal: iVectorLike, option?: iFocusMarkerOption): void;
+    hideFocusMarker(): void;
     startFadeInBackground(duration?: number): void;
     startFadeOutBackground(duration?: number): void;
     applyLocalTransformToSelected(name: string, translation: iVectorLike, rotation: iVectorLike, scale: iVectorLike): void;
@@ -111,8 +115,8 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     setCameraParameter(position?: number[] | iVectorLike, target?: number[] | iVectorLike, fov?: number): void;
     setControlsType(controlsType: string): void;
     getControlsType(): Promise<tControlsType>;
-    selectCameraPath(name: string): void;
-    updateCameraPath(time?: number): void;
+    selectCameraPath(name: string, force?: boolean): void;
+    updateCameraPath(time?: number, force?: boolean): void;
     setOrbitPointerDown(isDown: boolean): void;
     setOrbitRelativeRotateLeft(value: number): void;
     setOrbitRelativeRotateUp(value: number): void;
@@ -138,11 +142,12 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     setSpotLightDecay(decay: number): void;
     addSpotLight(position: iVectorLike, target: iVectorLike, color: number, intensity: number, distance: number, angle: number, penumbra: number, decay: number, castShadow?: boolean, isDebug?: boolean): void;
     addWhiteCube(position?: iVectorLike, scale?: iVectorLike, receiveShadow?: boolean, materialOption?: MeshStandardMaterialParameters): void;
-    saveSplatWasm(name: string, fileName?: string): Promise<any>;
-    savePlyWasm(name: string, fileName?: string): Promise<any>;
-    saveSpzWasm(name: string, fileName?: string): Promise<any>;
-    saveTavioWasm(name: string, fileName?: string, options?: any): Promise<any>;
+    saveSplatWasm(name: string, fileName?: string): Promise<void>;
+    savePlyWasm(name: string, fileName?: string): Promise<void>;
+    saveSpzWasm(name: string, fileName?: string): Promise<void>;
+    saveTavioWasm(name: string, fileName?: string, options?: any): Promise<void>;
     exportTavioWasm(name: string, options?: any): Promise<any>;
+    exportMeshWasm(name: string, format: "splat" | "ply" | "spz" | "sog"): Promise<Uint8Array>;
     /**
      * Worker 内の OffscreenCanvas で描画した内容を画像として取得する
      * (Blob は構造化複製で Worker からメインスレッドへ返る)
@@ -155,6 +160,7 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     getCurrentRenderViewName(): Promise<string | null>;
     setRenderViewSize(renderViewName?: string | Symbol, x?: number, y?: number, width?: number, height?: number, start?: boolean): void;
     getWorldPositionByRenderView(x: number, y: number, isDebug?: boolean): Promise<iPickingInfo | null>;
+    getSurfaceByRenderView(x: number, y: number, sampleRadius?: number): Promise<iSurfaceInfo | null>;
     setCustomDefines(defines: tCustomDefines): void;
     setCustomUniforms(uniforms: tCustomUniforms): void;
     setGaussianScale(scale: number): void;
@@ -239,6 +245,8 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     setSelectorColor(name: string, color: number): void;
     setGuideLine(name: string, from: iVectorLike, to: iVectorLike, color?: number): void;
     removeGuideLine(name: string): void;
+    setVisibleAreaHelper(name: string, option: iVisibleAreaHelperOption): void;
+    removeVisibleAreaHelper(name: string): void;
     pickSelector(ndcX: number, ndcY: number): Promise<string | null>;
     setSelectorScale(name: string, scale: iVectorLike): void;
     deleteSelector(name: string): void;

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

@@ -254,11 +254,17 @@ export declare class TavioMesh extends EventEmitter {
      */
     saveTavioWasm(filename: string, options?: Parameters<typeof TavioMesh.prototype.exportTavioWasm>[0]): Promise<void>;
     /**
-    * 様々な形式のリソースをセーブする
-    * @param filename - 保存ファイル名
+     * 様々な形式のリソースをセーブする
+     * @param filename - 保存ファイル名
      * @param format - ファイル形式
      */
     saveMeshWasm(filename: string, format: "splat" | "ply" | "spz" | "sog"): Promise<void>;
+    /**
+     * 様々な形式のバイナリデータを生成する
+     * ダウンロードは行わないため、DOM の無い Worker(OffscreenCanvas)でも使用できる
+     * @param format - ファイル形式
+     */
+    exportMeshWasm(format: "splat" | "ply" | "spz" | "sog"): Promise<Uint8Array>;
     /**
      * ==========================================================================
      * getter / setter
@@ -470,6 +476,11 @@ export declare class TavioMesh extends EventEmitter {
      * @param camera - 対象となるカメラ
      */
     syncPinckingMaterial(camera: PerspectiveCamera): void;
+    /**
+     * picking 用マテリアルで、ピッキングの対象にする不透明度の下限を設定する
+     * @param threshold - この不透明度に満たない部分は対象にしない（0.0 ならスプラットの矩形全体が対象）
+     */
+    setPickingAlphaThreshold(threshold: number): void;
     /**
      * shadowing 用マテリアルに uniform 変数を同期する
      */

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

@@ -196,6 +196,26 @@ export interface iPickingInfo {
     index: number;
     target: iVectorLike;
 }
+/**
+ * ピッキングした位置の面の情報
+ */
+export interface iSurfaceInfo extends iPickingInfo {
+    /** 周辺のスプラットから推定した面の法線（正規化済み、カメラ側を向く） */
+    normal: iVectorLike;
+}
+/**
+ * 注視点を示すマーカー（平面のドーナツ）の表示オプション
+ */
+export interface iFocusMarkerOption {
+    /** 表示時間（ミリ秒、デフォルト 1500）。広がりながら後半でフェードアウトする */
+    duration?: number;
+    /** 広がりきったときの外径（ワールド単位、デフォルト 0.05）。中心から広がる */
+    radius?: number;
+    /** 表示開始時の太さ（外径に対する比率 0.0 ～ 1.0、デフォルト 0.3）。表示の終わりに向けて 0 まで細くなる */
+    thickness?: number;
+    /** 色（デフォルト 0xffffff） */
+    color?: number;
+}
 /**
  * ビューポートや focal の情報
  */

package/build/esm/types/wasm-bindings/wasm-handlers.d.ts

@@ -15,7 +15,7 @@ export type WasmWorkerUpdateMessage = {
 export declare function wasmBuildSourceProperty(event: WasmDecodeHeaderEvent, sourceIndex: number, sourceVertexOffset: number): {
     ready: boolean;
     index: number;
-    type: "tavio" | "splat" | "ply" | "spz" | "sog";
+    type: "splat" | "ply" | "spz" | "sog" | "tavio";
     vertexCount: number;
     vertexOffset: number;
     featureBits: number;

package/build/esm/types/wasm-bindings/wasm-worker-client.d.ts

@@ -9,6 +9,14 @@ export declare const setWasmBinaryUrls: (urls: {
     thread?: string;
     noThread?: string;
 }) => void;
+/**
+ * wasmバイナリの配信元ベースURLを外部から指定する。
+ * バンドラーによる `new URL(..., import.meta.url)` の解決に依存せず、
+ * アプリケーション側で `wasm/pkg` の配信先を明示したい場合に使う。
+ * TavioMesh を読み込む前に呼び出すこと。
+ * @param baseUrl - `thread/tavio_bg.wasm` / `no-thread/tavio_bg.wasm` を含むディレクトリ(`wasm/pkg`相当)のURL
+ */
+export declare const setWasmBaseUrl: (baseUrl: string) => void;
 export interface ResolvedGaussianEdits {
     pointCount: number;
     gaussianData: Uint8Array;

package/package.json

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