@realsee/five 6.8.0-alpha.2 → 6.8.0-alpha.21

package/five/controllers/floorplan.d.ts

@@ -0,0 +1,119 @@
+import * as THREE from "three";
+import { GestureEvent } from "../utils/event";
+import { TextureLoader } from "../texture/loader";
+import { BaseController, BaseControllerInitArgs } from "./base";
+import { State } from "../types/state";
+import { Pose } from "../types/pose";
+import { MovePanoEffect } from "../types/movePanoEffect";
+import { Works, WorkObserver } from "../work";
+import { ModelScene } from "../model";
+import { Motion } from "../utils/motion";
+import { IntersectMeshInterface } from "../types/intersectMeshInterface";
+type LocationMotion = Motion<"x" | "y" | "z" | "distance">;
+type ModelAlphaMotion = Motion<"modelAlpha">;
+type PerspToOrthoMotion = Motion<"perspToOrtho">;
+interface FloorplanControllerCustomInitArgs {
+    /** 默认水平角 */
+    defaultLongitude?: number;
+    /** 默认俯仰角 */
+    defaultLatitude?: number;
+    /** 最大俯仰角 */
+    maxLatitude?: number | ((fov: number) => number);
+    /** 最小俯仰角 */
+    minLatitude?: number | ((fov: number) => number);
+    /** 默认相机可视角度（垂直），可作为 `zoom` */
+    defaultFov?: number;
+    /** 最大相机可视角度 */
+    maxFov?: number;
+    /** 最小相机可视角度 */
+    minFov?: number;
+    /** 鼠标焦点环自定义创建器 */
+    intersectMeshCreator?: () => IntersectMeshInterface;
+}
+declare const defaultFloorplanControllerCustomInitArgs: Required<FloorplanControllerCustomInitArgs>;
+type FloorplanControllerInitArgs = BaseControllerInitArgs & FloorplanControllerCustomInitArgs;
+declare class FloorplanController extends BaseController implements Required<FloorplanControllerInitArgs> {
+    defaultLongitude: number;
+    defaultLatitude: number;
+    maxLatitude: number | ((fov: number) => number);
+    minLatitude: number | ((fov: number) => number);
+    defaultFov: number;
+    maxFov: number;
+    minFov: number;
+    intersectMeshCreator: () => IntersectMeshInterface;
+    locationMotion: LocationMotion;
+    modelAlphaMotion: ModelAlphaMotion;
+    perspToOrthoMotion: PerspToOrthoMotion;
+    protected pinchState?: {
+        x: number;
+        y: number;
+        fov: number;
+    };
+    protected pendingTextureId: string | null;
+    protected intersectMesh: IntersectMeshInterface;
+    protected textureLoader: TextureLoader;
+    static distanceFromModel(modelScene: ModelScene, fov: number, aspect: number): number;
+    static parseArgs(args: FloorplanControllerInitArgs): Required<FloorplanControllerInitArgs>;
+    static initAnimationEndState(args: FloorplanControllerInitArgs): State;
+    constructor(args: FloorplanControllerInitArgs);
+    updateConfiguration(args: FloorplanControllerCustomInitArgs): boolean;
+    /** 析构函数 */
+    destroy(): void;
+    /** 是否准备好，即不在用户操作中，并且不再动画中 */
+    isReady(): boolean;
+    /** 生命周期：更新 Work */
+    updateWork(works: Works, state: Partial<State>, options: {
+        duration: number;
+        effect: MovePanoEffect;
+    }, userAction: boolean): boolean;
+    /** 生命周期：更新模型 */
+    updateModel(modelScene: ModelScene): void;
+    /** 转动摄像头 */
+    updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
+    /** 通过帧动画转动摄像头 */
+    updateCameraWithKeyframes(keyframes: {
+        progress: number;
+        value: Pose;
+        key?: string;
+    }[], duration: number, userAction: boolean): Promise<void>;
+    /** 生命周期：时间迭代 */
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
+    /** 获取目标姿态 */
+    getTargetState(): State;
+    /** 初始化动画 */
+    protected initAnimation(): Promise<void>;
+    updateRenderSize(size: THREE.Vector2): void;
+    /**
+     * 方向射线上寻找下一个目标点位
+     * @param raycaster - 方向射线
+     * @returns 方向射线上寻找下一个目标点位
+     */
+    protected getForwardObserverOrNot(raycaster: THREE.Raycaster): WorkObserver | null;
+    protected coordinatesForOffset(offset: {
+        x: number;
+        y: number;
+    }): {
+        longitude: number;
+        latitude: number;
+    };
+    /** 惯性滚动 */
+    protected requestMomentumMovement(event: GestureEvent, isFirst: boolean, velocity: {
+        longitude: number;
+        latitude: number;
+    }, duration: number): void;
+    /** 触摸 Pan 事件，相机转动 */
+    protected onPanGesture(event: GestureEvent): void;
+    /** 触摸 Pinch 事件， 相机缩放 */
+    protected onPinchGesture(event: GestureEvent): void;
+    /** 鼠标移动事件 展示交点环 */
+    protected onMouseMove(event: GestureEvent): void;
+    /** 鼠标滚轮事件 相机缩放 */
+    protected onMouseWheel(event: GestureEvent): void;
+    /** 触摸 点击屏幕 */
+    protected onTapGesture(event: GestureEvent): void;
+    /** 触摸 双点屏幕 */
+    protected onDblTapGesture(event: GestureEvent): void;
+    /** 隐藏焦点环 */
+    protected hideIntersectMesh(): void;
+}
+export { LocationMotion, ModelAlphaMotion, PerspToOrthoMotion, FloorplanController, FloorplanControllerInitArgs, FloorplanControllerCustomInitArgs, defaultFloorplanControllerCustomInitArgs, };

package/five/controllers/mapview.d.ts

@@ -0,0 +1,139 @@
+import * as THREE from "three";
+import { TextureLoader } from "../texture/loader";
+import { BaseController, BaseControllerInitArgs } from "./base";
+import { Pose } from "../types/pose";
+import { State } from "../types/state";
+import { MovePanoEffect } from "../types/movePanoEffect";
+import { GestureEvent } from "../utils/event";
+import { Works, WorkObserver } from "../work";
+import { ModelScene } from "../model";
+import { Motion } from "../utils/motion";
+import { IntersectMeshInterface } from "../types/intersectMeshInterface";
+type LocationMotion = Motion<"x" | "y" | "z" | "distance">;
+type PerspToOrthoMotion = Motion<"perspToOrtho">;
+type ModelAlphaMotion = Motion<"modelAlpha">;
+interface MapviewControllerCustomInitArgs {
+    /** 默认水平角 */
+    defaultLongitude?: number;
+    /** 默认俯仰角 */
+    defaultLatitude?: number;
+    /** 默认相机距离 */
+    defaultDistance?: number;
+    /** 最大俯仰角 */
+    maxLatitude?: number | ((fov: number) => number);
+    /** 最小俯仰角 */
+    minLatitude?: number | ((fov: number) => number);
+    /**
+     * 相机类型
+     * perspective 透视相机
+     * orthographic 正交相机
+     * auto 在俯视为正交相机， 斜视为透视相机(默认)
+     */
+    cameraType?: "perspective" | "orthographic" | "auto";
+    /**
+     * 相机电子围栏
+     */
+    cameraFence?: THREE.Box3 | THREE.Sphere | null;
+    /** 鼠标焦点环自定义创建器 */
+    intersectMeshCreator?: () => IntersectMeshInterface;
+}
+declare const defaultMapviewControllerCustomInitArgs: Required<MapviewControllerCustomInitArgs>;
+type MapviewControllerInitArgs = BaseControllerInitArgs & MapviewControllerCustomInitArgs;
+declare class MapviewController extends BaseController implements Required<MapviewControllerInitArgs> {
+    defaultLongitude: number;
+    defaultLatitude: number;
+    defaultDistance: number;
+    maxLatitude: number | ((fov: number) => number);
+    minLatitude: number | ((fov: number) => number);
+    cameraType: "perspective" | "orthographic" | "auto";
+    cameraFence: THREE.Box3 | THREE.Sphere | null;
+    intersectMeshCreator: () => IntersectMeshInterface;
+    locationMotion: LocationMotion;
+    modelAlphaMotion: ModelAlphaMotion;
+    perspToOrthoMotion: PerspToOrthoMotion;
+    protected panState?: {
+        x: number;
+        y: number;
+        defaultPrevented: boolean;
+        buttons: number;
+        target: THREE.Vector3;
+        pointerLength: number;
+    };
+    protected pinchState?: {
+        x: number;
+        y: number;
+        scale: number;
+        distance: number;
+    };
+    protected intersectMesh: IntersectMeshInterface;
+    protected pendingTextureId: string | null;
+    protected textureLoader: TextureLoader;
+    static parseArgs(args: MapviewControllerInitArgs): Required<MapviewControllerInitArgs>;
+    static distanceFromModel(modelScene: ModelScene, fov: number, aspect: number): number;
+    static initAnimationEndState(args: MapviewControllerInitArgs): State;
+    constructor(args: MapviewControllerInitArgs);
+    updateConfiguration(args: MapviewControllerCustomInitArgs): boolean;
+    /** 析构函数 */
+    destroy(): void;
+    /** 是否准备好，即不在用户操作中，并且不再动画中 */
+    isReady(): boolean;
+    /** 生命周期：更新 Work */
+    updateWork(works: Works, state: Partial<State>, options: {
+        duration: number;
+        effect: MovePanoEffect;
+    }, userAction: boolean): boolean;
+    /** 生命周期：更新模型 */
+    updateModel(modelScene: ModelScene): void;
+    /** 转动摄像头 */
+    updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
+    /** 通过帧动画转动摄像头 */
+    updateCameraWithKeyframes(keyframes: {
+        progress: number;
+        value: Pose;
+        key?: string;
+    }[], duration: number, userAction: boolean): Promise<void>;
+    /** 生命周期：时间迭代 */
+    updateTime(time: number, deltaTime: number): void;
+    /** 获取目标姿态 */
+    getTargetState(): State;
+    /** 初始化动画 */
+    protected initAnimation(): Promise<void>;
+    /**
+     * 方向射线上寻找下一个目标点位
+     * @param raycaster - 方向射线
+     * @returns 方向射线上寻找下一个目标点位
+     */
+    protected getForwardObserverOrNot(raycaster: THREE.Raycaster): WorkObserver | null;
+    /** 计算 屏幕像素 offset 与 转动间的关系 */
+    protected coordinatesForOffset(offset: {
+        x: number;
+        y: number;
+    }): {
+        longitude: number;
+        latitude: number;
+    };
+    /** 惯性滚动 */
+    protected requestMomentumMovement(event: GestureEvent, isFirst: boolean, velocity: {
+        longitude: number;
+        latitude: number;
+        x: number;
+        y: number;
+        z: number;
+    }, duration: number): void;
+    protected fixFinalState(state: State): void;
+    /** 触摸 Pan 事件，相机转动 */
+    protected onPanGesture(event: GestureEvent): void;
+    /** 触摸 Pinch 事件， 相机缩放 */
+    protected onPinchGesture(event: GestureEvent): void;
+    /** 鼠标移动事件 展示交点环 */
+    protected onMouseMove(event: GestureEvent): void;
+    /** 鼠标滚轮事件 相机缩放 */
+    protected onMouseWheel(event: GestureEvent): void;
+    /** 触摸 点击屏幕 */
+    protected onTapGesture(event: GestureEvent): void;
+    /** 触摸 双点屏幕 */
+    protected onDblTapGesture(event: GestureEvent): void;
+    /** 隐藏焦点环 */
+    protected hideIntersectMesh(): void;
+}
+export { MapviewController, MapviewControllerInitArgs, MapviewControllerCustomInitArgs, defaultMapviewControllerCustomInitArgs, };

package/five/controllers/model.d.ts

@@ -0,0 +1,57 @@
+import * as THREE from "three";
+import { Pano } from "../utils/pano";
+import { Works } from "../work";
+import { MovePanoOptions } from "../types/movePanoOptions";
+import { State } from "../types/state";
+import { Pose } from "../types/pose";
+import { MovePanoEffect } from "../types/movePanoEffect";
+import { GestureEvent } from "../utils/event";
+import { BaseControllerInitArgs } from "./base";
+import { PanoramaLikeController, PanoramaLikeControllerCustomInitArgs } from "./panoramaLike";
+import { Motion } from "../utils/motion";
+type LocationMotion = Motion<"x" | "y" | "z" | "distance">;
+type ModelAlphaMotion = Motion<"modelAlpha">;
+type PerspToOrthoMotion = Motion<"perspToOrtho">;
+interface ModelControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
+}
+declare const defaultModelControllerCustomInitArgs: Required<ModelControllerCustomInitArgs>;
+type ModelControllerInitArgs = BaseControllerInitArgs & ModelControllerCustomInitArgs;
+declare class ModelController extends PanoramaLikeController implements Required<ModelControllerInitArgs> {
+    static parseArgs(args: ModelControllerInitArgs): Required<ModelControllerInitArgs>;
+    static initAnimationEndState(args: ModelControllerInitArgs): State;
+    locationMotion: LocationMotion;
+    modelAlphaMotion: ModelAlphaMotion;
+    perspToOrthoMotion: PerspToOrthoMotion;
+    constructor(args: ModelControllerInitArgs);
+    updateConfiguration(args: ModelControllerCustomInitArgs): boolean;
+    /** 析构函数 */
+    destroy(): void;
+    /** 是否准备好，即不在用户操作中，并且不再动画中 */
+    isReady(): boolean;
+    /** 生命周期：更新模型 */
+    updateWork(works: Works, state: Partial<State>, options: {
+        duration: number;
+        effect: MovePanoEffect;
+    }, userAction: boolean): boolean;
+    /** 转动摄像头 */
+    updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
+    /** 通过帧动画转动摄像头 */
+    updateCameraWithKeyframes(keyframes: {
+        progress: number;
+        value: Pose;
+        key?: string;
+    }[], duration: number, userAction: boolean): Promise<void>;
+    /** 生命周期：时间迭代 */
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
+    /** 初始化动画 */
+    protected initAnimation(): Promise<void>;
+    /** 获取目标姿态 */
+    getTargetState(): State;
+    /** 移动点位 */
+    moveToPano(pano: Pano, options: MovePanoOptions, userAction: boolean): void;
+    /** 移动相机位置 */
+    moveToPosition(position: THREE.Vector3, options: MovePanoOptions, userAction: boolean): void;
+    /** 触摸 点击屏幕 */
+    protected onTapGesture(event: GestureEvent): void;
+}
+export { ModelController, ModelControllerInitArgs, ModelControllerCustomInitArgs, defaultModelControllerCustomInitArgs, };

package/five/controllers/panorama.d.ts

@@ -0,0 +1,143 @@
+import * as THREE from "three";
+import { NetworkResponse, NetWorkMeta } from "../utils/ajax";
+import { ModelScene, PBMPanoPicture } from "../model";
+import { Works, WorkObserver } from "../work";
+import { Pano, PanoId } from "../utils/pano";
+import { TextureLoader } from "../texture/loader";
+import { MovePanoOptions } from "../types/movePanoOptions";
+import { MovePanoEffect } from "../types/movePanoEffect";
+import { BaseControllerInitArgs } from "./base";
+import { PanoramaLikeController, PanoramaLikeControllerCustomInitArgs } from "./panoramaLike";
+import { State } from "../types/state";
+import { GestureEvent } from "../utils/event";
+import { PanoCircleMeshInterface } from "../types/panoCircleMeshInterface";
+import { Motion } from "../utils/motion";
+import { Tiling } from "../core/tiling";
+import { PanoVideo } from "../core/panoVideo";
+declare const defaultEffectEase: import("../utils/easing").EasingFunction;
+type PanoResource = {
+    panoId: PanoId;
+    effect: Exclude<MovePanoOptions["effect"], undefined>;
+    effectEasing: Exclude<MovePanoOptions["effectEasing"], undefined>;
+    panoPicture: PBMPanoPicture | null;
+    position: THREE.Vector3;
+    fixCameraTransform: THREE.Matrix4;
+};
+type LocationMotion = Motion<"count" | "distance">;
+type PerspToOrthoMotion = Motion<"perspToOrtho">;
+type ModelAlphaMotion = Motion<"modelAlpha">;
+declare const adjustPanoCircleMeshVectors: THREE.Vector3[];
+interface PanoramaControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
+    /** 最远可移动观察点距离 */
+    maxAccessibleDistance?: number;
+    /**
+     * 点击地面观察点标识的判定范围
+     * @description
+     * 如果在判定范围内则确定去到目标点，
+     * 否则寻找点击位置方向最适合的点（可能会走到一个离相机更近的点）。
+     */
+    panoTapTriggerRadius?: number;
+    /** 地面观察点标识自定义创建器 */
+    panoCircleMeshCreator?: (observer: WorkObserver, options: {
+        aerialObserverMinHeight: number;
+    }) => PanoCircleMeshInterface;
+    /** 基于模型调整 地面观察点 的位置 */
+    adjustPanoCircleMeshPositionBasedOnModel?: boolean;
+    /**
+     * 全景瓦片登记
+     * @param fov - 当前 fov
+     * @param viewSize - 当前绘制区域大小
+     * @returns 返回瓦片等级
+     */
+    tileLevelForFov?: false | ((fov: number, viewSize: THREE.Vector2) => number);
+    /** 全景进入渐变时长 单位秒 */
+    tileAppearDuration?: number;
+    /** 全景瓦片并发数 */
+    tileMaxRequest?: number;
+    /** 是否使用深度信息干预全景图着色 */
+    flyEffectUseDepthBuffer?: boolean;
+}
+declare const defaultPanoramaControllerCustomInitArgs: Required<PanoramaControllerCustomInitArgs>;
+type PanoramaControllerInitArgs = BaseControllerInitArgs & PanoramaControllerCustomInitArgs;
+declare class PanoramaController extends PanoramaLikeController implements Required<PanoramaControllerInitArgs> {
+    maxAccessibleDistance: number;
+    panoTapTriggerRadius: number;
+    panoCircleMeshCreator: (observer: WorkObserver, options: {
+        aerialObserverMinHeight: number;
+    }) => PanoCircleMeshInterface;
+    adjustPanoCircleMeshPositionBasedOnModel: boolean;
+    adjustPanoCircleMeshPositionFix: Map<PanoId, THREE.Vector4>;
+    tileLevelForFov: false | ((fov: number, viewSize: THREE.Vector2) => number);
+    tileAppearDuration: number;
+    tileMaxRequest: number;
+    flyEffectUseDepthBuffer: boolean;
+    locationMotion: LocationMotion;
+    perspToOrthoMotion: PerspToOrthoMotion;
+    modelAlphaMotion: ModelAlphaMotion;
+    tiling: Tiling;
+    protected textureLoader: TextureLoader;
+    protected panoMeshes: Map<PanoId, PanoCircleMeshInterface>;
+    protected initAnimationed: boolean;
+    protected accessibleObserverFloorCheckCount: number;
+    protected pano0DepthCubeRenderTarget?: THREE.WebGLCubeRenderTarget;
+    protected pano1DepthCubeRenderTarget?: THREE.WebGLCubeRenderTarget;
+    protected pendingTextureTask?: {
+        panoId: PanoId;
+        hash: string;
+        onLoad(colorResponse: NetworkResponse<THREE.Texture, NetWorkMeta[]>): void;
+        onError(error: Error): void;
+    };
+    protected panoVideo: PanoVideo;
+    protected panoResources: {
+        [key: string]: PanoResource;
+    };
+    protected panoPictureObserverMap: WeakMap<PBMPanoPicture, WorkObserver>;
+    static parseArgs(args: PanoramaControllerInitArgs): Required<PanoramaControllerInitArgs>;
+    static initAnimationEndState(args: PanoramaControllerInitArgs): State;
+    constructor(args: PanoramaControllerInitArgs);
+    get tileLevel(): number;
+    updateConfiguration(args: PanoramaControllerCustomInitArgs): boolean;
+    /** controller 销毁 */
+    destroy(): void;
+    /** 是否准备好，即不在用户操作中，并且不再动画中 */
+    isReady(): boolean;
+    isTileReady(): boolean;
+    /** 动态更新 work */
+    updateWork(works: Works, state: Partial<State>, options: {
+        duration: number;
+        effect: MovePanoEffect;
+    }, userAction: boolean): boolean;
+    /** 更新模型 */
+    updateModel(modelScene: ModelScene): void;
+    /** 时间迭代 */
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
+    /** 获取目标姿态 */
+    getTargetState(): State;
+    /** 移动点位 */
+    moveToPano(pano: Pano, options: MovePanoOptions, userAction: boolean): void;
+    /** 初始化动画 */
+    protected initAnimation(): Promise<void>;
+    /**
+     * 获取 locationMotion.keyframe 中存储的 panoResource
+     * @param keyframe
+     * @returns
+     */
+    protected panoResourceFromLocationMotionKeyframe(keyframe: LocationMotion["keyframes"][number]): PanoResource;
+    /**
+     * 计算 locationMotion.keyframes 中的整体距离总合的长度
+     * @param keyframes
+     * @returns
+     */
+    protected locationMotionKeyframesLength(keyframes: LocationMotion["keyframes"]): number;
+    /** 移动相机 */
+    protected doMoveToPano(pano: Pano, panoResource: PanoResource, options?: MovePanoOptions): void;
+    /**
+     * 方向射线上寻找下一个目标点位
+     * @param raycaster - 方向射线
+     * @returns 方向射线上寻找下一个目标点位
+     */
+    protected getForwardObserverOrNot(camera: THREE.Camera, raycaster?: THREE.Raycaster): WorkObserver | null;
+    /** 触摸 点击屏幕 */
+    protected onTapGesture(event: GestureEvent): void;
+}
+export { LocationMotion, ModelAlphaMotion, PerspToOrthoMotion, PanoramaController, PanoramaControllerInitArgs, PanoramaControllerCustomInitArgs, defaultPanoramaControllerCustomInitArgs, defaultEffectEase, adjustPanoCircleMeshVectors, };

package/five/controllers/panoramaLike.d.ts

@@ -0,0 +1,87 @@
+import { BaseController, BaseControllerInitArgs } from "./base";
+import { IntersectMeshInterface } from "../types/intersectMeshInterface";
+import { State } from "../types/state";
+import { GestureEvent } from "../utils/event";
+import { MovePanoOptions } from "../types/movePanoOptions";
+interface PanoramaLikeControllerCustomInitArgs {
+    /** 默认相机俯仰角 */
+    defaultLatitude?: number;
+    /** 最大相机俯仰角 */
+    maxLatitude?: number | ((fov: number) => number);
+    /** 最小相机俯仰角 */
+    minLatitude?: number | ((fov: number) => number);
+    /** 默认相机可视角度（垂直），可作为 `zoom` */
+    defaultFov?: number;
+    /** 最大默认相机可视角度（垂直） */
+    maxFov?: number;
+    /** 最小默认相机可视角度（垂直） */
+    minFov?: number;
+    /**
+     * 点位间移动动画速度 单位 m/s
+     * @description
+     * 这边设置的是速度，整体耗时会通过距离除速度计算得到
+     */
+    moveSpeed?: number;
+    /** 鼠标焦点环自定义创建器 */
+    intersectMeshCreator?: () => IntersectMeshInterface;
+    /** 航拍点最小高度 */
+    aerialObserverMinHeight?: number;
+}
+declare const defaultPanoramaLikeControllerCustomInitArgs: Required<PanoramaLikeControllerCustomInitArgs>;
+type PanoramaLikeControllerInitArgs = BaseControllerInitArgs & PanoramaLikeControllerCustomInitArgs;
+declare class PanoramaLikeController extends BaseController implements Required<PanoramaLikeControllerInitArgs> {
+    maxLatitude: number | ((fov: number) => number);
+    minLatitude: number | ((fov: number) => number);
+    maxFov: number;
+    minFov: number;
+    defaultLatitude: number;
+    defaultFov: number;
+    moveSpeed: number;
+    intersectMeshCreator: () => IntersectMeshInterface;
+    aerialObserverMinHeight: number;
+    protected intersectMesh: IntersectMeshInterface;
+    protected pinchState?: {
+        x: number;
+        y: number;
+        fov: number;
+    };
+    static parseArgs(args: PanoramaLikeControllerInitArgs): Required<PanoramaLikeControllerInitArgs>;
+    static initAnimationEndState(args: PanoramaLikeControllerInitArgs): State;
+    constructor(args: PanoramaLikeControllerInitArgs);
+    /** 动态更新配置 */
+    updateConfiguration(args: PanoramaLikeControllerCustomInitArgs): boolean;
+    /** 析构函数 */
+    destroy(): void;
+    /** 是否准备好，即不在用户操作中，并且不再动画中 */
+    isReady(): boolean;
+    /** 计算动画时间 */
+    protected calculateMovingDuration(duration: MovePanoOptions["duration"], distance: number): number;
+    /** 隐藏焦点环 */
+    protected hideIntersectMesh(): void;
+    /** 计算 屏幕像素 offset 与 转动间的关系 */
+    protected coordinatesForOffset(offset: {
+        x: number;
+        y: number;
+    }): {
+        longitude: number;
+        latitude: number;
+    };
+    /** 相机拉风箱 */
+    protected cameraBounce(): void;
+    /** 惯性转动镜头 */
+    protected requestMomentumMovement(event: GestureEvent, isFirst: boolean, velocity: {
+        longitude: number;
+        latitude: number;
+    }, duration: number): void;
+    /** 触摸 Pan 事件，相机转动 */
+    protected onPanGesture(event: GestureEvent): void;
+    /** 触摸 Pinch 事件， 相机缩放 */
+    protected onPinchGesture(event: GestureEvent): void;
+    /** 鼠标滚轮事件 相机缩放 */
+    protected onMouseWheel(event: GestureEvent): void;
+    /** 鼠标移动事件 展示交点环 */
+    protected onMouseMove(event: GestureEvent): void;
+    /** 触摸 双点屏幕 */
+    protected onDblTapGesture(event: GestureEvent): void;
+}
+export { PanoramaLikeController, PanoramaLikeControllerInitArgs, PanoramaLikeControllerCustomInitArgs, defaultPanoramaLikeControllerCustomInitArgs, };

package/five/controllers/topview.d.ts

@@ -0,0 +1,42 @@
+import { State } from "../types/state";
+import { Pose } from "../types/pose";
+import { GestureEvent } from "../utils/event";
+import { BaseControllerInitArgs } from "./base";
+import { ModelScene } from "../model";
+import { FloorplanController, FloorplanControllerCustomInitArgs, FloorplanControllerInitArgs } from "./floorplan";
+interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
+declare const defaultTopviewControllerCustomInitArgs: Required<TopviewControllerCustomInitArgs>;
+type TopviewControllerInitArgs = BaseControllerInitArgs & TopviewControllerCustomInitArgs;
+declare class TopviewController extends FloorplanController implements Required<TopviewControllerInitArgs> {
+    static parseArgs(args: TopviewControllerInitArgs): Required<FloorplanControllerInitArgs>;
+    static initAnimationEndState(args: TopviewControllerInitArgs): State;
+    constructor(args: TopviewControllerInitArgs);
+    updateConfiguration(args: FloorplanControllerCustomInitArgs): boolean;
+    /**
+     * 更新模型
+     * @param model - 模型
+     */
+    updateModel(modelScene: ModelScene): void;
+    /** 转动摄像头 */
+    updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
+    /** 通过帧动画转动摄像头 */
+    updateCameraWithKeyframes(keyframes: {
+        progress: number;
+        value: Pose;
+        key?: string;
+    }[], duration: number, userAction: boolean): Promise<void>;
+    /**
+     * 初始化动画
+     */
+    protected initAnimation(): Promise<void>;
+    /** 惯性滚动 */
+    protected requestMomentumMovement(): void;
+    /** 触摸 Pan 事件，相机转动 */
+    protected onPanGesture(event: GestureEvent): void;
+    /** 触摸 Pinch 事件， 相机缩放 */
+    protected onPinchGesture(event: GestureEvent): void;
+    /** 鼠标滚轮事件 相机缩放 */
+    protected onMouseWheel(event: GestureEvent): void;
+}
+export { TopviewController, TopviewControllerInitArgs, TopviewControllerCustomInitArgs, defaultTopviewControllerCustomInitArgs, };

package/five/controllers/vrPanorama.d.ts

@@ -0,0 +1,56 @@
+import { CameraPose } from "../core/camera";
+import { Cardboard } from "../cardboard";
+import { State } from "../types/state";
+import { Pose } from "../types/pose";
+import { BaseControllerInitArgs } from "./base";
+import { PanoramaController, PanoramaControllerCustomInitArgs, PanoramaControllerInitArgs } from "./panorama";
+import { PanoCircleMeshInterface } from "../types/panoCircleMeshInterface";
+interface VRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
+declare const defaultVRPanoramaControllerCustomInitArgs: Required<VRPanoramaControllerCustomInitArgs>;
+type VRPanoramaControllerInitArgs = BaseControllerInitArgs & VRPanoramaControllerCustomInitArgs;
+declare class VRPanoramaController extends PanoramaController implements Required<VRPanoramaControllerInitArgs> {
+    protected cardboard: Cardboard;
+    protected helperElement?: HTMLElement;
+    protected activePanoMesh?: PanoCircleMeshInterface;
+    protected activeTime?: number;
+    static parseArgs(args: VRPanoramaControllerInitArgs): Required<PanoramaControllerInitArgs>;
+    static initAnimationEndState(args: VRPanoramaControllerInitArgs): State;
+    constructor(args: VRPanoramaControllerInitArgs);
+    updateConfiguration(args: VRPanoramaControllerCustomInitArgs): boolean;
+    /** 析构函数 */
+    destroy(): void;
+    /** 是否准备好，即不在用户操作中，并且不再动画中 */
+    isReady(): boolean;
+    /** 生命周期： 更新屏幕渲染尺寸 */
+    updateRenderSize(): void;
+    /** 转动摄像头 */
+    updateCamera(pose: Partial<Pose>, duration: number, userAction: boolean): Promise<void>;
+    /** 通过帧动画转动摄像头 */
+    updateCameraWithKeyframes(keyframes: {
+        progress: number;
+        value: Pose;
+        key?: string;
+    }[], duration: number, userAction: boolean): Promise<void>;
+    /** 时间迭代 */
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
+    /** 生命周期 渲染 */
+    render(): boolean;
+    /**
+     * 同步修改相机参数
+     * @param cameraPose
+     */
+    protected setCamera(cameraPose?: Partial<CameraPose>): void;
+    /** 删除提示层 */
+    protected destroyHelper(): void;
+    /** 设置提示层大小 */
+    protected updateHelperElementSize(): void;
+    /** 计算看向方向的射线碰撞 */
+    protected intersect(time: number): PanoCircleMeshInterface | undefined;
+    protected onPanGesture(): void;
+    protected onTapGesture(): void;
+    protected onPinchGesture(): void;
+    protected onMouseMove(): void;
+    protected onMouseOut(): void;
+}
+export { VRPanoramaController, VRPanoramaControllerInitArgs, VRPanoramaControllerCustomInitArgs, defaultVRPanoramaControllerCustomInitArgs, };