@realsee/five 5.0.0-alpha.53 → 5.0.0-alpha.54

package/five/index.d.ts

@@ -6,17 +6,150 @@ export declare interface AddableObject extends THREE_2.Object3D {
     setResolution?(width: number, height: number): void;
 }
 
+export declare interface AnimationFrame {
+    callback: (time: number, deltaTime: number) => void;
+    once: boolean;
+    delay: number;
+    order: number;
+}
+
+export declare class AnimationFrameLoop {
+    private frames;
+    private time;
+    private stoped;
+    private static sharedInstance?;
+    static get shared(): AnimationFrameLoop;
+    constructor();
+    private loop;
+    private remove;
+    /**
+     * 添加到动画循环
+     * @param callback - 动画循环回调
+     * @param once - 是否只回调一次
+     * @param delay - 延迟多少个动画循环回调
+     * @param order - 优先级，数字越小越早被调用
+     * @returns 移除动画循环函数
+     */
+    add(callback: AnimationFrame["callback"], once?: boolean, delay?: number, order?: number): () => void;
+    disponse(): void;
+    /**
+     * 获取下一帧间隔时间
+     * @param callback - 返回下一帧间隔时间
+     */
+    getFrameTime(callback: (deltaTime: number) => void): () => void;
+}
+
+export declare class BVH {
+    _trianglesArray: Float32Array;
+    _maxTrianglesPerNode: number;
+    _bboxArray: Float32Array;
+    _bboxHelper: Float32Array;
+    _rootNode: BVHNode | null;
+    _nodesToSplit: BVHNode[];
+    constructor(trianglesArray: Float32Array, maxTrianglesPerNode?: number);
+    private calcBoundingBoxes;
+    splitNode(): void;
+    private _splitNode;
+    /**
+     * 计算包围盒
+     * @param startIndex - 开始的三角形序号
+     * @param endIndex - 结束的三角形序号
+     * @param expandBy - 外面扩展
+     */
+    private calcExtents;
+    /**
+     * 计算射线与三角形的碰撞
+     * @param rayOrigin - 射线的原点坐标
+     * @param rayDirection - 设想的方向向量
+     * @param backfaceCulling - 是否背面剔除
+     * @return 碰撞焦点数组
+     */
+    intersectRay(rayOrigin: BVHVector3, rayDirection: BVHVector3, backfaceCulling: boolean): BVHIntersect[];
+    dispose(): void;
+}
+
+export declare interface BVHIntersect {
+    triangle: [BVHVector3, BVHVector3, BVHVector3];
+    triangleIndex: number;
+    intersectionPoint: BVHVector3;
+}
+
+/**
+ * A node in the BVH structure
+ * @param extentsMin - the min coords of this node's bounding box
+ * @param extentsMax - the max 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 {
+    _extentsMin: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    _extentsMax: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    _startIndex: number;
+    _endIndex: number;
+    _level: number;
+    _node0: BVHNode | null;
+    _node1: BVHNode | null;
+    elementCount: number;
+    center: number[];
+    size: number[];
+    order: number[];
+    constructor(extentsMin: {
+        x: number;
+        y: number;
+        z: number;
+    }, extentsMax: {
+        x: number;
+        y: number;
+        z: number;
+    }, startIndex: number, endIndex: number, level: number);
+    clearShapes(): void;
+}
+
+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: ArrayLike<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: Pose;
+    pose: CameraPose;
     constructor(fov: number);
     /** 通过相机参数反算姿态 */
-    computePose(): void;
+    computePose(): this;
     /** 设置相机姿态 */
-    setFromPose(pose: Partial<Pose>): void;
+    setFromPose(pose: Partial<CameraPose>): this;
     /** 拷贝相机姿态 */
-    copyPose(): Pose;
+    copyPose(): CameraPose;
+}
+
+export declare interface CameraPose {
+    longitude: number;
+    latitude: number;
+    fov: number;
+    distance: number;
+    offset: THREE_2.Vector3;
 }
 
 export declare type ControllerCustomInitTypes = {
@@ -156,20 +289,14 @@ export declare type ControllerEventTypes = {
      * @param final - 是否手势结束
      * @returns 可以通过 `return false` 阻止
      */
-    wantsGesture(type: GestureTypes, pointers: {
-        x: number;
-        y: number;
-    }[], final: boolean): void | false;
+    wantsGesture(type: GestureTypes, pointers: any[], final: boolean): void | false;
     /**
      * 手势 触发
      * @param type - 手势类型
      * @param pointers - 手指位置
      * @param final - 是否手势结束
      */
-    gesture(type: GestureTypes, pointers: {
-        x: number;
-        y: number;
-    }[], final: boolean): void;
+    gesture(type: GestureTypes, pointers: any[], final: boolean): void;
     /**
      * 意图要触发 pan 手势(滑动屏幕)， 可以通过 `return false` 阻止
      * @param pose - 意图的相机姿态
@@ -286,7 +413,7 @@ export declare type ControllerEventTypes = {
      * @param panoIndex - 加载点位下标
      * @param observer - 对应的 observer 详情
      */
-    textureLoaded(panoIndex: number, observer: WorkObserver, meta: (Meta | null)[]): void;
+    textureLoaded(panoIndex: number, observer: WorkObserver, meta: (NetWorkMeta | null)[]): void;
     /**
      * 抛出错误
      * @param error - 抛出错误
@@ -297,69 +424,17 @@ export declare type ControllerEventTypes = {
 export declare interface DepthPanoramaControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
     /** 最远可移动观察点距离 */
     maxAccessibleDistance?: number;
+    /**
+     * 点击地面观察点标识的判定范围
+     * @description
+     * 如果在判定范围内则确定去到目标点，
+     * 否则寻找点击位置方向最适合的点（可能会走到一个离相机更近的点）。
+     */
+    panoTapTriggerRadius?: number;
     /** 地面观察点标识自定义创建器 */
     panoCircleMeshCreator?: () => PanoCircleMeshInterface;
 }
 
-/**
- * 动画变化曲线
- */
-export declare const Easing: {
-    Linear: {
-        None: (amount: number) => number;
-    };
-    Quadratic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Cubic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Quartic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Quintic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Sinusoidal: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Exponential: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Circular: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Elastic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Back: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Bounce: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-};
-
 /**
  * Five 事件列表
  * @description
@@ -380,7 +455,7 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      */
     error(error: Error): void;
     /**
-     * 开始加载 Work 数据
+     * 准备加载 Work 数据
      * @param input - 输入的 work
      * @param work - 归一化的标准 work
      * @param state - 加载时的姿态
@@ -394,7 +469,7 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      */
     load(input: any, work: Work, state: Omit<State, "offset">): void;
     /**
-     * 开始加载 Work 数据
+     * 加载完 Work 数据
      * @param input - 输入的 work
      * @param work - 归一化的标准 work
      */
@@ -513,7 +588,7 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      * @param state - 状态
      * @param detail - 详情
      */
-    network(source: string, state: NetworkState, detail: string): void;
+    network(source: string, type: NetworkType, state: NetworkState, detail: string): void;
     /** five 被析构。 插件中请监听用于自身析构 */
     dispose(): void;
 };
@@ -550,62 +625,6 @@ export declare class Five extends Subscribe<EventTypes> {
      * 请使用 `import { Line } from "@realsee/five/line"` 代替;
      */
     static Line: any;
-    /** Five 的动画函数*/
-    static Easing: {
-        Linear: {
-            None: (amount: number) => number;
-        };
-        Quadratic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Cubic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Quartic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Quintic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Sinusoidal: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Exponential: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Circular: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Elastic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Back: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Bounce: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-    };
     /**
      * 自动播放状态是否暂停
      * @description
@@ -661,7 +680,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
      * 平衡加载时间和图片质量
      */
-    textureOptions: ImageOptions;
+    textureOptions: TextureOptions;
     /**
      * 模型贴图的配置参数
      * @description
@@ -692,11 +711,12 @@ export declare class Five extends Subscribe<EventTypes> {
     plugins: {
         [key: string]: FivePluginInstance<any>;
     };
-    private ident;
+    ident: string;
+    private stopAnimationLoop?;
+    private fps;
     private helperGroup;
     private modeChangeDuration;
     private onlyRenderIfNeeds;
-    private maxFps;
     private poweredByRealsee;
     private controller?;
     private destroyed;
@@ -704,11 +724,10 @@ export declare class Five extends Subscribe<EventTypes> {
     private controllerInits;
     private panoramaLikeSavedPose;
     private extraElements;
-    private moveToPanoQueue?;
     private getPixelsRenderTarget;
-    private tweenCoordinates?;
     private readyCallbacks;
     private modelPending;
+    private syncingState;
     /**
      * 是否开启 IOS EDR 模式
      * 需要客户端配合
@@ -802,7 +821,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * @param userAction - 是否用户触发
      * @returns Promise 是否移动成功
      */
-    updateCamera(pose: Partial<Pose>, duration: number, userAction?: boolean): Promise<void>;
+    updateCamera(pose: Partial<Omit<Pose, "offset">>, duration: number, userAction?: boolean): Promise<void>;
     /**
      * 获取当前相机经纬度
      * @deprecated 请使用使用 getPose
@@ -861,8 +880,9 @@ export declare class Five extends Subscribe<EventTypes> {
      * @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): Promise<void>;
+    changeMode<T extends Mode>(mode: T, state?: Partial<Omit<State, "mode">>, duration?: number, userAction?: boolean, force?: boolean): Promise<void>;
     /**
      * 获取画面中的像素颜色
      * @param x - 获取像素区域的起始坐标 x
@@ -877,10 +897,6 @@ export declare class Five extends Subscribe<EventTypes> {
      * 获取显示用的画布（Canvas DOM节点）
      */
     getElement(): HTMLCanvasElement | undefined;
-    /**
-     * 但停自动播放
-     */
-    pause(): void;
     /**
      * 强制渲染
      * @description
@@ -893,6 +909,11 @@ export declare class Five extends Subscribe<EventTypes> {
      * @param callback - 渲染完成回调
      */
     render(callback?: () => void, updateObjectResolution?: boolean): THREE_2.WebGLRenderTarget;
+    updateTime(time: number, deltaTime: number): void;
+    /**
+     * 但停自动播放
+     */
+    pause(): void;
     play(): void;
     /**
      * 转化到 Panorama 模态，并移动到对应序号的观察点。
@@ -1159,34 +1180,33 @@ export declare type GestureTypes = "pan" | "tap" | "pinch" | "mouseWheel";
 
 export declare function getViewportScale(): number;
 
-export declare class HashCubeTexture extends THREE_2.CubeTexture {
-    /** 识别哈希 */
-    hash: string;
-    meta: (Meta | null)[];
-}
-
 /**
  * 图片参数
  */
 export declare interface ImageOptions {
-    key?: string;
     /**
      * url 地址转化
      * @param url - 原始地址
      * @param options - 当前地址参数
      * @returns 转化后地址
      */
-    transform?: (url: string, options: ImageOptions) => string;
+    transform?: (url: string, options: ImageURLOptions) => string;
     /** 图片尺寸参数 */
     size?: number;
     /** 图片质量参数(0-100) */
     quality?: number;
     /** 图片格式参数（jpg, png） */
-    format?: string;
-    /** basis loader 是否初始化完成 */
-    basisLoaderInitialized?: boolean;
-    /** 针对 textureOptions 是否自动通过模型贴图的数量计算需要的模型贴图的尺寸 默认 true */
-    autoResize?: boolean;
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+}
+
+export declare interface ImageURLOptions {
+    key: string;
+    basisLoaderInitialized: boolean;
+    size?: number;
+    quality?: number;
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    cut?: [x: number, y: number, width: number, height: number];
+    sharpen?: number;
 }
 
 export declare class InternalWebGLRenderer extends THREE_2.WebGLRenderer {
@@ -1271,7 +1291,15 @@ export declare type LooseWorkPanorama = {
     front: string;
     back: string;
     video?: LooseWorkVideo;
-    tiles?: string;
+    luminance?: {
+        up: string;
+        down: string;
+        right: string;
+        left: string;
+        front: string;
+        back: string;
+    };
+    tiles?: number[];
 };
 
 export declare type LooseWorkVideo = {
@@ -1280,16 +1308,6 @@ export declare type LooseWorkVideo = {
     size: number[];
 };
 
-export declare type Meta = {
-    source: string;
-    headers: {
-        [name: string]: string;
-    };
-    requestTime: number;
-    responseTime: number;
-    costs: number;
-};
-
 export declare type Mirror<T extends string> = Record<T, T>;
 
 /**
@@ -1360,8 +1378,8 @@ export declare class Model extends PBMContainer implements Subscribe<ModelEventT
      */
     emit: SubscribeMixinType.emit<ModelEventType>;
     /** bvh 树的计算结果 */
-    bvhs: any[] & {
-        loaded?: boolean;
+    bvhs: BVH[] & {
+        loaded: boolean;
     };
     /** 网络跟踪 */
     private networkSubscribe?;
@@ -1408,13 +1426,13 @@ export declare class Model extends PBMContainer implements Subscribe<ModelEventT
      * @returns 返回碰撞
      */
     intersectRaycaster(raycaster: THREE_2.Raycaster, floors?: number | number[]): Intersection[];
-    buildBVH(): Promise<void>;
+    buildBVH(): void;
     /**
      * 加载模型
      * @param workModel - work 的 model 内容
      * @param imageOptions - 图片参数
      */
-    load(workModel: WorkModel, imageOptions?: ImageOptions): Promise<void>;
+    load(workModel: WorkModel, textureOptions?: TextureOptions): Promise<void>;
     /**
      * 析构函数
      * @description
@@ -1504,21 +1522,39 @@ export declare interface MovePanoOptions extends Partial<Omit<Pose, "offset">> {
     moveCancelCallback?: () => void;
 }
 
-export declare type NetworkState = "ok" | "preload" | "error" | "abort" | "timeout" | "forbidden";
+export declare type NetWorkMeta = {
+    source: string;
+    headers: {
+        [name: string]: string;
+    };
+    requestTime: number;
+    responseTime: number;
+    costs: number;
+    size?: number;
+};
+
+export declare type NetworkState = "ok" | "preload" | "error" | "timeout" | "forbidden";
 
 export declare class NetworkSubscribe extends Subscribe<{
-    network(source: string, state: NetworkState, detail: string): void;
+    network(source: string, type: NetworkType, state: NetworkState, detail: string): void;
 }> {
 }
 
+export declare type NetworkType = "XMLHttpRequest" | "Script" | "Image" | "Link";
+
 export declare interface PanoCircleMeshInterface extends THREE_2.Object3D {
     needsRender: boolean;
+    /** 当前高亮 */
+    current: boolean;
+    /** 是否当前高亮 */
+    setCurrent(current: boolean): void;
     loading: boolean;
-    disabled: boolean;
-    panoIndex: number;
     setLoading(shown: boolean): void;
+    disabled: boolean;
     setDisabled(disabled: boolean): void;
+    progress: number;
     setProgress(progress: number): void;
+    opacity: number;
     setOpacity(opacity: number): void;
     dispose(): void;
 }
@@ -1535,6 +1571,7 @@ export declare interface PanoramaControllerCustomInitArgs extends PanoramaLikeCo
     panoTapTriggerRadius?: number;
     /** 地面观察点标识自定义创建器 */
     panoCircleMeshCreator?: () => PanoCircleMeshInterface;
+    tileLevelForFov?: false | ((fov: number) => number);
 }
 
 export declare interface PanoramaLikeControllerCustomInitArgs {
@@ -1609,14 +1646,10 @@ export declare class PBMGroup extends PBMContainer {
 
 /** PBM 材质 */
 export declare class PBMMaterial extends THREE_2.ShaderMaterial implements PBMParameters {
-    /** 起始点位全景图 */
-    pano0Map: HashCubeTexture | null;
-    /** 起始点全景图变换矩阵 4x4 */
-    pano0Matrix: THREE_2.Matrix4;
-    /** 结束点位全景图 */
-    pano1Map: HashCubeTexture | null;
-    /** 结束点全景图变换矩阵 4x4 */
-    pano1Matrix: THREE_2.Matrix4;
+    /** 起始点 */
+    pano0: PBMPanoPicture | null;
+    /** 结束点 */
+    pano1: PBMPanoPicture | null;
     /** 模型贴图和全景图的混合程度 [0-1] */
     modelAlpha: number;
     /** 全景图混合程度 [0-1] */
@@ -1626,20 +1659,8 @@ export declare class PBMMaterial extends THREE_2.ShaderMaterial implements PBMPa
     perspToOrtho: number;
     /** 模型透明度 */
     opacity: number;
-    /** 起始点位深度, 需要使用深度参与计算全景图混合的话 */
-    pano0DepthMap: THREE_2.CubeTexture | null;
-    /** 全景视频贴图 */
-    panoVideoMap: THREE_2.VideoTexture | null;
-    /** 全景视频尺寸 */
-    panoVideoSize: THREE_2.Vector2;
-    /** 全景视频贴图变换矩阵 */
-    panoVideoMatrix: THREE_2.Matrix4;
-    /** 全景视频透明度 [0-1] */
-    panoVideoAlpha: number;
-    /** 瓦片材质 */
-    panoTileMap: THREE_2.Texture | null;
-    /** 瓦片寻址规则 */
-    panoTileMappings: THREE_2.Vector4[][] | null;
+    /** 视频 */
+    panoVideo: PBMPanoVideo | null;
     constructor(parameters?: Partial<PBMParameters>);
 }
 
@@ -1651,16 +1672,32 @@ export declare class PBMMesh extends THREE_2.Mesh<THREE_2.BufferGeometry, PBMMat
     needsRender: boolean;
 }
 
-/** PBM 材质参数 */
-export declare interface PBMParameters {
+export declare interface PBMPanoPicture {
     /** 起始点位全景图 */
-    pano0Map: HashCubeTexture | null;
+    map: THREE_2.CubeTexture;
+    /** 亮度增益 */
+    luminanceMap: THREE_2.CubeTexture | null;
     /** 起始点全景图变换矩阵 4x4 */
-    pano0Matrix: THREE_2.Matrix4;
-    /** 结束点位全景图 */
-    pano1Map: HashCubeTexture | null;
-    /** 结束点位全景图变换矩阵 */
-    pano1Matrix: THREE_2.Matrix4;
+    matrix: THREE_2.Matrix4;
+}
+
+export declare interface PBMPanoVideo {
+    /** 全景视频贴图 */
+    map: THREE_2.VideoTexture | null;
+    /** 全景视频尺寸 */
+    size: THREE_2.Vector2;
+    /** 全景视频贴图变换矩阵 */
+    matrix: THREE_2.Matrix4;
+    /** 全景视频透明度 [0-1] */
+    alpha: number;
+}
+
+/** PBM 材质参数 */
+export declare interface PBMParameters {
+    /** 起始点 */
+    pano0: PBMPanoPicture | null;
+    /** 结束点 */
+    pano1: PBMPanoPicture | null;
     /** 模型贴图和全景图的混合程度 [0-1] */
     modelAlpha: number;
     /** 全景图混合程度 [0-1] */
@@ -1670,20 +1707,8 @@ export declare interface PBMParameters {
     perspToOrtho: number;
     /** 模型透明度 */
     opacity: number;
-    /** 起始点位深度, 需要使用深度参与计算全景图混合的话 */
-    pano0DepthMap: THREE_2.CubeTexture | null;
-    /** 全景视频贴图 */
-    panoVideoMap: THREE_2.VideoTexture | null;
-    /** 全景视频尺寸 */
-    panoVideoSize: THREE_2.Vector2;
-    /** 全景视频贴图变换矩阵 */
-    panoVideoMatrix: THREE_2.Matrix4;
-    /** 全景视频透明度 [0-1] */
-    panoVideoAlpha: number;
-    /** 瓦片材质 */
-    panoTileMap: THREE_2.Texture | null;
-    /** 瓦片寻址规则 */
-    panoTileMappings: THREE_2.Vector4[][] | null;
+    /** 视频 */
+    panoVideo: PBMPanoVideo | null;
 }
 
 /**
@@ -1743,8 +1768,6 @@ export declare interface State extends Pose {
     panoIndex: number;
 }
 
-export declare function stringifyWork(work: Work): string;
-
 /**
  * 监听者模式
  * @template T - 预设的监听回调类型
@@ -1823,6 +1846,27 @@ export declare namespace SubscribeMixinType {
     }
 }
 
+/**
+ * 图片参数
+ */
+export declare interface TextureOptions {
+    /**
+     * url 地址转化
+     * @param url - 原始地址
+     * @param options - 当前地址参数
+     * @returns 转化后地址
+     */
+    transform?: (url: string, options: ImageURLOptions) => string;
+    /** 图片尺寸参数 */
+    size?: number;
+    /** 图片质量参数(0-100) */
+    quality?: number;
+    /** 图片格式参数（jpg, png） */
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    /** 针对 textureOptions 是否自动通过模型贴图的数量计算需要的模型贴图的尺寸 默认 true */
+    autoResize?: boolean;
+}
+
 export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "defaultLongitude" | "defaultLatitude" | "maxLatitude" | "minLatitude"> {
 }
 
@@ -1835,48 +1879,55 @@ export declare interface VRPanoramaControllerCustomInitArgs extends Omit<Panoram
     webvrPolyfillConfig?: any;
 }
 
-export declare type Work = {
+export declare class Work {
+    name: string;
     workCode: string;
     allowHosts: string[];
     expire: Date;
-    uuid: string;
     initial: WorkInitial;
     model?: WorkModel;
     observers: WorkObserver[];
     issuer: string;
     raw: any;
-};
+    constructor();
+    toJSON(): any;
+}
 
-/** 全景图 */
-export declare type WorkImages = {
+export declare interface WorkCubeImage {
     up: string;
     down: string;
     right: string;
     left: string;
     front: string;
     back: string;
+}
+
+/** 全景图 */
+export declare interface WorkImage extends WorkCubeImage {
     depth?: string;
-    tiles?: string;
-};
+    luminance?: WorkCubeImage;
+    tiles?: WorkTile[];
+}
 
 /** 初始化位姿参数 */
-export declare type WorkInitial = Omit<State, "offset">;
+export declare interface WorkInitial extends Omit<State, "offset"> {
+}
 
 /** 模型数据 */
-export declare type WorkModel = {
+export declare interface WorkModel {
     file: string;
     textures: string[];
     textureBase: string;
     bvh: boolean;
     async: boolean;
-};
+}
 
 /** 每个点位的数据 */
-export declare type WorkObserver = {
+export declare interface WorkObserver {
     panoIndex: number;
     active: boolean;
     loadable: boolean;
-    images: WorkImages;
+    images: WorkImage;
     video?: WorkVideo;
     visibleNodes: number[];
     accessibleNodes: number[];
@@ -1884,13 +1935,24 @@ export declare type WorkObserver = {
     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 type WorkVideo = {
+export declare interface WorkVideo {
     source: string;
     matrix: THREE_2.Matrix4;
     size: THREE_2.Vector2;
-};
+}
 
 export { }