@realsee/five 5.0.0-alpha.15 → 5.0.0-alpha.150

package/five/index.d.ts

@@ -0,0 +1,2922 @@
+import Matrix3 from '@math.gl/core/dist/esm/classes/matrix3';
+import Matrix4 from '@math.gl/core/dist/esm/classes/matrix4';
+import Quaternion from '@math.gl/core/dist/esm/classes/quaternion';
+import * as THREE_2 from 'three';
+import Vector3 from '@math.gl/core/dist/esm/classes/vector3';
+
+export declare interface AddableObject extends THREE_2.Object3D {
+    needsPerToOrt?: boolean;
+    needsRender?: boolean;
+    mixer?: THREE_2.AnimationMixer;
+    setResolution?(width: number, height: number): void;
+}
+
+export declare interface AnimationFrame {
+    callback: (time: number, deltaTime: number, ...args: any[]) => void;
+    once: boolean;
+    delay: number;
+    order: number;
+}
+
+export declare class AnimationFrameLoop {
+    private frames;
+    private time;
+    private stoped;
+    private context?;
+    private requestId;
+    private static sharedInstance?;
+    static get shared(): AnimationFrameLoop;
+    static getFrameTime(): number;
+    constructor();
+    private loop;
+    setContext(context: any): void;
+    getContext(): any;
+    private requestAnimationFrame;
+    private cancelAnimationFrame;
+    private remove;
+    /**
+     * 添加到动画循环
+     * @param callback - 动画循环回调
+     * @param once - 是否只回调一次
+     * @param delay - 延迟多少个动画循环回调
+     * @param order - 优先级，数字越小越早被调用
+     * @returns 移除动画循环函数
+     */
+    add(callback: AnimationFrame["callback"], once?: boolean, delay?: number, order?: number): () => void;
+    disponse(): void;
+}
+
+export declare class BVH {
+    trianglesArray?: Float32Array;
+    offsetArray?: Uint32Array;
+    rootNode?: BVHNode;
+    create(trianglesArray: Float32Array): this;
+    splitNode(maxTrianglesPerNode: number): this;
+    /**
+     * 计算射线与三角形的碰撞
+     * @param rayOrigin - 射线的原点坐标
+     * @param rayDirection - 设想的方向向量
+     * @param backfaceCulling - 是否背面剔除
+     * @return 碰撞焦点数组
+     */
+    intersectRay(rayOrigin: BVHVector3, rayDirection: BVHVector3, backfaceCulling: boolean): BVHIntersect[];
+    dispose(): void;
+}
+
+export declare class BVHIntersect {
+    triangle: [BVHVector3, BVHVector3, BVHVector3];
+    intersectionPoint: BVHVector3;
+    constructor(triangle: [BVHVector3, BVHVector3, BVHVector3], intersectionPoint: BVHVector3);
+}
+
+/**
+ * A node in the BVH structure
+ * @param extents - the min coords of this node's bounding box
+ * @param startIndex - an index in the bbox array, where the first element of this node is located
+ * @param endIndex - an index in the bbox array, where the last of this node is located, plus 1 (meaning that its non-inclusive).
+ * @param level - distance of this node from the root for the bvh tree. root node has level=0, its children have level=1 etc.
+ */
+export declare class BVHNode {
+    extents: ArrayLike<number>;
+    startIndex: number;
+    endIndex: number;
+    node0?: BVHNode;
+    node1?: BVHNode;
+    constructor(extents: ArrayLike<number>, startIndex: number, endIndex: number);
+}
+
+export declare class BVHVector3 {
+    x: number;
+    y: number;
+    z: number;
+    constructor(x: number, y: number, z: number);
+    copy(v: BVHVector3): this;
+    set(x: number, y: number, z: number): this;
+    fromArray(array: number[], firstElementPos?: number): this;
+    add(v: BVHVector3): this;
+    multiplyScalar(scalar: number): this;
+    subVectors(a: BVHVector3, b: BVHVector3): this;
+    dot(v: BVHVector3): number;
+    cross(v: BVHVector3): this;
+    crossVectors(a: BVHVector3, b: BVHVector3): this;
+    clone(): BVHVector3;
+}
+
+/** Five 相机 */
+export declare class Camera extends THREE_2.PerspectiveCamera {
+    /** 相机姿态 */
+    pose: CameraPose;
+    constructor(fov: number);
+    /** 通过相机参数反算姿态 */
+    computePose(): this;
+    /** 设置相机姿态 */
+    setFromPose(pose: Partial<CameraPose>): this;
+    /** 拷贝相机姿态 */
+    copyPose(): CameraPose;
+}
+
+export declare interface CameraPose {
+    longitude: number;
+    latitude: number;
+    fov: number;
+    distance: number;
+    offset: THREE_2.Vector3;
+}
+
+export declare class Clipper {
+    numPlanes: number;
+    clipperPlanes: Float32Array | null;
+    clipperFloors: number[] | null;
+    private static sharedInstance?;
+    static get shared(): Clipper;
+    constructor();
+    update(clipperParameter: ClipperParameter | ClipperParameter[], camera: THREE_2.Camera): void;
+    private projectPlanes;
+}
+
+export declare interface ClipperParameter {
+    clippingBoxMatrix: THREE_2.Matrix4;
+    floorIndex?: number;
+}
+
+export declare type ControllerCustomInitTypes = {
+    Floorplan: FloorplanControllerCustomInitArgs;
+    Topview: TopviewControllerCustomInitArgs;
+    Panorama: PanoramaControllerCustomInitArgs;
+    VRPanorama: VRPanoramaControllerCustomInitArgs;
+    Model: ModelControllerCustomInitArgs;
+    DepthPanorama: DepthPanoramaControllerCustomInitArgs;
+    Mapview: MapviewControllerCustomInitArgs;
+    XRPanorama: XRPanoramaControllerCustomInitArgs;
+};
+
+export declare type ControllerEventTypes = {
+    /**
+     * 模态间切换动画开始
+     * @param panoIndex - 当前点位
+     * @param pose - 相机姿态
+     * @param userAction - 是否用户触发
+     */
+    initAnimationWillStart(panoIndex: number, pose: Pose, userAction: boolean): void;
+    /**
+     * 模态间切换动画结束
+     * @param panoIndex - 当前点位
+     * @param pose - 相机姿态
+     * @param userAction - 是否用户触发
+     */
+    initAnimationEnded(panoIndex: number, pose: Pose, userAction: boolean): void;
+    /**
+     * 意图要变化相机的可视角度 可以通过 `return false` 阻止
+     * @deprecated
+     * 建议通过 初始化设置的 `defaultFov`, `maxFov`, `minFov` 来限制
+     * @param fov - 意图要变化相机的可视角度
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsChangeCameraFov(fov: number): void | false;
+    /**
+     * 相机姿态变化
+     * @param pose - 相机姿态
+     * @param userAction - 是否用户触发
+     */
+    cameraUpdate(pose: Pose, userAction: boolean): void;
+    /**
+     * 相机姿态中可视角度变化
+     * @param fov - 相机的可视角度
+     * @param userAction - 是否用户触发
+     */
+    cameraFovUpdate(fov: Pose["fov"], userAction: boolean): void;
+    /**
+     * 相机姿态中相机位置变化
+     * @param offset - 相机位置
+     * @param userAction - 是否用户触发
+     */
+    cameraPositionUpdate(offset: Pose["offset"], userAction: boolean): void;
+    /**
+     * 相机姿态中相机方向变化
+     * @param coordinates - 相机姿态的俯仰角和偏航角
+     * @param userAction - 是否用户触发
+     */
+    cameraDirectionUpdate(coordinates: Pick<Pose, "longitude" | "latitude">, userAction: boolean): void;
+    /**
+     * 观察点位被选择
+     * @param panoIndex - 选择的点位
+     */
+    panoSelected(panoIndex: number | null): void;
+    /**
+     * 意图要移动到某个点位 可以通过 `return false` 阻止
+     * @param panoIndex - 图要移动到的点位下标
+     * @param options - 移动参数
+     * @param userAction - 是否用户触发
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsMoveToPano(panoIndex: number, options: MovePanoOptions, userAction: boolean): void | false;
+    /**
+     * 开始加载并移动到某个观察点位
+     * @description
+     * 可 panoWillArrive 相比
+     * - moveToPano 在加载全景图资源前触发
+     * - panoWillArrive 在加载全景图资源后触发
+     * @param panoIndex - 移动到的点位下标
+     * @param userAction - 是否用户触发
+     */
+    moveToPano(panoIndex: number, userAction: boolean): void;
+    /**
+     * 开始加载某个观察点的全景资源
+     * @param panoIndex - 移动到的点位下标
+     */
+    panoWillLoad(panoIndex: number): void;
+    /**
+     * 某个观察点的全景资源加载完成
+     * @param panoIndex - 对应的点位下标
+     */
+    panoLoaded(panoIndex: number): void;
+    /**
+     * 某个观察点的全景资源加载失败
+     * @param error - 错误对象
+     * @param panoIndex - 对应的点位下标
+     */
+    panoLoadError(error: Error, panoIndex: number): void;
+    /**
+     * 移动到某个观察点位被取消
+     * @description
+     * 这个有一些情况会导致
+     * - 移动过程中切换模态
+     * - 移动过程中 five 被析构
+     * - 移动过程点击切换到另一个点位
+     * @param panoIndex - 对应的点位下标
+     */
+    moveToPanoCanceled(panoIndex: number): void;
+    /**
+     * 开始移动到某个观察点位
+     * @description
+     * 和 moveToPano 相比
+     * - moveToPano 在加载全景图资源前触发
+     * - panoWillArrive 在加载全景图资源后触发
+     * @param panoIndex - 移动到点位下标
+     * @param pose - 相机姿态
+     * @param userAction - 是否用户触发
+     */
+    panoWillArrive(panoIndex: number, pose: Pose, userAction: boolean): void;
+    /**
+     * 移动到某个观察点位
+     * @param panoIndex - 移动到点位下标
+     * @param pose - 相机姿态
+     * @param userAction - 是否用户触发
+     */
+    panoArrived(panoIndex: number, pose: Pose, userAction: boolean): void;
+    /**
+     * 移动中， 会告知移动状态（耗时百分比）
+     * @param panoIndex - 将要移动到的点位下标
+     * @param prevPanoIndex - 上一个点位下标
+     * @param progress - 整个过程经度 [0-1]
+     */
+    movingToPano(panoIndex: number, prevPanoIndex: number, progress: number): void;
+    /**
+     * 意图要触发手势， 可以通过 `return false` 阻止
+     * @param type - 手势类型
+     * @param pointers - 手指位置
+     * @param final - 是否手势结束
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsGesture(type: GestureTypes, pointers: {
+        x: number;
+        y: number;
+        delta?: number;
+    }[], final: boolean): void | false;
+    /**
+     * 手势 触发
+     * @param type - 手势类型
+     * @param pointers - 手指位置
+     * @param final - 是否手势结束
+     */
+    gesture(type: GestureTypes, pointers: {
+        x: number;
+        y: number;
+        delta?: number;
+    }[], final: boolean): void;
+    /**
+     * 意图要触发 pan 手势(滑动屏幕)， 可以通过 `return false` 阻止
+     * @param pose - 意图的相机姿态
+     * @param final - 是否手势结束
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsPanGesture(pose: Pose, final: boolean): void | false;
+    /**
+     * pan 手势(滑动屏幕) 被触发
+     * @param pose - 相机姿态
+     * @param final - 是否手势结束
+     */
+    panGesture(pose: Pose, final: boolean): void;
+    /**
+     * 意图要触发 pan 手势(滑动屏幕) 的惯性运动, 可以通过 `return false` 阻止
+     * @param pose - 意图的相机姿态
+     * @param final - 是否手势结束
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsInteriaPan(pose: Pose): void | false;
+    /**
+     * pan 手势(滑动屏幕) 的惯性运动
+     * @param pose - 意图的相机姿态
+     * @param final - 是否手势结束
+     */
+    interiaPan(pose: Pose, final: boolean): void;
+    /**
+     * 意图要触发 tap 手势(点击屏幕)， 可以通过 `return false` 阻止
+     * @param raycaster - 点击对应的三维射线
+     * @param tapPosition - 点击对应的屏幕位置
+     * @param final - 是否手势结束
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsTapGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, final: boolean): void | false;
+    /**
+     * tap 手势(点击屏幕) 被触发
+     * @param raycaster - 点击对应的三维射线
+     * @param tapPosition - 点击对应的屏幕位置
+     * @param final - 是否手势结束
+     */
+    tapGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, final: boolean): void;
+    /**
+     * 意图要触发 pinch 手势(双指缩放)，可以通过 `return false` 阻止
+     * @param scale - 缩放数值
+     * @param nextFov - 意图的fov变更
+     * @param final - 是否手势结束
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsPinchGesture(scale: number, nextFov: number, final: boolean): void | false;
+    /**
+     * 意图要触发 press 手势(长按屏幕)， 可以通过 `return false` 阻止
+     * @param raycaster - 长按对应的三维射线
+     * @param tapPosition - 长按对应的屏幕位置
+     * @param duration - 长按持续时间
+     * @param final - 是否手势结束
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsPressGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, duration: number, isFinal: boolean): void | false;
+    /**
+     * tap 手势(点击屏幕) 被触发
+     * @param raycaster - 点击对应的三维射线
+     * @param tapPosition - 点击对应的屏幕位置
+     * @param duration - 长按持续时间
+     * @param final - 是否手势结束
+     */
+    pressGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, duration: number, isFinal: boolean): void;
+    /**
+     * pinch 手势(双指缩放) 被触发
+     * @param scale - 缩放数值
+     * @param nextFov - 意图的fov变更
+     * @param final - 是否手势结束
+     */
+    pinchGesture(scale: number, fov: number, final: boolean): void;
+    /**
+     * 意图要触发 鼠标滚轮 可以通过 `return false` 阻止
+     * @param delta - 滚轮数值
+     * @param nextFov - 意图的fov变更
+     * @param final - 是否手势结束
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsMouseWheel(delta: number, nextFov: number, final: boolean): void | false;
+    /**
+     * 鼠标滚轮被触发
+     * @param delta - 滚轮数值
+     * @param nextFov - 意图的fov变更
+     * @param final - 是否手势结束
+     */
+    mouseWheel(delta: number, fov: number, final: boolean): void;
+    /**
+     * 鼠标焦点环位置被重新计算
+     * @param intersection - 焦点碰撞结果
+     * @param mesh - 焦点环 mesh
+     */
+    intersectionOnModelUpdate(intersection: Intersection, mesh: IntersectMeshInterface): void;
+    /**
+     * 意图要展示鼠标焦点环，可以通过 `return false` 阻止
+     * @param intersection - 焦点碰撞结果
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsShowIntersectionOnModel(raycaster: THREE_2.Raycaster): void | false;
+    /** 鼠标焦点环被隐藏 */
+    intersectionHidden(): void;
+    /** 意图要退出VR眼镜模式 */
+    vrWantsToExit(): void;
+    /**
+     * 观察点的全景资源开始加载
+     * @param panoIndex - 加载点位下标
+     * @param observer - 对应的 observer 详情
+     */
+    textureStartLoad(panoIndex: number, observer: WorkObserver): void;
+    /**
+     * 观察点的全景资源加载中，可获取到进度
+     * @param progress - 加载进度 [0-1]
+     * @param panoIndex - 加载点位下标
+     * @param observer - 对应的 observer 详情
+     */
+    textureLoading(progress: number, panoIndex: number, observer: WorkObserver): void;
+    /**
+     * 观察点的全景资源加载被中止
+     * @param panoIndex - 加载点位下标
+     * @param observer - 对应的 observer 详情
+     */
+    textureAbort(panoIndex: number, observer: WorkObserver): void;
+    /**
+     * 观察点的全景资源加载失败
+     * @param error - 错误对象
+     * @param panoIndex - 加载点位下标
+     * @param observer - 对应的 observer 详情
+     */
+    textureError(error: Error, panoIndex: number, observer: WorkObserver): void;
+    /**
+     * 观察点的全景资源加载完成
+     * @param panoIndex - 加载点位下标
+     * @param observer - 对应的 observer 详情
+     */
+    textureLoaded(panoIndex: number, observer: WorkObserver, meta: (NetWorkMeta | null)[]): void;
+    /**
+     * 抛出错误
+     * @param error - 抛出错误
+     */
+    error(error: Error): void;
+    /**
+     * webXR模式开始，webxr session完成坐标系矫正
+     */
+    webXRSessionStart(): void;
+    /**
+     * webXR模式结束,webxr session销毁
+     */
+    webXRSessionEnd(): void;
+    /**
+     * webXR模式结束,webxr session销毁
+     */
+    webXRSelected(type: WebXRSelectType): void;
+};
+
+/**
+ * URL 地址的转换
+ * @param source - url 原地址
+ * @param options - url 转换参数
+ * @returns url 转换结果
+ */
+export declare function defaultImageURLTransform(source: string, options: ImageURLOptions): string;
+
+export declare interface DepthPanoramaControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
+    /** 最远可移动观察点距离 */
+    maxAccessibleDistance?: number;
+    /**
+     * 点击地面观察点标识的判定范围
+     * @description
+     * 如果在判定范围内则确定去到目标点，
+     * 否则寻找点击位置方向最适合的点（可能会走到一个离相机更近的点）。
+     */
+    panoTapTriggerRadius?: number;
+    /** 地面观察点标识自定义创建器 */
+    panoCircleMeshCreator?: () => PanoCircleMeshInterface;
+}
+
+/**
+ * Five 事件列表
+ * @description
+ * 可以通过 `five.on(METHOD_NAME, METHOD)` 调用
+ */
+export declare interface EventCallback extends EventTypes {
+}
+
+/**
+ * Five 事件列表
+ * @description
+ * 具体事件列表 请查看 {@link EventCallback}
+ */
+export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROLLER_EVENT_NAMES[number]> & {
+    /**
+     * 内部错误
+     * @param error - 错误对象
+     */
+    error(error: Error): void;
+    /**
+     * 准备加载 Work 数据
+     * @param input - 输入的 work
+     * @param work - 归一化的标准 work
+     * @param state - 加载时的姿态
+     */
+    willLoad(input: any, work: Work, state: Omit<State, "offset" | "distance">): void;
+    /**
+     * 开始加载 Work 数据
+     * @param input - 输入的 work
+     * @param work - 归一化的标准 work
+     * @param state - 加载时的姿态
+     */
+    load(input: any, work: Work, state: Omit<State, "offset" | "distance">): void;
+    /**
+     * 加载完 Work 数据
+     * @param input - 输入的 work
+     * @param work - 归一化的标准 work
+     */
+    loaded(input: any, work: Work): void;
+    /**
+     * 模型开始加载
+     * @param workModel - 归一化的标准 work 中的 model 值
+     */
+    modelWillLoad(workModel: WorkModel): void;
+    /**
+     * 模型三角面片结构加载完成
+     * @param model - 加载完的 model 本质是一个 {@link PBMGroup}
+     */
+    modelGeometryLoaded(model: Model): void;
+    /**
+     * 模型材质结构加载完成
+     * @param model - 加载完的 model 本质是一个 {@link PBMGroup}
+     */
+    modelMaterialLoaded(model: Model): void;
+    /**
+     * 模型 bvh树 计算完成
+     * @description
+     * bvh 树用于高效的碰撞检测，可以在 `model.bvh` 属性来设置是否开启。默认开启。
+     * bvh 树计算需要一定事件，可能会暂时影响一些性能。计算完毕后，会对碰撞检测带来质的提升。
+     * @param model - 加载完的 model 本质是一个 {@link PBMGroup}
+     */
+    modelBvhLoaded(model: Model): void;
+    /**
+     * 模型加载错误
+     * @param error - 错误对象
+     * @param model - 加载完的 model 本质是一个 {@link PBMGroup}
+     */
+    modelLoadError(error: Error, model: Model): void;
+    /**
+     * 模型加载完成
+     * @param model - 加载完的 model 本质是一个 {@link PBMGroup}
+     */
+    modelLoaded(model: Model): void;
+    /**
+     * 模型楼层切换
+     * @param shownFloor - 模型楼层
+     */
+    modelShownFloorChange(shownFloor: number | null, totalFloorLength: number): void;
+    /**
+     * 渲染循环
+     * @param rendered - 是否渲染了
+     */
+    renderFrame(rendered: boolean): void;
+    /**
+     * 当前 fps 变化
+     * @param fps - 当前刷新率
+     */
+    fps(fps: number): void;
+    /**
+     * 当目标 state 变化时
+     * @param state - 当前姿态状态
+     * @param userAction - 是否用户触发
+     */
+    stateChange(state: State, userAction: boolean): void;
+    /**
+     * 当前实时 state 变化时
+     * @param state - 当前姿态状态
+     * @param userAction - 是否用户触发
+     */
+    currentStateChange(state: State, userAction: boolean): void;
+    /**
+     * 当 setState 方法被调用
+     * @param state - 当前姿态状态
+     */
+    setState(state: State): void;
+    /**
+     * 当 state 被同步完成时
+     * @param state - 当前姿态状态
+     */
+    stateSynced(state: State): void;
+    /**
+     * 意图要移动到某个点时, 可以通过 return false 阻止
+     * @param panoIndex - 意图要移动到点位下标
+     * @param options - 移动参数
+     * @param userAction - 是否用户触发
+     * @returns 可以通过 return false 阻止
+     */
+    wantsMoveToPano(panoIndex: number, options: MovePanoOptions, userAction: boolean): void | false;
+    /**
+     * 同 wantsMoveToPano
+     * @description
+     * @param panoIndex - 意图要移动到点位下标
+     * @param options - 移动参数
+     * @param userAction - 是否用户触发
+     * @returns 可以通过 return false 阻止
+     */
+    wantsToMoveToPano(panoIndex: number, options: MovePanoOptions, userAction: boolean): void;
+    /**
+     * 意图要切换到某个模态， 可以通过 return false 阻止
+     * @param mode - 意图要切换到的模态
+     * @param prevMode - 当前模态
+     * @returns 可以通过 return false 阻止
+     */
+    wantsChangeMode(mode: Mode, prevMode: Mode): void | false;
+    /**
+     * 模态切换完成
+     * @param mode - 切换到的模态
+     * @param prevMode - 上本质是一个模态
+     * @param panoIndex - 初始化动画结束后的点位下标
+     * @param toPose - 初始化动画结束后的状态
+     * @param userAction - 是否用户触发
+     */
+    modeChange(mode: Mode, prevMode: Mode, panoIndex: number, toPose: Pose, userAction: boolean): void;
+    /**
+     * 帮助元素显应的变换
+     * @param visible - 帮助元素的是否开启
+     */
+    helpersVisibleChange(visible: boolean): void;
+    /**
+     * 网络资源分析
+     * @param source - 资源地址
+     * @param state - 状态
+     * @param detail - 详情
+     */
+    network(source: string, type: NetworkType, state: NetworkState, detail: string): void;
+    /** five 被析构。 插件中请监听用于自身析构 */
+    dispose(): void;
+};
+
+/**
+ * 如视 VR Web展示器
+ *
+ * @example
+ * ```
+ * // 初始化构造函数
+ * const five = new Five();
+ * // 将绘制区域添加到页面上
+ * five.appendTo(document.body);
+ * // 加载 Work 数据
+ * five.load({...});
+ * ```
+ */
+export declare class Five extends Subscribe<EventTypes> {
+    static get version(): string;
+    /**
+     * Five 的显示模式，可以通过 `five.changeMode` `five.setState` 来切换
+     * @description
+     * ```text
+     * Panorama 全景图游走模式
+     * Model 模型游走模式
+     * Floorplan 模型查看模式
+     * Topview 户型图模式
+     * DepthPanorama 深度图游走模式
+     * VRPanorama VR眼镜模式
+     * XRPanorama VR硬件模式
+     * ```
+     */
+    static Mode: Mirror<Mode>;
+    /**
+     * @deprecated
+     * 请使用 `import { Line } from "@realsee/five/line"` 代替;
+     */
+    static Line: any;
+    /**
+     * 自动播放状态是否暂停
+     * @description
+     * 可以通过 `five.play` `five.pause` 方法播放或暂停
+     */
+    paused: boolean;
+    /** 当前点位序号 */
+    panoIndex?: number;
+    /** 当前展示的模式 */
+    currentMode?: Mode;
+    /** 内部使用的 `THREE.Scene` */
+    scene: Scene;
+    /** 内部使用的产生视差的物体Scene `THREE.Scene` */
+    parallaxScene: Scene;
+    /** 内部使用的 `Camera` */
+    camera: Camera;
+    /**
+     * 当前设置的 `scissor`
+     * @description
+     * 可通过初始化，或者 setScissor 方式设置
+     * `scissor` 是将屏幕中的内容渲染到 `renderer` 的指定区域。
+     * 页面整体长宽均为 `1`。通过类似 css 的 `left` `bottom` `width` `height` 来确定区域。
+     * @example
+     * ```
+     * scissor: { left: 0.75, bottom: 0, width: 0.25, height: 1 }
+     * ```
+     */
+    scissor: Scissor;
+    /**
+     * 当前使用的 THREE.WebGLRenderer。
+     * @description
+     * 如果初始化时传入了 `renderer` 则直接时该值
+     * 否则会通过 `preserveDrawingBuffer` `backgroundColor` `backgroundAlpha` `antialias` 创建一个 `THREE.WebGLRenderer`
+     */
+    renderer?: THREE_2.WebGLRenderer;
+    /** 当前加载的模型 */
+    model: Model;
+    /**
+     * 是否需要渲染
+     * @description
+     * 如果初始化设置了 `onlyRenderIfNeeds: true`, 则会激活按需渲染
+     * 可以通过设置 `five.needsRender = true` 来告知，five 会在下一帧渲染画面。
+     */
+    needsRender: boolean;
+    /**
+     * 全景图的配置参数
+     * @description
+     * 可以动态对配置在 `work` 数据中的全景图片在 runtime 做 url 调整。
+     * 平衡加载时间和图片质量
+     */
+    imageOptions: ImageOptions;
+    /**
+     * 模型贴图的配置参数
+     * @description
+     * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
+     * 平衡加载时间和图片质量
+     */
+    textureOptions: TextureOptions;
+    /**
+     * 模型贴图的配置参数
+     * @description
+     * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
+     * 平衡加载时间和图片质量
+     */
+    videoTexture: THREE_2.VideoTexture;
+    /**
+     * 当前状态
+     * @description
+     * ```text
+     * five 设置了以下状态
+     *
+     * - mode: Mode
+     * - panoIndex: number
+     * - longitude: number
+     * - latitude: number
+     * - fov: number
+     * - offset: THREE.Vector3
+     *
+     * 可以通过 five.state 和 five.setState 来获取和设置。
+     * 通过 state 设置后，five 会通过合适的动画运动来达到设置的位置。
+     * 来迎合一些通过数据驱动的场景。
+     * ```
+     */
+    state: State;
+    /** 插件暴露的方法 */
+    plugins: {
+        [key: string]: FivePluginInstance<any>;
+    };
+    ident: string;
+    private stopAnimationLoop?;
+    private fps;
+    private helperGroup;
+    private modeChangeDuration;
+    private onlyRenderIfNeeds;
+    private poweredByRealsee;
+    private controller?;
+    private destroyed;
+    private stateSynced;
+    private controllerInits;
+    private panoramaLikeSavedPose;
+    private extraElements;
+    private getPixelsRenderTarget;
+    private readyCallbacks;
+    private modelPending;
+    private syncingState;
+    /**
+     * 是否开启 IOS EDR 模式
+     * 需要客户端配合
+     * 并且开启 five.enablepostProcessing = true
+     */
+    private _enableIOSEDR;
+    private lastLoadWorkTask;
+    private requestProxy;
+    private networkSubscribe;
+    private screenBuffer?;
+    private analysis?;
+    private renderSwitch01;
+    /**
+     * gpu_picking
+     */
+    private gpuPickingRenderTarget;
+    private meshReplaceMaterialMap;
+    private meshOriginMaterialMap;
+    constructor(initArgs?: FiveInitArgs);
+    /**
+     * GPU Picking 获取选中的 mesh
+     * @param x - 屏幕坐标 x
+     * @param y - 屏幕坐标 y
+     * @param colorMap - 需要选取的 mesh 的颜色与 uuid 的映射
+     * @param modelColor - 指定的模型颜色
+     * @returns 选中 mesh 的 uuid
+     */
+    getGPUPicking(x: number, y: number, colorMap: {
+        [key: string]: THREE_2.Color;
+    }, pixelRatio?: number, modelColor?: THREE_2.Vector3): string | false;
+    /**
+     * 析构 five 对象。
+     * @description
+     * 一旦调用了析构方法，则不能再使用当前 five 对象了。
+     * 你可以新建一个新的。
+     */
+    dispose(): void;
+    /**
+     * 设置 `scissor`
+     * @param scissor - 指定区域
+     * `scissor` 是将屏幕中的内容渲染到 `renderer` 的指定区域。
+     * 请确保在 five 初始化时传入 `renderer` 对象
+     * 页面整体长宽均为 `1`。通过类似 css 的 `left` `bottom` `width` `height` 来确定区域。
+     * @example
+     * ```
+     * five.setScissor({ left: 0.75, bottom: 0, width: 0.25, height: 1 })
+     * ```
+     */
+    setScissor(scissor: Scissor): void;
+    /**
+     * 帮助元素显示/隐藏
+     */
+    get helperVisible(): boolean;
+    set helperVisible(visible: boolean);
+    /**
+     * 是否开启 IOS EDR 模式
+     * 需要客户端配合
+     * 并且开启 five.enablepostProcessing = true
+     */
+    get enableIOSEDR(): boolean;
+    set enableIOSEDR(enable: boolean);
+    get enablePostProcessing(): boolean;
+    set enablePostProcessing(enable: boolean);
+    updateConfiguration(args: Pick<FiveInitArgs, "panorama" | "model" | "floorplan" | "topview" | "mapview" | "depthPanorama" | "vrPanorama" | "imageOptions">): void;
+    /**
+     * 将显示区域加载到页面 DOM 中
+     * @description
+     * 如果你是传入的 `renderer`. 则你需要自行来方式显示区域该方法并不生效
+     *
+     * @param element - 加载到页面的 DOM 元素
+     * @param size - 显示区域尺寸 默认铺满这个 DOM 元素
+     */
+    appendTo(element: HTMLElement, size?: {
+        width?: number;
+        height?: number;
+    }): void;
+    /**
+     * 设置显示区域尺寸
+     * @description
+     * 如果你是传入的 `renderer`. 则你需要自行来设置显示区域尺寸，该方法并不生效
+     *
+     * @param size - 显示区域尺寸 默认铺满这个 DOM 元素
+     * @param pixelRatio - 像素比 默认继承之前的设置
+     */
+    refresh(size?: {
+        width?: number;
+        height?: number;
+    }, pixelRatio?: number): void;
+    /**
+     * 绑定一个额外 DOM 区域，接受触控/鼠标事件
+     * @returns 解除该绑定
+     */
+    addExtraElement(element: HTMLElement): () => void;
+    /**
+     * 解除绑定的一个额外 DOM 区域
+     */
+    removeExtraElement(element: HTMLElement): void;
+    /**
+     * 获取当前相机姿态, 可以使用 getCurrentState 代替
+     */
+    getPose(): Pose;
+    getSize(target: THREE_2.Vector2): THREE_2.Vector2;
+    getDrawingBufferSize(target: THREE_2.Vector2): THREE_2.Vector2;
+    /**
+     * 移动相机。（不触发点位移动）
+     * @description
+     * 如果动画中途被打断（用户触发行为，或者调用 setState, load, changeMode）的等
+     * 会 Promise.reject。运动完成则 Promise.resolve
+     * @param pose - 相机目标位置
+     * @param duration - 动画触发的时常
+     * @param userAction - 是否用户触发
+     * @returns Promise 是否移动成功
+     */
+    updateCamera(pose: Partial<Omit<Pose, "offset">>, duration: number, userAction?: boolean): Promise<void>;
+    /**
+     * 获取当前相机经纬度
+     * @deprecated 请使用使用 getPose
+     */
+    getLongitudeAndLatitude(): Pick<Pose, "longitude" | "latitude">;
+    /**
+     * 获取当前相机位置
+     * @deprecated 请使用使用 getPose
+     */
+    getOffset(): Pose["offset"];
+    /**
+     * 获取当前相机的姿态（用于内部的 python 脚本截图）
+     * @deprecated 这是用于内部的 python 脚本截图
+     */
+    getCameraLocal(): {
+        theta: number;
+        phi: number;
+        lookAtVector: THREE_2.Vector3;
+    };
+    /**
+     * 初始化 initBasisLoader
+     * @description
+     * 同初始化的 initBasisLoader 参数。用于初始化 basisLoader。
+     * basisLoader 只会初始化一次，一旦初始化则不会再修改。
+     *
+     * @param transcoderResourcePath - basis 解析器路径
+     * 如果不设置，使用默认解析器 basis 解析器。
+     * 可以传入解析器的 `resourcePath`, 则使用指定的解析器
+     * @example
+     * ```
+     * // 使用默认解析器
+     * five.initialBasisLoader();
+     *
+     * // 使用指定解析器
+     * // 会调用这个目录下的 basis_transcoder.js basis_transcoder.wasm 文件作为解析器
+     * five.initialBasisLoader("https://vr-public.realsee-cdn.cn/release/static/image/release/five/basis/");
+     * ```
+     */
+    initBasisLoader(transcoderResourcePath?: string): void;
+    /** 当前加载的 work 数据 */
+    get work(): Work;
+    /**
+     * 加载 Work 数据
+     * @param inputWork - Work 数据
+     * @param state - 初始化姿态
+     *  - "inherit" 使用当前姿态
+     *  - "initial" 使用 Work 数据中的 initial 姿态
+     *  - State 自定义姿态
+     * @param duration - 切换时间
+     */
+    load(inputWork: Work | LooseWork | any | Promise<Work | LooseWork | any>, state?: "inherit" | "initial" | Partial<Omit<State, "offset">>, duration?: number, userAction?: boolean): Promise<void>;
+    private load_;
+    /**
+     * 切换模态
+     * @param mode - 切换到的模态
+     * @param state - 切换完成时的姿态
+     * @param duration - 模态切换动画用时
+     * @param userAction - 是否时用户动作触发 默认 true
+     * @param force - 必须重新初始化 controller
+     */
+    changeMode<T extends Mode>(mode: T, state?: Partial<Omit<State, "mode">>, duration?: number, userAction?: boolean, force?: boolean): Promise<void>;
+    /**
+     * 获取画面中的像素颜色
+     * @param x - 获取像素区域的起始坐标 x
+     * @param y - 获取像素区域的起始坐标 y
+     * @param width - 获取像素区域的宽度
+     * @param height - 获取像素区域的高度
+     * @param pixelRatio - 获取区域的像素比
+     * @returns rgba颜色平铺的 Uint8Array
+     */
+    getPixels(x: number, y: number, width: number, height: number, pixelRatio?: number): Uint8Array;
+    /**
+     * 获取显示用的画布（Canvas DOM节点）
+     */
+    getElement(): HTMLCanvasElement | undefined;
+    /**
+     * 强制渲染
+     * @description
+     * 调用 `five.render()` 和设置 `five.needsRender = true` 均可在按需渲染时，使得画面渲染一次
+     * 区别在于：
+     * - `five.needsRender = true` 为在下帧渲染画面
+     * - `five.render()` 在当前帧渲染画面
+     * 推荐使用 `five.needsRender = true`, 可以更加流畅。但是如果需要截图等同步操作，可以使用 `five.render()`
+     *
+     * @param callback - 渲染完成回调
+     */
+    render(callback?: () => void, updateObjectResolution?: boolean): THREE_2.WebGLRenderTarget;
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
+    /**
+     * 但停自动播放
+     */
+    pause(): void;
+    play(): void;
+    /**
+     * 转化到 Panorama 模态，并移动到对应序号的观察点。
+     * @param panoIndex - 观察点序号
+     * @param options - 移动点位参数
+     * @param userAction - 是否用户触犯
+     */
+    moveToPano(panoIndex: number, options?: MovePanoOptions, userAction?: boolean): Promise<void>;
+    /**
+     * 预加载点位图片资源
+     * @param panoIndex - 观察点序号
+     * @param callback - 加载完成回调, 并传递加载用时。
+     * @returns 加载完成的 Promise 参数同 callback
+     */
+    preloadPano(panoIndex: number, callback?: (costs: number) => void): Promise<number>;
+    /**
+     * 计算三维坐标对应到屏幕的二维坐标
+     * @description
+     * 如果三维坐标不在屏幕中，则返回 null
+     * @param vector - 三维坐标
+     * @param testModel - 是否计算模型遮挡
+     * @returns 二维坐标 或者 null
+     */
+    project2d(vector: THREE_2.Vector3, testModel?: boolean): THREE_2.Vector2 | null;
+    /**
+     * 获取当前在屏幕视锥中的 mesh。
+     * @param object - 如果传入则检查这个对象中的mesh，如果不传，则检查整个 scene
+     */
+    getRenderObjects(object?: THREE_2.Object3D): THREE_2.Object3D[];
+    getCurrentState(): State;
+    /**
+     * 设置 State
+     * @description
+     * ```text
+     * five 设置了以下状态
+     *
+     * - mode: Mode
+     * - panoIndex: number
+     * - longitude: number
+     * - latitude: number
+     * - fov: number
+     * - offset: THREE.Vector3
+     *
+     * 可以通过 five.state 和 five.setState 来获取和设置。
+     * 通过 state 设置后，five 会通过合适的动画运动来达到设置的位置。
+     * 来迎合一些通过数据驱动的场景。
+     * ```
+     * @param state - 目标状态
+     * @param immediately - 是否马上转换，马上转换会尽快达到目标状态，尽量减少中间状态，更少动画。
+     * @param userAction - 是否是用户触发的动作
+     */
+    setState(state: Partial<State>, immediately?: boolean, userAction?: boolean): void;
+    aroundScissor(callback: () => void): void;
+    private syncState;
+    /**
+     * 当前页面静态
+     */
+    ready(args?: {
+        tile?: boolean;
+    }): Promise<void>;
+    /**
+     * 请求全屏
+     */
+    requestFullscreen(): void;
+    /**
+     * 退出全屏
+     */
+    exitFullscreen(): void;
+    private throwError;
+    private loadModel;
+    private commonParams;
+    private saveControllerPose;
+    private applyController;
+    /** 移除事件绑定 */
+    private removeEventListeners;
+    /** 销毁GPU Picking 所用的材质 */
+    private diposeGPUPickingMaterial;
+}
+
+/** Five 初始化参数 */
+export declare interface FiveInitArgs {
+    /**
+     * 外部传入的 `THREE.WebGLRenderer`。
+     * @description
+     * 如果需要使用 `scissor` 分割画布功能，则必须使用外部传入 renderer，
+     * 并且设置为 `preserveDrawingBuffer: false`。
+     * 如果设置了 `renderer`, 则 `preserveDrawingBuffer`
+     * `backgroundColor` `backgroundAlpha` `antialias`
+     * 均不再生效。
+     */
+    renderer?: THREE_2.WebGLRenderer;
+    /**
+     * 内部 `THREE.WebGLRenderer` 是否通过像素拷贝的方式绘制。
+     * @description
+     * 当你想做屏幕截图等要确定取得屏幕像素时，请设置为 `true`。
+     * 如果设置了参数 `renderer` 参数，则不生效，请对传入的 `renderer` 自行设置。
+     * @default `false`
+     */
+    preserveDrawingBuffer?: boolean;
+    /**
+     * 输出画面的背景颜色。
+     * @description
+     * 通过数字类型传入。
+     * 如果设置了参数 `renderer` 参数，则不生效，请对传入的 `renderer` 自行设置。
+     * @default `0x181A1C`
+     * @example
+     * ```
+     * backgroundColor: 0xffffff // 白色
+     * backgroundColor: 0xff0000 // 红色
+     * ```
+     */
+    backgroundColor?: number;
+    /**
+     * 输出画面的背景透明度
+     * @description
+     * 通过数字类型传入。取值范围 [0-1]
+     * 如果设置了参数 `renderer` 参数，则不生效，请对传入的 `renderer` 自行设置。
+     * @default `1`
+     */
+    backgroundAlpha?: number;
+    /**
+     * 是否开启 `THREE.WebGLRenderer` 的抗锯齿功能
+     * @description
+     * 这个抗锯齿功能是 `WEBGL` 自带的抗锯齿，并不是类似 fxaa taa 等后处理方式，比较吃性能。
+     * 如果设置了参数 `renderer` 参数，则不生效，请对传入的 `renderer` 自行设置。
+     * @default `false`
+     */
+    antialias?: boolean;
+    /**
+     * 屏幕渲染区域
+     * @description
+     * 请确保设置了 `renderer` 参数，`scissor` 参数才可生效
+     * `scissor` 是将屏幕中的内容渲染到 `renderer` 的指定区域。
+     * 页面整体长宽均为 `1`。通过类似 css 的 `left` `bottom` `width` `height` 来确定区域。
+     * @example
+     * ```
+     * scissor: { left: 0.75, bottom: 0, width: 0.25, height: 1 }
+     * ```
+     */
+    scissor?: Scissor;
+    /**
+     * 是否自动播放。
+     * @description
+     * 播放即把内存中计算的内容渲染到画面上。play则是进行每帧播放。
+     * 如果 `play: false` 则不自动播放。屏幕不显示。
+     * 你还可以通过 `five.play()` `five.pause()` 的方式来控制播放。
+     * @default `true`
+     */
+    play?: boolean;
+    /**
+     * 全景图的配置参数
+     * @description
+     * 可以动态对配置在 `work` 数据中的全景图片在 runtime 做 url 调整。
+     * 平衡加载时间和图片质量
+     */
+    imageOptions?: ImageOptions;
+    /**
+     * 模型贴图的配置参数
+     * @description
+     * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
+     * 平衡加载时间和图片质量
+     */
+    textureOptions?: TextureOptions;
+    /**
+     * 是否按需渲染
+     * @description
+     * 按需渲染时，如果页面中的渲染有 `needsRender: true` 属性。或者 `five.needsRender: true` 时
+     * 才会重新渲染屏幕，降低无用渲染产生的消耗。
+     * @default `true`
+     */
+    onlyRenderIfNeeds?: boolean;
+    /**
+     * 最高 fps 限制
+     * @description
+     * 如果为 `false`, 则不限制。最好也就是屏幕刷新率，不会再高了。
+     * @default `false`
+     */
+    maxFps?: number | false;
+    /**
+     * 是否初始化 `basisLoader`。
+     * @description
+     * 当你需要加载 basis 格式图片时请启用。
+     * 如果设置为 `true` 使用默认解析器 basis 解析器。
+     * 如果要自定义，可以传入解析器的 `resourcePath`, 则使用指定的解析器
+     * @default `false`
+     * @example
+     * ```
+     * // 使用默认解析器
+     * initialBasisLoader: true
+     *
+     * // 使用指定解析器
+     * // 会调用这个目录下的 basis_transcoder.js basis_transcoder.wasm 文件作为解析器
+     * initialBasisLoader: "https://vr-public.realsee-cdn.cn/release/static/image/release/five/basis/"
+     * ```
+     */
+    initialBasisLoader?: boolean | string;
+    /**
+     * 外挂视频对象。
+     * @description
+     * 当点位中有视频元素，则会使用。如果不传入也会外部新建，
+     * 加入传入的原因是，视频自动播放在不同浏览器或者 webview 中有不同的特性。
+     * 给予更多外部操作的空间。
+     */
+    videoInstance?: HTMLVideoElement;
+    /** 全景图游走模式下的特定参数 */
+    panorama?: ControllerCustomInitTypes["Panorama"];
+    /** 模型游走模式下的特定参数 */
+    model?: ControllerCustomInitTypes["Model"];
+    /** 模型查看模式下的特定参数 */
+    floorplan?: ControllerCustomInitTypes["Floorplan"];
+    /** 户型图模式下的特定参数 */
+    topview?: ControllerCustomInitTypes["Topview"];
+    /** 地图模式下的特定参数 */
+    mapview?: ControllerCustomInitTypes["Mapview"];
+    /** 深度图游走模式下的特定参数 */
+    depthPanorama?: ControllerCustomInitTypes["DepthPanorama"];
+    /** VR眼镜模式下的特定参数 */
+    vrPanorama?: ControllerCustomInitTypes["VRPanorama"];
+    /** XR眼镜模式下的特定参数 */
+    xrPanorama?: ControllerCustomInitTypes["XRPanorama"];
+    /**
+     * 模式间切换时的过度动画时间
+     * @description
+     * 单位毫秒
+     * @default `800`
+     */
+    modeChangeDuration?: number;
+    /**
+     * 插件定义
+     * @description
+     * 详见插件部分。
+     */
+    plugins?: (FivePlugin<void> | FivePluginInit<FivePlugin<any, any>> | FivePluginInit<FivePlugin<void, any>>)[];
+    /**
+     * 是否展示 powered by 如视
+     */
+    poweredByRealsee?: boolean;
+    /**
+     * 是否使用webgl2渲染执行环境, 默认值 false
+     */
+    webgl2?: boolean;
+    /**
+     * 是否开启模型裁切
+     */
+    localClippingEnabled?: boolean;
+    /**
+     * 请求代理
+     * @param url - 发起的请求
+     * @returns 返回的请求
+     */
+    requestProxy?(url: string): string | Promise<string>;
+}
+
+/**
+ * Five 插件
+ * [[include:plugins.md]]
+ * @template Parameters - 插件参数, 没有参数则为 void
+ * @template Returns - 如果有参数则插件暴露的 api，没有参数则不传
+ */
+export declare type FivePlugin<Parameters = void, Returns = void> = Parameters extends void ? ((five: Five) => Returns) : ((five: Five, parameters: Parameters) => Returns);
+
+/**
+ * 获取插件在Five中的初始化结构
+ * @template T - Five 插件
+ */
+export declare type FivePluginInit<T extends FivePlugin<any, any>> = Parameters<T>[1] extends undefined ? [
+Plugin: T,
+instanceName: null | string
+] : [
+Plugin: T,
+instanceName: null | string,
+parameters: Parameters<T>[1]
+];
+
+/**
+ * 获取插件暴露的 api
+ * @template T - Five 插件
+ */
+export declare type FivePluginInstance<T extends FivePlugin<any, any>> = ReturnType<T>;
+
+export declare interface FloorplanControllerCustomInitArgs {
+    /** 默认偏航角 */
+    defaultLongitude?: number;
+    /** 默认俯仰角 */
+    defaultLatitude?: number;
+    /** 最大俯仰角 */
+    maxLatitude?: number;
+    /** 最小俯仰角 */
+    minLatitude?: number;
+    /** 默认相机可视角度（垂直），可作为 `zoom` */
+    defaultFov?: number;
+    /** 最大相机可视角度 */
+    maxFov?: number;
+    /** 最小相机可视角度 */
+    minFov?: number;
+}
+
+export declare type GestureTypes = "pan" | "tap" | "pinch" | "press" | "mouseWheel";
+
+export declare function getViewportScale(): number;
+
+/**
+ * 图片参数
+ */
+export declare interface ImageOptions {
+    /**
+     * url 地址转化
+     * @param url - 原始地址
+     * @param options - 当前地址参数
+     * @returns 转化后地址
+     */
+    transform?: (url: string, options: ImageURLOptions) => string;
+    /** 图片尺寸参数 尽量使用 2 的幂次 如 512 1024 2048 */
+    size?: number;
+    /** 图片质量参数(0-100) */
+    quality?: number;
+    /** 图片格式参数 */
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    /** 锐化参数 海外不支持 */
+    sharpen?: number;
+    mappings?: ImageURLMappings;
+}
+
+export declare function imageSupport(): Promise<{
+    avif: boolean;
+    webp: boolean;
+}>;
+
+export declare interface ImageURLMappings {
+    [publicDomain: string]: {
+        "pano": [string, string];
+        "tile": [string, string];
+        "texture": [string];
+        "default": [string];
+    };
+}
+
+export declare interface ImageURLOptions {
+    /** 图片类型标识 */
+    key: string;
+    /** basisLoader 是否初始化完成 */
+    basisLoaderInitialized: boolean;
+    /** 图片尺寸参数 尽量使用 2 的幂次 如 256 512 1024 */
+    size?: number;
+    /** 图片质量参数(0-100) */
+    quality?: number;
+    /** 图片格式参数 */
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    /** 图片裁切 */
+    cut?: [x: number, y: number, width: number, height: number];
+    /** 锐化参数 海外不支持 */
+    sharpen?: number;
+    /** url匹配规则 */
+    mappings?: ImageURLMappings;
+}
+
+export declare class InternalWebGLRenderer extends THREE_2.WebGLRenderer {
+    constructor({ preserveDrawingBuffer, backgroundColor, backgroundAlpha, pixelRatio, antialias, webgl2, }: {
+        preserveDrawingBuffer?: boolean;
+        backgroundColor?: number | THREE_2.Color;
+        backgroundAlpha?: number;
+        pixelRatio?: number;
+        antialias?: boolean;
+        webgl2?: boolean;
+    });
+}
+
+export declare interface Intersection {
+    /** 焦点坐标 */
+    point: THREE_2.Vector3;
+    /** 焦点面片 */
+    face?: {
+        normal: THREE_2.Vector3;
+    } | null;
+    /** 焦点距离 */
+    distance: number;
+}
+
+export declare class IntersectMesh extends THREE_2.Object3D implements IntersectMeshInterface {
+    private ringMesh;
+    constructor();
+    dispose(): void;
+}
+
+/**
+ * 地面提示点位接口
+ */
+export declare interface IntersectMeshInterface extends THREE_2.Object3D {
+    dispose(): void;
+}
+
+export declare class LegacyPanoCircleMesh extends THREE_2.Object3D implements PanoCircleMeshInterface {
+    needsRender: boolean;
+    hitTestMesh: THREE_2.Mesh<THREE_2.BufferGeometry, THREE_2.MeshBasicMaterial>;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    progress: number;
+    opacity: number;
+    private centerMesh;
+    private loadingMesh;
+    private progressMotion;
+    private opacityMotion;
+    private stopInterval?;
+    constructor();
+    setLoading(shown: boolean): void;
+    setDisabled(disabled: boolean): void;
+    setProgress(progress: number): void;
+    setOpacity(opacity: number): void;
+    setCurrent(current: boolean): void;
+    updateTime(time: number, deltaTime: number): void;
+    dispose(): void;
+}
+
+export declare type LooseWork = {
+    bvh?: boolean;
+    modelAsync?: boolean;
+    initial?: LooseWorkInitial;
+    base_url?: string;
+    model?: LooseWorkModel;
+    panorama: {
+        base_url?: string;
+        pano_high_cube_base_url?: string;
+        info?: LooseWorkPanorama[];
+        list?: LooseWorkPanorama[];
+    };
+    observers: LooseWorkObserver[];
+};
+
+export declare type LooseWorkInitial = {
+    pano_index?: number;
+    pano?: number;
+    longitude?: number;
+    latitude?: number;
+    heading?: number;
+};
+
+export declare type LooseWorkModel = {
+    file_url: string;
+    material_textures?: string[];
+    material_base_url?: string;
+};
+
+export declare type LooseWorkObserver = {
+    active?: boolean;
+    index?: number;
+    visible_nodes: number[];
+    accessible_nodes: number[];
+    quaternion: {
+        y: number;
+        x: number;
+        z: number;
+        w: number;
+    };
+    standing_position: number[];
+    position: number[];
+    floor?: number;
+    floor_index?: number;
+};
+
+export declare type LooseWorkPanorama = {
+    active?: boolean;
+    loadable?: boolean;
+    index?: number;
+    up: string;
+    down: string;
+    right: string;
+    left: string;
+    front: string;
+    back: string;
+    video?: LooseWorkVideo;
+    luminance?: {
+        up: string;
+        down: string;
+        right: string;
+        left: string;
+        front: string;
+        back: string;
+    };
+    tiles?: number[];
+};
+
+export declare type LooseWorkVideo = {
+    source: string;
+    matrix: number[];
+    size: number[];
+};
+
+export declare interface MapviewControllerCustomInitArgs {
+    /** 默认偏航角 */
+    defaultLongitude?: number;
+    /** 默认俯仰角 */
+    defaultLatitude?: number;
+    /** 默认相机距离 */
+    defaultDistance?: number;
+    /** 最大俯仰角 */
+    maxLatitude?: number;
+    /** 最小俯仰角 */
+    minLatitude?: number;
+    /** 最大相机距离 */
+    maxDistance?: number;
+    /** 最小相机距离 */
+    minDistance?: number;
+}
+
+export declare type Mirror<T extends string> = Record<T, T>;
+
+/**
+ * Five 的显示模式，可以通过 `five.changeMode` `five.setState` 来切换
+ * - **Panorama**: 全景图游走模式
+ * - **Model**: 模型游走模式
+ * - **Floorplan**: 模型查看模式
+ * - **Topview**: 户型图模式
+ * - **Mapview**: 地图模式
+ * - **DepthPanorama**: 深度图游走模式
+ * - **VRPanorama**: VR眼镜模式
+ */
+export declare type Mode = 
+/** 模型查看模式 */
+"Floorplan" | 
+/** 户型图模式 */
+"Topview" | 
+/** 地图模式 */
+"Mapview" | 
+/** 全景图游走模式 */
+"Panorama" | 
+/** VR眼镜模式 */
+"VRPanorama" | 
+/** 模型游走模式 */
+"Model" | 
+/** 深度图游走模式 */
+"DepthPanorama" | 
+/** XR眼镜模式*/
+"XRPanorama";
+
+/**
+ * Five 模型
+ * @description
+ * 通过 work 数据加载, 适配 at3d、pbm、dome、domez 格式的文件
+ * 可以通过 jsonp 解析 base64 的 dataURL 内容，
+ * 需要满足 your/path/filename.at3d.json_xxxxxx,
+ * 通过 json_xxxxxx(<dataURL>) 方式返回。
+ */
+export declare class Model extends PBMContainer implements Subscribe<ModelEventType> {
+    /** 是否加载完成 */
+    loaded: boolean;
+    /** 是否未加载 */
+    empty: boolean;
+    /** 外接盒子的大小 */
+    bounding: THREE_2.Box3;
+    /** 当前显示的楼层 */
+    shownFloor: number | null;
+    /** 楼层的数量 */
+    floorLength: number;
+    /** 模型瓦片 */
+    originModel?: PBMContainer;
+    /** 模型瓦片 */
+    tiledModel?: Tile3DModel;
+    /**
+     * 判断是否注册了事件
+     * 具体可查看 {@link Subscribe.hasListener}
+     */
+    hasListener: SubscribeMixinType.hasListener<ModelEventType>;
+    /**
+     * 注册事件
+     * 具体可查看 {@link Subscribe.on}
+     */
+    on: SubscribeMixinType.on<ModelEventType>;
+    /**
+     * 注册事件(是否只执行一次)
+     * 具体可查看 {@link Subscribe.once}
+     */
+    once: SubscribeMixinType.once<ModelEventType>;
+    /**
+     * 解除事件
+     * 具体可查看 {@link Subscribe.off}
+     */
+    off: SubscribeMixinType.off<ModelEventType>;
+    /**
+     * 触发事件
+     * 具体可查看 {@link Subscribe.emit}
+     */
+    emit: SubscribeMixinType.emit<ModelEventType>;
+    /** bvh 树的计算结果 */
+    bvhs: BVH[] & {
+        loaded: boolean;
+    };
+    /** 网络代理 */
+    private requestProxy?;
+    /** 网络跟踪 */
+    private networkSubscribe?;
+    /** 安全域名 */
+    private allowHosts?;
+    constructor(options?: {
+        networkSubscribe?: NetworkSubscribe;
+        requestProxy?: (url: string) => string | Promise<string>;
+        allowHosts?: string[];
+    });
+    /**
+     * 当前显示的楼层
+     * @deprecated
+     * 请用 shwonFloor 代替
+     */
+    get shownfloor(): number | null;
+    /**
+     * 当前模型是否支持瓦片
+     */
+    get hasTiles(): boolean;
+    /**
+     * 是否开启瓦片
+     */
+    get enableTiles(): boolean;
+    set enableTiles(enable: boolean);
+    /**
+     * 获取模型边界线
+     * @param threshold - 面片间夹角阈值
+     * @returns 所有模型边界线
+     */
+    getEdges(threshold?: number): THREE_2.Line3[];
+    /**
+     * 获取当前楼层数
+     * @deprecated
+     * 请使用 floorLength 参数代替
+     */
+    hasFloors(): number;
+    private hasFloors_;
+    /**
+     * 显示某楼层
+     * @example
+     * ```
+     * model.show() //显示全部楼层
+     * model.show(1) //显示第一楼层
+     * model.show(1, 0) //显示第一楼层, 并且其他楼层透明度为 0
+     * ```
+     */
+    show(): void;
+    show(floorIndex: number, hiddenOpacity?: number): void;
+    private at3dShow;
+    private b3dmShow;
+    /**
+     * 计算模型射线碰撞检测
+     * @param raycaster - THREE 射线对象
+     * @param floors - 和某一楼层做碰撞检测， 不传为和所有楼层做碰撞检测
+     * @returns 返回碰撞
+     */
+    intersectRaycaster(raycaster: THREE_2.Raycaster, floors?: number | number[]): Intersection[];
+    buildBVH(): void;
+    /**
+     * 加载模型
+     * @param workModel - work 的 model 内容
+     * @param imageOptions - 图片参数
+     */
+    load(workModel: WorkModel, textureOptions?: TextureOptions): Promise<void>;
+    update(renderer: THREE_2.WebGLRenderer, camera: THREE_2.PerspectiveCamera): void;
+    /**
+     * 析构函数
+     * @description
+     * 一旦析构，则不能使用
+     */
+    dispose(): void;
+}
+
+export declare interface ModelControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
+}
+
+/**
+ * Five 模型事件列表
+ * @description
+ * 可以通过 `five.model.on(METHOD_NAME, METHOD)` 调用
+ */
+export declare interface ModelEventCallback extends ModelEventType {
+}
+
+/**
+ * 模型事件列表
+ * @description
+ * 具体事件列表 请查看 {@link ModelEventCallback}
+ */
+export declare type ModelEventType = {
+    /**
+     * 模型 bvh树 计算完成
+     * @description
+     * bvh 树用于高效的碰撞检测，可以在 `model.bvh` 属性来设置是否开启。默认开启。
+     * bvh 树计算需要一定时间，可能会暂时影响一些性能。计算完毕后，会对碰撞检测带来质的提升。
+     */
+    bvhLoaded(): void;
+    /** 模型三角面片结构加载完成 */
+    geometryLoaded(): void;
+    /** 模型材质结构加载完成 */
+    materialLoaded(): void;
+    /** 模型加载完成 */
+    loaded(): void;
+    /**
+     * 显示楼层改变
+     * @param shownFloor - 显示的楼层
+     */
+    shownFloorChange(shownFloor: number | null, totalFloorLength: number): void;
+    /**
+     * 内部错误
+     * @param error - 错误对象
+     */
+    error(error: Error): void;
+};
+
+/**
+ * 点位移动参数
+ */
+export declare interface MovePanoOptions extends Partial<Omit<Pose, "offset">> {
+    /** 是否通过初始化参数限制 fov, latitude */
+    limit?: boolean;
+    /**
+     * 动画模式
+     * @description
+     * - `fly` 通过相机移动方式变化
+     * - `fade` 通过渐变方式变化
+     * - `montage` 通过渐变穿插到黑屏方式变化
+     * - `instant` 通过插入黑屏方式变化
+     */
+    effect?: "fly" | "fade" | "montage" | "instant";
+    /**
+     * 运动耗时
+     * @description
+     * - `数字或者字符串类型` 直接当作运动耗时
+     * - `函数类型` 传入 距离和速度（速度为five初始化设置） 返回运动耗时
+     * - `不传或者null` 通过距离和速度（速度为five初始化设置）
+     */
+    duration?: number | ((distance: number, speed: number) => number) | string | null;
+    /** 运动曲线函数 */
+    easing?: (k: number) => number;
+    /** 运动开始回调 */
+    moveStartCallback?: (panoIndex: number, toPose: Pose) => void;
+    /** 运动结束回调 */
+    moveEndCallback?: (panoIndex: number, pose: Pose) => void;
+    /**
+     * 运动被取消回调
+     * @description
+     * 这个有一些情况会导致
+     * - 移动过程中切换模态
+     * - 移动过程中 five 被析构
+     * - 移动过程点击切换到另一个点位
+     */
+    moveCancelCallback?: () => void;
+}
+
+export declare type NetWorkMeta = {
+    origin: string;
+    source: string;
+    headers: {
+        [name: string]: string;
+    };
+    requestTime: number;
+    responseTime: number;
+    costs: number;
+    size?: number;
+};
+
+export declare interface NetworkOptions {
+    /** 超时时间 */
+    timeout?: number;
+    /** 请求代理 */
+    requestProxy?: (url: string) => string | Promise<string>;
+    /** 网络消息追踪 */
+    networkSubscribe?: NetworkSubscribe;
+    /** 安全域名 */
+    allowHosts?: string[];
+}
+
+export declare type NetworkResponse<T = any, E extends NetWorkMeta | NetWorkMeta[] = NetWorkMeta> = {
+    body: T;
+    meta: E;
+};
+
+export declare type NetworkState = "ok" | "preload" | "error" | "proxy-error" | "timeout" | "forbidden";
+
+export declare class NetworkSubscribe extends Subscribe<{
+    network(source: string, type: NetworkType, state: NetworkState, detail: string): void;
+}> {
+}
+
+export declare type NetworkType = "XMLHttpRequest" | "Script" | "Image" | "Link";
+
+export declare class PanoCircleMesh extends THREE_2.Object3D implements PanoCircleMeshInterface {
+    needsRender: boolean;
+    private loadingMesh;
+    private disableMesh;
+    private centerMesh;
+    private ringMesh;
+    private progressMesh;
+    private ringRotateMotion;
+    private tapMotion;
+    private progressMotion;
+    private progressOpacityMotion;
+    private opacityMotion;
+    progress: number;
+    opacity: number;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    constructor();
+    setProgress(progress: number): void;
+    setOpacity(opacity: number): void;
+    setCurrent(current: boolean): void;
+    setLoading(loading: boolean): void;
+    setDisabled(disabled: boolean): void;
+    tap(): Promise<void>;
+    setResolution(width: number, height: number): void;
+    updateTime(time: number, deltaTime: number): void;
+    dispose(): void;
+}
+
+export declare class PanoCircleMeshDark extends THREE_2.Object3D implements PanoCircleMeshInterface {
+    needsRender: boolean;
+    private backgroundMesh;
+    private loadingMesh;
+    private disableMesh;
+    private centerMesh;
+    private ringMesh;
+    private progressMesh;
+    private ringRotateMotion;
+    private tapMotion;
+    private progressMotion;
+    private progressOpacityMotion;
+    private opacityMotion;
+    progress: number;
+    opacity: number;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    constructor();
+    setProgress(progress: number): void;
+    setOpacity(opacity: number): void;
+    setCurrent(current: boolean): void;
+    setLoading(loading: boolean): void;
+    setDisabled(disabled: boolean): void;
+    tap(): Promise<void>;
+    setResolution(width: number, height: number): void;
+    updateTime(time: number, deltaTime: number): void;
+    dispose(): void;
+}
+
+/**
+ * 地面提示点位接口
+ *
+ * 点位状态
+ *  1. 默认状态: 无任何操作的情况
+ *  2. 高亮状态: 高亮，认为是合适的下一个点位，或者设备选中了某个点位
+ *  3. 进度状态: 点位加载中，存在进度的情况
+ *  4. 加载状态: 点位加载中，不存在进度的情况
+ *  5. 不可用状态：点位不可用，存在点位，但是点位是个摆设
+ *  6. 点击动画： 点位被选择，触发全景图切换
+ *  7. 透明度改变： 一般会处理为近的点位透明度高，远的点位透明度低
+ */
+export declare interface PanoCircleMeshInterface extends THREE_2.Object3D {
+    needsRender: boolean;
+    hitTestMesh?: THREE_2.Mesh;
+    /** 当前高亮 */
+    current: boolean;
+    /** 是否当前高亮 */
+    setCurrent(current: boolean): void;
+    loading: boolean;
+    setLoading(loading: boolean): void;
+    disabled: boolean;
+    setDisabled(disabled: boolean): void;
+    progress: number;
+    setProgress(progress: number): void;
+    opacity: number;
+    setOpacity(opacity: number): void;
+    updateTime?(time: number, deltaTime: number): void;
+    /** 点击交互 */
+    tap?(): Promise<void>;
+    dispose(): void;
+}
+
+export declare class PanoCircleMeshSolid extends THREE_2.Object3D implements PanoCircleMeshInterface {
+    needsRender: boolean;
+    private loadingMesh;
+    private disableMesh;
+    private centerMesh;
+    private progressMesh;
+    private tapMotion;
+    private progressMotion;
+    private progressOpacityMotion;
+    private opacityMotion;
+    progress: number;
+    opacity: number;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    constructor();
+    setProgress(progress: number): void;
+    setOpacity(opacity: number): void;
+    setCurrent(current: boolean): void;
+    setLoading(loading: boolean): void;
+    setDisabled(disabled: boolean): void;
+    tap(): Promise<void>;
+    setResolution(width: number, height: number): void;
+    updateTime(time: number, deltaTime: number): void;
+    dispose(): void;
+}
+
+export declare interface PanoramaControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
+    /** 最远可移动观察点距离 */
+    maxAccessibleDistance?: number;
+    /**
+     * 点击地面观察点标识的判定范围
+     * @description
+     * 如果在判定范围内则确定去到目标点，
+     * 否则寻找点击位置方向最适合的点（可能会走到一个离相机更近的点）。
+     */
+    panoTapTriggerRadius?: number;
+    /** 地面观察点标识自定义创建器 */
+    panoCircleMeshCreator?: () => PanoCircleMeshInterface;
+    /**
+     * 全景瓦片登记
+     * @param fov - 当前 fov
+     * @param viewSize - 当前绘制区域大小
+     * @returns 返回瓦片等级
+     */
+    tileLevelForFov?: false | ((fov: number, viewSize: THREE_2.Vector2) => number);
+}
+
+export declare interface PanoramaLikeControllerCustomInitArgs {
+    /** 默认相机偏航角 */
+    defaultLongitude?: number;
+    /** 默认相机俯仰角 */
+    defaultLatitude?: number;
+    /** 最大相机俯仰角 */
+    maxLatitude?: number;
+    /** 最小相机俯仰角 */
+    minLatitude?: number;
+    /** 默认相机可视角度（垂直），可作为 `zoom` */
+    defaultFov?: number;
+    /** 最大默认相机可视角度（垂直） */
+    maxFov?: number;
+    /** 最小默认相机可视角度（垂直） */
+    minFov?: number;
+    /**
+     * 点位间移动动画速度 单位 m/s
+     * @description
+     * 这边设置的是速度，整体耗时会通过距离除速度计算得到
+     */
+    moveSpeed?: number;
+    /** 鼠标焦点环自定义创建器 */
+    intersectMeshCreator?: () => IntersectMeshInterface;
+}
+
+/**
+ * 解析 Work 数据
+ * @param obj - work 数据，从如数开发者平台获取
+ * @param options - 配置参数， 可以在此二次设置 baseURL 等参数
+ * @param urlTransform - 配置参数， URL 解析规则
+ * @returns - 签署过的 Work 数据结构
+ */
+export declare function parseWork(obj: Work | LooseWork | string | any, options?: ParseWorkOptions, urlTransform?: (origin: string, absolute: string, relative: string, type: "panorama" | "texture" | "model") => void): Work;
+
+export declare type ParseWorkOptions = {
+    /** 重写 work 中的资源前缀 */
+    baseURL?: string;
+    /** work 中的资源地址使用短地址 */
+    shortPath?: boolean;
+    /** work 中的资源使用 jsonp 方式发布 */
+    jsonp?: boolean;
+    /** work 中模型是否计算bvh碰撞数，默认计算 true */
+    modelBvh?: boolean;
+};
+
+/** PBM 模型组 */
+export declare class PBMContainer extends THREE_2.Group {
+    /** 是否需要更新按需渲染 */
+    needsRender: boolean;
+    private enableTransparent;
+    /** 获取是否有透明参数 */
+    getTransparent(): boolean;
+    /** 设置透明参数 */
+    setTransparent(bool: boolean): void;
+    /** 获取材质参数 */
+    getMaterial(): PBMParameters | null;
+    /** 设置材质参数 */
+    setMaterial(parameters: Partial<PBMParameters>): void;
+    /** 析构材质 */
+    disposeMaterial(): void;
+    /** 析构模型网格 */
+    disposeGeometry(): void;
+}
+
+/** PBM 模型组 */
+export declare class PBMGroup extends PBMContainer {
+    /** 楼层序号 */
+    floorIndex: number;
+}
+
+/** PBM 材质 */
+export declare class PBMMaterial extends THREE_2.ShaderMaterial implements PBMParameters {
+    /** 起始点 */
+    pano0: PBMPanoPicture | null;
+    /** 结束点 */
+    pano1: PBMPanoPicture | null;
+    /** 模型贴图和全景图的混合程度 [0-1] */
+    modelAlpha: number;
+    /** 全景图混合程度 [0-1] */
+    progress: number;
+    /** 全景图通过过度黑色混合 */
+    useBlackTransition: boolean;
+    perspToOrtho: number;
+    /** 模型透明度 */
+    opacity: number;
+    originOpacity: number;
+    /** 楼层参数*/
+    floorIndex: number;
+    /** 楼层切割参数*/
+    floorInfo: THREE_2.Vector3 | null;
+    /** 对外模型裁切参数*/
+    clippers: ClipperParameter | ClipperParameter[] | null;
+    /** 对内模型裁切参数 裁切平面*/
+    clipperPlanesArray: Float32Array | null;
+    /** 对内模型裁切参数 裁切盒关联楼层*/
+    clipperFloors: number[] | null;
+    /** 模型颜色*/
+    modelColorInfo: THREE_2.Vector3 | null;
+    constructor(parameters?: Partial<PBMParameters>);
+}
+
+/** PBM 对象 */
+export declare class PBMMesh extends THREE_2.Mesh<THREE_2.BufferGeometry, PBMMaterial[]> {
+    /** 楼层序号 */
+    floorIndex: number;
+    /** 是否需要更新按需渲染 */
+    needsRender: boolean;
+}
+
+export declare interface PBMPanoPicture {
+    /** 起始点位全景图 */
+    map: THREE_2.CubeTexture | TileCubeTextureTarget;
+    /** 亮度增益 */
+    luminanceMap: null | THREE_2.CubeTexture | TileCubeTextureTarget;
+    /** 起始点全景图变换矩阵 4x4 */
+    matrix: THREE_2.Matrix4;
+}
+
+/** PBM 材质参数 */
+export declare interface PBMParameters {
+    /** 起始点 */
+    pano0: PBMPanoPicture | null;
+    /** 结束点 */
+    pano1: PBMPanoPicture | null;
+    /** 模型贴图和全景图的混合程度 [0-1] */
+    modelAlpha: number;
+    /** 全景图混合程度 [0-1] */
+    progress: number;
+    /** 全景图通过过度黑色混合 */
+    useBlackTransition: boolean;
+    perspToOrtho: number;
+    /** 模型透明度 */
+    opacity: number;
+    /** 楼层参数*/
+    floorIndex: number;
+    /** 楼层切割参数*/
+    floorInfo?: THREE_2.Vector3 | null;
+    /** 模型裁切参数（工程侧调用）*/
+    clippers?: ClipperParameter | ClipperParameter[] | null;
+    /** 模型裁切平面参数（内部调用） */
+    clipperPlanesArray?: Float32Array | null;
+    /** 模型裁切平面参数（内部调用） */
+    clipperFloors?: number[] | null;
+    /** 模型颜色*/
+    modelColorInfo?: THREE_2.Vector3 | null;
+}
+
+/**
+ * 相机位姿
+ * [[include: coordinate.md]]
+ */
+export declare interface Pose {
+    /** 相机偏航角 */
+    longitude: number;
+    /** 相机俯仰角 */
+    latitude: number;
+    /** 相机可视角度（垂直）*/
+    fov: number;
+    /** 相机位置*/
+    offset: THREE_2.Vector3;
+    /** 相机距离 */
+    distance: number;
+}
+
+export declare const PROXY_CONTROLLER_EVENT_NAMES: readonly ["cameraDirectionUpdate", "cameraUpdate", "cameraPositionUpdate", "panoSelected", "moveToPano", "moveToPanoCanceled", "panoWillArrive", "movingToPano", "panoArrived", "panoWillLoad", "panoLoaded", "panoLoadError", "initAnimationEnded", "initAnimationWillStart", "wantsGesture", "gesture", "wantsTapGesture", "tapGesture", "wantsPressGesture", "pressGesture", "wantsPanGesture", "wantsInteriaPan", "panGesture", "interiaPan", "wantsPinchGesture", "pinchGesture", "wantsMouseWheel", "mouseWheel", "wantsShowIntersectionOnModel", "intersectionOnModelUpdate", "intersectionHidden", "textureStartLoad", "textureLoading", "textureAbort", "textureLoaded", "textureError", "webXRSessionStart", "webXRSessionEnd", "webXRSelected"];
+
+/** Five 场景*/
+export declare class Scene extends THREE_2.Scene {
+    add(...objects: AddableObject[]): this;
+    remove(...objects: AddableObject[]): this;
+}
+
+/**
+ * 显示区域裁剪参数
+ * @description
+ * 可通过初始化，或者 setScissor 方式设置
+ * `scissor` 是将屏幕中的内容渲染到 `renderer` 的指定区域。
+ * 页面整体长宽均为 `1`。通过类似 css 的 `left` `bottom` `width` `height` 来确定区域。
+ */
+export declare interface Scissor {
+    /** 距离左侧 */
+    left: number;
+    /** 距离下侧 */
+    bottom: number;
+    /** 宽度 */
+    width: number;
+    /** 高度 */
+    height: number;
+}
+
+/**
+ * 状态
+ * @description
+ * ```text
+ * 可以通过 five.state 和 five.setState 来获取和设置。
+ * 通过 state 设置后，five 会通过合适的动画运动来达到设置的位置。
+ * 来迎合一些通过数据驱动的场景。
+ * ```
+ */
+export declare interface State extends Pose {
+    /** 模态 */
+    mode: Mode;
+    /** 观察点序号 */
+    panoIndex: number;
+}
+
+/**
+ * 监听者模式
+ * @template T - 预设的监听回调类型
+ * @example
+ * ```
+ * new Subscribe<{
+ * "foo": [arg1: number, arg2: string],
+ * "bar": [arg: boolean],
+ * }>()
+ * ```
+ */
+export declare class Subscribe<T extends SubscribeEventMap> {
+    /**
+     * 判断是否注册了事件
+     * @param name - 事件类型
+     */
+    hasListener(name: keyof T): boolean;
+    /**
+     * 注册事件
+     * @param name - 事件类型
+     * @param callback - 事件回调函数
+     * @param once - 是否只执行一次
+     * @returns 解除事件
+     * @template K - 预设的监听事件名称
+     * @template C - 回调函数函数上下文
+     */
+    on<K extends keyof T>(name: K, callback: (...args: Parameters<T[K]>) => ReturnType<T[K]>, once?: boolean): () => void;
+    /**
+     * 注册事件(是否只执行一次)
+     * @param name - 事件类型
+     * @param callback - 事件回调函数
+     * @returns 解除事件
+     * @template K - 预设的监听事件名称
+     * @template C - 回调函数函数上下文
+     */
+    once<K extends keyof T>(name: K, callback: (...args: Parameters<T[K]>) => ReturnType<T[K]>): () => void;
+    /**
+     * 解除事件
+     *
+     * 如果 name 不传的话解除对应所有事件
+     * 如果 name, callback 不传的话解除所有name的所有事件
+     * @param name - 事件类型
+     * @param callback - 事件回调函数
+     * @template K - 预设的监听事件名称
+     */
+    off<K extends keyof T>(name?: K, callback?: (...args: Parameters<T[K]>) => ReturnType<T[K]>): void;
+    /**
+     * 触发事件
+     * @param name - 事件类型
+     * @param data - 触发事件的数据
+     * @returns canceled 是否被触发取消
+     * @template K - 预设的监听事件名称
+     */
+    emit<K extends keyof T>(name: K, ...data: Parameters<T[K]>): boolean;
+}
+
+export declare type SubscribeEventMap = {
+    [name: string]: (...args: any[]) => void | boolean;
+};
+
+export declare namespace SubscribeMixinType {
+    export interface hasListener<T extends SubscribeEventMap> {
+        (name: keyof T): boolean;
+    }
+    export interface on<T extends SubscribeEventMap> {
+        <K extends keyof T>(name: K, callback: (...args: Parameters<T[K]>) => ReturnType<T[K]>, once?: boolean): () => void;
+    }
+    export interface once<T extends SubscribeEventMap> {
+        <K extends keyof T>(name: K, callback: (...args: Parameters<T[K]>) => ReturnType<T[K]>): () => void;
+    }
+    export interface off<T extends SubscribeEventMap> {
+        <K extends keyof T>(names?: K | K[], callback?: (...args: any[]) => any): void;
+    }
+    export interface emit<T extends SubscribeEventMap> {
+        <K extends keyof T>(name: K, ...data: Parameters<T[K]>): boolean;
+    }
+}
+
+export declare class TextureLoader {
+    private timeout?;
+    private allowHosts?;
+    private requestProxy?;
+    private networkSubscribe?;
+    constructor(options: NetworkOptions);
+    setAllowHosts(allowHosts: string[]): void;
+    setRequestProxy(requestProxy: (url: string) => string): void;
+    setNetworkSubscribe(networkSubscribe: NetworkSubscribe): void;
+    loadTexture(source: string, options?: {
+        imageURL?: {
+            transform?: (source: string, options: ImageURLOptions) => string;
+            options?: ImageURLOptions;
+        };
+        flipY?: boolean;
+        format?: THREE_2.PixelFormat;
+        minFilter?: THREE_2.TextureFilter;
+        magFilter?: THREE_2.TextureFilter;
+        wrapS?: THREE_2.Wrapping;
+        wrapT?: THREE_2.Wrapping;
+        maxSize?: THREE_2.Vector2;
+        preInit?: boolean;
+        viaAjax?: boolean;
+    }, onLoad?: (response: NetworkResponse<THREE_2.Texture>) => void, onError?: (error: Error) => void, onProgress?: (percent: number) => void, renderer?: THREE_2.WebGLRenderer): Promise<NetworkResponse<THREE_2.Texture>>;
+    loadCubeTexture(sources: WorkCubeImage, options: {
+        imageURL?: {
+            transform?: (source: string, options: ImageURLOptions) => string;
+            options?: ImageURLOptions;
+        };
+        format?: THREE_2.PixelFormat;
+        minFilter?: THREE_2.TextureFilter;
+        magFilter?: THREE_2.TextureFilter;
+        wrapS?: THREE_2.Wrapping;
+        wrapT?: THREE_2.Wrapping;
+        preInit?: boolean;
+        viaAjax?: boolean;
+    }, onLoad: (response: NetworkResponse<THREE_2.CubeTexture, NetWorkMeta[]>) => void, onError: (error: Error) => void, onProgress: (percent: number) => void, renderer: THREE_2.WebGLRenderer): Promise<NetworkResponse<THREE_2.CubeTexture, NetWorkMeta[]>>;
+    loadTiledCubeTexture(sources: WorkCubeImage, tileSources: WorkTile[], options: {
+        tileImageSize?: number;
+        tileMaxLevel?: number;
+        imageURL?: {
+            transform?: (source: string, options: ImageURLOptions) => string;
+            options?: ImageURLOptions;
+        };
+        format?: THREE_2.PixelFormat;
+        minFilter?: THREE_2.TextureFilter;
+        magFilter?: THREE_2.TextureFilter;
+        wrapS?: THREE_2.Wrapping;
+        wrapT?: THREE_2.Wrapping;
+        viaAjax?: boolean;
+    }, onLoad: (response: NetworkResponse<TileCubeTextureTarget, NetWorkMeta[]>) => void, onError: (error: Error) => void, onProgress: (percent: number) => void, renderer: THREE_2.WebGLRenderer): Promise<NetworkResponse<TileCubeTextureTarget, NetWorkMeta[]>>;
+}
+
+/**
+ * 图片参数
+ */
+export declare interface TextureOptions {
+    /**
+     * url 地址转化
+     * @param url - 原始地址
+     * @param options - 当前地址参数
+     * @returns 转化后地址
+     */
+    transform?: (url: string, options: ImageURLOptions) => string;
+    /** 图片尺寸参数 尽量使用 2 的幂次 如 256 512 1024 */
+    size?: number;
+    /** 图片质量参数(0-100) */
+    quality?: number;
+    /** 图片格式参数 */
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    /** 针对 textureOptions 是否自动通过模型贴图的数量计算需要的模型贴图的尺寸 默认 true */
+    autoResize?: boolean;
+    /** 锐化参数 海外不支持 */
+    sharpen?: number;
+    mappings?: ImageURLMappings;
+}
+
+/**
+ * A Tile3DHeader represents a tile as Tileset3D. When a tile is first created, its content is not loaded;
+ * the content is loaded on-demand when needed based on the view.
+ * Do not construct this directly, instead access tiles through {@link Tileset3D#tileVisible}.
+ */
+export declare class Tile3D {
+    cacheNode?: TileCacheNode<Tile3D>;
+    tileset: Tileset3D;
+    header: TilesetJSONNode;
+    content?: TileContent;
+    parent?: Tile3D;
+    boundingVolume: TileOrientedBoundingBox;
+    contentState: "UNLOADED" | "LOADING" | "PROCESSING" | "READY" | "FAILED";
+    children: Tile3D[];
+    depth: number;
+    selectionDepth: number;
+    transform: Matrix4;
+    computedTransform: Matrix4;
+    frameNumber: number;
+    touchedFrameNumber: number;
+    requestedFrameNumber: number;
+    selectedFrameNumber: number;
+    distanceToCamera: number;
+    centerZDepth: number;
+    screenSpaceError: number;
+    visibilityPlaneMask: number;
+    visible: boolean;
+    shouldRefine: boolean;
+    /**
+     * @constructs
+     * Create a TileHeader instance
+     * @param tileset - Tileset3D instance
+     * @param header - tile header - JSON loaded from a dataset
+     * @param parentHeader - parent TileHeader instance
+     */
+    constructor(tileset: Tileset3D, header: TilesetJSONNode, parentHeader?: Tile3D);
+    get id(): string;
+    get refine(): "REPLACE" | "ADD";
+    get type(): "EMPTY" | "SCENEGRAPH" | "MESH";
+    get contentUrl(): string;
+    get lodMetricType(): "geometricError";
+    get lodMetricValue(): number;
+    get hasEmptyContent(): boolean;
+    get selected(): boolean;
+    /** Returns true if tile is not an empty tile and not an external tileset */
+    get hasRenderContent(): boolean;
+    /** Returns true if tile has children */
+    get hasChildren(): boolean;
+    /**
+     * Determines if the tile's content is ready. This is automatically `true` for
+     * tiles with empty content.
+     */
+    get contentReady(): boolean;
+    /**
+     * Determines if the tile has available content to render.  `true` if the tile's
+     * content is ready or if it has expired content this renders while new content loads; otherwise,
+     */
+    get contentAvailable(): boolean;
+    /** Returns true if tile has renderable content but it's unloaded */
+    get hasUnloadedContent(): boolean;
+    /**
+     * Determines if the tile's content has not be requested. `true` if tile's
+     * content has not be requested; otherwise, `false`.
+     */
+    get contentUnloaded(): boolean;
+    get contentFailed(): boolean;
+    /** Get the tile's screen space error. */
+    getScreenSpaceError(frameState: TileFrameState, useParentLodMetric: boolean): number;
+    private getPriority;
+    /**
+     *  Requests the tile's content.
+     * The request may not be made if the Request Scheduler can't prioritize it.
+     */
+    loadContent(): Promise<boolean>;
+    unloadContent(): void;
+    /**
+     * Update the tile's visibility
+     */
+    updateVisibility(frameState: TileFrameState): void;
+    private visibility;
+    /**
+     * Computes the (potentially approximate) distance from the closest point of the tile's bounding volume to the camera.
+     * @param frameState - The frame state.
+     * @returns The distance, in meters, or zero if the camera is inside the bounding volume.
+     */
+    private distanceToTile;
+    private updateTransform;
+}
+
+export declare class Tile3DModel extends PBMContainer {
+    tileset?: Tileset3D;
+    private options;
+    private nodeGroup;
+    private boundingGroup;
+    private nodes;
+    private boundings;
+    private unloadTileQueue;
+    private timer;
+    private clock;
+    private lastCameraTransform;
+    private lastCameraAspect;
+    private lastCameraFov;
+    private sseDenominator;
+    private lastCamera;
+    private lastRenderer;
+    private enabled;
+    constructor(loaderOptions?: Partial<Tile3DModelLoaderOptions>);
+    get enable(): boolean;
+    set enable(value: boolean);
+    load(url: WorkModelTiles): void;
+    update(renderer: THREE_2.WebGLRenderer, camera: THREE_2.PerspectiveCamera): void;
+    private tilesetUpdate;
+    reset(): void;
+}
+
+/** Advanced loader options */
+export declare interface Tile3DModelLoaderOptions {
+    updateInterval: number;
+    maxMemoryUsage: number;
+    maxScreenSpaceError: number;
+    viewDistanceScale: number;
+    throttleRequests: boolean;
+    maxRequests: number;
+    onNodeCreated: (node: PBMGroup) => void;
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string | Promise<string>;
+    networkSubscribe?: NetworkSubscribe;
+    maxDepth?: number;
+}
+
+export declare class TileBoundingSphere {
+    center: Vector3;
+    radius: number;
+    constructor(center?: number[], radius?: number);
+    fromCenterRadius(center: number[], radius: number): this;
+    fromCornerPoints(corner: number[], oppositeCorner: number[]): this;
+    equals(right: TileBoundingSphere): boolean;
+    clone(): TileBoundingSphere;
+    union(boundingSphere: TileBoundingSphere): TileBoundingSphere;
+    expand(point: number[]): this;
+    transform(transform: Matrix4): this;
+    distanceSquaredTo(point: number[]): number;
+    distanceTo(point: number[]): number;
+    intersectPlane(plane: TilePlane): 0 | 1 | -1;
+}
+
+export declare interface TileBoundingVolume {
+    /**
+     * Applies a 4x4 affine transformation matrix to a bounding sphere.
+     * @param sphere - The bounding sphere to apply the transformation to.
+     * @param transform - The transformation matrix to apply to the bounding sphere.
+     * @returns itself, i.e. the modified BoundingVolume.
+     */
+    transform(transform: readonly number[]): this;
+    /** Computes the estimated distance squared from the closest point on a bounding sphere to a point. */
+    distanceSquaredTo(point: readonly number[]): number;
+    /** Computes the estimated distance from the closest point on a bounding sphere to a point. */
+    distanceTo(point: readonly number[]): number;
+    /**
+     * Determines which side of a plane the oriented bounding box is located.
+     *
+     * @param plane - The plane to test against.
+     * @returns
+     *  - `INTERSECTION.INSIDE` if the entire box is on the side of the plane the normal is pointing.
+     *  - `INTERSECTION.OUTSIDE` if the entire box is on the opposite side.
+     *  - `INTERSECTION.INTERSECTING` if the box intersects the plane.
+     */
+    intersectPlane(plane: TilePlane): number;
+}
+
+export declare class TileCacheNode<T> {
+    item: T;
+    previous: TileCacheNode<T> | null;
+    next: TileCacheNode<T> | null;
+    constructor(item: T, previous: TileCacheNode<T> | null, next: TileCacheNode<T> | null);
+}
+
+export declare interface TileContent {
+    version: 1;
+    magic: number;
+    byteLength: number;
+    header: {
+        featureTableJsonByteLength: number;
+        featureTableBinaryByteLength: number;
+        batchTableJsonByteLength: number;
+        batchTableBinaryByteLength: number;
+        batchLength: number;
+    };
+    featureTableJson: Record<string, any>;
+    featureTableBinary: Uint8Array;
+    batchTableJson: Record<string, any>;
+    batchTableBinary: Uint8Array;
+    rotateYtoZ: boolean;
+    gltfUpAxis: "X" | "Y" | "Z";
+    gltfArrayBuffer: ArrayBuffer;
+    gltfByteOffset: number;
+    gltfByteLength: number;
+    rtcCenter?: Float32Array;
+}
+
+export declare interface TileCubeNode {
+    level: number;
+    face: "up" | "down" | "left" | "right" | "front" | "back";
+    position: THREE_2.Vector2;
+    size: number;
+    box: THREE_2.Box3;
+    children: TileCubeNode[];
+}
+
+export declare class TileCubeTextureTarget {
+    private tileTree;
+    private tileSources;
+    private options;
+    private renderer;
+    name: string;
+    needsRender: boolean;
+    private disposed;
+    private loadedCubeNodes;
+    private loadingCubeNodes;
+    private baseCubeTexture;
+    private _cubeRenderTarget;
+    private textures;
+    constructor(baseCubeTexture: THREE_2.CubeTexture, tileTree: TileCubeTree, tileSources: WorkTile[], options: {
+        textureSize: number;
+        tileImageSize: number;
+        textureLoader: TextureLoader;
+        imageURL?: {
+            transform?: (source: string, options: ImageURLOptions) => string;
+            options?: ImageURLOptions;
+        };
+        format?: THREE_2.PixelFormat;
+        minFilter?: THREE_2.TextureFilter;
+        magFilter?: THREE_2.TextureFilter;
+        wrapS?: THREE_2.Wrapping;
+        wrapT?: THREE_2.Wrapping;
+    }, renderer: THREE_2.WebGLRenderer);
+    get cubeRenderTarget(): THREE_2.WebGLCubeRenderTarget | null;
+    set cubeRenderTarget(cubeRenderTarget: THREE_2.WebGLCubeRenderTarget | null);
+    private requestTile;
+    update(frustum: THREE_2.Frustum, level: number): void;
+    get tilePending(): number;
+    get texture(): THREE_2.Texture;
+    dispose(): void;
+}
+
+export declare interface TileCubeTree {
+    children: TileCubeNode[];
+}
+
+export declare class TileCullingVolume {
+    static get MASK_OUTSIDE(): number;
+    static get MASK_INSIDE(): number;
+    static get MASK_INDETERMINATE(): number;
+    planes: TilePlane[];
+    constructor(planes?: TilePlane[]);
+    fromBoundingSphere(boundingSphere: {
+        center: Vector3;
+        radius: number;
+    }): this;
+    computeVisibilityWithPlaneMask(boundingVolume: TileBoundingVolume, parentPlaneMask: number): number;
+}
+
+export declare type TileFrameState = {
+    camera: {
+        position: number[];
+        direction: number[];
+        up: number[];
+    };
+    height: number;
+    cullingVolume: TileCullingVolume;
+    frameNumber: number;
+    sseDenominator: number;
+};
+
+export declare class TileOrientedBoundingBox {
+    center: Vector3;
+    halfAxes: Matrix3;
+    constructor(center?: number[], halfAxes?: number[]);
+    get halfSize(): number[];
+    get quaternion(): Quaternion;
+    fromCenterHalfSizeQuaternion(center: number[], halfSize: number[], quaternion: number[]): this;
+    clone(): TileOrientedBoundingBox;
+    equals(right: TileOrientedBoundingBox): boolean;
+    getBoundingSphere(result?: TileBoundingSphere): TileBoundingSphere;
+    intersectPlane(plane: TilePlane): 0 | 1 | -1;
+    distanceTo(point: number[]): number;
+    distanceSquaredTo(point: number[]): number;
+    computePlaneDistances(position: Vector3, direction: Vector3, result?: number[]): number[];
+    transform(transformation: number[]): this;
+}
+
+export declare class TilePlane {
+    normal: Vector3;
+    distance: number;
+    constructor(normal?: number[], distance?: number);
+    fromNormalDistance(normal: number[], distance: number): this;
+    fromPointNormal(point: number[], normal: number[]): this;
+    fromCoefficients(a: number, b: number, c: number, d: number): this;
+    clone(): TilePlane;
+    equals(right: TilePlane): boolean;
+    getPointDistance(point: number[]): number;
+    transform(matrix4: Matrix4): this;
+    projectPointOntoPlane(point: number[], result?: number[]): Vector3;
+}
+
+/** Tracks one request */
+export declare type TileRequest<Identiy> = {
+    identiy: Identiy;
+    priority: number;
+    getPriority: (identiy: Identiy) => number;
+    resolve: (requestResult: TileRequestResult) => void;
+};
+
+export declare type TileRequestResult = null | {
+    done: () => void;
+};
+
+/**
+ * Used to issue a request, without having them "deeply queued" by the browser.
+ * @todo - Track requests globally, across multiple servers
+ */
+export declare class TileRequestScheduler<Identiy> {
+    private props;
+    private activeRequestCount;
+    /** Tracks the number of active requests and prioritizes/cancels queued requests. */
+    private requestQueue;
+    private requestMap;
+    private deferred;
+    constructor(props?: TileRequestSchedulerOptions);
+    /**
+     * Called by an application that wants to issue a request, without having it deeply queued by the browser
+     *
+     * When the returned promise resolved, it is OK for the application to issue a request.
+     * The promise resolves to an object that contains a `done` method.
+     * When the application's request has completed (or failed), the application must call the `done` function
+     *
+     * @param identiy - Identiy
+     * @param getPriority - will be called when request "slots" open up, allowing the caller to update priority or cancel the request Highest priority executes first, priority less than 0 cancels the request
+     * @returns a promise resolves to a object (with a `done` field) when the request can be issued without queueing, resolves to `null` if the request has been cancelled (by the callback return less than 0). In this case the application should not issue the request
+     */
+    scheduleRequest(identiy: Identiy, getPriority?: (identiy: Identiy) => number): Promise<TileRequestResult>;
+    private issueRequest;
+    /** We check requests asynchronously, to prevent multiple updates */
+    private issueNewRequests;
+    /** Refresh all requests  */
+    private issueNewRequestsAsync;
+    /** Ensure all requests have updated priorities, and that no longer valid requests are cancelled */
+    private updateAllRequests;
+    /** Update a single request by calling the callback */
+    private updateRequest;
+}
+
+/** RequestScheduler Options */
+export declare type TileRequestSchedulerOptions = {
+    throttleRequests?: boolean;
+    maxRequests?: number;
+};
+
+export declare class Tileset3D {
+    rawJson: any;
+    options: Tileset3dOptions;
+    root: Tile3D;
+    traverser: Tileset3DTraverser;
+    cache: TilesetCache;
+    requestScheduler: TileRequestScheduler<string>;
+    selectedTiles: Tile3D[];
+    requestedTiles: Tile3D[];
+    memoryUsageInBytes: number;
+    frameNumber: number;
+    private _tiles;
+    private pendingCount;
+    b3dmMapping: TilesetJSON['b3dmMapping'];
+    /**
+     * Create a new Tileset3D
+     * @param json - TilesetJSON
+     * @param options - Tileset3dOptions
+     */
+    constructor(json: TilesetJSON, options: Tileset3dOptions);
+    get maxMemoryUsage(): number;
+    get asset(): any;
+    get type(): any;
+    get basePath(): any;
+    get modelMatrix(): Matrix4;
+    get geometricError(): number;
+    get lodMetricType(): number;
+    get lodMetricValue(): number;
+    get refine(): 'ADD' | "REPLACE";
+    get tiles(): Tile3D[];
+    get floorInfo(): TilesetJSON['floorInfo'];
+    /** Release resources */
+    reset(): void;
+    /** Is the tileset loaded (update needs to have been called at least once) */
+    isLoaded(): boolean;
+    /**
+     * The callback to post-process tiles after traversal procedure
+     * @param frameState - frame state for tile culling
+     */
+    private onTraversalEnd;
+    loadTile(tile: Tile3D): void;
+    unloadTile(tile: Tile3D): void;
+}
+
+export declare interface Tileset3dOptions {
+    throttleRequests: boolean;
+    maxRequests: number;
+    maxMemoryUsage: number;
+    modelMatrix: Matrix4;
+    maxScreenSpaceError: number;
+    viewDistanceScale: number;
+    onTileLoad: (tile: Tile3D) => any;
+    onTileUnload: (tile: Tile3D) => any;
+    onTileError: (tile: Tile3D, message: string) => any;
+    contentLoader: (tile: Tile3D) => Promise<void>;
+    onTraversalComplete: (selectedTiles: Tile3D[]) => Tile3D[];
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string | Promise<string>;
+    networkSubscribe?: NetworkSubscribe;
+    maxDepth?: number;
+}
+
+export declare class Tileset3DTraverser {
+    root: Tile3D | null;
+    options: TilesetTraverserProps;
+    requestedTiles: Record<string, Tile3D>;
+    selectedTiles: Record<string, Tile3D>;
+    emptyTiles: Record<string, Tile3D>;
+    private _traversalStack;
+    private _emptyTraversalStack;
+    private _frameNumber;
+    constructor(options: TilesetTraverserProps);
+    traverse(root: Tile3D, frameState: TileFrameState): void;
+    reset(): void;
+    private executeTraversal;
+    private updateChildTiles;
+    private updateAndPushChildren;
+    updateTile(tile: Tile3D, frameState: TileFrameState): void;
+    selectTile(tile: Tile3D, frameState: TileFrameState): void;
+    loadTile(tile: Tile3D, frameState: TileFrameState): void;
+    touchTile(tile: Tile3D, frameState: TileFrameState): void;
+    private canTraverse;
+    private shouldLoadTile;
+    private shouldSelectTile;
+    private shouldRefine;
+    private updateTileVisibility;
+    private meetsScreenSpaceErrorEarly;
+    private compareDistanceToCamera;
+    private anyChildrenVisible;
+    private everyChildrenVisibleIsLoaded;
+    private executeEmptyTraversal;
+}
+
+export declare class TilesetCache {
+    private list;
+    private sentinel;
+    constructor();
+    reset(): void;
+    touch(tile: Tile3D): void;
+    add(tile: Tile3D, addCallback?: (tile: Tile3D) => void): void;
+    unloadTile(tile: Tile3D, unloadCallback?: (tile: Tile3D) => void): void;
+    unloadTiles(isOverMemory: () => boolean, unloadCallback?: (tile: Tile3D) => void): void;
+}
+
+export declare interface TilesetJSON {
+    asset: {
+        gltfUpAxis: "X" | "Y" | "Z";
+        version: "1.0";
+    };
+    basePath: string;
+    lodMetricType: "geometricError";
+    geometricError: number;
+    lodMetricValue: number;
+    root: TilesetJSONNode;
+    type: "TILES3D";
+    floorInfo: {
+        ground: number;
+        height: number;
+    }[];
+    b3dmMapping: {
+        b3dm_base_url: string;
+        b3dm_url: Record<string, string>;
+    };
+}
+
+export declare interface TilesetJSONNode {
+    boundingVolume: {
+        box: number[];
+    };
+    content: {
+        uri: string;
+    };
+    id: string;
+    transform?: number[];
+    contentUrl?: string;
+    children: TilesetJSONNode[];
+    lodMetricType: "geometricError";
+    geometricError: number;
+    lodMetricValue: number;
+    refine: "REPLACE" | "ADD";
+    type: "EMPTY" | "SCENEGRAPH" | "MESH";
+}
+
+export declare type TilesetTraverserProps = {
+    loadSiblings: boolean;
+    skipLevelOfDetail: boolean;
+    maxScreenSpaceError: number;
+    maxDepth?: number;
+    onTraversalEnd: (frameState: TileFrameState) => any;
+};
+
+export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "defaultLongitude" | "defaultLatitude" | "maxLatitude" | "minLatitude"> {
+}
+
+export declare interface VRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
+
+export declare type WebXREventTypes = {
+    /** WebXR模式开始，session完成坐标系设置*/
+    webXRSessionStart(): void;
+    /** WebXR模式结束，销毁session*/
+    webXRSessionEnd(): void;
+};
+
+export declare type WebXRSelectType = "Select" | "Squeeze";
+
+export declare class Work {
+    /** 名称 */
+    name: string;
+    /** 编号 */
+    workCode: string;
+    /** 允许访问的安全域名 */
+    allowHosts: string[];
+    /** 过期时间 */
+    expire: Date;
+    /** 初始化参数 */
+    initial: WorkInitial;
+    /** 模型参数 */
+    model?: WorkModel;
+    /** 全景点位信息 */
+    observers: WorkObserver[];
+    /** 数据签发人 */
+    issuer: string;
+    /** 原始数据 */
+    raw: {
+        works: string[];
+        options: string;
+    };
+    /**
+     * 解析 Work 数据
+     * @param obj - work 数据，从如数开发者平台获取
+     * @param options - 配置参数， 可以在此二次设置 baseURL 等参数
+     * @param urlTransform - 配置参数， URL 解析规则
+     * @returns - 签署过的 Work 数据结构
+     */
+    static parse: typeof parseWork;
+    constructor();
+    toJSON(): any;
+}
+
+export declare interface WorkCubeImage {
+    /** 全景图 up */
+    up: string;
+    /** 全景图 down */
+    down: string;
+    /** 全景图 right */
+    right: string;
+    /** 全景图 left */
+    left: string;
+    /** 全景图 front */
+    front: string;
+    /** 全景图 back */
+    back: string;
+}
+
+/** 全景图 */
+export declare interface WorkImage extends WorkCubeImage {
+    /** 深度图 */
+    depth?: string;
+    /** 光照强度图 */
+    luminance?: WorkCubeImage;
+    /** 瓦片信息 */
+    tiles?: WorkTile[];
+}
+
+/** 初始化位姿参数 */
+export declare interface WorkInitial extends Omit<State, "offset" | "distance"> {
+}
+
+/** 模型数据 */
+export declare interface WorkModel {
+    /** 模型文件地址 at3d / domez */
+    file: string;
+    /** 模型贴图文件地址 */
+    textures: string[];
+    /** 模型贴图文件地址的父目录 */
+    textureBase: string;
+    /** 是否开启 bvh 碰撞树，开启会大大加快射线碰撞的执行效率 */
+    bvh: boolean;
+    tiles?: WorkModelTiles;
+}
+
+/** 模型瓦片 */
+export declare interface WorkModelTiles {
+    tileset_url: string;
+    tileset_url_md5: string;
+    b3md_mappings_url: string;
+    b3md_mappings_url_md5: string;
+}
+
+/** 每个点位的数据 */
+export declare interface WorkObserver {
+    /** 点位序号 */
+    panoIndex: number;
+    /** 点位是否激活可用 */
+    active: boolean;
+    /** 点位是否可加载 */
+    loadable: boolean;
+    /** 点位全景图 */
+    images: WorkImage;
+    /** 点位视频 */
+    video?: WorkVideo;
+    /** 可以看到的相关点位序号 */
+    visibleNodes: number[];
+    /** 可以连通的相关点位序号 */
+    accessibleNodes: number[];
+    /** 点位和模型的旋转对齐关系四元数 */
+    quaternion: THREE_2.Quaternion;
+    /** 点位和模型的地面位置坐标关系 */
+    standingPosition: THREE_2.Vector3;
+    /** 点位和模型的观察点坐标关系 */
+    position: THREE_2.Vector3;
+    /** 点位所在楼层 */
+    floorIndex: number;
+}
+
+export declare interface WorkTile {
+    level: number;
+    size: number;
+    up: string;
+    down: string;
+    right: string;
+    left: string;
+    front: string;
+    back: string;
+}
+
+/** 全景视频贴片 */
+export declare interface WorkVideo {
+    /** 视频源 url */
+    source: string;
+    /** 视频源变化矩阵 */
+    matrix: THREE_2.Matrix4;
+    /** 视频源长宽尺寸 */
+    size: THREE_2.Vector2;
+}
+
+export declare class XRButton {
+    static createButton(onClickHook: () => void): HTMLAnchorElement | HTMLButtonElement;
+}
+
+export declare interface XRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
+
+export { }