@realsee/five 6.7.0-alpha.9 → 6.7.1

package/five/index.d.ts

@@ -2,6 +2,20 @@
 
 import * as THREE_2 from 'three';
 
+export declare class AdaptiveLuminancePass extends FivePass {
+    luminanceScreenSampleScale: number;
+    luminanceScale: number;
+    luminanceStep: number;
+    private luminanceTargetBuffer?;
+    private luminancePrevBuffer?;
+    private luminanceNextBuffer?;
+    private progress;
+    constructor();
+    render(renderer: THREE_2.WebGLRenderer, writeBuffer: THREE_2.WebGLRenderTarget, readBuffer: THREE_2.WebGLRenderTarget, deltaTime: number, maskActive?: boolean): void;
+    clearBuffer(): void;
+    dispose(): void;
+}
+
 export declare interface AddableObject extends THREE_2.Object3D {
     /** 是否需要渲染一次 */
     needsRender?: boolean;
@@ -23,15 +37,16 @@ export declare type AjaxResponseType = "arraybuffer" | "blob" | "text";
 export declare type AjaxResponseTypeMapping<K extends AjaxResponseType> = K extends "arraybuffer" ? ArrayBuffer : K extends "blob" ? Blob : K extends "text" ? string : never;
 
 export declare interface AnimationFrame {
-    callback: (time: number, deltaTime: number, ...args: any[]) => void;
+    callback: (time: number, deltaTime: number, ...requestAnimationFrameArgs: RequestAnimationFrameArgs) => void;
     once: boolean;
     delay: number;
     order: number;
+    calls: number;
 }
 
-export declare interface AnimationFrameContext {
-    requestAnimationFrame(...args: any[]): any;
-    cancelAnimationFrame(requestId: any): void;
+export declare interface AnimationFrameContext<Args extends any[] = any[], RequestId = any> {
+    requestAnimationFrame(fn: (...args: RequestAnimationFrameArgs<Args>) => void): RequestId;
+    cancelAnimationFrame(requestId: RequestId): void;
 }
 
 export declare class AnimationFrameLoop {
@@ -48,7 +63,7 @@ export declare class AnimationFrameLoop {
     start(): void;
     stop(): void;
     setContext(context: AnimationFrameContext | null): void;
-    getContext<T extends AnimationFrameContext>(): T | null;
+    getContext<T extends AnimationFrameContext = AnimationFrameContext>(): T | null;
     setLoopType(type: AnimationFrameLoopType): void;
     getLoopType(): AnimationFrameLoopType;
     private requestAnimationFrame;
@@ -75,6 +90,14 @@ export declare interface BaseEvent {
     defaultPrevented: boolean;
 }
 
+export declare class BoundingMesh extends PBMMesh {
+    constructor(options?: {
+        name?: string;
+    });
+    update(renderer: THREE_2.WebGLRenderer, camera: Camera, modelScene: ModelScene): boolean;
+    dispose(): void;
+}
+
 export declare interface BoundingVolume {
     type: 'box' | 'sphere' | 'regin';
     applyMatrix4(matrix: THREE_2.Matrix4): this;
@@ -154,6 +177,15 @@ export declare class Camera extends THREE_2.Camera {
     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;
+    };
     clearViewOffset(): void;
     updateProjectionMatrix(): void;
     get perspectiveProjectionMatrix(): THREE_2.Matrix4;
@@ -324,6 +356,38 @@ export declare class Draco {
 
 export declare const draco: Draco;
 
+/**
+ * EffectComposer
+ *
+ * 基于three.js的EffectComposer，用于管理后处理pass的渲染流程
+ */
+export declare class EffectComposer {
+    renderTarget1: THREE_2.WebGLRenderTarget;
+    renderTarget2: THREE_2.WebGLRenderTarget;
+    writeBuffer: THREE_2.WebGLRenderTarget;
+    readBuffer: THREE_2.WebGLRenderTarget;
+    passes: Pass[];
+    normalMaterial: THREE_2.MeshNormalMaterial;
+    clock: THREE_2.Clock;
+    renderToScreen: boolean;
+    status: {
+        endabledPassNumber: number;
+        needsColorGBuffer: boolean;
+        needsDepthGBuffer: boolean;
+        needsNormalGBuffer: boolean;
+        version: string;
+    };
+    gbuffer: Map<'depth' | 'normal' | 'color', THREE_2.Texture>;
+    constructor();
+    swapBuffers(): void;
+    addPass(pass: Pass): void;
+    insertPass(pass: Pass, index: number): void;
+    render(renderer: THREE_2.WebGLRenderer): boolean;
+    setSize(width: number, height: number): void;
+    updateStatus(): void;
+    dispose(): void;
+}
+
 /**
  * Five 事件列表
  * @description
@@ -386,6 +450,18 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
     "dispose"(): void;
 };
 
+export declare class EyeDomeLightingPass extends FivePass {
+    strength: number;
+    radius: number;
+    neighbours: number;
+    private camera;
+    private fsQuad;
+    private material;
+    constructor(camera: Camera);
+    render(renderer: THREE_2.WebGLRenderer, writeBuffer: THREE_2.WebGLRenderTarget, readBuffer: THREE_2.WebGLRenderTarget, deltaTime: number, maskActive?: boolean): void;
+    dispose(): void;
+}
+
 export declare class Fetcher {
     private options;
     constructor(options?: NetworkOptions);
@@ -484,12 +560,6 @@ export declare class Five extends Subscribe<EventTypes> {
      * 是否按需渲染
      */
     onlyRenderIfNeeds: boolean;
-    /**
-     * 模型是否需要更新渲染
-     * @description
-     * 可以设置modelNeedsRender为true，通知five进行模型渲染的更新
-     */
-    modelSceneNeedsRender: boolean;
     /** 是否显示 Powered By Realsee */
     poweredByRealsee: boolean;
     /** 背景颜色 */
@@ -540,9 +610,7 @@ export declare class Five extends Subscribe<EventTypes> {
     plugins: {
         [key: string]: FivePluginInstance<any>;
     };
-    ident: string;
-    /** 包围盒子 */
-    private boundingMesh;
+    readonly fiveId: string;
     private stopAnimationLoop?;
     private fps;
     private helperGroup;
@@ -560,12 +628,12 @@ export declare class Five extends Subscribe<EventTypes> {
     private requestProxy;
     private networkSubscribe;
     private analysis?;
-    private renderSwitch01;
     private currentUpdateArgs;
-    enableLayeringRendering: boolean;
-    private _builtinRenderer;
-    private _buildInRendererType;
+    private fiveRenderer;
+    private adaptiveLuminancePass;
+    private eyeDomeLightingPass;
     constructor(initArgs?: FiveInitArgs);
+    get ident(): string;
     get panoIndex(): number;
     /**
      * 析构 five 对象。
@@ -586,14 +654,15 @@ export declare class Five extends Subscribe<EventTypes> {
      * ```
      */
     setViewport(viewport: Viewport): void;
+    /**
+     * 获取 boundingMesh
+     */
+    get boundingMesh(): BoundingMesh;
     /**
      * 帮助元素显示/隐藏
      */
     get helperVisible(): boolean;
     set helperVisible(visible: boolean);
-    private getBuiltinRenderer;
-    get renderEffect(): 'default' | 'edl' | 'hq' | 'luminance';
-    set renderEffect(value: "default" | "edl" | "hq" | "luminance");
     updateConfiguration(args: Pick<FiveInitArgs, "panorama" | "model" | "floorplan" | "topview" | "mapview" | "vrPanorama" | "imageOptions" | "textureOptions">, refresh?: boolean): void;
     /**
      * 将显示区域加载到页面 DOM 中
@@ -807,7 +876,8 @@ export declare class Five extends Subscribe<EventTypes> {
      */
     exitFullscreen(): void;
     private throwError;
-    private loadModels;
+    private bindModel;
+    private bindWorkFetcher;
     private commonParams;
     private applyController;
     /** 移除事件绑定 */
@@ -849,29 +919,53 @@ export declare class Five extends Subscribe<EventTypes> {
         lookAtVector: THREE_2.Vector3;
     };
     /**
-     * @deprecated
-     * use five.effect instead
+     * 增加后处理PASS
+     * @param pass - 要添加的Pass实例
      */
-    get enableIOSEDR(): boolean;
-    set enableIOSEDR(enable: boolean);
+    addPass(pass: Pass): void;
     /**
-     * @deprecated
-     * use five.effect instead
+     * 移除后处理Pass
+     * @param pass - 要移除的Pass实例
+     */
+    removePass(pass: Pass): void;
+    /**
+     * 在指定位置插入后处理Pass
+     * @param pass - 要插入的Pass实例
+     * @param index - 插入位置的索引
      */
+    insertPass(pass: Pass, index: number): void;
+    /**
+     * 设置渲染模式
+     */
+    get renderMode(): "default" | "ssaa" | "point-cloud-high-quality";
+    set renderMode(value: "default" | "ssaa" | "point-cloud-high-quality");
+    /** 开启 HQ */
+    get enableHQ(): boolean;
+    set enableHQ(enable: boolean);
+    /** 开启 edl */
     get enableEDL(): boolean;
     set enableEDL(enable: boolean);
+    /** 开启 AdaptiveLuminance */
+    get enableAdaptiveLuminance(): boolean;
+    set enableAdaptiveLuminance(enable: boolean);
     /**
      * @deprecated
-     * use five.effect instead
+     * 不可用
      */
-    get enableHQ(): boolean;
-    set enableHQ(enable: boolean);
+    get enableIOSEDR(): boolean;
+    set enableIOSEDR(enable: boolean);
     /**
      * @deprecated
-     * use five.effect instead
+     * 不可用
      */
     get enablePostProcessing(): boolean;
     set enablePostProcessing(enable: boolean);
+    /**
+     * @deprecated
+     * use five.modelScene.needsRender instead
+     */
+    get modelSceneNeedsRender(): boolean;
+    set modelSceneNeedsRender(needsRender: boolean);
 }
 
 /** Five 初始化参数 */
@@ -1039,38 +1133,55 @@ export declare interface FiveInitArgs {
      */
     requestProxy?(url: string): string | Promise<string>;
     /**
-     * 是否开启分层渲染，默认开启
+     * @deprecated
+     * 无效
      */
     enableLayeringRendering?: boolean;
 }
 
 export declare interface FiveLoadOptions {
+    /** 替换 / 追加 */
+    mode?: 'replace' | "add";
     /** 切换运动时间 */
     duration?: number;
     /** 切换运动全景图效果 */
     effect?: MovePanoEffect;
-    model?: {
-        light?: boolean;
-        /**
-         * 模型贴图的配置参数
-         * @description
-         * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
-         * 平衡加载时间和图片质量
-         */
-        textureOptions?: TextureOptions;
-        /** 模型 3d-tile 参数 */
-        "3d-tiles"?: Tile3dOptions;
-    };
+    model?: ModelOptions;
     /**
      * @deprecated
      * 请通过 model.textureOptions 设置
      */
-    textureOptions?: TextureOptions;
+    textureOptions?: ModelOptions['textureOptions'];
     /**
      * @deprecated
      * 请通过 model.textureOptions 设置
      */
-    "3d-tiles"?: Tile3dOptions;
+    "3d-tiles"?: ModelOptions['3d-tiles'];
+}
+
+/**
+ * FivePass
+ *
+ * Five 引擎优化的 Pass 基类
+ * 支持 G-Buffer 注入，避免重复渲染场景
+ */
+export declare class FivePass implements Pass {
+    static FullScreenQuad: typeof FullScreenQuad;
+    enabled: boolean;
+    needsSwap: boolean;
+    clear: boolean;
+    renderToScreen: boolean;
+    dependencies: ('depth' | 'normal' | 'color')[];
+    /**
+     * G-Buffer 纹理集合
+     * 包含 depth、normal、color 等纹理
+     * 由 EffectComposer 在 render 时注入
+     */
+    gbuffer: Map<'depth' | 'normal' | 'color', THREE_2.Texture>;
+    constructor(dependencies?: ('depth' | 'normal' | 'color')[]);
+    setSize(width: number, height: number): void;
+    render(renderer: THREE_2.WebGLRenderer, writeBuffer: THREE_2.WebGLRenderTarget, readBuffer: THREE_2.WebGLRenderTarget, deltaTime?: number, maskActive?: boolean): void;
+    dispose(): void;
 }
 
 /**
@@ -1100,6 +1211,19 @@ parameters: Parameters<T>[1]
  */
 export declare type FivePluginInstance<T extends FivePlugin<any, any>> = ReturnType<T>;
 
+export declare class FiveRenderer {
+    composer: EffectComposer;
+    composerVersion: string;
+    colorRenderTarget: THREE_2.WebGLRenderTarget;
+    normalRenderTarget: THREE_2.WebGLRenderTarget;
+    renderMode: 'default' | 'ssaa' | 'point-cloud-high-quality';
+    private sceneRenders;
+    constructor();
+    private renderSceneToBuffers;
+    render(renderer: THREE_2.WebGLRenderer, scene: Scene, modelScene: ModelScene, camera: Camera, sceneUpdated: boolean): boolean;
+    dispose(): void;
+}
+
 export declare interface FloorplanControllerCustomInitArgs {
     /** 默认水平角 */
     defaultLongitude?: number;
@@ -1119,6 +1243,21 @@ export declare interface FloorplanControllerCustomInitArgs {
     intersectMeshCreator?: () => IntersectMeshInterface;
 }
 
+/**
+ * 用于全屏渲染的辅助类
+ */
+export declare class FullScreenQuad<T extends THREE_2.Material = THREE_2.Material> {
+    private static camera;
+    private static geometry;
+    private _scene;
+    private _mesh;
+    constructor(material: T);
+    get material(): T;
+    set material(value: T);
+    dispose(): void;
+    render(renderer: THREE_2.WebGLRenderer): void;
+}
+
 export declare interface GestureEvent extends StateEvent {
     target: EventTarget | null;
     pointerType: 'touch' | 'pen' | 'mouse' | 'kinect';
@@ -1838,6 +1977,7 @@ export declare interface LooseWork {
         base_url?: string;
         pano_high_cube_base_url?: string;
         pano_cube_base_url?: string;
+        pattern?: LooseWorkPanorama;
         info?: LooseWorkPanorama[];
         list?: LooseWorkPanorama[];
     };
@@ -1865,6 +2005,7 @@ export declare interface LooseWorkModel {
     file_url?: string;
     material_textures?: string[];
     material_base_url?: string;
+    up_axis?: string;
     coordinate?: NonNullable<TilesetHeader['rootMeta']>['coordinate'];
     tiles?: {
         type?: 'point_cloud' | 'mesh' | string;
@@ -1884,6 +2025,7 @@ export declare interface LooseWorkModel {
 
 export declare interface LooseWorkObserver {
     active?: boolean;
+    loadable?: boolean;
     index?: number;
     visible_nodes?: number[];
     visibleNodes?: number[];
@@ -1905,10 +2047,16 @@ export declare interface LooseWorkObserver {
     derived_id_str?: string;
 }
 
-export declare interface LooseWorkPanorama extends Record<CubeFace, string> {
+export declare interface LooseWorkPanorama {
     active?: boolean;
     loadable?: boolean;
     index?: number;
+    right?: string;
+    left?: string;
+    up?: string;
+    down?: string;
+    front?: string;
+    back?: string;
     video?: LooseWorkVideo;
     tiles?: number[];
     size_list?: number[];
@@ -2045,6 +2193,7 @@ export declare interface Model {
  * 通过 json_xxxxxx(<dataURL>) 方式返回。
  */
 export declare class Model extends THREE_2.Object3D {
+    fiveId: string;
     parent: ModelScene | null;
     needsRender: boolean;
     children: ViewLayer[];
@@ -2066,14 +2215,14 @@ export declare class Model extends THREE_2.Object3D {
     /** 模型细化进度 */
     refineProgress: [number, number];
     /** 初始化完成 */
-    initReady: Promise<void>;
+    initReady: Promise<Model>;
     /** 初次加载完成 */
-    loadedReady: Promise<void>;
+    loadedReady: Promise<Model>;
     /** 外接盒子的大小 */
     boundingBox: THREE_2.Box3;
     /** 所有楼层 */
     floorLength: number;
-    constructor(work: Work, options?: {
+    constructor(fiveId: string, work: Work, options?: {
         light?: boolean;
         textureOptions?: TextureOptions;
     });
@@ -2171,9 +2320,26 @@ export declare interface ModelEvent extends BaseEvent {
     error: Error | null;
 }
 
-export declare interface ModelLike extends THREE_2.Object3D {
-    update?(renderer: THREE_2.WebGLRenderer, camera: Camera, modelScene: ModelScene): boolean;
-    dispose?: () => void;
+export declare interface ModelOptions {
+    /** 模型是否感光 */
+    light?: boolean;
+    /** 模型 3d-tile 参数 */
+    "3d-tiles"?: (Partial<ParameterTilesetValue> & {
+        viewerRequestVolume?: BoundingVolume | BoundingVolumeJson;
+        showLayers?: boolean | string[];
+    }) | ((viewLayer: ViewLayer, model: Model) => void | (Partial<ParameterTilesetValue> & {
+        viewerRequestVolume?: BoundingVolume | BoundingVolumeJson;
+        showLayers?: boolean | string[];
+    }));
+    /**
+     * 模型贴图的配置参数
+     * @description
+     * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
+     * 平衡加载时间和图片质量
+     */
+    textureOptions?: TextureOptions;
+    /** 强制显示模型，不等待加载完 */
+    forceReplaceImmediately?: boolean;
 }
 
 export declare type Models = Model[] & {
@@ -2229,13 +2395,48 @@ export declare type Models = Model[] & {
     resetBrightness(): void;
 };
 
+export declare interface ModelScene {
+    dispatchEvent(event: {
+        type: 'model.create';
+        model: Model;
+    }): void;
+    dispatchEvent(event: {
+        type: 'model.dispose';
+        model: Model;
+    }): void;
+    dispatchEvent(event: {
+        type: string;
+        [attachment: string]: any;
+    }): void;
+    addEventListener(type: 'model.create', listener: (event: THREE_2.Event & {
+        type: 'model.create';
+        model: Model;
+    }) => void): void;
+    addEventListener(type: 'model.dispose', listener: (event: THREE_2.Event & {
+        type: 'model.dispose';
+        model: Model;
+    }) => void): void;
+    addEventListener(type: string, listener: (event: THREE_2.Event) => void): void;
+    removeEventListener(type: 'model.create', listener: (event: THREE_2.Event & {
+        type: 'model.create';
+        model: Model;
+    }) => void): void;
+    removeEventListener(type: 'model.dispose', listener: (event: THREE_2.Event & {
+        type: 'model.dispose';
+        model: Model;
+    }) => void): void;
+    removeEventListener(type: string, listener: (event: THREE_2.Event) => void): void;
+}
+
 export declare class ModelScene extends THREE_2.Scene {
+    fiveId: string;
     needsRender: boolean;
-    children: ModelLike[];
     /** 自动细化 */
     autoRefine: boolean;
     /** 包围盒 */
     boundingBox: THREE_2.Box3;
+    /** 包围盒 Mesh */
+    boundingMesh: BoundingMesh;
     /** 加载完成 */
     loaded: boolean;
     /** 细化完成 */
@@ -2246,9 +2447,13 @@ export declare class ModelScene extends THREE_2.Scene {
     parameter: Parameter;
     /** 模型列表 */
     readonly models: Models;
-    constructor();
-    add(...objects: ModelLike[]): this;
-    remove(...objects: ModelLike[]): this;
+    private readonly shownModels;
+    private updateModelMap;
+    constructor(options: {
+        fiveId: string;
+    });
+    setModels(works: Works, options: ModelOptions): Model[];
+    get empty(): boolean;
     /**
      * 计算模型射线碰撞检测
      * @param raycaster - THREE 射线对象
@@ -2277,6 +2482,7 @@ export declare class ModelScene extends THREE_2.Scene {
      * Use `.parameter.reset('brightness')` instead
      */
     resetBrightness(): void;
+    dispose(): void;
 }
 
 export declare interface ModelSceneEvent extends BaseEvent {
@@ -2611,7 +2817,9 @@ export declare interface PanoramaControllerCustomInitArgs extends PanoramaLikeCo
      */
     panoTapTriggerRadius?: number;
     /** 地面观察点标识自定义创建器 */
-    panoCircleMeshCreator?: (pano: Pano) => PanoCircleMeshInterface;
+    panoCircleMeshCreator?: (observer: WorkObserver, options: {
+        aerialObserverMinHeight: number;
+    }) => PanoCircleMeshInterface;
     /** 基于模型调整 地面观察点 的位置 */
     adjustPanoCircleMeshPositionBasedOnModel?: boolean;
     /**
@@ -2650,6 +2858,8 @@ export declare interface PanoramaLikeControllerCustomInitArgs {
     moveSpeed?: number;
     /** 鼠标焦点环自定义创建器 */
     intersectMeshCreator?: () => IntersectMeshInterface;
+    /** 航拍点最小高度 */
+    aerialObserverMinHeight?: number;
 }
 
 export declare function panoStringify(pano: Pano): PanoId;
@@ -2697,8 +2907,6 @@ declare interface ParameterMaterialValue {
     refinedScreen: PBMRefinedScreen | null;
     /** 模型贴图和全景图的混合程度 [0-1] */
     modelAlpha: number;
-    /** 深度写入alpha */
-    logDepthAlpha: number;
     /** 全景图混合程度 [0-1] */
     progress: number;
     /** 全景图过度混合 */
@@ -2784,7 +2992,6 @@ export declare interface ParameterTilesetValue {
     requestOrder: TileRequestOrder;
     /** 模型屏幕空间误差计算最大值 */
     maxScreenSpaceError: number;
-    memoryAdjustedOverflow: number;
     memoryAdjustedScreenSpaceError: boolean;
     /** 缓存相机 */
     cacheCameras: readonly (Camera | THREE_2.PerspectiveCamera)[];
@@ -2816,6 +3023,19 @@ export declare type ParseOptions = {
  */
 export declare function parseWork(obj: Work | LoosePanoWork | LooseWork | string | any, options?: ParseOptions): Work;
 
+/**
+ * Pass基类
+ * three.js 的 Pass 接口，用于 EffectComposer
+ */
+export declare interface Pass {
+    enabled: boolean;
+    needsSwap: boolean;
+    clear: boolean;
+    renderToScreen: boolean;
+    setSize(width: number, height: number): void;
+    render(renderer: THREE_2.WebGLRenderer, writeBuffer: THREE_2.WebGLRenderTarget, readBuffer: THREE_2.WebGLRenderTarget, deltaTime?: number, maskActive?: boolean): void;
+}
+
 export declare type PBMAlphaMode = 'OPAQUE' | 'MASK' | 'BLEND';
 
 export declare interface PBMClipperParameter {
@@ -2972,7 +3192,6 @@ export declare class PBMMeshMaterial extends PBMMaterial implements THREE_2.Mesh
     pano1Depth: PBMPanoDepth | null;
     refinedScreen: PBMRefinedScreen | null;
     modelAlpha: number;
-    logDepthAlpha: number;
     progress: number;
     transition: PBMTransition;
     colorStyle: PBMColorStyle;
@@ -3012,7 +3231,6 @@ export declare interface PBMMeshMaterialParameters extends THREE_2.MaterialParam
     pano1?: PBMPanoPicture | null;
     refinedScreen?: PBMRefinedScreen | null;
     modelAlpha?: number;
-    logDepthAlpha?: number;
     progress?: number;
     transition?: PBMTransition;
     colorStyle?: PBMColorStyle;
@@ -3078,7 +3296,6 @@ export declare class PBMPointCloudMaterial extends PBMMaterial {
     pointShape: PBMPointShape;
     pointBack: PBMPointBack;
     modelAlpha: number;
-    logDepthAlpha: number;
     colorStyle: PBMColorStyle;
     constantColor: THREE_2.Vector3;
     floorIndex: number;
@@ -3118,7 +3335,6 @@ export declare interface PBMPointCloudMaterialParameters extends THREE_2.Materia
     pointShape?: PBMPointShape;
     pointBack?: PBMPointBack;
     modelAlpha?: number;
-    logDepthAlpha?: number;
     colorStyle?: PBMColorStyle;
     constantColor?: THREE_2.Vector3;
     floorIndex?: number;
@@ -3214,6 +3430,8 @@ export declare interface RenderEvent extends BaseEvent {
     needsRender: boolean;
 }
 
+export declare type RequestAnimationFrameArgs<Args extends any[] = any[]> = [domHighResTimeStamp: number, ...args: Args];
+
 export declare interface ResolvedParameterValue extends ParameterValue {
     versions: string[];
     version: string;
@@ -3658,14 +3876,6 @@ declare interface Tile3DOptions {
 export { Tile3DOptions as Tile3DModelLoaderOptions }
 export { Tile3DOptions }
 
-export declare type Tile3dOptions = (Partial<ParameterTilesetValue> & {
-    viewerRequestVolume?: BoundingVolume | BoundingVolumeJson;
-    showLayers?: boolean | string[];
-}) | ((viewLayer: ViewLayer, model: Model, modelIndex: number) => void | (Partial<ParameterTilesetValue> & {
-    viewerRequestVolume?: BoundingVolume | BoundingVolumeJson;
-    showLayers?: boolean | string[];
-}));
-
 export declare class TileCache {
     private options;
     private cacheNodeMap;
@@ -3716,11 +3926,12 @@ export declare interface TileHeader {
 
 export declare class TileNode extends THREE_2.Object3D {
     materials: THREE_2.Material[];
+    animations: THREE_2.AnimationClip[];
     pbmObjects: (PBMMesh | PBMSkinnedMesh | PBMPointCloud)[];
     private contentObject;
     private appearMotion;
     private disposers;
-    constructor(name: string, contentObject: THREE_2.Object3D, disposer?: () => void);
+    constructor(name: string, contentObject: THREE_2.Object3D, animations: THREE_2.AnimationClip[], disposer?: () => void);
     generateBvhTree(): Promise<this>;
     intersectRaycaster(raycaster: THREE_2.Raycaster, target?: Intersection[]): Intersection[];
     update(renderer: THREE_2.WebGLRenderer, camera: Camera, modelScene: ModelScene, tile3d: Tile3D, tile: Tile, parameterValue: ResolvedParameterValue): boolean;
@@ -3786,6 +3997,9 @@ export declare class Tileset {
     pointLength: number;
     floorLength: number;
     constructor(header: TilesetHeader, options: TilesetOptions);
+    /**
+     * 通过当前的内存使用，推测 maxScreenSpaceError
+     */
     private adjustScreenSpaceError;
     private getTraverser;
     /** Release resources */
@@ -3820,7 +4034,6 @@ export declare type TilesetFrameState = {
     maxRequests: number;
     requestOrder: TileRequestOrder;
     maxScreenSpaceError: number;
-    memoryAdjustedOverflow: number;
     memoryAdjustedScreenSpaceError: boolean;
     maxMemoryUsage: number;
 };
@@ -3866,7 +4079,7 @@ export declare interface TilesetHeader {
         numFloors?: number;
         /** 点云的点数量 */
         numTotalPoints?: number;
-        /** 采��轨迹数量 */
+        /** 采集轨迹数量 */
         numTrajectories?: number;
         /** 点云的 pnts 数据的排序规则 */
         pntsOrder?: "RANDOM" | "UNSORTED";
@@ -3905,7 +4118,7 @@ export declare interface TilesetOptions {
     onTrajectoryError: (trajectory: Trajectory, error: Error) => any;
 }
 
-export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "defaultLongitude" | "defaultLatitude" | "maxLatitude" | "minLatitude"> {
+export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
 }
 
 export declare class Trajectory {
@@ -4083,6 +4296,8 @@ export declare interface WorkImage extends WorkCubeImage {
     sizeList: readonly number[];
     /** 瓦片信息 */
     tiles: readonly WorkTile[];
+    /** 点位视频 */
+    video?: WorkVideo;
 }
 
 /** 初始化位姿参数 */
@@ -4137,6 +4352,8 @@ export declare interface WorkModel {
     textures?: readonly string[];
     /** 模型贴图文件地址的父目录 */
     textureBase?: string;
+    /** 指定上方向，对于 obj， ply 等定义不明确的需要指定上方向 */
+    upAxis?: string;
     /** 模型的地理坐标数据 */
     coordinate?: NonNullable<TilesetHeader['rootMeta']>['coordinate'];
     /** 3d tile */
@@ -4147,14 +4364,20 @@ export declare interface WorkModelJson {
     file_url?: string;
     material_textures?: string[];
     material_base_url?: string;
+    up_axis?: string;
     layers?: WorkModelLayerJson[];
 }
 
 export declare interface WorkModelLayer {
+    /** work */
     work: Work;
+    /** 模型类型 point_cloud mesh */
     type: 'point_cloud' | 'mesh';
+    /** 模型名称 */
     name: string;
+    /** 指定上方向 */
     upAxis: string;
+    /** 如果 tileset.json 地址 */
     tileset: string;
 }
 
@@ -4178,22 +4401,24 @@ export declare interface WorkObserver {
      * @example
      * `${workCode}[${panoIndex}]`
      */
-    panoId: string;
+    panoId: PanoId;
     /** 点位所在楼层 */
     floorIndex: number;
     /** 点位 derived_id */
-    derivedId?: number;
+    derivedId: number;
     /** 点位 derived_id_str */
-    derivedIdStr?: string;
+    derivedIdStr: string;
     /** 点位是否激活可用 */
     active: boolean;
     /** 点位是否可加载 */
     loadable: boolean;
     /** 点位全景图 */
     images: WorkImage;
-    /** 点位视频 */
-    video?: WorkVideo;
-    /** 可以看到的相关点位序号 */
+    /**
+     * @deprecated
+     * 可以看到的相关点位序号
+     * 数据和 accessibleNodes 一致，使用 accessibleNodes
+     */
     visibleNodes: readonly number[];
     /** 可以连通的相关点位序号 */
     accessibleNodes: readonly number[];
@@ -4210,6 +4435,8 @@ export declare interface WorkObserver {
 export declare interface WorkObserverJson {
     index: number;
     floor_index: number;
+    derived_id: number;
+    derived_id_str: string;
     position: number[];
     standing_position: number[];
     quaternion: {
@@ -4269,7 +4496,6 @@ export declare type Works = ReadonlyArray<Work> & {
 export declare interface WorksEvent extends BaseEvent {
     input: any;
     works: Works;
-    state: Partial<State>;
     userAction: boolean;
 }