@openheart/tavio-renderer 2.6.0 → 2.6.2

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/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,7 @@
 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, };
+export type { iMaterialOption, 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,7 +3,7 @@ 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';
@@ -108,6 +108,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 +140,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;

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

@@ -2,7 +2,7 @@ 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 { 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 +68,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;
@@ -86,6 +88,16 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
     /** 直前にフレームを描画した時刻（Date.now()） */
     private _lastFrameTimestamp;
     private _rafId;
+    /**
+     * 直前に発行したフレームのGPU処理完了を検知するためのフェンス。
+     * requestAnimationFrame は GPU の完了を待たずに発火するため、1フレームのGPU処理時間が
+     * 表示間隔を超えると未処理のGPUコマンドが際限なく溜まり、同じGPUを使う他の描画
+     * (ブラウザのコンポジタや他タブのビデオ再生など)が停滞する。前フレームの完了を
+     * 確認できるまで次のフレームを発行しないことで、GPUの処理能力に描画頻度を合わせる
+     */
+    private _gpuFence;
+    /** 次回の _render でGPUフェンスの完了待ちを省略するか(リサイズ直後の即時描画用) */
+    private _bypassGpuFenceOnce;
     /**
      * 対応する Controls 種別
      */
@@ -476,6 +488,19 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @private
      */
     private _render;
+    /**
+     * 前フレームで発行したGPUフェンスがまだ完了していないかどうかを返す。
+     * 完了していればフェンスを破棄する。WebGL2 でない環境やフェンスが無い場合は false
+     */
+    private _isGpuBusy;
+    /**
+     * このフレームのGPUコマンドの末尾にフェンスを発行し、完了検知に使えるよう flush する
+     */
+    private _insertGpuFence;
+    /**
+     * レンダラーの WebGL2 コンテキストを返す。WebGL2 でない場合やコンテキスト喪失時は null
+     */
+    private _getWebGL2Context;
     /**
      * 登録されている最初のメッシュの名前を取得する
      */
@@ -524,6 +549,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)
@@ -1184,6 +1230,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 - アニメーションの継続時間（ミリ秒）

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

@@ -1,5 +1,5 @@
 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';
@@ -79,6 +79,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 +113,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;

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

@@ -1,6 +1,6 @@
 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';
@@ -59,6 +59,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;
@@ -155,6 +158,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;

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

@@ -470,6 +470,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/package.json

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