@openheart/tavio-renderer 2.3.30-with-wasm → 2.5.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/boxSelector.d.ts

@@ -1,13 +1,14 @@
-import { PerspectiveCamera, Vector3, Ray, Quaternion, Euler } from 'three';
+import { PerspectiveCamera, Vector3, Ray } from 'three';
 import { Selector, iIntersection } from './selector';
+import { iVectorLike } from '../../viewer/types';
 export interface iBoxSelectorOption {
     width?: number;
     height?: number;
     depth?: number;
     segment?: number;
     color?: number;
-    position?: Vector3 | [number, number, number];
-    rotation?: Euler | Quaternion | [number, number, number];
+    position?: iVectorLike | [number, number, number];
+    rotation?: iVectorLike | [number, number, number];
     visible?: boolean;
 }
 /**

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

@@ -1,6 +1,7 @@
-import { Core, TavioError, TavioErrorCode, SELECTION_MODE, tSelectionMode, tMaskSource, iLoadingOption, iViewerOption, iHeaderInfo, iDistanceInfo, iTransform, iVectorLike } from './viewer/canvas';
-import { iAnimationConfig } from './animation/animationController';
+import { Core } from './viewer/canvas';
+import { TavioError, tSelectionMode, tMaskSource, iLoadingOption, iViewerOption, iHeaderInfo, iDistanceInfo, iTransform, iVectorLike, 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, TavioErrorCode, SELECTION_MODE, CHUNK_TARGET, SHADER_STAGE };
-export type { iAnimationConfig, iMaterialOption, tSelectionMode, tMaskSource, iLoadingOption, iViewerOption, iHeaderInfo, iDistanceInfo, iTransform, iVectorLike };
+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 default Core;