@realsee/five 6.0.0-alpha.2 → 6.0.0-alpha.21

package/five/index.d.ts

@@ -210,7 +210,7 @@ export declare class Clipper {
     private static sharedInstance?;
     static get shared(): Clipper;
     constructor();
-    update(clipperParameters: ClipperParameter[], camera: THREE_2.Camera): void;
+    update(clipperParameter: ClipperParameter | ClipperParameter[], camera: THREE_2.Camera): void;
     private projectPlanes;
 }
 
@@ -284,6 +284,14 @@ export declare type ControllerEventTypes = {
     "xr.session.start"(event: XRSessionEvent_2): void;
     /** XR 手势（按钮） */
     "xr.gesture.tap"(event: XRGestureEvent): void;
+    /** XR 手势（按钮） */
+    "xr.gesture.press"(event: XRGestureEvent): void;
+    /** XR 手势（按钮） */
+    "xr.gesture.buttonUp"(event: XRGestureEvent): void;
+    /** XR 手势（按钮） */
+    "xr.gesture.buttonDown"(event: XRGestureEvent): void;
+    /** XR手柄更新*/
+    "xr.controller.update"(event: XRControllerEvent): void;
     /** 抛出错误 */
     "error"(error: Error): void;
 };
@@ -307,6 +315,8 @@ export declare class CullingVolume {
  */
 export declare function defaultImageURLTransform(source: string, options: ImageURLOptions): string;
 
+export declare const defaultPbmParameters: PBMParameters;
+
 export declare interface DepthPanoramaControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
     /** 最远可移动观察点距离 */
     maxAccessibleDistance?: number;
@@ -334,7 +344,7 @@ export declare interface EventCallback extends EventTypes {
  * @description
  * 具体事件列表 请查看 {@link EventCallback}
  */
-export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROLLER_EVENT_NAMES[number]> & legacyEventType & {
+export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROLLER_EVENT_NAMES[number]> & LegacyEventType & {
     /** 请求点位 */
     "pano.request"(event: PanoEvent): void;
     /** 内部错误 */
@@ -343,6 +353,8 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
     "works.request"(event: WorksEvent): void;
     /** 加载 work */
     "works.load"(event: WorksEvent): void;
+    /** 加载 work 并 controller ready */
+    "works.ready"(event: WorksEvent): void;
     /** 设置 state */
     "state.set"(event: StateEvent): void;
     /** 当 state 变化 */
@@ -427,6 +439,8 @@ export declare class Five extends Subscribe<EventTypes> {
     currentMode: Mode;
     /** 内部使用的 `THREE.Scene` */
     scene: Scene;
+    /** 供外部放置需要在xr场景下产生遮挡的物体们*/
+    xrCustomObjectsScene: THREE_2.Scene;
     /** 内部使用的 `Camera` */
     camera: Camera;
     /**
@@ -602,11 +616,17 @@ export declare class Five extends Subscribe<EventTypes> {
      */
     get enableIOSEDR(): boolean;
     set enableIOSEDR(enable: boolean);
+    /**
+     * 后处理类型
+     */
+    get postProcessingType(): PostProcessingType;
     /**
      * 是否开启EDL模式
      */
     get enableEDL(): boolean;
     set enableEDL(enable: boolean);
+    get enableHQ(): boolean;
+    set enableHQ(enable: boolean);
     /**
      * 是否开启后处理
      */
@@ -826,7 +846,6 @@ export declare class Five extends Subscribe<EventTypes> {
     private applyController;
     /** 移除事件绑定 */
     private removeEventListeners;
-    initlegacyEvent(): void;
 }
 
 /** Five 初始化参数 */
@@ -1169,7 +1188,7 @@ export declare function isPanoId(id: any): id is PanoId;
 /**
  * 过时的事件列表
  */
-declare type legacyEventType = {
+export declare type LegacyEventType = {
     /**
      * 模态间切换动画开始
      * @param panoIndex - 当前点位
@@ -1179,7 +1198,6 @@ declare type legacyEventType = {
     initAnimationWillStart(panoIndex: number, pose: Pose, userAction: boolean): void;
     /**
      * 模态间切换动画结束
-     * @deprecated
      * @param panoIndex - 当前点位
      * @param pose - 相机姿态
      * @param userAction - 是否用户触发
@@ -1187,7 +1205,6 @@ declare type legacyEventType = {
     initAnimationEnded(panoIndex: number, pose: Pose, userAction: boolean): void;
     /**
      * 意图要触发手势， 可以通过 `return false` 阻止
-     * @deprecated
      * @param type - 手势类型
      * @param pointers - 手指位置
      * @param final - 是否手势结束
@@ -1465,6 +1482,17 @@ declare type legacyEventType = {
      * axes代表控制杆，axes数组的0-1元素分别代表左控制器的左（-1）右（1）,左控制器的上（-1）下（1），axes数组的2-3元素同理
      */
     webXRControllerEvent(type: WebXRControllerType, key: WebXRControllerKey, params: WebXRControllerParams): void;
+    /**
+     * xr控制器的Axes原始实时数据状态
+     */
+    webXRAxesUpdate(type: 'left' | 'right', param: WebXRAxesParams): void;
+    /**
+     * xr控制器的控制器射线更新
+     */
+    webXRControllerRayUpdate(raycaster: {
+        leftRay: THREE_2.Raycaster;
+        rightRay: THREE_2.Raycaster;
+    }): void;
     /**
      * 准备加载 Work 数据
      * @param input - 输入的 work
@@ -1563,6 +1591,53 @@ declare type legacyEventType = {
     network(source: string, type: NetworkType, state: NetworkState, detail: string): void;
 };
 
+export declare function loadAt3d(url: string, options: {
+    textureOptions?: TextureOptions;
+    textureBaseUri?: string;
+    textureArray?: string[];
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string | Promise<string>;
+    networkSubscribe?: NetworkSubscribe;
+}): Promise<ParsedResultType>;
+
+export declare function loadB3dm(url: string, options: {
+    upAxis: 'X' | 'Y' | 'Z';
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string | Promise<string>;
+    networkSubscribe?: NetworkSubscribe;
+}): Promise<ParsedResultType>;
+
+export declare function loadDome(url: string, options: {
+    textureOptions: TextureOptions;
+    textureBaseUri?: string;
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string | Promise<string>;
+    networkSubscribe?: NetworkSubscribe;
+}): Promise<ParsedResultType>;
+
+export declare function loadDomez(url: string, options: {
+    textureOptions: TextureOptions;
+    textureBaseUri?: string;
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string | Promise<string>;
+    networkSubscribe?: NetworkSubscribe;
+}): Promise<ParsedResultType>;
+
+export declare function loadPbm(url: string, options: {
+    textureOptions?: TextureOptions;
+    textureBaseUri?: string;
+    textureArray?: string[];
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string | Promise<string>;
+    networkSubscribe?: NetworkSubscribe;
+}): Promise<ParsedResultType>;
+
+export declare function loadPnts(url: string, options: {
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string | Promise<string>;
+    networkSubscribe?: NetworkSubscribe;
+}): Promise<ParsedResultType>;
+
 export declare type LooseWork = {
     work_code?: string;
     code?: string;
@@ -1837,7 +1912,7 @@ export declare interface ModelLodOptions {
     maxDepth?: number;
 }
 
-export declare type ModelMaterialValues = Pick<PBMParameters, 'pano0' | 'pano1' | 'modelAlpha' | 'progress' | 'useBlackTransition' | 'opacity' | 'constantColor' | 'useEDL' | 'pointShape' | 'pointColorType' | 'pointSizeType' | 'pointSize' | 'pointMinSize' | 'pointMaxSize' | 'pointSizeAdaptiveScale' | 'gradientTexture'>;
+export declare type ModelMaterialValues = Pick<PBMParameters, 'pano0' | 'pano1' | 'modelAlpha' | 'progress' | 'useBlackTransition' | 'opacity' | 'constantColor' | 'useEDL' | 'useHQWeight' | 'useHQDepth' | 'pointShape' | 'pointColorType' | 'pointSizeType' | 'pointSize' | 'pointMinSize' | 'pointMaxSize' | 'pointSizeAdaptiveScale' | 'gradientTexture'>;
 
 export declare type Models = Model[] & {
     needsRender: boolean;
@@ -2160,6 +2235,13 @@ export declare interface PanoTextureEvent extends BaseEvent {
     error: Error | null;
 }
 
+export declare type ParsedResultType = {
+    type: 'b3dm' | 'pnts' | 'at3d' | 'pbm';
+    byteLength: number;
+    uri: string;
+    object: THREE_2.Object3D;
+};
+
 /**
  * 解析 Work 数据
  * @param obj - work 数据，从如数开发者平台获取
@@ -2240,41 +2322,45 @@ export declare class PBMMeshMaterial extends THREE_2.ShaderMaterial implements P
     /** 更新版本 */
     pbmMaterialParametersVersion: number;
     /** 起始点 */
-    pano0: PBMPanoPicture | null;
+    pano0: PBMParameters['pano0'];
     /** 结束点 */
-    pano1: PBMPanoPicture | null;
+    pano1: PBMParameters['pano1'];
     /** 模型贴图和全景图的混合程度 [0-1] */
-    modelAlpha: number;
+    modelAlpha: PBMParameters['modelAlpha'];
     /** 全景图混合程度 [0-1] */
-    progress: number;
+    progress: PBMParameters['progress'];
     /** 全景图通过过度黑色混合 */
-    useBlackTransition: boolean;
+    useBlackTransition: PBMParameters['useBlackTransition'];
     /** 模型透明度 */
-    opacity: number;
+    opacity: PBMParameters['opacity'];
     /** 模型颜色*/
-    constantColor: THREE_2.Vector3 | null;
+    constantColor: PBMParameters['constantColor'];
     /** 楼层参数*/
-    floorIndex: number;
+    floorIndex: PBMParameters['floorIndex'];
     /** 对外模型裁切参数*/
-    clippers: ClipperParameter[] | null;
+    clippers: PBMParameters['clippers'];
     /** edl*/
-    useEDL: boolean;
+    useEDL: PBMParameters['useEDL'];
+    /** hq*/
+    useHQWeight: PBMParameters['useHQWeight'];
+    /** HQDepthMask*/
+    useHQDepth: PBMParameters['useHQDepth'];
     /** 点云着色方式*/
-    pointColorType: PBMPointColorType;
+    pointColorType: PBMParameters['pointColorType'];
     /** 点云大小绘制方式*/
-    pointSizeType: PBMPointSizeType;
+    pointSizeType: PBMParameters['pointSizeType'];
     /** 点云形状*/
-    pointShape: PBMPointShapeType;
+    pointShape: PBMParameters['pointShape'];
     /** 点云基础大小*/
-    pointSize: number;
+    pointSize: PBMParameters['pointSize'];
     /** 自适应点云大小因子*/
-    pointSizeAdaptiveScale: number;
+    pointSizeAdaptiveScale: PBMParameters['pointSizeAdaptiveScale'];
     /** 点云最大尺寸*/
-    pointMinSize: number;
+    pointMinSize: PBMParameters['pointMinSize'];
     /** 点云最小尺寸*/
-    pointMaxSize: number;
+    pointMaxSize: PBMParameters['pointMaxSize'];
     /** 高程彩色图*/
-    gradientTexture: THREE_2.Texture | null;
+    gradientTexture: PBMParameters['gradientTexture'];
     constructor(parameters?: Partial<PBMParameters>);
     update(renderer: THREE_2.WebGLRenderer, camera: Camera, cache: PBMMaterialReferenceCache): void;
 }
@@ -2310,12 +2396,16 @@ export declare interface PBMParameters {
     constantColor: THREE_2.Vector3 | null;
     /** 是否使用EDL*/
     useEDL: boolean;
+    /** 是否使用HQ*/
+    useHQWeight: boolean;
+    /** 是否使用HQ_DEPTH_MASK*/
+    useHQDepth: boolean;
     /** 点云形状*/
-    pointShape: PBMPointShapeType;
+    pointShape: 'SQUARE' | 'CIRCLE';
     /** 点云着色方式*/
-    pointColorType: PBMPointColorType;
+    pointColorType: 'RGB' | 'ALTITUDE';
     /** 点云大小绘制方式*/
-    pointSizeType: PBMPointSizeType;
+    pointSizeType: 'FIXED' | 'ADAPTIVE';
     /** 点云基础大小*/
     pointSize: number;
     /** 点云最大尺寸*/
@@ -2328,21 +2418,6 @@ export declare interface PBMParameters {
     gradientTexture: THREE_2.Texture | null;
 }
 
-export declare enum PBMPointColorType {
-    RGB = "rgb",
-    ALTITUDE = "altitude"
-}
-
-export declare enum PBMPointShapeType {
-    SQUARE = "square",
-    CIRCLE = "circle"
-}
-
-export declare enum PBMPointSizeType {
-    FIXED = "fixed",
-    ADAPTIVE = "adaptive"
-}
-
 /**
  * 相机位姿
  * [[include: coordinate.md]]
@@ -2360,7 +2435,9 @@ export declare interface Pose {
     distance: number;
 }
 
-export declare const PROXY_CONTROLLER_EVENT_NAMES: readonly ["gesture.pan", "gesture.tap", "gesture.press", "gesture.pinch", "gesture.mousewheel", "gesture.mousemove", "gesture.momentum", "initAnimation.start", "initAnimation.end", "camera.update", "intersect.update", "pano.select", "pano.moveTo", "pano.moving", "pano.arrived", "pano.cancel", "pano.error", "pano.texture.load", "pano.texture.progress", "pano.texture.success", "pano.texture.error", "pano.texture.abort", "xr.session.start", "xr.session.end", "xr.gesture.tap"];
+export declare type PostProcessingType = 'edl' | 'hq' | 'luminance' | null;
+
+export declare const PROXY_CONTROLLER_EVENT_NAMES: readonly ["gesture.pan", "gesture.tap", "gesture.press", "gesture.pinch", "gesture.mousewheel", "gesture.mousemove", "gesture.momentum", "initAnimation.start", "initAnimation.end", "camera.update", "intersect.update", "pano.select", "pano.moveTo", "pano.moving", "pano.arrived", "pano.cancel", "pano.error", "pano.texture.load", "pano.texture.progress", "pano.texture.success", "pano.texture.error", "pano.texture.abort", "xr.session.start", "xr.session.end", "xr.gesture.tap", "xr.gesture.press", "xr.gesture.buttonUp", "xr.gesture.buttonDown", "xr.controller.update"];
 
 export declare class RegionBoundingVolume implements BoundingVolume {
     type: "regin";
@@ -2730,6 +2807,7 @@ export declare class Tile3DModel extends THREE_2.Object3D {
     static DEFAULT_MAX_SCREEN_SPACE_ERROR: number;
     static DEFAULT_MAX_REQUESTS: number;
     workCode: string;
+    search: string;
     tileset: Tileset;
     maxLevelOfDetail: number;
     boundingBox: THREE_2.Box3;
@@ -2739,8 +2817,8 @@ export declare class Tile3DModel extends THREE_2.Object3D {
     disposed: boolean;
     needsRender: boolean;
     lastRefineTime: number;
-    private nodeGroup;
-    private debugBoundingGroup;
+    nodeGroup: THREE_2.Group;
+    debugBoundingGroup: THREE_2.Group;
     private nodes;
     private debugBoundings;
     private unloadTileQueue;
@@ -2771,6 +2849,7 @@ export declare interface Tile3DModelLoaderOptions {
     allowHosts?: string[];
     requestProxy?: (url: string) => string | Promise<string>;
     networkSubscribe?: NetworkSubscribe;
+    search?: string;
     onError?: (error: Error) => void;
 }
 
@@ -2993,13 +3072,30 @@ export declare enum VolumePlaneIntersect {
 export declare interface VRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
 }
 
-export declare type WebXRControllerKey = 'A' | 'B' | 'X' | 'Y' | 'RightTrigger' | 'RightPinch' | 'LeftTrigger' | 'LeftPinch' | 'LeftAxesLeft' | 'LeftAxesRight' | 'LeftAxesUp' | 'LeftAxesDown' | 'RightAxesLeft' | 'RightAxesRight' | 'RightAxesUp' | 'RightAxesDown';
+export declare interface WebXRAxesParams {
+    raycaster: {
+        leftRay: THREE_2.Raycaster;
+        rightRay: THREE_2.Raycaster;
+    };
+    axesState: {
+        up: number;
+        down: number;
+        left: number;
+        right: number;
+    };
+    deltaTime: number;
+}
+
+export declare type WebXRControllerKey = XRGestureEvent['buttons'];
 
 export declare interface WebXRControllerParams {
-    raycaster: THREE_2.Raycaster[];
+    raycaster: {
+        leftRay: THREE_2.Raycaster;
+        rightRay: THREE_2.Raycaster;
+    };
 }
 
-export declare type WebXRControllerType = 'tap' | 'press' | 'axes';
+export declare type WebXRControllerType = 'tap' | 'press' | 'axes' | 'buttonUp' | 'buttonDown';
 
 export declare class Work {
     /** 名称 */
@@ -3200,15 +3296,51 @@ export declare class XRButton {
     static createButton(onClickHook: () => void): HTMLAnchorElement | HTMLButtonElement;
 }
 
+export declare interface XRControllerEvent extends BaseEvent {
+    left: {
+        axes: {
+            up: number;
+            down: number;
+            left: number;
+            right: number;
+        };
+        raycaster: THREE_2.Raycaster;
+        deltaTime: number;
+    };
+    right: {
+        axes: {
+            up: number;
+            down: number;
+            left: number;
+            right: number;
+        };
+        raycaster: THREE_2.Raycaster;
+        deltaTime: number;
+    };
+    buttons: {
+        X: boolean;
+        Y: boolean;
+        LeftTrigger: boolean;
+        LeftPinch: boolean;
+        A: boolean;
+        B: boolean;
+        RightTrigger: boolean;
+        RightPinch: boolean;
+    };
+}
+
 export declare interface XRGestureEvent extends BaseEvent {
     session: XRSession | null;
-    buttons: null | 'A' | 'B' | 'X' | 'Y' | 'RightTrigger' | 'RightPinch' | 'LeftTrigger' | 'LeftPinch' | 'LeftAxesLeft' | 'LeftAxesRight' | 'LeftAxesUp' | 'LeftAxesDown' | 'RightAxesLeft' | 'RightAxesRight' | 'RightAxesUp' | 'RightAxesDown';
+    buttons: 'A' | 'B' | 'X' | 'Y' | 'RightTrigger' | 'RightPinch' | 'LeftTrigger' | 'LeftPinch' | 'LeftAxesLeft' | 'LeftAxesRight' | 'LeftAxesUp' | 'LeftAxesDown' | 'RightAxesLeft' | 'RightAxesRight' | 'RightAxesUp' | 'RightAxesDown';
     machineType: 'Pico' | 'Oculus';
     isFirst: boolean;
     isFinal: boolean;
     controllers: {
-        raycaster: THREE_2.Raycaster;
-    }[];
+        raycaster: {
+            leftRay: THREE_2.Raycaster;
+            rightRay: THREE_2.Raycaster;
+        };
+    };
 }
 
 export declare interface XRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {