@aibee/owlly 1.0.25 → 1.0.29

package/lib/prod/src/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/prod/src/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, };

package/lib/prod/src/owlly/element/tile-panorama.d.ts

@@ -0,0 +1,162 @@
+import { NS_THREE } from '../stage/externals';
+import { Element, ElementFrameContext } from './element';
+import { View } from '../view';
+import { TilePlane } from './tile-plane';
+import { TileTextureInfo } from '../utils/tile-util';
+interface TilePanoramaViewConfiguration {
+    targetView: View;
+    showBorder?: boolean;
+    showSkyBox?: boolean;
+}
+/**
+ * 全景图对象
+ * @noInheritDoc
+ */
+declare class TilePanorama extends Element {
+    static DisposeModule(): void;
+    private initialized;
+    private needsUpdate;
+    private level;
+    /** @ignore */
+    levelMax: number;
+    private sphereMesh;
+    private isPlayingVideo;
+    private video;
+    private wireFrame;
+    /** @ignore */
+    tilePlanes: TilePlane[];
+    pid: number;
+    /** @ignore */
+    seqID: number;
+    /** @ignore */
+    neighborPanoramaIDs: number[];
+    /** @ignore */
+    highTextureURLs: string[];
+    /** @ignore */
+    textureURLs: string[];
+    /** @ignore */
+    offLinTextureUrls: string[];
+    /** @ignore */
+    offLineTextureLevel: number;
+    /** @ignore */
+    useLowTextureURLsOnly: boolean;
+    /** @ignore */
+    tiledTextureURLRoot: string | undefined;
+    private baseQuaternion;
+    private additionalQuaternion;
+    private panoramaLoaded;
+    private eventListeners;
+    private isSelected;
+    private videoCanvas;
+    private mpegVideoPlayer;
+    private videoContentType;
+    private mounted;
+    /**
+     * @param textureURLs 低清立方体贴图六张图的URL数组（本地相对路径或网络URL均可），按右左上下前后的顺序
+     * @param highTextureURLs 高清立方体贴图六张图的URL数组（本地相对路径或网络URL均可），按右左上下前后的顺序
+     * @param useLowTextureURLsOnly 可选，设置后则（如果没有提供瓦片贴图）只使用低清立方体贴图
+     * @param tiledTextureURLRoot 可选，瓦片贴图URL的前缀部分，若没有则用highTextureURLs和lowTextureURLs作为贴图源
+     */
+    constructor(pid: number, seqID: number, textureURLs: string[], neighborPanoramaIDs: number[] | undefined, levelMax: number, offLinTextureUrls?: string[], offLineTextureLevel?: number, position?: NS_THREE.Vector3, quaternion?: NS_THREE.Quaternion);
+    /**
+     * 关联包围框
+     * @param size
+     */
+    private linkLineBox;
+    /**
+     * 关联球
+     * @returns
+     */
+    private linkShere;
+    /**
+     * 挂载
+     * @ignore
+     */
+    mount(): void;
+    /**
+     * 卸载
+     */
+    unMount(): void;
+    /**
+     * 更新等级
+     * @param level
+     */
+    updateLevel(level: number): void;
+    /**
+     * 获取预处理纹理信息
+     * @returns
+     */
+    getPreTextureInfos(): TileTextureInfo[];
+    /**
+     * 设置位移
+     * @param position
+     * @param quaternion
+     */
+    private setTransform;
+    /**
+     * 暂停视频播放
+     */
+    pauseVideo(): void;
+    /**
+     * 恢复视频播放
+     */
+    resumeVideo(): Promise<void>;
+    /**
+     * 停止视频播放，并释放视频相关资源
+     */
+    stopVideo(): void;
+    /**
+     * 开始视频播放
+     * @param videoURL 视频地址
+     * @param loop 是否循环播放
+     * @param callbacks 回调函数集合，可选
+     */
+    playVideo(videoURL: string, loop: boolean, callbacks?: {
+        onPrepareToPlay?: (video?: HTMLVideoElement) => void;
+        onReadyToPlay?: (video?: HTMLVideoElement) => void;
+        onEnded?: (video?: HTMLVideoElement) => void;
+    }, contentType?: 'mp4' | 'ts', canvasSize?: [number, number]): HTMLVideoElement | null;
+    /**
+     * 设置是否只使用低分辨率贴图
+     * @param useLowTexturesOnly 是否只使用低分辨率贴图
+     */
+    setUseLowTexturesOnly(useLowTexturesOnly: boolean): void;
+    /**
+     * 是否使用地分辨率贴图
+     * @returns
+     */
+    isUseLowTexturesOnly(): boolean;
+    /**
+     * 清理
+     */
+    dispose(): void;
+    /**
+     * @ignore
+     */
+    update(): ElementFrameContext;
+    /**
+     * 使用欧拉角模式设置矫正
+     * @param roll 横滚角, 坐标轴为x
+     * @param pitch 俯仰角, 坐标轴为y
+     * @param yaw 偏航角, 坐标轴为z
+     */
+    setAdditionalRotationInEuler(roll: number, pitch: number, yaw: number): NS_THREE.Quaternion;
+    /**
+     * 使用四元数模式设置矫正
+     * @param x 四元数的x值
+     * @param y 四元数的y值
+     * @param z 四元数的y值
+     * @param w 四元数的w值
+     */
+    setAdditionalRotationInQuaternion(x: number, y: number, z: number, w: number): NS_THREE.Euler;
+    /**
+     * 获取盒子
+     * @ignore
+     * @returns
+     */
+    getBox(): {
+        size: number;
+        matrix: NS_THREE.Matrix4;
+    };
+}
+export { TilePanorama, TilePanoramaViewConfiguration };

package/lib/prod/src/owlly/element/tile-plane.d.ts

@@ -0,0 +1,114 @@
+import { NS_THREE } from '../stage/externals';
+import { Element, ElementFrameContext, View } from '..';
+import { TileTextureInfo } from '../utils/tile-util';
+/**
+ * 瓦片平面，可以是平面，也可以是曲面
+ */
+declare class TilePlane extends Element {
+    private initialized;
+    /** 全景面id @ignore */
+    pfid: number;
+    private planeGeometry;
+    private uniforms;
+    private plane;
+    private needsUpdate;
+    /** @ignore */
+    textureMap: Map<string, TileTextureInfo>;
+    /** @ignore */
+    level: number;
+    /** @ignore */
+    revers: boolean;
+    /** @ignore */
+    face: number;
+    /** @ignore */
+    flipX: boolean;
+    /** @ignore */
+    flipY: boolean;
+    /** @ignore */
+    textureRootUrl: string;
+    /** @ignore */
+    offLineTextureRootUrl?: string;
+    /** @ignore */
+    offLineTextureLevel: number;
+    /**
+     * 构造
+     * @param face 面数
+     * @param flipX x翻转
+     * @param flipY y翻转
+     */
+    constructor(face: number, flipX?: boolean, flipY?: boolean);
+    /**
+     * 更新面id
+     * @ignore
+     * @param pfid 全景面id
+     * @param level 全景等级
+     */
+    updatePfid(pfid: number, level: number): void;
+    /**
+     * 设置纹理
+     * @param max
+     * @param textures
+     */
+    private setTexturesUniforms;
+    /**
+     * 更新纹理
+     * @param textures
+     * @param textureMap
+     */
+    updateTextures(textures: NS_THREE.Texture[], textureMap: Map<string, TileTextureInfo>): void;
+    /**
+     * 更新纹理图
+     * @ignore
+     * @param textureMap
+     */
+    updateInfos(textureMap: Map<string, TileTextureInfo>): void;
+    /**
+     * 更新在相机中的信息
+     * @ignore
+     * @param view
+     * @returns
+     */
+    udpateInCamera(view: View): TileTextureInfo[];
+    /**
+     * 更新
+     * @returns
+     */
+    update(): ElementFrameContext;
+    renderOnce(): void;
+    /**
+     * 销毁
+     */
+    destroy(): void;
+}
+/**
+ * 瓦片平面工具类
+ */
+declare class TilePlaneUtil {
+    private static cubeMatrix;
+    /**
+     * 设置平面可见性
+     * @ignore
+     * @param visible
+     */
+    static setPlanesVisible(visible: boolean): void;
+    /**
+     * 根据矩阵获取平面组
+     * @ignore
+     * @param pid 全景id
+     * @param level 瓦片等级
+     * @param textureUrls 纹理地址
+     * @returns
+     */
+    static getPlanesByMatrix(pid: number, level: number, textureUrls: string[], offLineTextureLevel?: number, offLineTextureUrls?: string[]): TilePlane[];
+    /**
+     * 获取cube平面矩阵
+     * @returns
+     */
+    static getCubeMatrix(): NS_THREE.Matrix4[];
+    /**
+     * 销毁所有平面
+     * @ignore
+     */
+    static destroyPlanes(): void;
+}
+export { TilePlane, TilePlaneUtil };

package/lib/prod/src/owlly/element/video-element.d.ts

@@ -0,0 +1,33 @@
+import { NS_THREE } from '../stage/externals';
+import { Element, ElementFrameContext } from './element';
+declare class SharedVideo {
+    video: HTMLVideoElement;
+    count: number;
+    playing: boolean;
+    playSet: Set<number>;
+    texture: NS_THREE.VideoTexture;
+    private listeners;
+    constructor(videoSrc: string);
+    play(identifier?: number): void;
+    pause(identifier?: number): void;
+    destroy(): void;
+}
+declare class VideoElement extends Element {
+    static Videos: Map<string, SharedVideo>;
+    private initialized;
+    private video;
+    private videoPlane;
+    private videoVisible;
+    constructor(videoSrc: string);
+    private static RemoveVideo;
+    private static AddVideo;
+    private createVideoPlane;
+    setVideoSrc(videoSrc: string): void;
+    setVideoVisible(visible: boolean): void;
+    setVideoSize(width: number, height: number): void;
+    play(identifier?: number): void;
+    stop(identifier?: number): void;
+    update(): ElementFrameContext;
+    dispose(): void;
+}
+export { VideoElement };

package/lib/prod/src/owlly/geometries/ExtrudeGeometry2.d.ts

@@ -0,0 +1,15 @@
+import { NS_THREE } from '../stage/externals';
+export interface ExtrudeGeometry2Options {
+    extrudePath: NS_THREE.Vector3[];
+    closed: boolean;
+}
+export interface UVGenerator2 {
+    generateTopUV(geometry: ExtrudeGeometry2, vertices: number[], indexA: number, indexB: number, indexC: number): THREE.Vector2[];
+    generateSideWallUV(geometry: ExtrudeGeometry2, vertices: number[], indexA: number, indexB: number, indexC: number, indexD: number): THREE.Vector2[];
+}
+declare class ExtrudeGeometry2 extends NS_THREE.BufferGeometry {
+    private parameters;
+    constructor(shapes: NS_THREE.Shape | NS_THREE.Shape[], options: ExtrudeGeometry2Options);
+    toJSON(): any;
+}
+export { ExtrudeGeometry2, ExtrudeGeometry2 as ExtrudeBufferGeometry2 };

package/lib/prod/src/owlly/index.d.ts

@@ -0,0 +1,13 @@
+import TWEEN from '@tweenjs/tween.js';
+export * from './stage';
+export * from './screen';
+export * from './view';
+export * from './overlay';
+export * from './element';
+export * from './controller';
+export * from './utils';
+export * from '../external/loaders/gltf-loader';
+export * from '../external/lines/line-geometry';
+export * from '../external/lines/line-material';
+export * from '../external/lines/line-segments-2';
+export { TWEEN };