@realsee/five 6.8.0-alpha.9 → 6.8.0

package/five/thirdparty/jsrsasign.d.ts

@@ -88,31 +88,16 @@
  * https://code.google.com/p/crypto-js/wiki/License
  * PART: ext/cryptojs
  */
-declare var KJUR: {};
 declare function hex2b64(d: any): string;
 declare function b64tohex(f: any): string;
-declare function RSAKey(): void;
-declare namespace RSAKey {
-    var getPosArrayOfChildrenFromHex: (a: any) => any;
-    var getHexValueArrayOfChildrenFromHex: (f: any) => any;
-    var SALT_LEN_HLEN: number;
-    var SALT_LEN_MAX: number;
-    var SALT_LEN_RECOVER: number;
-}
 declare function hextopem(a: any, b: any): string;
 declare function pemtohex(a: any, b: any): string;
-declare function X509(q: any): void;
-declare namespace X509 {
-    var hex2dn: (e: any, b: any) => any;
-    var hex2rdn: (f: any, b: any) => string;
-    var hex2attrTypeValue: (d: any, i: any) => string;
-    var getPublicKeyFromCertHex: (b: any) => any;
-    var getPublicKeyFromCertPEM: (b: any) => any;
-    var getPublicKeyInfoPropOfCertPEM: (c: any) => {};
-    var KEYUSAGE_NAME: string[];
-}
+
 declare namespace KJUR {
-    namespace crypto { }
+    namespace crypto {
+        export type DSA = any;
+        export type ECDSA = any;
+    }
 }
 interface ECCPrivateKey {
     curve: string;

package/five/types/movePanoOptions.d.ts

@@ -1,5 +1,6 @@
-import { State } from "./state";
-import { MovePanoEffect } from './movePanoEffect';
+import type { State } from "./state";
+import type { MovePanoEffect } from './movePanoEffect';
+import type { EasingFunction } from '../utils/easing';
 /**
  * 点位移动参数
  */
@@ -9,7 +10,7 @@ interface MovePanoOptions extends Partial<Omit<State, "offset" | 'distance' | 'm
      */
     effect?: MovePanoEffect;
     /** 走点图片过度策略 */
-    effectEasing?: (progress: number) => number;
+    effectEasing?: EasingFunction;
     /**
      * 运动耗时
      * @description

package/five/utils/error.d.ts

@@ -0,0 +1 @@
+export declare function toError(error: any): Error;

package/five/utils/event.d.ts

@@ -8,86 +8,138 @@ import { ModelScene, Model } from '../model';
 import { type Tile } from '../model/tile3d/tile';
 import { Intersection } from '../model/intersection';
 import { MovePanoOptions } from '../types/movePanoOptions';
+/** 所有事件的基础接口 */
 export interface BaseEvent {
+    /** 事件类型名称 */
     type: string;
+    /** 事件触发时的时间戳 */
     timeStamp: number;
+    /** 阻止事件的默认行为 */
     preventDefault(): void;
-    defaultPrevented: boolean;
+    /** 是否已调用过 preventDefault */
+    readonly defaultPrevented: boolean;
 }
+export interface BaseExtendableEvent extends BaseEvent {
+    waitUntil(f: Promise<any>): void;
+}
+/** 射线检测事件 */
 export interface IntersectEvent extends BaseEvent {
+    /** 被检测到的 3D 对象 */
     object: THREE.Object3D;
+    /** 发出射线的 Raycaster */
     raycaster: THREE.Raycaster;
+    /** 射线与对象的交点信息，未命中时为 null */
     intersection: Intersection | null;
 }
+/** 状态变更事件 */
 export interface StateEvent extends BaseEvent {
+    /** 当前的 Five 状态 */
     state: State;
+    /** 是否由用户交互触发 */
     userAction: boolean;
 }
+/** 全景图切换事件 */
 export interface PanoEvent extends StateEvent {
+    /** 切换前的全景图 */
     prevPano: Pano;
+    /** 新的全景图 */
+    pano: Pano;
+    /** 切换动画进度（0-1） */
     progress: number;
+    /** 切换时传入的选项 */
     options: MovePanoOptions;
+    /** 切换过程中发生的错误 */
     error: Error | null;
 }
+/** 全景图准备事件 */
+export interface PanoPrepareEvent extends BaseExtendableEvent {
+    /** 切换前的全景图 */
+    prevPano: Pano;
+    /** 新的全景图 */
+    pano: Pano;
+}
+/** 全景图纹理加载事件 */
 export interface PanoTextureEvent extends BaseEvent {
+    /** 对应的全景图 */
     pano: Pano;
+    /** 纹理加载进度（0-1） */
     progress: number;
+    /** 网络请求元信息 */
     meta: NetWorkMeta[] | null;
+    /** 加载过程中发生的错误 */
     error: Error | null;
 }
+/** 单个触控点 / 鼠标指针的信息 */
+export interface GesturePointer {
+    /** 指针在屏幕上的 x 坐标（像素） */
+    x: number;
+    /** 指针在屏幕上的 y 坐标（像素） */
+    y: number;
+    /** 相对上一帧的位移量 */
+    delta: number;
+    /** 当前按下的鼠标键（单键编号） */
+    button: number;
+    /** 当前按下的所有鼠标键（位掩码） */
+    buttons: number;
+    shiftKey: boolean;
+    ctrlKey: boolean;
+    altKey: boolean;
+    metaKey: boolean;
+    /** 归一化设备坐标（NDC） */
+    coords: THREE.Vector2;
+    /** 从该指针位置发出的射线 */
+    raycaster: THREE.Raycaster;
+}
+/** 手势事件，涵盖触摸、鼠标、笔等输入方式 */
 export interface GestureEvent extends StateEvent {
+    /** 事件的原始 DOM 目标 */
     target: EventTarget | null;
+    /** 输入设备类型 */
     pointerType: 'touch' | 'pen' | 'mouse' | 'kinect';
+    /** 原始 DOM 事件 */
     srcEvent: MouseEvent | TouchEvent | PointerEvent;
-    pointers: {
-        x: number;
-        y: number;
-        delta: number;
-        buttons: number;
-        coords: THREE.Vector2;
-        raycaster: THREE.Raycaster;
-    }[];
+    /** 所有活跃指针的信息列表 */
+    pointers: GesturePointer[];
+    /** 是否为该手势序列的第一个事件 */
     isFirst: boolean;
+    /** 是否为该手势序列的最后一个事件 */
     isFinal: boolean;
+    /** 多指缩放比例 */
     scale: number;
-    center: {
-        x: number;
-        y: number;
-        delta: number;
-        buttons: number;
-        coords: THREE.Vector2;
-        raycaster: THREE.Raycaster;
-    };
+    /** 所有活跃指针的中心点信息 */
+    center: GesturePointer;
+    /** 当前 x 方向速度 */
     velocityX: number;
+    /** 当前 y 方向速度 */
     velocityY: number;
+    /** 整个手势序列的 x 方向平均速度 */
     overallVelocityX: number;
+    /** 整个手势序列的 y 方向平均速度 */
     overallVelocityY: number;
 }
+/** XR 会话事件（进入/退出 XR 模式时触发） */
 export interface XRSessionEvent extends BaseEvent {
+    /** 当前 XR 会话 */
     session: XRSession | null;
+    /** XR 设备类型 */
     machineType: 'Pico' | 'Oculus';
 }
+/** XR 控制器状态 */
+export interface XRControllerState {
+    /** 摇杆轴输入（0-1） */
+    axes: Record<'up' | 'down' | 'left' | 'right', number>;
+    /** 左手控制器射线 */
+    raycaster: THREE.Raycaster;
+    /** 距上一帧的时间间隔 */
+    deltaTime: number;
+}
+/** XR 控制器输入事件 */
 export interface XRControllerEvent extends BaseEvent {
-    left: {
-        axes: {
-            up: number;
-            down: number;
-            left: number;
-            right: number;
-        };
-        raycaster: THREE.Raycaster;
-        deltaTime: number;
-    };
-    right: {
-        axes: {
-            up: number;
-            down: number;
-            left: number;
-            right: number;
-        };
-        raycaster: THREE.Raycaster;
-        deltaTime: number;
-    };
+    /** 左手控制器状态 */
+    left: XRControllerState;
+    /** 右手控制器状态 */
+    right: XRControllerState;
+    /** 各按键的按下状态 */
     buttons: {
         X: boolean;
         Y: boolean;
@@ -99,12 +151,19 @@ export interface XRControllerEvent extends BaseEvent {
         RightPinch: boolean;
     };
 }
+/** XR 手势事件（按键、摇杆方向等离散输入） */
 export interface XRGestureEvent extends BaseEvent {
+    /** 当前 XR 会话 */
     session: XRSession | null;
+    /** 触发该手势的按键或摇杆方向 */
     buttons: 'A' | 'B' | 'X' | 'Y' | 'RightTrigger' | 'RightPinch' | 'LeftTrigger' | 'LeftPinch' | 'LeftAxesLeft' | 'LeftAxesRight' | 'LeftAxesUp' | 'LeftAxesDown' | 'RightAxesLeft' | 'RightAxesRight' | 'RightAxesUp' | 'RightAxesDown';
+    /** XR 设备类型 */
     machineType: 'Pico' | 'Oculus';
+    /** 是否为该手势序列的第一个事件 */
     isFirst: boolean;
+    /** 是否为该手势序列的最后一个事件 */
     isFinal: boolean;
+    /** 控制器射线信息 */
     controllers: {
         raycaster: {
             leftRay: THREE.Raycaster;
@@ -147,3 +206,5 @@ export interface NetworkResourceEvent extends BaseEvent {
     detail: string;
 }
 export declare function createEvent<T extends BaseEvent = BaseEvent>(type: string, eventArgs: Omit<T, keyof BaseEvent>): T;
+export declare function createExtendableEvent<T extends BaseExtendableEvent = BaseExtendableEvent>(type: string, eventArgs: Omit<T, keyof BaseExtendableEvent>): T;
+export declare function waitForExtendableEvent(event: BaseExtendableEvent): Promise<void>;

package/five/utils/imageURL.d.ts

@@ -33,7 +33,7 @@ interface ImageURLOptions {
  * @returns url 转换结果
  */
 declare function imageURL(source: string, options: ImageURLOptions): string;
-declare function applyImageURLOptions(source: string, imageURLTransform: (source: string, options: ImageURLOptions) => string, imageURLOptions: ImageURLOptions): string;
+declare function applyImageURLOptions(source: string, imageURLTransform: ((source: string, options: ImageURLOptions) => string) | undefined, imageURLOptions: ImageURLOptions): string;
 /** 从 url 获取图片尺寸， 图片中有 cube_<size> 特征  */
 declare function getImageSizeFromURL(url: string): number | null;
 /** 从 url 替换图片尺寸， 图片中有 cube_<size> 特征  */

package/five/utils/memoryUsage.d.ts

@@ -1,12 +1,12 @@
 import * as THREE from 'three';
-import { PBMGSObject } from '../model/objects/pbmGSObject';
+import { PBMGaussianSplattingObject } from '../model/objects/pbmGaussianSplattingObject';
 /**
  * 统计 Geometry 的存储占用 单位 bytes
  * @param geometry
  * @returns
  */
 export declare function getGeometryMemoryUsed(geometry: THREE.BufferGeometry | THREE.Geometry): number;
-export declare function getPBMGSObjectMemoryUsed(object: PBMGSObject): number;
+export declare function getPBMGSObjectMemoryUsed(object: PBMGaussianSplattingObject): number;
 /**
  * 统计 Texture 的存储占用 单位 bytes
  * Textures are often the part of a three.js app that use the most memory.

package/five/utils/subscribe.d.ts

@@ -27,7 +27,7 @@ declare class Subscribe<T extends SubscribeEventMap> {
      * @template K - 预设的监听事件名称
      * @template C - 回调函数函数上下文
      */
-    on<K extends keyof T>(name: K, callback: (...args: Parameters<T[K]>) => ReturnType<T[K]>, once?: boolean): () => void;
+    on<K extends keyof T>(name: K, callback: (this: this, ...args: Parameters<T[K]>) => ReturnType<T[K]>, once?: boolean): () => void;
     /**
      * 注册事件(是否只执行一次)
      * @param name - 事件类型
@@ -36,7 +36,7 @@ declare class Subscribe<T extends SubscribeEventMap> {
      * @template K - 预设的监听事件名称
      * @template C - 回调函数函数上下文
      */
-    once<K extends keyof T>(name: K, callback: (...args: Parameters<T[K]>) => ReturnType<T[K]>): () => void;
+    once<K extends keyof T>(name: K, callback: (this: this, ...args: Parameters<T[K]>) => ReturnType<T[K]>): () => void;
     /**
      * 解除事件
      *

package/five/webxr/motionHelper.d.ts

@@ -54,7 +54,7 @@ declare class MotionController {
     layoutDescription: any;
     components: any;
     constructor(xrInputSource: XRInputSource, profile: any, assetUrl: string);
-    get gripSpace(): XRSpace;
+    get gripSpace(): XRSpace | undefined;
     get targetRaySpace(): XRSpace;
     /**
      * @description Returns a subset of component data for simplified debugging

package/five/work/index.d.ts

@@ -1,4 +1,5 @@
 export { parseWork, type ParseOptions, Work, type WorkCubeImage, type WorkImage, type WorkInitial, type WorkModel, type WorkModelLayer, type WorkObserver, type WorkTile, type WorkVideo, } from './work';
+export { type WorkObserverProto, } from './workObserverProto';
 export { type WorkInitialJson, type WorkJson, type WorkModelJson, type WorkModelLayerJson, type WorkObserverJson, type WorkPanoramaJson, type WorkPanoramasJson, } from './workJsonType';
 export { workToJson, } from './workJson';
 export { type LoosePanoWork, type LooseWork, type LooseWorkInitial, type LooseWorkModel, type LooseWorkObserver, type LooseWorkPanorama, type LooseWorkVideo, type LooseWorkWithExtrinsics, } from './looseWorkType';

package/five/work/looseWorkType.d.ts

@@ -18,7 +18,7 @@ export interface LooseWorkPanorama {
     video?: LooseWorkVideo;
     tiles?: number[];
     size_list?: number[];
-    derived_id?: number;
+    derived_id?: number | string;
     derived_id_str?: string;
 }
 export interface LooseWorkInitial {
@@ -78,7 +78,7 @@ export interface LooseWorkObserver {
     floor?: number;
     floor_index?: number;
     floorIndex?: number;
-    derived_id?: number;
+    derived_id?: number | string;
     derived_id_str?: string;
 }
 export interface LooseWork {

package/five/work/work.d.ts

@@ -1,9 +1,11 @@
 import * as THREE from "three";
 import type { Mode } from "../application/mode";
 import type { TilesetHeader } from "../model/tile3d/header";
+import type { WorkObserverProto } from './workObserverProto';
 import type { LooseWork, LoosePanoWork } from "./looseWorkType";
 import { CubeFace } from "../types/cube";
 import type { PanoId } from "../utils/pano";
+import type { Histogram } from "../texture/histogram";
 /** 全景视频贴片 */
 export interface WorkVideo {
     work: Work;
@@ -16,6 +18,7 @@ export interface WorkVideo {
 }
 export interface WorkCubeImage extends Record<CubeFace, string> {
     work: Work;
+    histogram?: Histogram;
 }
 export interface WorkTile extends WorkCubeImage {
     /** 层级 */
@@ -53,7 +56,7 @@ export interface WorkInitial {
     distance?: number;
 }
 /** 每个点位的数据 */
-export interface WorkObserver {
+export interface WorkObserver extends WorkObserverProto {
     /** work */
     work: Work;
     /** 序号 */
@@ -69,7 +72,7 @@ export interface WorkObserver {
     /** 点位所在楼层 */
     floorIndex: number;
     /** 点位 derived_id */
-    derivedId: number;
+    derivedId: number | string;
     /** 点位 derived_id_str */
     derivedIdStr: string;
     /** 点位是否激活可用 */
@@ -94,39 +97,6 @@ export interface WorkObserver {
     quaternion: THREE.Quaternion;
     /** 点位和模型的旋转对齐关系矩阵 */
     matrix: THREE.Matrix4;
-    /**
-     * 将方向向量转化为全景图 uv。
-     * @param vector - 全局的方向向量。单位向量。
-     * @param uvOrigin - top-left 原点在左上角，x轴向右，y轴向下[默认]。bottom-left 原点左下角，x轴向右，y轴向上。
-     * @returns uv坐标 取值范围 [0,1]。
-     */
-    vectorToEquirectangularUv(this: WorkObserver, vector: THREE.Vector3, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector2;
-    /**
-     * 将全景图 uv 转化为方向向量。
-     * @param uv - uv坐标 取值范围 [0,1]。
-     * @param uvOrigin - top-left 原点在左上角，x轴向右，y轴向下[默认]。bottom-left 原点左下角，x轴向右，y轴向上。
-     * @returns 全局的方向向量。单位向量。
-     */
-    equirectangularUvToVector(this: WorkObserver, uv: THREE.Vector2, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector3;
-    /**
-     * 将方向向量转化为获六视图 uv
-     * @param vector - 全局的方向向量。单位向量。
-     * @param uvOrigin - top-left 原点在左上角，x轴向右，y轴向下[默认]。bottom-left 原点左下角，x轴向右，y轴向上。
-     * @returns uv 坐标，取值范围 [0,1]
-     */
-    vectorToCubemapUv(this: WorkObserver, vector: THREE.Vector3, uvOrigin?: 'top-left' | 'bottom-left'): [cubeFace: CubeFace, cubemapUv: THREE.Vector2];
-    /**
-     * 将六视图 uv 转化为方向向量
-     * @param cubeFace - 六视图的某一面。
-     * @param uv - uv坐标 取值范围 [0,1]。
-     * @param uvOrigin - top-left 原点在左上角，x轴向右，y轴向下[默认]。bottom-left 原点左下角，x轴向右，y轴向上。
-     * @returns 全局的方向向量。单位向量。
-     */
-    cubemapUvToVector(this: WorkObserver, cubeFace: CubeFace, uv: THREE.Vector2, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector3;
-    /** 获取点位的全局坐标 */
-    getWorldPosition(this: WorkObserver): THREE.Vector3;
-    /** 获取点位的全局地面坐标 */
-    getWorldStandingPosition(this: WorkObserver): THREE.Vector3;
 }
 export interface WorkModelLayer {
     /** work */

package/five/work/workJsonType.d.ts

@@ -35,7 +35,7 @@ export interface WorkModelLayerJson {
 export interface WorkObserverJson {
     index: number;
     floor_index: number;
-    derived_id: number;
+    derived_id: number | string;
     derived_id_str: string;
     position: number[];
     standing_position: number[];
@@ -56,7 +56,7 @@ export interface WorkPanoramaJson {
     index: number;
     active?: boolean;
     loadable?: boolean;
-    derived_id?: number;
+    derived_id?: number | string;
     derived_id_str?: string;
     size_list: number[];
     up: string;

package/five/work/workObserverProto.d.ts

@@ -0,0 +1,39 @@
+import * as THREE from 'three';
+import { type WorkObserver } from './work';
+import { type CubeFace } from '../types/cube';
+export interface WorkObserverProto {
+    /**
+     * 将方向向量转化为全景图 uv。
+     * @param vector - 全局的方向向量。单位向量。
+     * @param uvOrigin - top-left 原点在左上角，x轴向右，y轴向下[默认]。bottom-left 原点左下角，x轴向右，y轴向上。
+     * @returns uv坐标 取值范围 [0,1]。
+     */
+    vectorToEquirectangularUv(this: WorkObserver, vector: THREE.Vector3, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector2;
+    /**
+     * 将方向向量转化为获六视图 uv
+     * @param vector - 全局的方向向量。单位向量。
+     * @param uvOrigin - top-left 原点在左上角，x轴向右，y轴向下[默认]。bottom-left 原点左下角，x轴向右，y轴向上。
+     * @returns uv 坐标，取值范围 [0,1]
+     */
+    vectorToCubemapUv(this: WorkObserver, vector: THREE.Vector3, uvOrigin?: 'top-left' | 'bottom-left'): [cubeFace: CubeFace, cubemapUv: THREE.Vector2];
+    /**
+     * 将全景图 uv 转化为方向向量。
+     * @param uv - uv坐标 取值范围 [0,1]。
+     * @param uvOrigin - top-left 原点在左上角，x轴向右，y轴向下[默认]。bottom-left 原点左下角，x轴向右，y轴向上。
+     * @returns 全局的方向向量。单位向量。
+     */
+    equirectangularUvToVector(this: WorkObserver, uv: THREE.Vector2, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector3;
+    /**
+     * 将六视图 uv 转化为方向向量
+     * @param cubeFace - 六视图的某一面。
+     * @param uv - uv坐标 取值范围 [0,1]。
+     * @param uvOrigin - top-left 原点在左上角，x轴向右，y轴向下[默认]。bottom-left 原点左下角，x轴向右，y轴向上。
+     * @returns 全局的方向向量。单位向量。
+     */
+    cubemapUvToVector(this: WorkObserver, cubeFace: CubeFace, uv: THREE.Vector2, uvOrigin?: 'top-left' | 'bottom-left'): THREE.Vector3;
+    /** 获取点位的全局坐标 */
+    getWorldPosition(this: WorkObserver): THREE.Vector3;
+    /** 获取点位的全局地面坐标 */
+    getWorldStandingPosition(this: WorkObserver): THREE.Vector3;
+}
+export declare const workObserverProto: WorkObserverProto;