@openheart/tavio-renderer 2.4.0 → 2.6.0

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

@@ -15,10 +15,25 @@ export declare class CameraPath {
     private positionSpline;
     private targetSpline;
     private visualizationObjects;
+    private times;
     /**
      * @constructor
      */
     constructor();
+    /**
+     * 各制御点に対応する時刻を設定する。制御点ごとに到達するタイミングを変えたい場合に使う
+     * （軌道の形は変わらず、各区間を通過する速さだけが変わる）。
+     * 2要素以上・有限値・単調非減少でない場合は無視して等間隔として扱う。
+     * @param times - 各制御点の時刻（0.0 ～ 1.0）。null で等間隔に戻す
+     */
+    setTimes(times: number[] | null): this;
+    /**
+     * 時刻 t（0.0 ～ 1.0）を、スプラインの等間隔パラメータに変換する。
+     * times が設定されていて制御点数と一致する場合のみ、t が属する区間を求めてその区間内の割合に変換する
+     * @param t - 時刻（0.0 ～ 1.0）
+     * @param pointCount - 対象スプラインの制御点数
+     */
+    private toSplineParameter;
     /**
      * カメラパスから指定された時刻の座標・注視点を返す
      * @param t - 時刻（0.0 ～ 1.0）
@@ -84,8 +99,25 @@ export declare class CameraPath {
     /**
      * シーンを指定して、補間後の曲線と制御点を可視化する
      * @param parent - ラインと点を追加する Object3D
-     */
-    insertObject(parent: Object3D): void;
+     * @param options.showPoints - 制御点(Points)も表示するか(デフォルト: true)。
+     *   本レンダラーでは Points の描画サイズが環境によって意図せず巨大な板状に見えることが
+     *   あるため、曲線(Line)だけで十分な用途ではfalseを指定できるようにしている。
+     * @param options.lineWidth - 曲線の太さ(px)。指定すると太さを持つ線(Line2 + LineMaterial)で描画する
+     *   (WebGLの通常の線は環境によって1pxに制限されるため)。省略時は通常の1pxの線
+     * @param options.resolution - 描画領域のサイズ(px)。lineWidth指定時に太さの計算に使う
+     * @param options.lineColor - 曲線の色(座標・注視点の両方)。省略時は座標がマゼンタ、注視点が緑
+     * @param options.showTargetLine - 注視点の曲線も表示するか(デフォルト: true)
+     */
+    insertObject(parent: Object3D, options?: {
+        showPoints?: boolean;
+        lineWidth?: number;
+        resolution?: {
+            x: number;
+            y: number;
+        };
+        lineColor?: number;
+        showTargetLine?: boolean;
+    }): void;
     /**
      * 可視化用に追加したオブジェクトを削除する
      * @param parent - オブジェクトを削除する親 Object3D
@@ -99,6 +131,7 @@ export declare class CameraPath {
      * @param segments - スプラインを何本の線の結合でジオメトリ生成するか
      * @param pointColor - 制御点の色
      * @param lineColor - ラインの色
+     * @param showPoints - 制御点(Points)も追加するか
      */
     private insert;
 }
@@ -114,7 +147,8 @@ interface iVectorLike {
  * カメラパスを生成するヘルパー関数
  * @param position - カメラの座標（{x, y, z} のオブジェクト、または [x, y, z] の数値の配列）の配列
  * @param target - 注視点の座標（{x, y, z} のオブジェクト、または [x, y, z] の数値の配列）の配列
+ * @param times - 各制御点に対応する時刻（0.0 ～ 1.0）。省略時は等間隔
  * @returns 生成された CameraPath
  */
-export declare function createCameraPath(position: iVectorLike[] | number[][], target: iVectorLike[] | number[][]): CameraPath;
+export declare function createCameraPath(position: iVectorLike[] | number[][], target: iVectorLike[] | number[][], times?: number[] | null): CameraPath;
 export {};

package/build/esm/types/editor/selector/cameraSelector.d.ts

@@ -0,0 +1,57 @@
+import { PerspectiveCamera, Ray, Vector3 } from 'three';
+import { Selector, iIntersection } from './selector';
+export interface iCameraSelectorOption {
+    radius?: number;
+    color?: number;
+    lineWidth?: number;
+    aspectRatio?: number;
+}
+/**
+ * カメラの位置(position)を表す、カメラを模した四角錐(フラスタム)アイコンのセレクター。
+ * 底面はカメラのフレーム(画角)を模した長方形(aspectRatioで指定)にし、正方形の底面を持つ
+ * ConeGeometryではなくカスタムジオメトリで、頂点から底面各頂点への4本の稜線と底面の
+ * 輪郭(4辺)だけのシンプルな形状を作る(底面を閉じる面は作らない)。
+ * これをWireframeGeometry2 + LineMaterial(Fat Lines)で太さのある線として描画する。
+ * 底面は+Z方向を向く(Selector.lookAt()でtarget方向を向けたときに底面がtarget側になるため)。
+ * SphereSelectorと同じくTransformControlsをtranslateモードのみで使う想定(位置編集用の
+ * ポイントハンドルとしての利用が主目的)。
+ * containsPoint/intersectRayは、実際の四角錐形状ではなく底面・奥行きを包含できる
+ * 外接球で近似する(このセレクターは領域選択ではなく位置マーカーとしての利用が主目的のため)。
+ * @class
+ */
+export declare class CameraSelector extends Selector {
+    private radius;
+    private boundingRadius;
+    private frustumGeometry;
+    private wireGeometry;
+    private material;
+    /**
+     * @param camera - TransformControls に設定するカメラ
+     * @param eventTarget - TransformControls に設定するイベント処理の対象要素
+     * @param option - セットアップオプション
+     */
+    constructor(camera: PerspectiveCamera, eventTarget: HTMLElement, option?: iCameraSelectorOption);
+    /**
+     * 設定されている半径(外接球の近似半径)を返す
+     */
+    getRadius(): number;
+    /**
+     * セットアップを行う
+     * @param option - セットアップオプション
+     */
+    setup(option?: iCameraSelectorOption): void;
+    /**
+     * 開放処理
+     */
+    dispose(): void;
+    /**
+     * 包含判定処理(外接球で近似)
+     * @param point - 任意の点（座標）
+     */
+    containsPoint(point: Vector3): boolean;
+    /**
+     * Ray オブジェクトの入射点と射出点までの距離を求める処理(外接球で近似)
+     * @param ray - 判定を行う Ray
+     */
+    intersectRay(ray: Ray): iIntersection;
+}

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

@@ -1,5 +1,5 @@
 import { default as EventEmitter } from 'eventemitter3';
-import { Euler, Matrix4, Object3D, PerspectiveCamera, Quaternion, Ray, Vector3 } from 'three';
+import { Euler, Matrix4, Object3D, PerspectiveCamera, Quaternion, Ray, Sphere, Vector3 } from 'three';
 import { TransformControls } from 'three/examples/jsm/controls/TransformControls.js';
 /**
  * Selector は選択範囲を管理・制御するための基底クラスで、継承される前提になっている。
@@ -43,6 +43,23 @@ export declare abstract class Selector extends EventEmitter {
      */
     set visible(visible: boolean);
     get visible(): boolean;
+    /**
+     * 操作用のギズモ(TransformControls)だけの表示・操作可否を切り替える。
+     * 本体(object)の表示はそのまま残すため、「全件表示しつつ、選択中の1件だけドラッグ可能にする」
+     * といった使い方ができる
+     * @param visible - ギズモを表示して操作可能にするか
+     */
+    setGizmoVisible(visible: boolean): void;
+    /**
+     * クリック判定(レイキャスト)用に、本体を包む球(ワールド座標)を返す。非表示の場合はnull。
+     * 形状ごとの厳密な判定ではなく、回転を含めた本体全体を包む境界球で近似する
+     */
+    getPickSphere(): Sphere | null;
+    /**
+     * 本体の色を変更する(material.color を持つマテリアルの場合のみ)
+     * @param color - 設定する色(例: 0xffffff)
+     */
+    setColor(color: number): void;
     /**
      * @constructor
      * @param camera - TransformControls に設定するカメラ
@@ -107,6 +124,13 @@ export declare abstract class Selector extends EventEmitter {
      * @param Euler - 設定する回転（オイラー角）
      */
     setEuler(euler: Euler): void;
+    /**
+     * 指定した位置の方を向くよう回転を設定する(現在位置からの相対方向)。
+     * カメラの位置マーカー(CameraSelector)を、対応する注視点(target)の方向へ
+     * 向けたい場合などに使う。
+     * @param target - 向く先の位置(ワールド座標)
+     */
+    lookAt(target: Vector3): void;
     /**
      * 平行移動モードを設定する
      * @param index - 対象となるインデックス（省略時はすべてのコントロールを対象とする）

package/build/esm/types/editor/selector/sphereSelector.d.ts

@@ -4,6 +4,7 @@ export interface iSphereSelectorOption {
     radius?: number;
     segment?: number;
     color?: number;
+    fill?: boolean;
 }
 /**
  * スプラットを選択するための sphere インターフェースを提供する

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

@@ -7,6 +7,7 @@ import { iVectorLike, iViewerOption, iViewerMaterialOption, iLoadingOption, iHea
 import { iCollisionTarget } from '../worker/tavioWorker';
 import { iSphereSelectorOption } from '../editor/selector/sphereSelector';
 import { iBoxSelectorOption } from '../editor/selector/boxSelector';
+import { iCameraSelectorOption } from '../editor/selector/cameraSelector';
 export declare class Core extends EventEmitter {
     private driver;
     static CHUNK_TARGET: {
@@ -61,6 +62,18 @@ export declare class Core extends EventEmitter {
     loadTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadTavioWasm(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadPlyWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSplatWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSpzWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSogWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
     loadSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
     loadCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
@@ -74,6 +87,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>;
+    /**
+     * 現在の描画内容を画像として取得する。OffscreenCanvas(Worker)で描画している場合も取得できる
+     * @param type - 画像の MIME タイプ [default: "image/png"]
+     * @param quality - 画質(0〜1)。"image/jpeg" や "image/webp" のときのみ有効
+     */
+    captureImage(type?: string, quality?: number): Promise<Blob>;
     addTavioMesh(name: string): void;
     removeTavioMesh(name: string, renderViewName?: string | Symbol): void;
     removeTavioMeshAllRenderView(name: string): void;
@@ -145,9 +164,10 @@ export declare class Core extends EventEmitter {
     setControlsAttenuation(attenuation: number): void;
     selectCameraPath(name: string): void;
     updateCameraPath(time?: number): void;
-    createCameraPath(position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean): CameraPath | void;
-    addCameraPath(name: string, position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: 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;
+    setCameraPathDebugVisible(name: string, visible: boolean): void;
     getPathNames(): Promise<string[]> | string[];
     getActiveCameraPathName(): Promise<string | null> | string | null;
     getCameraPathByTime(name?: string, time?: number): Promise<{
@@ -226,8 +246,15 @@ export declare class Core extends EventEmitter {
     setSelectorModeRotate(name: string): void;
     setSelectorPosition(name: string, position: iVectorLike): void;
     setSelectorRotation(name: string, rotation: iVectorLike): void;
+    setSelectorLookAt(name: string, target: iVectorLike): void;
+    setSelectorGizmoVisible(name: string, visible: boolean): void;
+    setSelectorColor(name: string, color: number): void;
+    setGuideLine(name: string, from: iVectorLike, to: iVectorLike, color?: number): void;
+    removeGuideLine(name: string): void;
+    pickSelector(ndcX: number, ndcY: number): Promise<string | null> | string | null;
     setSelectorScale(name: string, scale: iVectorLike): void;
     deleteSelector(name: string): void;
     addSphereSelector(name: string, option?: iSphereSelectorOption): void;
     addBoxSelector(name: string, option?: iBoxSelectorOption): void;
+    addCameraSelector(name: string, option?: iCameraSelectorOption): void;
 }

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

@@ -1,6 +1,7 @@
 import { RawShaderMaterial, WebGLRenderTarget, WebGLRenderer, PMREMGenerator, MeshStandardMaterialParameters } from 'three';
 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 { iCollisionTarget } from '../../worker/tavioWorker';
 import { WorkerElementAdapter } from './workerElementAdapter';
@@ -84,6 +85,7 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
     private _frameIntervalMs;
     /** 直前にフレームを描画した時刻（Date.now()） */
     private _lastFrameTimestamp;
+    private _rafId;
     /**
      * 対応する Controls 種別
      */
@@ -313,6 +315,15 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
         bytes: Uint8Array;
         version: string;
     }>;
+    /**
+     * 現在の描画内容を画像として取得する
+     * preserveDrawingBuffer が無効でも取得できるよう、その場で1フレーム描画し、同じタスク内で
+     * canvas のスナップショットを取る(toBlob / convertToBlob は呼び出し時点の内容を複製する)
+     * OffscreenCanvas(Worker)では OffscreenDriver から RPC で呼び出され、Worker 内で convertToBlob する
+     * @param type - 画像の MIME タイプ [default: "image/png"]
+     * @param quality - 画質(0〜1)。"image/jpeg" や "image/webp" のときのみ有効
+     */
+    captureImage(type?: string, quality?: number): Promise<Blob>;
     /**
      * tavio 形式のリソースを保存する
      * @param name - このメッシュの固有名
@@ -434,6 +445,13 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param start - リサイズと同時に描画を開始するかどうか
      */
     resize(width?: number, height?: number, start?: boolean): void;
+    /**
+     * 予約中の描画を取り消し、その場で1フレーム描画する(以降は通常の描画ループに戻る)。
+     * canvas のサイズを変えると描画内容がクリアされるが、ResizeObserver の通知はブラウザの
+     * その回の描画処理(requestAnimationFrame)の後に来るため、次のフレームを待つと
+     * クリアされた空の状態が一瞬表示され、リサイズ中にちらついて見える。これを防ぐために使う
+     */
+    private _renderImmediately;
     /**
      * 描画を開始する
      * ※ pause() によって一時停止中の場合は何もしない（再開するには resume() を呼ぶ）
@@ -748,8 +766,9 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param position - カメラの座標（{x, y, z} のオブジェクト、または [x, y, z] の数値の配列）の配列
      * @param target - 注視点の座標（{x, y, z} のオブジェクト、または [x, y, z] の数値の配列）の配列
      * @param debug - デバッグモードをオンにすると、各点とその補間後の軌跡がシーンに追加される
+     * @param times - 各制御点に対応する時刻（0.0 ～ 1.0）。省略時は等間隔
      */
-    createCameraPath(position: iVectorLike[] | number[][], target: iVectorLike[] | number[][], debug?: boolean): CameraPath;
+    createCameraPath(position: iVectorLike[] | number[][], target: iVectorLike[] | number[][], debug?: boolean, times?: number[] | null): CameraPath;
     /**
      * カメラパスが有効な場合、指定された時間を設定し更新する
      * @param time - 設定する時間（0.0 ～ 1.0）
@@ -761,13 +780,21 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param position - カメラ移動経路の座標配列
      * @param target - カメラ注視点経路の座標配列
      * @param debug - デバッグ用軌跡描画を行うかどうか
+     * @param times - 各制御点に対応する時刻（0.0 ～ 1.0）。省略時は等間隔
      */
-    addCameraPath(name: string, position: iVectorLike[] | number[][], target: iVectorLike[] | number[][], debug?: boolean): void;
+    addCameraPath(name: string, position: iVectorLike[] | number[][], target: iVectorLike[] | number[][], debug?: boolean, times?: number[] | null): void;
     /**
      * カメラパスを名前で削除する
      * @param name - 削除するカメラパスの名前
      */
     removeCameraPath(name: string): void;
+    /**
+     * 名前を指定してカメラパスのデバッグ可視化(補間曲線と制御点)の表示/非表示を切り替える。
+     * removeObject→(必要なら)insertObjectの順で呼ぶため、繰り返し呼んでも多重に追加されない。
+     * @param name - 対象のカメラパスの名前
+     * @param visible - 表示するかどうか
+     */
+    setCameraPathDebugVisible(name: string, visible: boolean): void;
     /**
      * アクティブなカメラパスを選択する
      * @param name - 選択するカメラパスの名前
@@ -1258,6 +1285,7 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      */
     setPointUniforms(uniforms: Record<string, tUniformValue>): void;
     private selectorMap;
+    private guideLineMap;
     private reversedCollision;
     /**
      * セレクターによる衝突判定の反転フラグを設定する
@@ -1349,6 +1377,45 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param visible - 可視性
      */
     setSelectorVisible(name: string, visible: boolean): void;
+    /**
+     * 名前を指定して、セレクターの操作用ギズモだけの表示・操作可否を設定する(本体の表示はそのまま)
+     * @param name - 対象セレクター名
+     * @param visible - ギズモを表示して操作可能にするか
+     */
+    setSelectorGizmoVisible(name: string, visible: boolean): void;
+    /**
+     * 名前を指定してセレクター本体の色を設定する
+     * @param name - 対象セレクター名
+     * @param color - 設定する色(例: 0xffffff)
+     */
+    setSelectorColor(name: string, color: number): void;
+    /**
+     * 名前を指定して、2点を結ぶガイド線を追加・更新する(編集時の補助表示用。
+     * 常に手前に描画し、スプラットに隠れないようにする)
+     * @param name - ガイド線の識別名
+     * @param from - 始点
+     * @param to - 終点
+     * @param color - 線の色(省略時は白)
+     */
+    setGuideLine(name: string, from: iVectorLike, to: iVectorLike, color?: number): void;
+    /**
+     * 名前を指定してガイド線を削除する
+     * @param name - 削除するガイド線の識別名
+     */
+    removeGuideLine(name: string): void;
+    /**
+     * 画面上の位置(正規化デバイス座標)からレイを飛ばし、最初に当たる表示中のセレクターの名前を返す。
+     * 各セレクターを包む境界球で判定し、遠くにある小さなセレクターでもクリックしやすいよう、
+     * 画面上でPICK_TOLERANCE_PXぶんの大きさは最低限確保する
+     * @param ndcX - 正規化デバイス座標のX(-1 ～ 1、左端が-1)
+     * @param ndcY - 正規化デバイス座標のY(-1 ～ 1、下端が-1)
+     */
+    pickSelector(ndcX: number, ndcY: number): string | null;
+    /**
+     * 編集用の線(カメラパスの曲線・ガイド線)を、太さを持つ線で描画するための設定を返す
+     * (LineMaterialは描画領域のサイズを基準に太さを計算するため、現在のサイズを渡す)
+     */
+    private getEditLineDrawOptions;
     /**
      * 名前を指定してセレクターを平行移動モードにする
      * @param name - 設定するセレクターの名前
@@ -1376,6 +1443,12 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param rotation - 設定する回転（Euler）
      */
     setSelectorRotation(name: string, rotation: iVectorLike): void;
+    /**
+     * 名前を指定してセレクターを、targetの方向へ向ける(現在位置からの相対方向)
+     * @param name - 設定するセレクターの名前
+     * @param target - 向く先の位置
+     */
+    setSelectorLookAt(name: string, target: iVectorLike): void;
     /**
      * 名前を指定してセレクターのスケールを設定する
      * @param name - 設定するセレクターの名前
@@ -1399,4 +1472,12 @@ export declare class CoreDriver extends EventEmitter implements iCoreDriver {
      * @param option - セレクターに対するオプション
      */
     addBoxSelector(name: string, option?: iBoxSelectorOption): void;
+    /**
+     * 名前を指定して、カメラを模した四角錐アイコンのセレクターを追加する
+     * （既定の状態では visible が false である点に注意）。カメラのposition編集用の
+     * ポイントハンドルとしての利用を主目的とする。
+     * @param name - 追加するセレクターに付与する名前
+     * @param option - セレクターに対するオプション
+     */
+    addCameraSelector(name: string, option?: iCameraSelectorOption): void;
 }

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

@@ -3,6 +3,7 @@ import { iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTra
 import { iCollisionTarget } from '../../worker/tavioWorker';
 import { iSphereSelectorOption } from '../../editor/selector/sphereSelector';
 import { iBoxSelectorOption } from '../../editor/selector/boxSelector';
+import { iCameraSelectorOption } from '../../editor/selector/cameraSelector';
 import { MeshStandardMaterialParameters } from 'three';
 import { iLatitudeLongitude } from '../../camera/flightControls';
 import { WorkerElementAdapter } from './workerElementAdapter';
@@ -33,6 +34,18 @@ export interface iCoreDriver extends EventEmitter {
     loadTavioWasm(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadPlyWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSplatWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSpzWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSogWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
     loadImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
     loadCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
     concatTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
@@ -45,6 +58,12 @@ 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>;
+    /**
+     * 現在の描画内容を画像として取得する(描画内容の画像化・サムネイル生成用)
+     * @param type - 画像の MIME タイプ [default: "image/png"]
+     * @param quality - 画質(0〜1)。"image/jpeg" や "image/webp" のときのみ有効
+     */
+    captureImage(type?: string, quality?: number): Promise<Blob>;
     addTavioMesh(name: string): void;
     removeTavioMesh(name: string, renderViewName?: string | Symbol): void;
     removeTavioMeshAllRenderView(name: string): void;
@@ -125,9 +144,12 @@ export interface iCoreDriver extends EventEmitter {
     setControlsAttenuation(attenuation: number): void;
     selectCameraPath(name: string): void;
     updateCameraPath(time?: number): void;
-    createCameraPath(position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean): CameraPath | void;
-    addCameraPath(name: string, position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: 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;
     removeCameraPath(name: string): void;
+    /** 名前を指定してカメラパスのデバッグ可視化(補間曲線と制御点)の表示/非表示を切り替える */
+    setCameraPathDebugVisible(name: string, visible: boolean): void;
     getPathNames(): Promise<string[]> | string[];
     getActiveCameraPathName(): Promise<string | null> | string | null;
     getCameraPathByTime(name?: string, time?: number): Promise<{
@@ -199,8 +221,22 @@ export interface iCoreDriver extends EventEmitter {
     setSelectorModeRotate(name: string): void;
     setSelectorPosition(name: string, position: iVectorLike): void;
     setSelectorRotation(name: string, rotation: iVectorLike): void;
+    /** 指定したセレクターを、targetの方向へ向ける(現在位置からの相対方向) */
+    setSelectorLookAt(name: string, target: iVectorLike): void;
+    /** 指定したセレクターの操作用ギズモだけの表示・操作可否を設定する(本体の表示はそのまま) */
+    setSelectorGizmoVisible(name: string, visible: boolean): void;
+    /** 指定したセレクター本体の色を設定する */
+    setSelectorColor(name: string, color: number): void;
+    /** 2点を結ぶ編集用のガイド線を追加・更新する */
+    setGuideLine(name: string, from: iVectorLike, to: iVectorLike, color?: number): void;
+    /** 編集用のガイド線を削除する */
+    removeGuideLine(name: string): void;
+    /** 画面上の位置(正規化デバイス座標)にある、表示中のセレクターの名前を返す(無ければnull) */
+    pickSelector(ndcX: number, ndcY: number): Promise<string | null> | string | null;
     setSelectorScale(name: string, scale: iVectorLike): void;
     deleteSelector(name: string): void;
     addSphereSelector(name: string, option?: iSphereSelectorOption): void;
     addBoxSelector(name: string, option?: iBoxSelectorOption): void;
+    /** カメラを模した四角錐アイコンのセレクターを追加する(カメラのposition編集用ポイントハンドル) */
+    addCameraSelector(name: string, option?: iCameraSelectorOption): void;
 }

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

@@ -5,6 +5,7 @@ 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 { MeshStandardMaterialParameters } from 'three';
 import { WorkerElementAdapter } from './workerElementAdapter';
 /**
@@ -77,6 +78,18 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     loadTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadTavioWasm(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadPlyWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSplatWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSpzWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
+    loadSogWasm(name: string, url: string, options?: {
+        useSphericalHarmonics?: boolean;
+    }): Promise<void>;
     loadSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
     loadImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
     loadCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
@@ -130,6 +143,11 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     saveSpzWasm(name: string, fileName?: string): Promise<any>;
     saveTavioWasm(name: string, fileName?: string, options?: any): Promise<any>;
     exportTavioWasm(name: string, options?: any): Promise<any>;
+    /**
+     * Worker 内の OffscreenCanvas で描画した内容を画像として取得する
+     * (Blob は構造化複製で Worker からメインスレッドへ返る)
+     */
+    captureImage(type?: string, quality?: number): Promise<Blob>;
     addTavioMesh(name: string): void;
     getFirstMeshName(): Promise<string | null>;
     createRenderView(name: string | Symbol): void;
@@ -151,9 +169,10 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     setCameraColliderSelector(selectorNames?: string[]): void;
     setInteractiveMode(interactive: boolean): void;
     getInteractiveMode(): Promise<boolean>;
-    createCameraPath(position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean): void;
-    addCameraPath(name: string, position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean): void;
+    createCameraPath(position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean, times?: number[] | null): void;
+    addCameraPath(name: string, position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean, times?: number[] | null): void;
     removeCameraPath(name: string): void;
+    setCameraPathDebugVisible(name: string, visible: boolean): void;
     getPathNames(): Promise<string[]>;
     getActiveCameraPathName(): Promise<string | null>;
     getCameraPathByTime(name?: string, time?: number): Promise<{
@@ -215,8 +234,15 @@ export declare class OffscreenDriver extends EventEmitter implements iCoreDriver
     setSelectorModeRotate(name: string): void;
     setSelectorPosition(name: string, position: iVectorLike): void;
     setSelectorRotation(name: string, rotation: iVectorLike): void;
+    setSelectorLookAt(name: string, target: iVectorLike): void;
+    setSelectorGizmoVisible(name: string, visible: boolean): void;
+    setSelectorColor(name: string, color: number): void;
+    setGuideLine(name: string, from: iVectorLike, to: iVectorLike, color?: number): void;
+    removeGuideLine(name: string): void;
+    pickSelector(ndcX: number, ndcY: number): Promise<string | null>;
     setSelectorScale(name: string, scale: iVectorLike): void;
     deleteSelector(name: string): void;
     addSphereSelector(name: string, option?: iSphereSelectorOption): void;
     addBoxSelector(name: string, option?: iBoxSelectorOption): void;
+    addCameraSelector(name: string, option?: iCameraSelectorOption): void;
 }

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

@@ -1,4 +1,14 @@
 import { WasmFnMap, WasmWorkerInitOptions } from './wasm-worker';
+/** wasmバイナリのURL(レンダリングWorkerへ渡すため、メインスレッドで求めた値を取り出す) */
+export declare const getWasmBinaryUrls: () => {
+    thread?: string;
+    noThread?: string;
+};
+/** wasmバイナリのURLを差し替える(レンダリングWorkerで、メインスレッドから受け取った値を使う) */
+export declare const setWasmBinaryUrls: (urls: {
+    thread?: string;
+    noThread?: string;
+}) => void;
 export interface ResolvedGaussianEdits {
     pointCount: number;
     gaussianData: Uint8Array;

package/build/esm/wasm/pkg/no-thread/tavio.d.ts

@@ -92,8 +92,8 @@ export interface InitOutput {
     readonly registerEventHandler: (a: number) => number;
     readonly resolveGaussianEdits: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
     readonly sort: (a: number, b: number, c: number) => number;
-    readonly __wasm_bindgen_func_elem_2970: (a: number, b: number, c: number, d: number) => void;
     readonly __wasm_bindgen_func_elem_2972: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_2974: (a: number, b: number, c: number, d: number) => void;
     readonly __wasm_bindgen_func_elem_1183: (a: number, b: number, c: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;