@openheart/tavio-renderer 2.2.9-without-wasm

package/build/esm/types/animation/animationController.d.ts

@@ -0,0 +1,133 @@
+import { default as EventEmitter } from 'eventemitter3';
+import { iVectorLike } from '../viewer/canvas';
+/**
+ * canvas.ts 内に定義されているメソッドを引数から受け取るためのインターフェース
+ */
+export interface iAnimationUpdateCallback {
+    setEffectDistancePoints: (value: number) => void;
+    setEffectDistanceBase: (value: number) => void;
+    setEffectDistanceNearPoints: (value: number) => void;
+    setEffectDistanceColor: (value: number) => void;
+    setEffectDistanceColorNear: (value: number) => void;
+    setEffectSonar: (value: number) => void;
+    setHSVColor: (hsv: iVectorLike) => void;
+    setBackgroundOpacity: (value: number) => void;
+    start: () => void;
+    updateCameraPath: (time: number) => void;
+}
+/**
+ * アニメーション設定のインターフェース
+ */
+export interface iAnimationConfig {
+    /** アニメーションの最大描画距離（0.0～1.0、デフォルト1.0）progressが1.0に達したときにこの値がゴールとなる */
+    maxRenderDistance?: number;
+    /** メインの範囲の距離（実際の距離値、distance50やdistance70など、nullで距離マッピングを無効化） */
+    mainDistance?: number | null;
+    /** 残りの範囲の距離（実際の距離値、effectDistanceMaxと同じ、通常はdistance100、nullで距離マッピングを無効化） */
+    remainingDistance?: number | null;
+    /** 分割点（0.0～1.0、デフォルト0.8。progressがこの値まででmainDistance、それ以降でremainingDistanceまで） */
+    splitPoint?: number;
+}
+/**
+ * アニメーションコントローラー
+ */
+export declare class AnimationController extends EventEmitter {
+    private activeAnimations;
+    private callbacks;
+    private mainDistance;
+    private remainingDistance;
+    private splitPoint;
+    private maxRenderDistance;
+    /**
+     * インスタンスが発火するイベント
+     */
+    static EVENTS: string[];
+    /**
+     * アニメーションが実行中かどうかを取得する
+     * @returns アニメーションが実行中の場合 true
+     */
+    get isAnimating(): boolean;
+    /**
+     * アニメーションの最大描画距離を取得する
+     * @returns 最大描画距離（0.0～1.0）
+     */
+    getMaxRenderDistance(): number;
+    /**
+     * アニメーションの最大描画距離を設定する
+     * progressが1.0に達したときにこの値がゴールとなる
+     * @param value - 最大描画距離（0.0～1.0）
+     */
+    setMaxRenderDistance(value: number): void;
+    /**
+     * アニメーション設定を一括で取得する
+     * @returns 現在のアニメーション設定
+     */
+    getConfig(): iAnimationConfig;
+    /**
+     * アニメーション設定を一括で設定する
+     * @param config - アニメーション設定オブジェクト（各プロパティはオプショナル、指定されたもののみ更新）
+     */
+    setConfig(config: iAnimationConfig): void;
+    /**
+     * @constructor
+     * @param callbacks - アニメーション更新時に呼び出されるコールバック関数群
+     */
+    constructor(callbacks: iAnimationUpdateCallback);
+    /**
+     * アニメーションのprogress（0.0～1.0）を実際の距離にマッピングする
+     * progress 0.0 → 0.0（正規化）
+     * progress splitPoint → mainDistance/remainingDistance（正規化）
+     * progress 1.0 → maxRenderDistance（正規化）
+     * @param progress - アニメーションの進行度 (0.0 ~ 1.0)
+     * @returns マッピング後の距離値（正規化、0.0 ~ maxRenderDistance）
+     */
+    private _mapProgressToDistance;
+    /**
+     * 距離情報を設定する
+     * @param mainDistance - メインの範囲の距離（実際の距離値、distance50やdistance70など、nullの場合は距離マッピングを無効化）
+     * @param remainingDistance - 残りの範囲の距離（実際の距離値、effectDistanceMaxと同じ、通常はdistance100、nullの場合は距離マッピングを無効化）
+     * @param splitPoint - 分割点（0.0～1.0、デフォルトはSPLIT_POINTを参照。progressがこの値まででmainDistance、それ以降でremainingDistanceまで）
+     * @note mainDistanceまたはremainingDistanceがnullの場合、距離マッピングは無効化され、progressがそのまま使用されます
+     */
+    setDistanceInfo(mainDistance: number | null, remainingDistance: number | null, splitPoint?: number): void;
+    /**
+     * アニメーションを更新する
+     * @param currentTime - 現在時刻（ミリ秒）
+     */
+    update(currentTime: number): void;
+    /**
+     * アクティブなアニメーションの数を取得する
+     * @returns アクティブなアニメーションの数
+     */
+    getActiveAnimationCount(): number;
+    /**
+     * すべてのアニメーションをクリアする
+     */
+    clear(): void;
+    /**
+     * ==========================================================================
+     * animations
+     * ==========================================================================
+     */
+    /**
+     * 点描画の開花効果をアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    bloomPoints(duration: number): void;
+    /**
+     * 点描画からガウシアンへの溶解効果をアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    dissolveToGaussian(duration: number): void;
+    /**
+     * ソナー波効果をアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    sonarWave(duration: number): void;
+    /**
+     * カメラパスをアニメーションする
+     * @param name - カメラパスの名前
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    animatePath(name: string, duration: number): void;
+}

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

@@ -0,0 +1,54 @@
+import { PerspectiveCamera, Vector3 } from 'three';
+import { Selector } from '../editor/selector/selector';
+import { CameraPath } from './cameraPath';
+import { default as EventEmitter } from 'eventemitter3';
+/**
+ * 設定された領域内にカメラが留まるよう振る舞わせる
+ * @class
+ */
+export declare class CameraCollider extends EventEmitter {
+    private camera;
+    private selector;
+    private path;
+    private previousPosition;
+    /**
+     * @constructor
+     * @param camera - 対象となるカメラ
+     * @param selector - 判定に用いるセレクター、またはその配列
+     * @param path - 判定に用いるカメラパス
+     */
+    constructor(camera: PerspectiveCamera, selector?: Selector | Selector[], path?: CameraPath);
+    /**
+     * セレクターを設定する
+     * @param selector - 対象となるセレクター
+     */
+    setSelector(selector: Selector | Selector[]): void;
+    /**
+     * カメラパスを設定する
+     * @param path - 対象となるカメラパス
+     */
+    setPath(path: CameraPath): void;
+    /**
+     * 直前に参照した座標を返す
+     */
+    getLatestPosition(): Vector3;
+    /**
+     * 直前に参照した座標を上書きする
+     * @param position
+     */
+    setLatestPosition(position: Vector3): void;
+    /**
+     * カメラの現在の座標が範囲内に含まれるかどうかを判断基準とした更新処理を行う
+     */
+    updateIfContains(): boolean;
+    /**
+     * カメラの軌道が範囲外に出ていないかどうかを判断基準とした更新処理を行う
+     */
+    updateIfIntersects(): boolean;
+    /**
+     * カメラの現在の座標が範囲内に含まれるかどうかを判断基準とした更新処理を行う
+     * ※カメラパスを用いるものはセレクターを用いるものと別メソッドとしている
+     * @param radius - カメラパスの制御点からの距離（半径）
+     */
+    updateIfContainsByPath(radius: number): boolean;
+}

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

@@ -0,0 +1,120 @@
+import { Camera, Object3D, Quaternion, Vector3 } from 'three';
+/**
+ * カメラパスの座標と注視点用のデータ構造
+ */
+export interface iCameraData {
+    position: Vector3;
+    target: Vector3;
+    screenQuaternion?: Quaternion;
+}
+/**
+ * スプラインを保持し、制御点の追加・削除などを管理する
+ * @class
+ */
+export declare class CameraPath {
+    private positionSpline;
+    private targetSpline;
+    private visualizationObjects;
+    /**
+     * @constructor
+     */
+    constructor();
+    /**
+     * カメラパスから指定された時刻の座標・注視点を返す
+     * @param t - 時刻（0.0 ～ 1.0）
+     */
+    get(t: number): iCameraData;
+    /**
+     * カメラパスに設定されている座標点の配列を返す
+     */
+    getPointsOfPosition(): Vector3[];
+    /**
+     * カメラパスに設定されている注視点の配列を返す
+     */
+    getPointsOfTarget(): Vector3[];
+    /**
+     * カメラパスから指定された時刻の座標を返す
+     * @param t - 時刻（0.0 ～ 1.0）
+     */
+    getPosition(t: number): Vector3;
+    /**
+     * カメラパスから指定された時刻の注視点を返す
+     * @param t - 時刻（0.0 ～ 1.0）
+     */
+    getTarget(t: number): Vector3;
+    /**
+     * 座標用のカメラパスに制御点を追加する
+     * @param v - 追加する制御点の座標
+     */
+    addPosition(v: Vector3): this;
+    /**
+     * 注視点用のカメラパスに制御点を追加する
+     * @param v - 追加する制御点の座標
+     */
+    addTarget(v: Vector3): this;
+    /**
+     * 配列を用いて、座標用のカメラパスに複数の制御点を追加する
+     * @param pointArray - 追加する制御点の配列
+     */
+    addPositionFromArray(pointArray: Vector3[]): this;
+    /**
+     * 配列を用いて、注視点用のカメラパスに複数の制御点を追加する
+     * @param pointArray - 追加する制御点の配列
+     */
+    addTargetFromArray(pointArray: Vector3[]): this;
+    /**
+     * インデックスを指定して座標用の制御点を削除する
+     * @param index - 削除する制御点のインデックス
+     */
+    removePosition(index: number): this;
+    /**
+     * インデックスを指定して注視点用の制御点を削除する
+     * @param index - 削除する制御点のインデックス
+     */
+    removeTarget(index: number): this;
+    /**
+     * カメラから座標と注視点を取得し、制御点を追加する
+     * @param camera - 対象となるカメラ
+     */
+    addFromCamera(camera: Camera): this;
+    /**
+     * 補間に必要な計算を実行する（仕組み上、事前に一部を計算しておくことで高速化する意図）
+     */
+    compute(): this;
+    /**
+     * シーンを指定して、補間後の曲線と制御点を可視化する
+     * @param parent - ラインと点を追加する Object3D
+     */
+    insertObject(parent: Object3D): void;
+    /**
+     * 可視化用に追加したオブジェクトを削除する
+     * @param parent - オブジェクトを削除する親 Object3D
+     */
+    removeObject(parent: Object3D): void;
+    /**
+     * 対象のシーンに、対象のスプラインを、指定された色で追加する
+     * @private
+     * @param parent - 追加の対象となる Object3D
+     * @param spline - 対象のスプライン
+     * @param segments - スプラインを何本の線の結合でジオメトリ生成するか
+     * @param pointColor - 制御点の色
+     * @param lineColor - ラインの色
+     */
+    private insert;
+}
+/**
+ * Vector3 と同様に外部データを扱うための型定義
+ */
+interface iVectorLike {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * カメラパスを生成するヘルパー関数
+ * @param position - カメラの座標（{x, y, z} のオブジェクト、または [x, y, z] の数値の配列）の配列
+ * @param target - 注視点の座標（{x, y, z} のオブジェクト、または [x, y, z] の数値の配列）の配列
+ * @returns 生成された CameraPath
+ */
+export declare function createCameraPath(position: iVectorLike[] | number[][], target: iVectorLike[] | number[][]): CameraPath;
+export {};

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

@@ -0,0 +1,73 @@
+import { Camera, Vector2 } from 'three';
+import { default as EventEmitter } from 'eventemitter3';
+import { CameraPath, iCameraData } from './cameraPath';
+/**
+ * カメラとカメラパスを制御する
+ * @class
+ */
+export declare class CameraPathControls extends EventEmitter {
+    private camera;
+    private path;
+    private interactiveScale;
+    private interactiveTimer;
+    private interactiveOrigin;
+    private interactivePosition;
+    private interactiveTarget;
+    private time;
+    private attenuation;
+    private screenQuaternion;
+    enabled: boolean;
+    interactivity: boolean;
+    /**
+     * @constructor
+     * @param camera - 制御の対象となるカメラ
+     * @param path - 参照するカメラパス
+     */
+    constructor(camera: Camera, path?: CameraPath);
+    /**
+     * 自身にカメラを設定する
+     * @param camera - 制御の対象となるカメラ
+     */
+    setCamera(camera: Camera): void;
+    /**
+     * 自身にカメラパスを設定する
+     * @param path - 参照するカメラパス
+     */
+    setPath(path: CameraPath): void;
+    /**
+     * 現在時刻を設定する
+     * @param time - 設定する時刻
+     */
+    setTime(time: number): iCameraData;
+    /**
+     * 減衰係数を設定する
+     * @param attenuation - 減衰（0.0 ～ 1.0）
+     */
+    setAttenuation(attenuation: number): void;
+    /**
+     * 現在時刻を返す
+     */
+    getTime(): number;
+    /**
+     * 状態を更新する
+     * ※ただしカメラパスコントロール自身はカメラのパラメータを変更せず戻り値を返す
+     */
+    update(forceChanged?: boolean): iCameraData;
+    /**
+     * インタラクティブな動きの、指向対象を設定する
+     * ※指向対象は Vector2 で、-1.0 ～ 1.0 の範囲を指定する（指定された対象位置に、補間しながらカメラが向く）
+     * ※範囲は常に -1.0 ～ 1.0 で指定し、動く幅のスケールは setInteractiveScaleX と setInteractiveScaleY で縦横それぞれに指定できる
+     * @param target - カメラを向ける位置を表すベクトル
+     */
+    setInteractiveTarget(target: Vector2): void;
+    /**
+     * 指定された指向位置に向かって動く横方向のスケールを設定する
+     * @param scale - 横方向のスケール（ラジアンに相当）
+     */
+    setInteractiveScaleX(scale: number): void;
+    /**
+     * 指定された指向位置に向かって動く縦方向のスケールを設定する
+     * @param scale - 縦方向のスケール（ラジアンに相当）
+     */
+    setInteractiveScaleY(scale: number): void;
+}

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

@@ -0,0 +1,67 @@
+import { CameraPath } from './cameraPath';
+/**
+ * 複数のカメラパスを管理する
+ * @class
+ */
+export declare class CameraPathManager {
+    private pathMap;
+    private activePathName;
+    /**
+     * @constructor
+     */
+    constructor();
+    /**
+     * カメラパスを名前で追加する
+     * @param name - カメラパスの名前
+     * @param path - 追加する CameraPath
+     */
+    add(name: string, path: CameraPath): void;
+    /**
+     * カメラパスを名前で削除する
+     * @param name - 削除するカメラパスの名前
+     * @returns 削除されたカメラパスがアクティブだったかどうか
+     */
+    remove(name: string): boolean;
+    /**
+     * アクティブなカメラパスを選択する
+     * @param name - 選択するカメラパスの名前
+     * @returns 選択されたカメラパス
+     */
+    select(name: string): CameraPath;
+    /**
+     * 現在アクティブなカメラパスを取得する
+     * @returns アクティブなカメラパス、または null
+     */
+    getActive(): CameraPath | null;
+    /**
+     * 現在アクティブなカメラパスの名前を取得する
+     * @returns アクティブなカメラパスの名前、または null
+     */
+    getActiveName(): string | null;
+    /**
+     * 指定された名前のカメラパスを取得する
+     * @param name - カメラパスの名前
+     * @returns カメラパス、または null
+     */
+    get(name: string): CameraPath | null;
+    /**
+     * すべてのカメラパス名を取得する
+     * @returns カメラパス名の配列
+     */
+    getAllNames(): string[];
+    /**
+     * すべてのカメラパス名を取得する（getAllNamesのエイリアス）
+     * @returns カメラパス名の配列
+     */
+    getPathNames(): string[];
+    /**
+     * カメラパスが存在するかどうかを確認する
+     * @param name - カメラパスの名前
+     * @returns 存在する場合 true
+     */
+    has(name: string): boolean;
+    /**
+     * すべてのカメラパスをクリアする
+     */
+    clear(): void;
+}

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

@@ -0,0 +1,76 @@
+import { PerspectiveCamera } from 'three';
+import { default as EventEmitter } from 'eventemitter3';
+/**
+ * 緯度経度管理
+ */
+export interface iLatitudeLongitude {
+    latitude: number;
+    longitude: number;
+}
+/**
+ * カメラを中心に首振りや仰角方向の視線制御を可能とするカメラコントロール
+ * @class
+ */
+export declare class FlightControls extends EventEmitter {
+    private camera;
+    private attenuation;
+    private currentLatitude;
+    private targetLatitude;
+    private latitudeQuaternion;
+    private currentLongitude;
+    private targetLongitude;
+    private longitudeQuaternion;
+    enabled: boolean;
+    static EVENTS: string[];
+    /**
+     * @constructor
+     * @param camera - 制御の対象となるカメラ
+     */
+    constructor(camera: PerspectiveCamera);
+    /**
+     * 現在の視線を XZ 平面に投影し正規化したベクトルを返す
+     */
+    private _getHorizontalEyeDirection;
+    /**
+     * 現在の視線から緯度・経度を計算する
+     */
+    private _getLL;
+    /**
+     * 自身にカメラを設定する
+     * @param camera - 制御の対象となるカメラ
+     */
+    setCamera(camera: PerspectiveCamera): void;
+    /**
+     * 設定されているカメラの情報を各プロパティに反映する
+     */
+    syncCameraParameter(): void;
+    /**
+     * 減衰係数を設定する
+     * @param attenuation - 減衰（0.0 ～ 1.0 未満）
+     */
+    setAttenuation(attenuation: number): void;
+    /**
+     * 緯度方向の視線を設定する
+     * @param latitude - 視線の方向を指し示す緯度
+     * @param force - 補間を待たずに即座に反映するかどうか
+     */
+    setLatitude(latitude: number, force?: boolean): void;
+    /**
+     * 経度方向の視線を設定する
+     * @param longitude - 視線の方向を指し示す経度
+     * @param force - 補間を待たずに即座に反映するかどうか
+     */
+    setLongitude(longitude: number, force?: boolean): void;
+    /**
+     * 現在の緯度を返す
+     */
+    getLatitude(): number;
+    /**
+     * 現在の経度を返す
+     */
+    getLongitude(): number;
+    /**
+     * 状態を更新し、変更があったかどうかを真偽値で返す
+     */
+    update(): boolean;
+}