@realsee/five-webgpu 1.0.0-alpha.1

package/five/controllers/mapview.d.ts

@@ -0,0 +1,138 @@
+import * as THREE from "three/webgpu";
+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;
+        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/webgpu";
+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 | undefined, userAction: boolean): void;
+    /** 移动相机位置 */
+    moveToPosition(position: THREE.Vector3, options: MovePanoOptions | undefined, 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/webgpu";
+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("..").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.CubeRenderTarget;
+    protected pano1DepthCubeRenderTarget?: THREE.CubeRenderTarget;
+    protected pendingTextureTask?: {
+        panoId: PanoId;
+        hash: string;
+        onLoad(colorResponse: NetworkResponse<THREE.Texture, NetWorkMeta[]>, hdrConfig?: any): 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/core/camera.d.ts

@@ -0,0 +1,65 @@
+import * as THREE from "three/webgpu";
+import type { Mode } from "../application/mode";
+interface CameraPose {
+    longitude: number;
+    latitude: number;
+    fov: number;
+    distance: number;
+    offset: THREE.Vector3;
+}
+/** Five 相机 */
+declare class Camera extends THREE.Camera {
+    fov: number;
+    aspect: number;
+    near: number;
+    far: number;
+    perspToOrtho: THREE.Vector2;
+    resolution: THREE.Vector2;
+    pixelRatio: number;
+    /** 相机姿态 */
+    pose: CameraPose;
+    private perspectiveCamera;
+    private orthographicCamera;
+    autoNearFar: boolean;
+    needsRender: boolean;
+    refineModel: boolean;
+    time: number;
+    controllerMode: Mode | null;
+    private lastValues;
+    constructor(fov: number, aspect?: number, near?: number, far?: number, perspToOrtho?: THREE.Vector2, resolution?: THREE.Vector2, pixelRatio?: number);
+    get orthoDistance(): number;
+    get zoom(): number;
+    get top(): number;
+    get bottom(): number;
+    get left(): number;
+    get right(): number;
+    getDirection(target: THREE.Vector3): THREE.Vector3;
+    /** 通过相机参数反算姿态 */
+    computePose(distance?: number): this;
+    /** 设置相机姿态 */
+    setFromPose(pose: Partial<CameraPose>): this;
+    /** 拷贝相机姿态 */
+    copyPose(): CameraPose;
+    private computeProjectionMatrix;
+    setViewOffset(fullWidth: number, fullHeight: number, x: number, y: number, width: number, height: number): void;
+    get view(): {
+        enabled: boolean;
+        fullWidth: number;
+        fullHeight: number;
+        offsetX: number;
+        offsetY: number;
+        width: number;
+        height: number;
+    } | null;
+    clearViewOffset(): void;
+    updateProjectionMatrix(): void;
+    get perspectiveProjectionMatrix(): THREE.Matrix4;
+    get perspectiveProjectionMatrixInverse(): THREE.Matrix4;
+    get orthographicProjectionMatrix(): THREE.Matrix4;
+    get orthographicProjectionMatrixInverse(): THREE.Matrix4;
+    updateTime(time: number): void;
+    get isPerspectiveCamera(): boolean;
+    get isOrthographicCamera(): boolean;
+    copy(source: this, recursive?: boolean): this;
+}
+export { Camera, CameraPose };

package/five/core/internalWebGPURenderer.d.ts

@@ -0,0 +1,13 @@
+import * as THREE from "three/webgpu";
+export type OutputTextureDataType = typeof THREE.HalfFloatType | typeof THREE.UnsignedByteType;
+declare class InternalWebGPURenderer extends THREE.WebGPURenderer {
+    ready: Promise<void>;
+    private _backendReady;
+    constructor({ antialias, logarithmicDepthBuffer, outputType, }: {
+        antialias?: boolean;
+        logarithmicDepthBuffer?: boolean;
+        outputType?: OutputTextureDataType | undefined;
+    });
+    get isInitialized(): boolean;
+}
+export { InternalWebGPURenderer };

package/five/core/panoVideo.d.ts

@@ -0,0 +1,18 @@
+import * as THREE from "three/webgpu";
+interface PanoVideoProps {
+    size: THREE.Vector2;
+    matrix: THREE.Matrix4;
+    panoMatrix: THREE.Matrix4;
+    alpha: number;
+    map: THREE.Texture;
+}
+declare class PanoVideo {
+    private material;
+    object: THREE.Mesh<THREE.BufferGeometry, THREE.ShaderMaterial>;
+    private alphaMotion;
+    constructor();
+    setMaterial(value: PanoVideoProps | null): void;
+    updateTime(time: number): void;
+    dispose(): void;
+}
+export { PanoVideo };

package/five/core/scene.d.ts

@@ -0,0 +1,10 @@
+import * as THREE from "three/webgpu";
+import { AddableObject } from "../types/addableObject";
+/** Five 场景*/
+declare class Scene extends THREE.Scene {
+    needsRender: boolean;
+    add(...objects: AddableObject[]): this;
+    remove(...objects: AddableObject[]): this;
+    update(renderer: THREE.WebGPURenderer, camera: THREE.Camera): boolean;
+}
+export { Scene };

package/five/core/tiling.d.ts

@@ -0,0 +1,56 @@
+import * as THREE from "three/webgpu";
+import { WorkObserver } from "../work";
+import { ImageOptions } from "../types/imageOptions";
+export interface TilingFrameState {
+    time: number;
+    resolution: THREE.Vector2;
+    pixelRatio: number;
+    renderer: THREE.WebGPURenderer;
+    cameraMatrix: THREE.Matrix4;
+    cameraProjectionMatrix: THREE.Matrix4;
+    panoMap: THREE.CubeTexture | null;
+    gainMap?: THREE.CubeTexture;
+    panoMatrix: THREE.Matrix4;
+    panoZoom: number;
+    minLevel: number;
+    level: number;
+    /** HDR：是否启用，以及该 pano 的 gainmap 配置 + 显示增益 */
+    useHDR?: boolean;
+    maxDisplayBoost?: number;
+    hdrConfig?: {
+        gamma?: number;
+        minContentBoost?: number;
+        maxContentBoost?: number;
+        hdrCapacityMin?: number;
+        hdrCapacityMax?: number;
+    };
+}
+export declare class Tiling {
+    private disposed;
+    fiveId: string;
+    level: number;
+    pedding: number;
+    maxRequest: number;
+    appearDuration: number;
+    maxCacheTile: number;
+    imageOptions: ImageOptions;
+    private boundingMesh;
+    private hdrUniforms;
+    private prevHDRKey;
+    private tileTree;
+    private tileMeshes;
+    private textureLoader;
+    observer: WorkObserver | null;
+    frustum: THREE.Frustum;
+    scene: THREE.Scene;
+    camera: THREE.PerspectiveCamera;
+    renderTarget: THREE.RenderTarget;
+    private forceRenderWhenNextUpdate;
+    constructor(options: {
+        fiveId: string;
+    });
+    dispose(): void;
+    cleanup(): void;
+    setObserver(observer: WorkObserver | null): void;
+    update(frameState: TilingFrameState): boolean;
+}

package/five/declare.d.ts

@@ -0,0 +1,35 @@
+import * as THREE from 'three/webgpu';
+import type { Model, ViewLayer, Tile } from './model';
+
+declare module 'three' {
+
+  export interface Raycaster {
+    /**
+     * 只捕获第一个焦点
+     */
+    firstHitOnly?: boolean;
+
+    /**
+     * 对焦点进行筛选
+     */
+    hitFilter?: (intersect: THREE.Intersection & { model?: Model; viewLayer?: ViewLayer; tile?: Tile; }) => boolean;
+
+    /**
+     * 是否由近及远排序， 默认 true
+     */
+    sortByDistance?: boolean;
+
+    /**
+     * 作用楼层
+     */
+    floorIndex?: number;
+
+    /**
+     * 作用楼层
+     * @deprecated
+     * use floorIndex instead.
+     */
+    floor?: number | null;
+  }
+
+}