@openheart/tavio-renderer 2.2.9-without-wasm

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

@@ -0,0 +1,1108 @@
+import { Euler, Group, Matrix4, PerspectiveCamera, Quaternion, RawShaderMaterial, Scene, Vector3, WebGLRenderTarget, WebGLRenderer, PMREMGenerator } from 'three';
+import { default as EventEmitter } from 'eventemitter3';
+import { iCollisionTarget } from '../worker/tavioWorker';
+import { CameraPath } from '../camera/cameraPath';
+import { CameraPathControls } from '../camera/cameraPathControls';
+import { CameraPathManager } from '../camera/cameraPathManager';
+import { FlightControls, iLatitudeLongitude } from '../camera/flightControls';
+import { TransferControls } from '../camera/transferControls';
+import { OrbitControls } from '../camera/orbitControls';
+import { CameraCollider } from '../camera/cameraCollider';
+import { ConsoleOutput } from '../utility/console';
+import { iSphereSelectorOption } from '../editor/selector/sphereSelector';
+import { iBoxSelectorOption } from '../editor/selector/boxSelector';
+import { Selector } from '../editor/selector/selector';
+import { TavioMesh } from './tavioMesh';
+import { iAnimationConfig } from '../animation/animationController';
+/**
+ * Tavio Viewer のエラーコード
+ */
+export declare const TavioErrorCode: {
+    /** Float16Array 未対応環境 */
+    readonly FLOAT16_NOT_SUPPORTED: "E001";
+};
+/**
+ * Tavio Viewer のカスタムエラークラス
+ */
+export declare class TavioError extends Error {
+    /** エラーコード */
+    code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * カメラコントロールの種類
+ */
+type tControlsType = "orbit" | "path" | "flight";
+/**
+ * カメラコントロールの型チェック用定義
+ */
+type tControlInstance = OrbitControls | CameraPathControls | FlightControls;
+/**
+ * Vector3 と同様に外部データを扱うための型定義
+ */
+export interface iVectorLike {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * カメラパスコントロールのオプション
+ */
+interface iCameraPathOption {
+    attenuation?: number;
+    scaleX?: number;
+    scaleY?: number;
+}
+/**
+ * 汎用カメラパラメータ
+ */
+interface iCameraParameter {
+    position?: number[];
+    eye?: number[];
+    fov?: number;
+}
+/**
+ * ビューアオプション
+ */
+export interface iViewerOption {
+    usingSharedArrayBuffer?: boolean;
+    controlsType?: tControlsType;
+    gaussianScale?: number;
+    minimumScale?: number;
+    distanceEffectPoint?: number;
+    distanceEffectPointNear?: number;
+    distanceEffectBase?: number;
+    distanceEffectRange?: number;
+    distanceColorEffect?: number;
+    distanceColorEffectNear?: number;
+    effectSonar?: number;
+    effectSonarRange?: number;
+    worldOrigin?: iVectorLike;
+    opacityPoints?: number;
+    opacityAdditive?: number;
+    opacityMultiplier?: number;
+    colorTemperature?: number;
+    colorTint?: number;
+    colorContrast?: number;
+    colorHSV?: iVectorLike;
+    colorRGB?: iVectorLike;
+    colorBlur?: number;
+    colorSharpness?: number;
+    backgroundOpacity?: number;
+    disableBackground?: boolean;
+    consoleOutput?: boolean;
+    enableOrbitCursor?: boolean;
+    orbitCursorScale?: number;
+}
+/**
+ * セレクターの情報
+ */
+interface iSelectorInfo {
+    name: string;
+    visible: boolean;
+    position?: iVectorLike;
+    rotation?: iVectorLike;
+    scale?: iVectorLike;
+}
+/**
+ * ファイルのロードオプション
+ */
+export interface iLoadingOption {
+    useSphericalHarmonics?: boolean;
+}
+/**
+ * ファイル内に含まれる 3DGS の原点からの距離と割合
+ */
+export interface iDistanceInfo {
+    per50?: number;
+    per70?: number;
+    per90?: number;
+    per100: number;
+}
+/**
+ * ファイル内のヘッダ及び頂点情報
+ */
+export interface iHeaderInfo {
+    majorVersionNumber: number;
+    minorVersionNumber: number;
+    featureBits: any;
+    distance: iDistanceInfo;
+}
+/**
+ * ファイルに対する座標変換情報
+ */
+export interface iTransform {
+    translation: Vector3;
+    rotation: Euler;
+    scale: number;
+}
+/**
+ * ビューア実装本体
+ */
+export declare class Core extends EventEmitter {
+    canvas: HTMLCanvasElement;
+    gl: WebGL2RenderingContext;
+    uniforms: any;
+    viewerOption: iViewerOption;
+    meshMap: Map<string, TavioMesh>;
+    controlsMap: Map<string, tControlInstance>;
+    enableControlsMap: Map<string, boolean>;
+    currentControlsType: tControlsType;
+    transferControls: TransferControls;
+    selectorMap: Map<string, Selector>;
+    cameraColliderEnabled: boolean;
+    cameraCollider: CameraCollider;
+    cameraPathCollisionRadius: number;
+    cameraPathManager: CameraPathManager;
+    reversedCollision: boolean;
+    previousPosition: Vector3;
+    previousRotation: Quaternion;
+    previousFov: number;
+    maxDistance: number;
+    isInteractive: boolean;
+    isRendering: boolean;
+    startRendering: number;
+    isDown: boolean;
+    isWheel: boolean;
+    isLoading: boolean;
+    onPointerDown: (evt: PointerEvent) => void;
+    onPointerUp: (evt: PointerEvent) => void;
+    onWheel: (evt: WheelEvent) => void;
+    renderer: WebGLRenderer;
+    scene: Scene;
+    pmremGenerator: PMREMGenerator;
+    gaussianGroup: Group;
+    meshGroup: Group;
+    interfaceGroup: Group;
+    perspectiveCamera: PerspectiveCamera;
+    gaussianMaterial: RawShaderMaterial;
+    gaussianPickingMaterial: RawShaderMaterial;
+    pickingRenderTarget: WebGLRenderTarget;
+    pickingScene: Scene;
+    parameters: any;
+    console: ConsoleOutput;
+    consoleOutput: boolean;
+    private orbitCursor;
+    private orbitCursorMaterial;
+    private orbitCursorGeometry;
+    private orbitCursorEnabled;
+    private orbitCursorHorizontal;
+    private orbitCursorCenter;
+    private previousOrbitTarget;
+    private animationController;
+    private pathAnimationLocked;
+    /**
+     * インスタンスが発火するイベント
+     * ※実際には TavioMesh が発火するイベントをリレーする
+     */
+    static EVENTS: string[];
+    /**
+     * 対応する Controls 種別
+     */
+    static CONTROLS: string[];
+    /**
+     * @constructor
+     * @param viewerOption - ビューア実装の初期化オプション
+     * @throws Float16Array 未対応環境ではエラーをスローする
+     */
+    constructor(viewerOption?: iViewerOption);
+    /**
+     * ==========================================================================
+     * setup
+     * ==========================================================================
+     */
+    /**
+     * コンストラクタ内のセットアップ
+     * ※一度 dispose した場合、コンストラクタを再度実行することはできないのでこのメソッドで復帰させる
+     * @param viewerOption - ビューア実装の初期化オプション
+     */
+    setupOnConstructor(viewerOption?: iViewerOption): void;
+    /**
+     * 各種初期化処理を行う
+     * @param canvas - WebGL コンテキストを取得する対象となる canvas 要素
+     */
+    init(canvas: HTMLCanvasElement): void;
+    /**
+     * カメラコントロール・カメラコライダーをセットアップする
+     */
+    setupControls(): void;
+    /**
+     * OrbitControls をセットアップする
+     */
+    setupOrbitControls(): void;
+    /**
+     * CameraPathControls をセットアップする
+     */
+    setupCameraPathControls(): void;
+    /**
+     * FlightControls をセットアップする
+     */
+    setupFlightControls(): void;
+    /**
+     * TransferControls をセットアップする
+     */
+    setupTransferControls(): void;
+    /**
+     * CameraCollider をセットアップする
+     */
+    setupCameraCollider(): void;
+    /**
+     * セレクターをセットアップする
+     */
+    setupSelector(): void;
+    /**
+     * イベントのセットアップ
+     */
+    setupEvent(): void;
+    /**
+     * デバッグ用インターフェースのセットアップ
+     */
+    setupPane(): void;
+    /**
+     * ==========================================================================
+     * TavioMesh / loader
+     * ==========================================================================
+     */
+    /**
+     * TavioMesh を生成しロード前の共通処理を行う
+     * @private
+     * @param name - このメッシュの固有名
+     */
+    private _beforeLoadMesh;
+    /**
+     * TavioMesh のロード後の共通処理を行う
+     * @private
+     * @param name - 設定する名前
+     */
+    private _afterLoadMesh;
+    /**
+     * TavioMesh のインスタンスを生成し tavio 形式のリソースをロード、シーンに追加する
+     * @param name - このメッシュの固有名
+     * @param url - 読み込む .tavio ファイル
+     * @param option - ロード・パース関連のオプション
+     */
+    loadTavio(name: string, url: string, option?: iLoadingOption): Promise<void>;
+    /**
+     * 既存の TavioMesh のインスタンスにデータを統合する
+     * @param name - このメッシュの固有名
+     * @param url - 読み込む .tavio ファイル
+     * @param option - ロード・パース関連のオプション
+     */
+    concatTavio(name: string, url: string, option?: iLoadingOption): Promise<void>;
+    /**
+     * TavioMesh のインスタンスを生成し ply 形式のリソースをロード、シーンに追加する
+     * @param name - このメッシュの固有名
+     * @param url - 読み込む .ply ファイル
+     * @param option - ロード・パース関連のオプション
+     */
+    loadPly(name: string, url: string, option?: iLoadingOption): Promise<void>;
+    /**
+     * 既存の TavioMesh のインスタンスにデータを統合する
+     * @param name - このメッシュの固有名
+     * @param url - 読み込む .tavio ファイル
+     * @param option - ロード・パース関連のオプション
+     */
+    concatPly(name: string, url: string, option?: iLoadingOption): Promise<void>;
+    /**
+     * TavioMesh のインスタンスを生成し splat 形式のリソースをロード、シーンに追加する
+     * @param name - このメッシュの固有名
+     * @param url - 読み込む .splat ファイル
+     */
+    loadSplat(name: string, url: string): Promise<void>;
+    /**
+     * 既存の TavioMesh のインスタンスにデータを統合する
+     * @param name - このメッシュの固有名
+     * @param url - 読み込む .tavio ファイル
+     * @param option - ロード・パース関連のオプション
+     */
+    concatSplat(name: string, url: string): Promise<void>;
+    /**
+     * tavio 形式のリソースをロードする
+     * @param name - このメッシュの固有名
+     * @see {@link TavioMesh.prototype.loadTavioWasm}
+     */
+    loadTavioWasm(name: string, ...args: Parameters<typeof TavioMesh.prototype.loadTavioWasm>): Promise<void>;
+    /**
+     * ply 形式のリソースをロードする
+     * @param name - このメッシュの固有名
+     * @see {@link TavioMesh.prototype.loadPlyWasm}
+     */
+    loadPlyWasm(name: string, ...args: Parameters<typeof TavioMesh.prototype.loadPlyWasm>): Promise<void>;
+    /**
+     * tavio 形式のリソースをセーブする
+     * @param name - このメッシュの固有名
+     * @see {@link TavioMesh.prototype.saveTavioWasm}
+     */
+    saveTavioWasm(name: string, ...args: Parameters<typeof TavioMesh.prototype.saveTavioWasm>): Promise<void>;
+    /**
+     * 名前を指定してロード済み TavioMesh をシーンに追加する
+     * @param name - 対象の名前
+     */
+    addTavioMesh(name: string): Promise<void>;
+    /**
+     * 名前を指定してロード済み TavioMesh をシーンから取り除く
+     * @param name - 対象の名前
+     */
+    removeTavioMesh(name: string): Promise<void>;
+    /**
+     * 名前を指定して TavioMesh を削除・解放する
+     * @param name - 対象の名前
+     */
+    disposeTavioMesh(name: string): void;
+    /**
+     * 名前を指定して TavioMesh の表示・非表示を設定する
+     * @param name - 対象の名前
+     * @param visibility - 可視状態
+     */
+    setVisibilityTavioMesh(name: string, visibility: boolean): Promise<void>;
+    /**
+     * 名前を指定して TavioMesh の点描画用 Points の表示・非表示を設定する
+     * @param name - 対象の名前
+     * @param visibility - 可視状態
+     */
+    setVisibilityPoints(name: string, visibility: boolean): void;
+    /**
+     * 背景球（シーンの背景）の透明度を指定する（0.0 ～ 1.0）
+     * @param opacity - 透明度
+     */
+    setBackgroundOpacity(opacity: number): void;
+    /**
+     * 名前を指定した TavioMesh に含まれるインスタンスを、インデックスで指定して動かす
+     * ※ここでいうインデックスとは load/concat した順番を意味する整数値
+     * @param name - 対象の名前
+     * @param index - インデックス
+     * @param translation - 平行移動
+     * @param rotation - 回転（オイラー角）
+     * @param scale - 拡大縮小（XYZ で統一のスケール）
+     */
+    setTransform(name: string, index: number, translation: Vector3, rotation: Euler, scale: number): void;
+    /**
+     * 名前を指定した TavioMesh に含まれるインスタンスの、指定されたインデックスの座標変換情報を返す
+     * ※ここでいうインデックスとは load/concat した順番を意味する整数値
+     * @param name - 対象の名前
+     * @param index - インデックス
+     */
+    getTransform(name: string, index: number): iTransform;
+    /**
+     * ==========================================================================
+     * general
+     * ==========================================================================
+     */
+    /**
+     * ウィンドウのリサイズ処理
+     * @param width - 幅
+     * @param height - 高さ
+     * @param start - リサイズと同時に描画を開始するかどうか
+     */
+    resize(width?: number, height?: number, start?: boolean): void;
+    /**
+     * 描画を開始する
+     */
+    start(): void;
+    /**
+     * 描画処理
+     * @private
+     */
+    private _render;
+    /**
+     * DevicePixelRatio をレンダラーに対して設定する
+     * @param value - 設定する DevicePixelRatio
+     */
+    setDevicePixelRatio(value: number): void;
+    /**
+     * 現在設定されている DevicePixelRatio を返す
+     */
+    getDevicePixelRatio(): number;
+    /**
+     * インタラクティブに描画するモードを用いるかどうかを設定する
+     * @param isInteractive - 有効とするかどうか
+     */
+    setInteractiveMode(isInteractive: boolean): void;
+    /**
+     * 球面調和関数の交流成分を利用するかどうかを設定する
+     * @param isUsing - 利用するかどうかのフラグ
+     */
+    setUsingSphericalHarmonics(isUsing: boolean): void;
+    /**
+     * 球面調和関数の交流成分に対する係数を設定する（0.0 ～ 1.0）
+     * @param intensity - 0.0 で交流成分の効果が完全に不可視化される
+     */
+    setSphericalHarmonicsIntensity(intensity: number): void;
+    /**
+     * ファイルに含まれるヘッダ情報及び頂点の情報などを取得する
+     */
+    getHeaderInfo(name: string): iHeaderInfo;
+    /**
+     * フレームバッファに 3DGS のワールド座標をレンダリングし指定されたスクリーン座標から取得する
+     * @param x - 取得する X 座標（スクリーン空間を -1.0 ～ 1.0 に正規化した座標）
+     * @param y - 取得する Y 座標（スクリーン空間を -1.0 ～ 1.0 に正規化した座標, Y-down）
+     */
+    getWorldPositionByScreen(x: number, y: number): Promise<Float32Array>;
+    /**
+     * 各種リソースを解放する
+     * ※このメソッドを呼び出すと、それまで利用していた canvas は再利用できなくなる
+     * ※別の canvas を渡して setupOnConstructor や init、render を呼ぶことで再度描画を行うことができる
+     */
+    dispose(): void;
+    /**
+     * ビューポートの情報を uniform 変数に設定する
+     * @private
+     */
+    private _updateViewportUniforms;
+    /**
+     * ==========================================================================
+     * camera
+     * ==========================================================================
+     */
+    /**
+     * カメラの現在の座標と注視点、視野角を取得する
+     */
+    getCameraParameter(): iCameraParameter;
+    /**
+     * カメラの現在の座標と注視点、視野角を取得する
+     * @param position - 設定する座標
+     * @param eye - 設定する注視点
+     * @param fov - 設定する視野角
+     */
+    setCameraParameter(position: iVectorLike, eye: iVectorLike, fov?: number): void;
+    /**
+     * ==========================================================================
+     * controls
+     * ==========================================================================
+     */
+    /**
+     * Controls タイプを設定する
+     * @param type - 設定するタイプを意味する文字列
+     */
+    setControlsType(type: tControlsType): void;
+    /**
+     * 現在のカメラコントロールを意味する文字列を返す
+     */
+    getControlsType(): tControlsType;
+    /**
+     * FlightControls と TransferControls に減衰を設定する
+     * @param attenuation - 減衰（0.0 以上 ～ 1.0 未満）
+     */
+    setControlsAttenuation(attenuation: number): void;
+    /**
+     * ==========================================================================
+     * orbit controls
+     * ==========================================================================
+     */
+    /**
+     * オービットコントロールの注視点の座標を取得する
+     * @returns 注視点の座標
+     */
+    getOrbitTarget(): iVectorLike;
+    /**
+     * オービットコントロールの注視点と座標を設定する
+     * @param position - カメラの座標
+     * @param target - 注視点の座標
+     * setTransferPositionのみ呼び出した場合、見た目が変わらなかったため本関数を作成。
+     */
+    setOrbitPositionAndTarget(position: iVectorLike, target: iVectorLike): void;
+    /**
+     * オービットコントロールの注視点を設定する
+     * @param target - 注視点の座標
+     */
+    setOrbitTarget(target: iVectorLike): void;
+    /**
+     * オービットコントロールのズーム使用可否を設定する
+     * @param enable - 使用可否を意味する真偽値
+     */
+    setOrbitEnableZoom(enable: boolean): void;
+    /**
+     * オービットコントロールの平行移動使用可否を設定する
+     * @param enable - 使用可否を意味する真偽値
+     */
+    setOrbitEnablePan(enable: boolean): void;
+    /**
+     * オービットコントロールの可動範囲制限の可否を設定する
+     * @param enable - 使用可否を意味する真偽値
+     */
+    setOrbitEnableLimit(enable: boolean): void;
+    /**
+     * オービットコントロールの注視点と座標の距離を取得する
+     * @returns 注視点と座標の距離
+     */
+    getOrbitDistance(): number;
+    /**
+     * オービットコントロールの注視点から位置までの距離を設定する
+     * @param distance - 設定する距離
+     */
+    setOrbitDistance(distance: number): void;
+    /**
+     * オービットコントロールのピッチとヨーを相対的に移動する
+     * @param pitch - ピッチ角度の変化量（ラジアン）
+     * @param yaw - ヨー角度の変化量（ラジアン）
+     */
+    setOrbitRelativeRotation(pitch: number, yaw: number): void;
+    /**
+     * オービットコントロールのドリー（前後移動）を相対的に設定する
+     * @param value - 設定する値
+     */
+    setOrbitRelativeDollyOut(value: number): void;
+    /**
+     * オービットコントロールの上下の回転を相対的に設定する
+     * @param value - 設定する値
+     */
+    setOrbitRelativeRotateUp(value: number): void;
+    /**
+     * オービットコントロールの左右の回転を相対的に設定する
+     * @param value - 設定する値
+     */
+    setOrbitRelativeRotateLeft(value: number): void;
+    /**
+     * オービットコントロールの上下の移動を相対的に設定する
+     * @param value - 設定する値
+     */
+    setOrbitRelativeTranslateUp(value: number): void;
+    /**
+     * オービットコントロールの左右の移動を相対的に設定する
+     * @param value - 設定する値
+     */
+    setOrbitRelativeTranslateLeft(value: number): void;
+    /**
+     * オービットコントロールへポインターが押下中かどうかを設定する
+     * @param isDown - 設定する値
+     */
+    setOrbitPointerDown(isDown: boolean): void;
+    /**
+     * オービットコントロールの範囲外へはみ出すことができる範囲を設定する
+     * @param value - 設定する値
+     */
+    setOrbitOverflow(value: number): void;
+    /**
+     * オービットコントロールの北緯方向の可動範囲を設定する
+     * @param value - 設定する値
+     */
+    setOrbitUpLimit(value: number): void;
+    /**
+     * オービットコントロールの南緯方向の可動範囲を設定する
+     * @param value - 設定する値
+     */
+    setOrbitDownLimit(value: number): void;
+    /**
+     * オービットコントロールの西経方向の可動範囲を設定する
+     * @param value - 設定する値
+     */
+    setOrbitLeftLimit(value: number): void;
+    /**
+     * オービットコントロールの西経方向の可動範囲を設定する
+     * @param value - 設定する値
+     */
+    setOrbitRightLimit(value: number): void;
+    /**
+     * ==========================================================================
+     * camera path controls
+     * ==========================================================================
+     */
+    /**
+     * カメラパスを生成して返す
+     * @param position - カメラの座標（{x, y, z} のオブジェクト、または [x, y, z] の数値の配列）の配列
+     * @param target - 注視点の座標（{x, y, z} のオブジェクト、または [x, y, z] の数値の配列）の配列
+     * @param debug - デバッグモードをオンにすると、各点とその補間後の軌跡がシーンに追加される
+     */
+    createCameraPath(position: iVectorLike[] | number[][], target: iVectorLike[] | number[][], debug?: boolean): CameraPath;
+    /**
+     * カメラパスが有効な場合、指定された時間を設定し更新する
+     * @param time - 設定する時間（0.0 ～ 1.0）
+     */
+    updateCameraPath(time: number): void;
+    /**
+     * カメラパスを設定する
+     * @deprecated このメソッドは廃止されました。addCameraPath(name, path) と selectCameraPath(name) を使用してください。
+     * @param path - 設定する CameraPath
+     */
+    setCameraPath(path: CameraPath): void;
+    /**
+     * カメラパスを名前で追加する
+     * @param name - カメラパスの名前
+     * @param path - 追加する CameraPath
+     */
+    addCameraPath(name: string, path: CameraPath): void;
+    /**
+     * カメラパスを名前で削除する
+     * @param name - 削除するカメラパスの名前
+     */
+    removeCameraPath(name: string): void;
+    /**
+     * アクティブなカメラパスを選択する
+     * @param name - 選択するカメラパスの名前
+     */
+    selectCameraPath(name: string): void;
+    /**
+     * 現在アクティブなカメラパスを取得する
+     * @returns アクティブなカメラパス、または null
+     */
+    getActiveCameraPath(): CameraPath | null;
+    /**
+     * すべてのカメラパス名を取得する
+     * @returns カメラパス名の配列
+     */
+    getPathNames(): string[];
+    /**
+     * カメラパスのオプションを設定する
+     * @param option - カメラパスに設定するオプション
+     */
+    setCameraPathOption(option: iCameraPathOption): void;
+    /**
+     * カメラパスのインタラクション用の座標を設定する
+     * @param x - 設定する X 座標（スクリーン空間を -1.0 ～ 1.0 に正規化した座標）
+     * @param y - 設定する Y 座標（スクリーン空間を -1.0 ～ 1.0 に正規化した座標, Y-down）
+     */
+    setCameraPathInteraction(x: number, y: number): void;
+    /**
+     * カメラパスの可動領域（カプセル型）の半径を設定する
+     * @param radius - 設定する半径
+     */
+    setCameraPathCollisionRadius(radius: number): void;
+    /**
+     * ==========================================================================
+     * flight controls
+     * ==========================================================================
+     */
+    /**
+     * FlightControls に緯度を設定する
+     * @param latitude - 緯度（-90 ～ 90）
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setFlightLatitude(latitude: number, isForce?: boolean): void;
+    /**
+     * FlightControls に経度を設定する
+     * @param longitude - 経度（0 ～ 360）
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setFlightLongitude(longitude: number, isForce?: boolean): void;
+    /**
+     * FlightControls に緯度を相対的に設定する
+     * @param latitude - 相対値
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setFlightRelativeLatitude(latitude: number, isForce?: boolean): void;
+    /**
+     * FlightControls に経度を相対的に設定する
+     * @param longitude - 相対値
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setFlightRelativeLongitude(longitude: number, isForce?: boolean): void;
+    /**
+     * FlightControls から緯度経度を取得する
+     */
+    getFlightParameter(): iLatitudeLongitude;
+    /**
+     * ==========================================================================
+     * transfer controls
+     * ==========================================================================
+     */
+    /**
+     * TransferControls に位置を設定する
+     * @param position - 位置
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setTransferPosition(position: iVectorLike, isForce?: boolean): void;
+    /**
+     * TransferControls に位置を相対的に設定する
+     * @param position - 相対値
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setTransferRelativePosition(position: iVectorLike, isForce?: boolean): void;
+    /**
+     * TransferControls に、現在の位置と向きに応じて移動するよう設定する
+     * @param offset - 移動する量
+     * @param scale - 移動するスケール
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    moveTransferByDirection(offset: iVectorLike, scale: number, isForce?: boolean): void;
+    /**
+     * TransferControls に、現在の位置と向きに応じて水平に移動するよう設定する
+     * @param x - 右を正とした横方向
+     * @param y - 奥を正とした前後方向
+     * @param scale - 移動するスケール
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    moveTransferByHorizontalDirection(x: number, y: number, scale: number, isForce?: boolean): void;
+    /**
+     * TransferControls に、XZ 平面に対して上昇するよう設定する
+     * @param scale - 移動するスケール
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    moveTransferToTop(scale: number, isForce?: boolean): void;
+    /**
+     * TransferControls に、XZ 平面に対して下降するよう設定する
+     * @param scale - 移動するスケール
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    moveTransferToBottom(scale: number, isForce?: boolean): void;
+    /**
+     * TransferControls に fov を設定する
+     * @param fov - 設定する fov
+     * @param isForce - トランジションせず即座に強制上書きするかどうか
+     */
+    setTransferFov(fov: number, isForce?: boolean): void;
+    /**
+     * ==========================================================================
+     * camera collider
+     * ==========================================================================
+     */
+    /**
+     * カメラコライダーの有効・無効を設定する
+     * @param enabled - 有効化するかどうか
+     */
+    setCameraColliderEnabled(enabled: boolean): void;
+    /**
+     * カメラコライダーの有効・無効状態を取得する
+     * @returns カメラコライダーが有効かどうか
+     */
+    getCameraColliderEnabled(): boolean;
+    /**
+     * ==========================================================================
+     * shader effects
+     * ==========================================================================
+     */
+    /**
+     * 点描画用の Points に対して uniform 変数の値を設定する
+     * ※あくまでも private なメソッドであり、値設定後に自動で start() はコールされない
+     * @private
+     * @param uniforms - 設定する値を定義したオブジェクト
+     */
+    private _setPointUniforms;
+    /**
+     * ガウシアンの大きさの基本係数を設定する
+     * @param value - 設定する係数（0.0 to 1.0）
+     */
+    setGaussianScale(value: number): void;
+    /**
+     * 距離に応じたガウシアンの大きさにおける最小値を設定する
+     * @param value - 設定する係数（0.0 to 1.0）
+     */
+    setEffectMinimumScale(value: number): void;
+    /**
+     * 距離に応じたガウシアンの大きさ係数を設定する
+     * @param value - 設定する係数（0.0 to 1.0）
+     */
+    setEffectDistanceBase(value: number): void;
+    /**
+     * 距離に応じたガウシアンの範囲係数を設定する
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectDistanceRange(value: number): void;
+    /**
+     * シェーダーで使用するワールド原点を設定する
+     * @param x - X座標
+     * @param y - Y座標
+     * @param z - Z座標
+     */
+    setWorldOrigin(x: number, y: number, z: number): void;
+    /**
+     * シェーダ上で作用する加減算アルファ値を設定する
+     * @param alpha - アルファ（適切な範囲はおよそ -3.0 ～ 3.0）
+     */
+    setOpacityAdditive(alpha: number): void;
+    /**
+     * シェーダ上で作用する乗算アルファ値を設定する
+     * @param alpha - アルファ（適切な範囲はおよそ -3.0 ～ 3.0）
+     */
+    setOpacityMultiplier(alpha: number): void;
+    /**
+     * 点描画用の Points に対して距離に応じたエフェクトの範囲係数を設定する（外側）
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectDistancePoints(value: number): void;
+    /**
+     * 点描画用の Points に対して距離に応じたエフェクトの範囲係数を設定する（内側）
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectDistanceNearPoints(value: number): void;
+    /**
+     * 色エフェクトの範囲を設定する（外側）
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectDistanceColor(value: number): void;
+    /**
+     * 色エフェクトの範囲を設定する（内側）
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectDistanceColorNear(value: number): void;
+    /**
+     * ソナーエフェクトを設定する（外側）
+     * @param value - 設定する係数（0.0 < n <= 1.0）
+     */
+    setEffectSonar(value: number): void;
+    /**
+     * ソナーエフェクトの範囲を設定する
+     * @param value - 設定する範囲（0.0 < n <= 1.0）
+     */
+    setEffectSonarRange(value: number): void;
+    /**
+     * 点描画用の Points に対してアルファを設定する
+     * @param alpha - アルファ（0.0 ～ 1.0）
+     */
+    setOpacityPoints(alpha: number): void;
+    /**
+     * シェーダ上で作用する色温度を設定する
+     * @param temperature - 色温度（適切な範囲はおよそ -1.0 ～ 1.0）
+     */
+    setColorTemperature(temperature: number): void;
+    /**
+     * シェーダ上で作用するティントを設定する
+     * @param tint - ティント（適切な範囲はおよそ -1.0 ～ 1.0）
+     */
+    setColorTint(tint: number): void;
+    /**
+     * シェーダ上で作用するコントラストを設定する
+     * @param contrast - コントラスト（適切な範囲はおよそ 0.0 ～ 1.0）
+     */
+    setColorContrast(contrast: number): void;
+    /**
+     * シェーダ上で作用する HSV を設定する
+     * @param hsv - 変換に用いる係数を Vector3 で表したもの
+     */
+    setHSVColor(hsv: iVectorLike): void;
+    /**
+     * シェーダ上で作用する RGB を設定する
+     * @param rgb - 変換に用いる係数を Vector3 で表したもの（rgb-R, rgb-G, rgb-B）
+     */
+    setColorRGB(rgb: iVectorLike): void;
+    /**
+     * シェーダ上で作用する blur を設定する
+     * @param blur - ガウシアン内で色をぼかす係数（適切な範囲はおよそ 0.0 ～ 1.0）
+     */
+    setColorBlur(blur: number): void;
+    /**
+     * シェーダ上で作用する sharpness を設定する
+     * @param sharpness - ガウシアン内で色を強調する係数（適切な範囲はおよそ 0.0 ～ 1.0）
+     */
+    setColorSharpness(sharpness: number): void;
+    /**
+     * ==========================================================================
+     * animation
+     * ==========================================================================
+     */
+    /**
+     * アニメーションがアクティブかどうかを返す
+     * @returns アニメーションがアクティブかどうか
+     */
+    isAnimating(): boolean;
+    /**
+     * 点描画の開花効果をアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    startBloomPoints(duration: number): void;
+    /**
+     * 点描画からガウシアンへの溶解効果をアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    startDissolveToGaussian(duration: number): void;
+    /**
+     * ソナー波効果をアニメーションする
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    startSonarWave(duration: number): void;
+    /**
+     * カメラパスをアニメーションする
+     * @param name - カメラパスの名前
+     * @param duration - アニメーションの継続時間（ミリ秒）
+     */
+    animatePath(name: string, duration: number): void;
+    /**
+     * アニメーション用の距離情報を設定する
+     * @param mainDistance - メインの範囲の距離（実際の距離値、distance50やdistance70など、nullの場合は距離マッピングを無効化）
+     * @param remainingDistance - 残りの範囲の距離（実際の距離値、effectDistanceMaxと同じ、通常はdistance100、nullの場合は距離マッピングを無効化）
+     * @param splitPoint - 分割点（0.0～1.0、デフォルト0.8。progressがこの値まででmainDistance、それ以降でremainingDistanceまで）
+     * @note mainDistanceまたはremainingDistanceがnullの場合、距離マッピングは無効化され、progressがそのまま使用されます
+     * @deprecated setAnimationConfig を使用してください
+     */
+    setDistanceInfoForAnimation(mainDistance: number | null, remainingDistance: number | null, splitPoint?: number): void;
+    /**
+     * アニメーションの最大描画距離を取得する
+     * @returns 最大描画距離（0.0～1.0）
+     * @deprecated getAnimationConfig を使用してください
+     */
+    getMaxRenderDistanceForAnimation(): number;
+    /**
+     * アニメーションの最大描画距離を設定する
+     * progressが1.0に達したときにこの値がゴールとなる
+     * @param value - 最大描画距離（0.0～1.0）
+     * @deprecated setAnimationConfig を使用してください
+     */
+    setMaxRenderDistanceForAnimation(value: number): void;
+    /**
+     * アニメーション設定を一括で取得する
+     * @returns 現在のアニメーション設定
+     */
+    getAnimationConfig(): iAnimationConfig;
+    /**
+     * アニメーション設定を一括で設定する
+     * @param config - アニメーション設定オブジェクト
+     * @example
+     * // 最大描画距離のみ設定
+     * tvv.setAnimationConfig({ maxRenderDistance: 0.5 });
+     *
+     * // 距離マッピングと最大描画距離を設定
+     * tvv.setAnimationConfig({
+     *   maxRenderDistance: 0.5,
+     *   mainDistance: 50,
+     *   remainingDistance: 100,
+     *   splitPoint: 0.8
+     * });
+     */
+    setAnimationConfig(config: iAnimationConfig): void;
+    /**
+     * ==========================================================================
+     * collision
+     * ==========================================================================
+     */
+    /**
+     * セレクターから球の衝突判定を生成する
+     * @private
+     * @param selector - 対象となるセレクター
+     */
+    private _createCollisionSphereFromSelector;
+    /**
+     * セレクターから箱の衝突判定を生成する
+     * @private
+     * @param selector - 対象となるセレクター
+     */
+    private _createCollisionBoxFromSelector;
+    /**
+     * 衝突判定を設定する
+     * @param collision - 設定する衝突判定、またはその配列
+     */
+    setCollision(collision: iCollisionTarget | iCollisionTarget[]): void;
+    /**
+     * 現在の衝突判定を解除する
+     */
+    resetCollision(): void;
+    /**
+     * 現在選択しているガウシアンを削除状態とする
+     */
+    deleteSelectedGaussian(): void;
+    /**
+     * 削除状態を一世代前に戻す
+     */
+    undoDeletedGaussian(): void;
+    /**
+     * すべての削除状態をリセットする
+     */
+    resetDeletedGaussian(): void;
+    /**
+     * セレクターによる衝突判定の反転フラグを設定する
+     * @param reversed - 設定する反転属性
+     */
+    setCollisionReversed(reversed: boolean): void;
+    /**
+     * 名前を指定してセレクターで衝突判定を行う
+     * @param name - 対象となるセレクターの名前
+     */
+    checkCollisionBySelector(name: string): void;
+    /**
+     * 名前を複数（配列で）指定して対象のセレクターで衝突判定を行う
+     * @param names - 対象となるセレクターの名前の配列
+     */
+    checkCollisionBySelectors(names: string[]): void;
+    /**
+     * 現在追加されているすべてのセレクターで衝突判定を行う
+     */
+    checkCollisionByAllSelectors(): void;
+    /**
+     * 球の衝突判定パラメータ（Worker に渡すフォーマット）を生成する
+     * @param radius - 半径
+     * @param position - ワールド空間における位置
+     * @param scale - ワールド空間における拡大縮小（スケール）
+     * @param inverseMatrix - ワールド変換の逆行列
+     * @param reversed - 判定の反転（球に内包されている状態を規定とし、それを反転するかどうか）
+     */
+    createCollisionSphere(radius: number, position: iVectorLike, scale: iVectorLike, inverseMatrix: Matrix4, reversed?: boolean): iCollisionTarget;
+    /**
+     * 箱の衝突判定パラメータ（Worker に渡すフォーマット）を生成する
+     * @param width - 一辺の幅
+     * @param position - ワールド空間における位置
+     * @param scale - ワールド空間における拡大縮小（スケール）
+     * @param inverseMatrix - ワールド変換の逆行列
+     * @param reversed - 判定の反転（球に内包されている状態を規定とし、それを反転するかどうか）
+     */
+    createCollisionBox(width: number, position: iVectorLike, scale: iVectorLike, inverseMatrix: Matrix4, reversed?: boolean): iCollisionTarget;
+    /**
+     * ==========================================================================
+     * selector
+     * ==========================================================================
+     */
+    /**
+     * すべての生成済みセレクターの諸情報を返す
+     */
+    getAllSelectorInfo(): iSelectorInfo[];
+    /**
+     * 名前を指定してセレクターの可視性を設定する
+     * @param name - 設定するセレクターの名前
+     * @param visible - 設定する可視性
+     */
+    setSelectorVisible(name: string, visible: boolean): void;
+    /**
+     * 名前を指定してセレクターを平行移動モードにする
+     * @param name - 設定するセレクターの名前
+     */
+    setSelectorModeTranslate(name: string): void;
+    /**
+     * 名前を指定してセレクターを拡大縮小モードにする
+     * @param name - 設定するセレクターの名前
+     */
+    setSelectorModeScale(name: string): void;
+    /**
+     * 名前を指定してセレクターを回転モードにする
+     * @param name - 設定するセレクターの名前
+     */
+    setSelectorModeRotate(name: string): void;
+    /**
+     * 名前を指定してセレクターの位置を設定する
+     * @param name - 設定するセレクターの名前
+     * @param position - 設定する位置
+     */
+    setSelectorPosition(name: string, position: iVectorLike): void;
+    /**
+     * 名前を指定してセレクターの回転を設定する
+     * @param name - 設定するセレクターの名前
+     * @param rotation - 設定する回転（Euler）
+     */
+    setSelectorRotation(name: string, rotation: iVectorLike): void;
+    /**
+     * 名前を指定してセレクターのスケールを設定する
+     * @param name - 設定するセレクターの名前
+     * @param position - 設定するスケール
+     */
+    setSelectorScale(name: string, scale: iVectorLike): void;
+    /**
+     * 名前を指定してセレクターを削除する
+     * @param name - 削除するセレクターの名前
+     */
+    deleteSelector(name: string): void;
+    /**
+     * 名前を指定して球のセレクターを追加する（既定の状態では visible が false である点に注意）
+     * @param name - 追加するセレクターに付与する名前
+     * @param option - セレクターに対するオプション
+     */
+    addSphereSelector(name: string, option?: iSphereSelectorOption): void;
+    /**
+     * 名前を指定して箱のセレクターを追加する（既定の状態では visible が false である点に注意）
+     * @param name - 追加するセレクターに付与する名前
+     * @param option - セレクターに対するオプション
+     */
+    addBoxSelector(name: string, option?: iBoxSelectorOption): void;
+    /**
+     * OrbitControlsの注視点カーソル機能の有効・無効を設定する
+     * orbitCursorが有効のとき、カメラモードがorbitかつ注視点の座標が変化したときに自動表示される
+     * @param enabled - 有効にするかどうか
+     */
+    enableOrbitCursor(enabled: boolean): void;
+    /**
+     * OrbitControlsの注視点カーソル機能が有効かどうかを取得する
+     * @returns 有効かどうか
+     */
+    isOrbitCursorEnabled(): boolean;
+    /**
+     * OrbitControlsの注視点カーソルのスケールを設定する
+     * @param scale - 設定するスケール値
+     */
+    setOrbitCursorScale(scale: number): void;
+}
+export {};