@aibee/owlly 1.0.25 → 1.0.29

package/lib/owlly/element/svg-floors.d.ts

@@ -0,0 +1,27 @@
+import { Element, ElementFrameContext } from './element';
+import { ModelSvgMapping } from '../view/svg-map-view';
+import { SvgFloorModel } from './svg-floor-model';
+interface SvgModelInfo {
+    url: string;
+    mapping: ModelSvgMapping;
+}
+/**
+ * SVG楼层模型组, 不应再被维护
+ * @noInheritDoc
+ * @deprecated
+ */
+declare class SvgFloors extends Element {
+    private initialized;
+    private loadCounter;
+    private floorInfos;
+    private floors;
+    private visibleFloorIndex;
+    private renderThisFrame;
+    constructor(floors: SvgModelInfo[], visibleFloorIndex?: number);
+    update(): ElementFrameContext;
+    setFloorVisible(index: number): void;
+    switchToFloor(index: number): Promise<unknown>;
+    getCurrentVisibleFloorModel(): SvgFloorModel;
+    dispose(): void;
+}
+export { SvgFloors, SvgModelInfo };

package/lib/owlly/element/svg-floors.js

@@ -0,0 +1,109 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import TWEEN from '@tweenjs/tween.js';
+import { Element, ElementFrameContext } from './element';
+import { SvgFloorModel } from './svg-floor-model';
+/**
+ * SVG楼层模型组, 不应再被维护
+ * @noInheritDoc
+ * @deprecated
+ */
+class SvgFloors extends Element {
+    constructor(floors, visibleFloorIndex = 0) {
+        super();
+        this.initialized = false;
+        this.loadCounter = 0;
+        this.floorInfos = floors;
+        this.visibleFloorIndex = visibleFloorIndex;
+        this.renderThisFrame = false;
+        this.floors = [];
+        this.floorInfos.forEach(({ url, mapping }) => {
+            this.floors.push(new SvgFloorModel(url, mapping));
+        });
+        this.add(...this.floors);
+        this.setFloorVisible(visibleFloorIndex);
+    }
+    update() {
+        this.floors.forEach((f) => {
+            const ctx = f.update();
+            if (ctx.shouldPlaceElement)
+                this.loadCounter += 1;
+        });
+        const frameContext = new ElementFrameContext(this);
+        if (!this.initialized && this.loadCounter === this.floors.length) {
+            this.initialized = true;
+            frameContext.needUpdate = true;
+        }
+        if (this.renderThisFrame)
+            frameContext.needUpdate = true;
+        this.renderThisFrame = false;
+        if (this.initialized && !this.parent) {
+            frameContext.shouldPlaceElement = true;
+        }
+        return frameContext;
+    }
+    setFloorVisible(index) {
+        this.floors.forEach((f, i) => { f.visible = i === index; });
+    }
+    switchToFloor(index) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (index < 0 || index >= this.floors.length)
+                throw Error('Index out of range');
+            this.renderThisFrame = true;
+            if (index === this.visibleFloorIndex)
+                return;
+            const modelFrom = this.floors[this.visibleFloorIndex];
+            const modelTo = this.floors[index];
+            const reverse = this.visibleFloorIndex < index;
+            modelTo.position.setZ(reverse ? 0 : -20);
+            modelTo.setOpacity(0);
+            modelTo.visible = true;
+            modelFrom.setShadowEnabled(false);
+            yield new Promise((resolve) => {
+                new TWEEN.Tween({ z: 0, alpha: 1 })
+                    .to({ z: 20, alpha: 0 }, 500)
+                    .easing(TWEEN.Easing.Quadratic.InOut)
+                    .onUpdate(({ z, alpha }) => {
+                    if (reverse) {
+                        modelFrom.position.setZ(-z);
+                        modelTo.position.setZ(20 - z);
+                    }
+                    else {
+                        modelFrom.position.setZ(z);
+                        modelTo.position.setZ(z - 20);
+                    }
+                    modelFrom.setOpacity(alpha);
+                    modelTo.setOpacity(1 - alpha);
+                    this.renderThisFrame = true;
+                })
+                    .onComplete(() => {
+                    modelFrom.visible = false;
+                    this.renderThisFrame = true;
+                    this.visibleFloorIndex = index;
+                    modelTo.setShadowEnabled(true);
+                    resolve(null);
+                })
+                    .start();
+            });
+        });
+    }
+    getCurrentVisibleFloorModel() {
+        return this.floors[this.visibleFloorIndex];
+    }
+    dispose() {
+        super.dispose();
+        while (this.floors.length) {
+            const f = this.floors.pop();
+            f.dispose();
+        }
+        this.floorInfos = [];
+    }
+}
+export { SvgFloors };

package/lib/owlly/element/tile-panorama-group.d.ts

@@ -0,0 +1,335 @@
+import { NS_THREE } from '../stage/externals';
+import { Element, ElementFrameContext } from './element';
+import { View } from '../view/view';
+import { GroundParameters } from './floor-model';
+import { TilePanorama } from './tile-panorama';
+/** 全景点位显示模式
+ * 点位的显示/隐藏状态通过[setIndicatorVisibility]方法设置，
+ * 但是最终是否显示、以何外观显示，则是结合PanoramaGroup在当前View的显示模式来决定
+ * @param AlwaysHide 不论显示/隐藏的设置如何，都不显示
+ * @param AlwaysShow 不论显示/隐藏的设置如何，都不显示。该模式主要用于俯视全局视图用
+ * @param Editing 编辑模式，隐藏/显示状态的点位用不同的外观显示
+ * @param Show 按显示/隐葳的状态设置决定是否显示
+*/
+declare enum IndicatorDisplayMode {
+    AlwaysHide = 0,
+    AlwaysShow = 1,
+    Editing = 2,
+    Show = 3
+}
+/**
+ * 全景图组显示状态配置
+ */
+interface TilePanoramaGroupViewConfiguration {
+    targetView: View;
+    hidden?: boolean;
+    /** 可视范围半径，会根据此数值来决定预加载哪些全景图以及显示哪些点位 */
+    visibleRadius?: number;
+    /** 全景点位显示模式 */
+    indicatorDisplayMode?: IndicatorDisplayMode;
+    /** 是否显示模型包围盒，用于全景漫游时 */
+    showBoundBox?: boolean;
+}
+interface TilePanoramaData {
+    pid: number;
+    seqID: number;
+    textureURLs: string[];
+    neighbourPanoramaIDs: number[];
+    highTextureURLs?: string[];
+    useLowTextureURLsOnly?: boolean;
+    tiledTextureURLRoot?: string;
+    position?: NS_THREE.Vector3;
+    quaternion?: NS_THREE.Quaternion;
+    legacyMode?: boolean;
+    visible?: boolean;
+    offLineTextureUrls?: string[];
+    offLineTextureLevel?: number;
+}
+/**
+ * 全景图组
+ * @noInheritDoc
+ */
+declare class TilePanoramaGroup extends Element {
+    private initialized;
+    private needUpdate;
+    /** 当前全景点 */
+    currentPanorama: TilePanorama | undefined;
+    /** 模型元素 */
+    modelElement: NS_THREE.Object3D | null;
+    private groundParams?;
+    private boundBox;
+    /** 当前全景点id */
+    currentPanoramaID: number;
+    private panoramaDatas;
+    private panoramaMap;
+    private indicatorMeshPrototype;
+    private indicatorMaterials;
+    private indicatorShaderUniforms;
+    private invisibleIndicatorShaderUniforms;
+    private indicatorMap;
+    private inSightIndicators;
+    private indicatorVisibilityMap;
+    private indicatorHiddenMap;
+    private indicatorPositionMap;
+    private indicatorImageURL;
+    private indicatorWidth;
+    private indicatorHeight;
+    private panoramaCreatingTasks;
+    private group;
+    private viewConfigurations;
+    private showInvisible;
+    private eventListeners;
+    private maxWorldDistance;
+    /** 默认有效半径 */
+    static DefaultVisibleRadius: number;
+    /** 标签显示半径 */
+    static IndicatorRadius: number;
+    /** 标签高度偏移 */
+    static IndicatorOffsetZ: number;
+    /** 全局缩放 */
+    private globalScale;
+    /**
+     * @param modelElement 模型对象，通常应该是FloorModel
+     * @param groundParams 地面参数对象，若有则在计算地面高度时忽略modelElement，优先使用它
+     * @param indicatorImageURL 显示状态全景点地面标识的图片URL
+     * @param invisibleIndicatorImageURL 编辑模式下隐藏状态全景点地面标识的图片URL
+     * @param indicatorWidth 全景点地面标识宽度
+     * @param indicatorHeight 全景点地面标识高度
+     * @example
+     * ``` typescript
+     * panoMgr = new TilePanoramaGroup(panoramaDataList, 2, {
+     *  floorModel,
+     *  groundParams,
+     * });
+     * stage.bindElement(panoMgr);
+     */
+    constructor(panoramaDataList: TilePanoramaData[], options: {
+        modelElement?: NS_THREE.Object3D;
+        groundParams?: GroundParameters;
+        indicatorImageURL?: string;
+        invisibleIndicatorImageURL?: string;
+        indicatorWidth?: number;
+        indicatorHeight?: number;
+        indicatorPositionMap?: Map<number, NS_THREE.Vector3>;
+        globalScale?: number;
+        showInvisible?: boolean;
+    });
+    /**
+     * @ignore
+     * @param panoramaDataList
+     */
+    private initPanoramas;
+    private initIndicatorPosition;
+    /**
+     * 更新最大等级
+     * @param levelMax 最大等级
+     */
+    updateLevelMax(levelMax: number): void;
+    /**
+     * 销毁
+     * @param exceptForCubeTextureOfPID
+     */
+    dispose(exceptForCubeTextureOfPID?: number): void;
+    /**
+     * 初始化indicator
+     * @param indicatorImageURL
+     * @param invisibleIndicatorImageURL
+     */
+    private initIndicator;
+    /**
+     * 更新标签
+     */
+    private updateIndicators;
+    /**
+     * @ignore
+     */
+    update(): ElementFrameContext;
+    /**
+     * 绑定模型Element对象（用于创建天空包围盒供全景切换时使用）
+     * @param modelElement 模型Element对象
+     */
+    bindModelElement(modelElement?: NS_THREE.Object3D): void;
+    /**
+     * 获取盒子
+     * @param rootObj
+     * @param globalScale
+     * @returns
+     */
+    static getBoundBox(rootObj: NS_THREE.Object3D | null): NS_THREE.Mesh | null;
+    /**
+     * 获取模型盒子
+     * @returns
+     */
+    private getModelBoundBox;
+    /**
+     * 设置包围盒出现
+     * @param material
+     * @returns
+     */
+    setBoundBoxAppearance(material: NS_THREE.Material): void;
+    private setBoundBoxVisible;
+    /**
+     * 加载指定全景图并加入场景（显示要通过PanoramaController）
+     * @param panorama 要加载的全景图
+     */
+    private presentPanorama;
+    /**
+     * 根据全景对象初始化纹理
+     * @param panorama
+     */
+    private initTexturesByPanorama;
+    /**
+     * 加载指定PID的全景图并加入场景（显示要通过PanoramaController）
+     * @param pid 要加载的全景图ID
+     */
+    private presentPanoramaOfPID;
+    private visibleRadiusOfView;
+    /**
+     * @ignore
+     * @param centerPID
+     * @param view
+     * @returns
+     */
+    panoramaIDsAround(centerPID: number, view?: View): number[] | null;
+    /**
+     * 设置当前位于的全景点位。将加载指定全景点并预加载其相邻全景点
+     * @param {number} currentPID 全景点位ID
+     * @returns 1为初始化成功， 0为初始化失败
+     */
+    presentPanoramaAround(currentPID: number, view?: View): Promise<number>;
+    /** @ignore */
+    private getPIDPositionMap;
+    /**
+     * 根据pid获取标签的位置
+     * @param pid
+     * @returns
+     */
+    getIndicatorPosition(pid: number): NS_THREE.Vector3 | undefined;
+    /**
+     * 显示指定全景点位标签
+     * @param pidPositionMap 从PID映射到全景点位位置的Map
+     */
+    presentPanoramaIndicators(pidPositionMap: Map<number, NS_THREE.Vector3>): void;
+    /**
+      * 更新标签位置
+      */
+    private updateIndicatorsPositions;
+    /**
+     * 显示指定全景点及其相邻全景点上的标签
+     * @param pid “中心”全景点ID，一般指摄像机当前所在的全景点PID
+     */
+    presentPanoramaIndicatorsAround(pid: number, view?: View): Promise<void>;
+    /**
+     * 获取pid的标签是否可见
+     * @param pid
+     * @returns
+     */
+    getIndicatorVisibility(pid: number): boolean;
+    /**
+     * 设置指定全景点位的显示/隐藏状态
+     * @param visibility 显示/隐藏状态
+     * @param pid 可选，可以是全景图点位PID数组，也可以是单个PID,
+     * 若不设置则应用到本PanoramaGroup的所有全景点位上
+     */
+    setIndicatorVisibility(visibility: boolean, pid?: number | number[]): void;
+    /**
+     * 设置标签隐藏
+     * @param hidden 隐藏
+     * @param pid 指定pid
+     */
+    setIndicatorHidden(hidden: boolean, pid?: number | number[]): void;
+    /**
+     * 与全景点标志作相交测试
+     * 若有任一个全景点标志与射线相交则返回最近一个的相应PID
+     * 若没有则返回-1
+     * @param rayOrigin 射线起点
+     * @param rayDirection 射线方向
+     */
+    intersectIndicators(rayOrigin: NS_THREE.Vector3, rayDirection: NS_THREE.Vector3): number;
+    /**
+     * @ignore
+     * @param screenPosition
+     * @param radius
+     * @param param2
+     * @param camera
+     * @returns
+     */
+    intersectIndicatorsOnScreen(screenPosition: NS_THREE.Vector2, radius: number, { screenWidth, screenHeight }: {
+        screenWidth: number;
+        screenHeight: number;
+    }, camera: NS_THREE.Camera): number;
+    /**
+     * 添加全景点
+     * @param {Panorama} pano 全景图对象
+     */
+    putPanorama(pano: TilePanorama): void;
+    /**
+       * 指定预构建全景对象的顺序策略
+       * @param preInitStrategy 多义参数，表示具体的创建顺序
+       * 当为'all'时，直接按构造函数中panoramaDataList的顺序创建全部全景对象
+       * 当为一个整数值时，表示一个全景PID，将按全景点邻接关系以广度优先搜索的顺序创建全景对象
+       * 当为一个整数数组时，以数组指定的PID顺序依次创建
+       */
+    initializePanoramasIfNecessary(preInitStrategy: 'all' | number | number[]): Promise<(TilePanorama | undefined)[]>;
+    /**
+     * 获得指定ID的全景点对象
+     * @param pid 全景点ID
+     */
+    getPanoramaByPID(pid: number): TilePanorama | undefined;
+    /**
+     * 立刻获得指定ID的全景点对象
+     * @param pid 全景点ID
+     */
+    getPanoramaByPIDInstant(pid: number): TilePanorama | null;
+    /**
+     * @ignore
+     * @param rayDirection
+     */
+    getNeghbourPanoClosestToRay(rayDirection: NS_THREE.Vector3): number;
+    /**
+     * @ignore
+     */
+    updateIndicatorGeometry(): void;
+    /**
+     * 改变地面全景点标识的尺寸
+     * @param width 宽度
+     * @param height 高度
+     */
+    setIndicatorSize(width: number, height: number): void;
+    /**
+     * 设置标签的图片
+     * @param url
+     */
+    setIndicatorImageURL(url: string): void;
+    /**
+     * 查询当前设置的地面全景点标识尺寸
+     * @returns number数组，依次是width, height
+     */
+    getIndicatorSize(): number[];
+    private setIndicatorMeshPrototype;
+    /**
+     * 设定全景点位标签的原型对象，每个全景点位的标签会以该原型对象为母本clone出来
+     * @param prototypeObject 点位标签原型Object3D对象
+     * @param mode 点位的展示模式
+     * @param visibility 点位的显隐状态设置
+     */
+    setIndicatorMaterial(material: NS_THREE.Material, mode: IndicatorDisplayMode, visibility: boolean): void;
+    /**
+     * 获取标签材质
+     * @param mode
+     * @param visibility
+     * @returns
+     */
+    getIndicatorMaterial(mode: IndicatorDisplayMode, visibility: boolean): NS_THREE.Material | undefined;
+    /**
+     * 配置全景图组在不同view中的显示状态
+     * @param configuration 全景图组配置，见[[PanoramaGroupViewConfiguration]]
+     */
+    addGroupViewConfiguration(configuration: TilePanoramaGroupViewConfiguration): void;
+    /**
+     * 设置最大时间距离
+     * @param distance
+     */
+    setMaxWorldDistance(distance: number): void;
+}
+export { TilePanoramaGroup, IndicatorDisplayMode, TilePanoramaGroupViewConfiguration, TilePanoramaData, };