@openheart/tavio-renderer 2.6.2 → 2.6.3

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/module.d.ts

@@ -2,6 +2,8 @@ import { Core } from './viewer/canvas';
 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, iSurfaceInfo, iFocusMarkerOption, 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

@@ -8,6 +8,7 @@ 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"]
@@ -166,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;
@@ -255,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,6 +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 { 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';
@@ -327,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フレーム描画し、同じタスク内で
@@ -818,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 - カメラパスの識別名
@@ -844,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
@@ -1353,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;
     /**
      * セレクターによる衝突判定の反転フラグを設定する
@@ -1470,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

@@ -4,6 +4,7 @@ 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"]
@@ -146,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;
@@ -235,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

@@ -6,6 +6,7 @@ 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';
 /**
@@ -114,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;
@@ -141,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 からメインスレッドへ返る)
@@ -243,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

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.2",
+  "version": "2.6.3",
   "author": "OpenHeart Inc.",
   "license": "UNLICENSED",
   "description": "Rendering Engine for Tavio Format 3D data",