@aibee/owlly 1.0.26 → 1.0.29

package/lib/prod/src/owlly/utils/panorama-model-util.d.ts

@@ -0,0 +1,46 @@
+import { NS_THREE } from '../stage/externals';
+declare class PanoramaModelUtil {
+    /**
+     * 获取模型的顶点着色器
+     * @ignore
+     */
+    static getModelVS(): string;
+    /**
+     * 获取穿梭的定点着色器
+     * @ignore
+     */
+    static getInstantTranslationVS(): string;
+    /**
+     * 获得模型片源着色器
+     * @ignore
+     * @returns {string} 片源着色器代码
+     */
+    static getModelFS(): string;
+    /**
+     * debug模型顶点着色器
+     * @ignore
+     */
+    static debugModelVS(): string;
+    /**
+     * debug模型片源着色器
+     * @ignore
+     */
+    static debugModelFS(): string;
+    static createModelUniforms(): {
+        [uniform: string]: NS_THREE.IUniform;
+    };
+    /**
+     * @ignore
+     */
+    static createInstantTranslationUniforms(): {
+        [uniform: string]: NS_THREE.IUniform;
+    };
+    /**
+     * 获取模型网格
+     * @ignore
+     * @param e 3d对象
+     * @returns
+     */
+    static getModelMeshInElement(e: NS_THREE.Object3D): NS_THREE.Mesh | undefined;
+}
+export { PanoramaModelUtil, };

package/lib/prod/src/owlly/utils/path-utils.d.ts

@@ -0,0 +1,80 @@
+import { NS_THREE } from '../stage/externals';
+import { FloorModel, GroundParameters } from '../element/floor-model';
+declare class PathUtils {
+    static PathMeshOffsetZ: number;
+    static ArrowMeshOffsetZ: number;
+    static getAngle(vec0: NS_THREE.Vector2, vec1: NS_THREE.Vector2): number;
+    /**
+     * 路径简化
+     * @param path 路径点集数组
+     * @param ignoreFirst 是否在简化过程中忽略第一个点
+     * @param smoothingOptimization 是否针对平滑对路径进行插值
+     * @param simplifyDistanceThreshold 简化时路径最短保留的距离, 默认为5
+     * @param maximumTurningDegree 简化时三点夹角认定为转弯的最大角度，默认为150
+     * @param smoothingDistance 平滑时使用的转角最大距离
+     */
+    static simplify(path: {
+        x: number;
+        y: number;
+    }[], ignoreFirst?: boolean, smoothingOptimization?: boolean, simplifyDistanceThreshold?: number, maximumTurningDegree?: number, smoothingDistance?: number): {
+        x: number;
+        y: number;
+    }[];
+    static averageStepLength(path: [number, number][]): number;
+    static smoothPath(path: [number, number][], threshold?: number): [number, number][];
+    static smoothPathBezier(path: [number, number][], bezierLength: number, segment?: number): [number, number][];
+    static getRenderHeight(expression: number[], x: number, y: number): number;
+    static getPointHash(x: number, y: number, minX: number, minY: number, dist?: number): [number, number];
+    /**
+     * @deprecated
+     * @param path 路径点二维坐标数组
+     * @param params 其它可选参数
+     * @param arrowImageRatio 箭头图像的宽高比，用于生成纹理坐标
+     * @param arrowImageURL 箭头图像URL
+     * @param floorModel FloorModel对象，用于计算地面高度坐标
+     * @param groundParams GroundParameters对象，用于计算地面高度坐标
+     * @param color 路劲的颜色
+     * 当存在groundParams时优先用它计算，忽略floorModel
+     */
+    static generatePathMesh(path: {
+        x: number;
+        y: number;
+    }[], params?: {
+        viewDistance?: number;
+        gradientDistance?: number;
+        arrowImageRatio?: number;
+        arrowImageURL?: string;
+        floorModel?: FloorModel;
+        groundParams?: GroundParameters;
+        color?: string;
+        dynamicPathEnabled?: boolean;
+        width?: number;
+    }): {
+        mesh: NS_THREE.Mesh;
+        arrowMeshes: {
+            arrowMesh: NS_THREE.Mesh;
+            index: number;
+        }[];
+        newPath: [number, number][];
+        pointMap: Map<string, Map<string, number[][]>>;
+        pathMinX: number;
+        pathMinY: number;
+        progressBuffer: Float32Array;
+        pathDistance: number[];
+    };
+    static nearlyEqualsV2(v1: NS_THREE.Vector2, v2: NS_THREE.Vector2, tolerance?: number): boolean;
+    static nearlyEqualsV3(v1: NS_THREE.Vector3, v2: NS_THREE.Vector3, tolerance?: number): boolean;
+    static mergePathSameVectorPoint3(path: NS_THREE.Vector3[], tolerance?: number): void;
+    static mergePathSameVectorPoint2(path: NS_THREE.Vector2[], tolerance?: number): void;
+    static mergeSamePoint3(path: NS_THREE.Vector3[], tolerance?: number): void;
+    static mergeSamePoint2(path: NS_THREE.Vector2[], tolerance?: number): void;
+    static splitPathByPoints(path: NS_THREE.Vector3[], closed: boolean, points: NS_THREE.Vector3[], widths: number | number[], tolerance?: number): {
+        paths: NS_THREE.Vector3[][];
+        split: boolean;
+    };
+    static invalidPath(path: NS_THREE.Vector3[]): boolean;
+    static getDistances(path: NS_THREE.Vector3[]): number[];
+    static findPointIndexByPath(path: NS_THREE.Vector3[], point: NS_THREE.Vector3, tolerance?: number): number[];
+    static pointInLine(point: NS_THREE.Vector3, lineP1: NS_THREE.Vector3, lineP2: NS_THREE.Vector3, tolerance?: number): boolean;
+}
+export { PathUtils };

package/lib/prod/src/owlly/utils/svgutils.d.ts

@@ -0,0 +1,138 @@
+import Snap from '@aibee/snapsvg';
+import { NS_THREE } from '../stage/externals';
+import { Shape } from '../element/map-kit/shape';
+interface ModelSvgMapping {
+    scale: number;
+    theta: number;
+    offsetRatioX: number;
+    offsetRatioY: number;
+    imageHeight?: number;
+    imageWidth?: number;
+}
+declare type ArrayFixed<T, L extends number> = [T, ...Array<T>] & {
+    length: L;
+};
+/** @ignore */
+interface SvgNode {
+    name: string;
+    type: string;
+    value: string;
+    attributes: any;
+    children: SvgNode[];
+}
+/** @ignore */
+interface Command {
+    command: CommandChar;
+    args: number[];
+}
+/** @ignore */
+interface CanvasNode {
+    id?: string;
+    children: CanvasNode[];
+    commands: Command[];
+    fill?: string;
+    fillRule?: string;
+    tag?: string;
+}
+/** @ignore */
+interface SvgTransComps {
+    position: NS_THREE.Vector3;
+    scale: NS_THREE.Vector3;
+    quaternion: NS_THREE.Quaternion;
+}
+/** @ignore */
+declare type CommandChar = 'C' | 'M' | 'L' | 'Z';
+declare class SvgUtils {
+    /**
+     * @deprecated
+     * 将SVG文件解析为Owlly map-kit可用的格式
+     * @param url svg地址
+     * @param alignMatrix 对齐数组
+     * @example
+     * ```typescript
+     * // 将svg解析为Shape对象数组
+     * const shapes = await SvgUtils.parseSVG(
+     *   <svg url>,
+     *   [0.02, 0, 0, 0, 0, -0.02, 0, 0, 0, 0, 0, 0, -40, 40, 0, 1], // 对齐矩阵
+     * );
+     * ```
+     */
+    static parseSVG(url: string, alignMatrix: ArrayFixed<number, 16>): Promise<Shape[]>;
+    static parseSVGString(svgStr: string, alignMatrix: ArrayFixed<number, 16>): Promise<Shape[]>;
+    /** @ignore */
+    static getShapesFromCanvasNode(canvasNode: CanvasNode): Shape[];
+    /** @ignore */
+    static planCoordinateToWorldCoordinate(planX: number, planY: number, mapping: ModelSvgMapping): {
+        x: number;
+        y: number;
+    };
+    /** @ignore */
+    static getPathCommands(path: string, translate: number[], mapping: ModelSvgMapping): Command[];
+    /** @ignore */
+    static svgNode2Canvas(node: SvgNode, mapping: ModelSvgMapping, isRoot?: boolean, fill?: string | null, fillRule?: string | null, translate?: number[], tag?: string | null): CanvasNode | null;
+    /** @ignore */
+    static svg2canvas(svg: SvgNode, mapping: ModelSvgMapping): CanvasNode | null;
+    /** @ignore */
+    static getPathCommandsWithAlignment(path: string, translate: number[], alignMatrix: ArrayFixed<number, 16>): Command[];
+    static get3DPositionsFrom2D([x, y]: [number, number], m: ArrayFixed<number, 16>): {
+        x: number;
+        y: number;
+    };
+    /**
+     * 获取对齐矩阵指向北方转动的弧度
+     * @param m 对齐矩阵
+     */
+    static getRotateRadiusToNorth(m: ArrayFixed<number, 16>): number;
+    /** @ignore */
+    private static generateCanvasNodeFromSvg;
+    /** @ignore */
+    static getCanvasNodeFromSvg(svg: SvgNode, alignMatrix: ArrayFixed<number, 16>): CanvasNode | null;
+    /** @ignore */
+    static generateNewShape(path: string, id: string, options?: {
+        tag?: string;
+        fill?: string;
+        ownTag?: string;
+    }): Shape;
+    /** @ignore */
+    static parseRectElementToShape(node: Snap.Element, alignMatrix: ArrayFixed<number, 16>, { tag, fill, ownTag }: {
+        tag?: string;
+        fill?: string;
+        ownTag?: string;
+    }): Shape;
+    /** @ignore */
+    static parsePolygonElementToShape(node: Snap.Element, alignMatrix: ArrayFixed<number, 16>, { tag, fill, ownTag }: {
+        tag?: string;
+        fill?: string;
+        ownTag?: string;
+    }): Shape;
+    /** @ignore */
+    static parsePathElementToShape(node: Snap.Element, alignMatrix: ArrayFixed<number, 16>, { tag, fill, ownTag }: {
+        tag?: string;
+        fill?: string;
+        ownTag?: string;
+    }): Shape;
+    /** @ignore */
+    static parseSnapSvgToShapes(node: Snap.Element, alignMatrix: ArrayFixed<number, 16>, options?: {
+        tag?: string;
+        fill?: string;
+    }): Shape[];
+    /** @ignore */
+    static getCompsFromMat4(mat: ArrayFixed<number, 16>): SvgTransComps;
+    /**
+     * 将svg解析为Shape对象数组
+     * @param url SVG文件url
+     * @param alignMatrix 对齐矩阵数组
+     * @param coefficient shape高度调整系数
+     * @example
+     * ```typescript
+     * // 将svg解析为Shape对象数组
+     * const shapes = await SvgUtils.parseSvgToShapes(
+     *   <svg url>,
+     *   [0.02, 0, 0, 0, 0, -0.02, 0, 0, 0, 0, 0, 0, -40, 40, 0, 1], // 对齐矩阵
+     * );
+     * ```
+     */
+    static parseSvgToShapes(url: string, alignMatrix: ArrayFixed<number, 16>, coefficient?: number): Promise<Shape[]>;
+    static calcHeightFromMat(height: number, alignMatrix: ArrayFixed<number, 16>): number;
+}
+export { CanvasNode, SvgNode, SvgUtils, ModelSvgMapping, };

package/lib/prod/src/owlly/utils/texture-cache.d.ts

@@ -0,0 +1,29 @@
+import { NS_THREE } from '../stage/externals';
+declare class TextureCache {
+    private textureLoader;
+    private textureCache;
+    private workingTasks;
+    private static sharedHdFaceTextureCache;
+    private static sharedLdFaceTextureCache;
+    static disposeAll(): void;
+    static get hdFaceTexturesCache(): TextureCache;
+    static get ldFaceTexturesCache(): TextureCache;
+    dispose(): void;
+    constructor(capacity: number);
+    /**
+     * @ignore
+     * 获取贴图，先从缓存中获取，若未命中则异步加载贴图
+     * @param textureURL 贴图的图像URL
+     */
+    loadTexture(textureURL: string, cacheAnyway?: boolean | undefined): Promise<NS_THREE.Texture>;
+    /**
+     * 获取一组贴图，若没命中则异步加载
+     * @param textureURLs 需要获取的贴图URL数组
+     * @param waitForReadyCount 指定函数必须在textureURLsArray中的前多少个贴图获取到以后才能返回
+     */
+    preloadTextures(textureURLs: (string | undefined)[], waitForReadyCount: number): Promise<NS_THREE.Texture[]>;
+    recycleTexture(textureURL: string): boolean;
+    getCapacity(): number;
+    getTotalCost(): number;
+}
+export { TextureCache };

package/lib/prod/src/owlly/utils/tile-util.d.ts

@@ -0,0 +1,187 @@
+import { NS_THREE } from '../stage/externals';
+declare const TEXT_MAX = 16;
+declare const TEXT_SEGMENT = 4;
+interface TileConfig {
+    textPixel?: number;
+    imgTextPixel?: number;
+}
+declare function getTextPixel(): number;
+declare function getImgTextPixel(): number;
+declare function setTileConfig(config: TileConfig): void;
+export declare const TEXT_PIXEL: number;
+export declare const IMG_TEXT_PIXEL: number;
+declare const USE_CANVAS = false;
+declare const USE_TEXTURE_BLACK = false;
+declare const VertexShader: string;
+declare const FragmentShader = "\n            uniform sampler2D mTexture0;\n            uniform sampler2D mTexture1;\n            uniform sampler2D mTexture2;\n            uniform sampler2D mTexture3;\n            uniform sampler2D mTexture4;\n            uniform sampler2D mTexture5;\n            uniform sampler2D mTexture6;\n            uniform sampler2D mTexture7;\n            uniform sampler2D mTexture8;\n            uniform sampler2D mTexture9;\n            uniform sampler2D mTexture10;\n            uniform sampler2D mTexture11;\n            uniform sampler2D mTexture12;\n            uniform sampler2D mTexture13;\n            uniform sampler2D mTexture14;\n            uniform sampler2D mTexture15;\n\n            uniform int uvMax;\n            varying vec3 vUv;\n            uniform bool black;\n\n            int modi(int x, int y) {\n              int result = x - ((x / y) * y);\n              return result < 0 ? result + y : result;\n            }\n\n            float modf(float x, float y){\n              float result = x - y * floor(x/y);\n              return result < 0.0 ? result + y : result;\n            }\n\n            int getInt(float value) {\n              // \u6DFB\u52A0\u8FB9\u754C\u68C0\u67E5\n              if (value < 0.0) return 0;\n              if (value > float(0x7FFFFFFF)) return 0x7FFFFFFF;\n\n              float m = modf(value, 1.0);\n              return m < 1.0 && m > 0.6 ? int(value) + 1 : int(value);\n            }\n\n            vec4 getSample(int index, vec2 uv) {\n              if (index == 0) return texture2D(mTexture0, uv);\n              if (index == 1) return texture2D(mTexture1, uv);\n              if (index == 2) return texture2D(mTexture2, uv);\n              if (index == 3) return texture2D(mTexture3, uv);\n              if (index == 4) return texture2D(mTexture4, uv);\n              if (index == 5) return texture2D(mTexture5, uv);\n              if (index == 6) return texture2D(mTexture6, uv);\n              if (index == 7) return texture2D(mTexture7, uv);\n              if (index == 8) return texture2D(mTexture8, uv);\n              if (index == 9) return texture2D(mTexture9, uv);\n              if (index == 10) return texture2D(mTexture10, uv);\n              if (index == 11) return texture2D(mTexture11, uv);\n              if (index == 12) return texture2D(mTexture12, uv);\n              if (index == 13) return texture2D(mTexture13, uv);\n              if (index == 14) return texture2D(mTexture14, uv);\n              if (index == 15) return texture2D(mTexture15, uv);\n              return vec4(0.0, 0.0, 0.0, 1.0); // \u9ED8\u8BA4\u8FD4\u56DE\u900F\u660E\u9ED1\u8272\n            }\n\n            vec2 getUv(vec2 uvs, int pos){\n              // \u4E25\u683C\u7684\u8FB9\u754C\u4FDD\u62A4\n              float min2 = 1.0 / 4096.0;\n              float max2 = 1.0 - min2;\n              vec2 clampedUvs = clamp(uvs, vec2(min2), vec2(max2));\n\n              vec2 tuv = clampedUvs / 4.0;\n              int x = modi(pos, 4);\n              int y = pos / 4;\n\n              float segment = 1.0 / 4.0;\n              vec2 base = vec2(float(x) * segment, float(y) * segment);\n\n              // \u6DFB\u52A0\u989D\u5916\u7684\u8FB9\u754C\u68C0\u67E5\n              return clamp(tuv + base, vec2(0.0), vec2(1.0));\n            }\n\n            void main(){\n              vec2 tuv = vUv.xy;\n              int indexPos = getInt(vUv.z);\n              int index = indexPos / 100;\n              int pos = modi(indexPos, 100);\n              tuv = getUv(tuv, pos);\n              gl_FragColor = getSample(index, tuv);\n            }";
+/**
+ * 获取瓦片信息id
+ * @ignore
+ * @param pid pid
+ * @param level 等级
+ * @param index 下标
+ * @returns id字符串
+ */
+declare function getTileInfoId(pid: number, level: number, index: number): string;
+interface FaceConfig {
+    normal: NS_THREE.Vector3;
+    trans: NS_THREE.Vector3;
+    euler?: NS_THREE.Euler;
+    face: number;
+    flipX: boolean;
+    flipY: boolean;
+    revers: boolean;
+}
+/**
+ * 六面配置
+ */
+declare const CubeFaceConfig: FaceConfig[];
+/**
+ * 根据参数获取顶点数据
+ * @ignore
+ * @param level 等级
+ * @param index 下标
+ * @param revers 逆转
+ * @param flipX x翻转
+ * @param flipY y翻转
+ * @returns 顶点数组
+ */
+declare function getVertices(level: number, index: number, revers: boolean, flipX: boolean, flipY: boolean): NS_THREE.Vector3[];
+/**
+ * info说明  TileTextureInfo
+ * pid  pid.index // pid为全景id， index为0-5的该场景的面小标
+ * textureIndex index*100 + pos // index 为textures的下标， 该纹理的区域位置，以2048*2048算的话现在为0-15
+ * level  当前的level等级
+ * index  该level等级下的平面所在区域
+ */
+declare class TileTextureInfo {
+    /** @ignore */
+    pfid: number;
+    /** @ignore 纹理坐标 */
+    textureIndex: number;
+    /** @ignore 等级 */
+    level: number;
+    /** @ignore 坐标 */
+    index: number;
+    /** @ignore 冻结 */
+    frize: boolean;
+    /** @ignore 是否在相机内 */
+    isInCamera: boolean;
+    /** @ignore 是否将要在相机内 */
+    willIsInCamera: boolean;
+    /** @ignore 顶点 */
+    private _originVertices;
+    /** @ignore */
+    rootUrl: string;
+    /** @ignore */
+    offLineRootUrl: string;
+    /** @ignore */
+    offLineLevel: number;
+    /** @ignore */
+    time: number;
+    /** @ignore */
+    centerDis: number;
+    /**
+     * 构造
+     * @ignore
+     * @param pfid 全景面id
+     * @param textureIndex 纹理下标
+     * @param level 等级
+     * @param index 下标
+     * @param rootUrl 根地址
+     */
+    constructor(pfid?: number, textureIndex?: number, level?: number, index?: number, rootUrl?: string, offLineLevel?: number, offLineRootUrl?: string);
+    /** @ignore */
+    get id(): string;
+    /** @ignore */
+    get originVertices(): NS_THREE.Vector3[];
+    /**
+     * 判定是否在相机内
+     * @ignore
+     * @param matrix 矩阵
+     * @param camera 相机
+     * @returns bool
+     */
+    inCamera(matrix: NS_THREE.Matrix4, camera: NS_THREE.Camera): boolean;
+    /**
+     * @ignore
+     * 目标id
+     */
+    get targetTid(): number;
+}
+/**
+ * 瓦片工具类
+ */
+declare class TileUtil {
+    /** 美帧最大纹理更新个数 */
+    static updateTextureMax: number;
+    /**  等级最小限制  */
+    static levelMin: number;
+    /**  等级最大限制  */
+    static levelMax: number;
+    /** 优先重置大小 */
+    static resizeFirst: boolean;
+    /**
+     * 获取xy
+     * @ignore
+     * @param value 目标值
+     * @param segment 分段
+     * @returns {x,y}
+     */
+    static getXY(value: number, segment: number): {
+        x: number;
+        y: number;
+    };
+    /**
+     * 根据level等级获取分段
+     * @ignore
+     * @param level 等级
+     * @returns 分段数
+     */
+    static getSegment(level: number): number;
+    /**
+     * 根据level等级获取总数量
+     * @ignore
+     * @param level 等级
+     * @returns 总数量
+     */
+    static getCount(level: number): number;
+    /**
+     * 获取图片信息
+     * @ignore
+     * @param pid 全景id
+     * @param index 下标
+     * @param level 等级
+     * @returns {url, id}
+     */
+    static getImageInfo2(pfid: number, index: number, level: number, rootUrl: string): {
+        url: string;
+        id: string;
+    };
+    /**
+     * 获取图片信息
+     * @param info
+     * @returns
+     */
+    static getImageInfo(info: TileTextureInfo): {
+        url: string;
+        id: string;
+    };
+    static getTileInfoId: typeof getTileInfoId;
+    static getVertices: typeof getVertices;
+    /**
+     * 防抖
+     * @param cb
+     * @param time
+     * @returns
+     */
+    static antiShake(cb: Function, time: number): Function;
+    /**
+     * 节流
+     * @param cb
+     * @param time
+     * @returns
+     */
+    static throttle(cb: Function, time: number): Function;
+}
+export { TileUtil, TileTextureInfo, TEXT_MAX, TEXT_SEGMENT, VertexShader, FragmentShader, FaceConfig, CubeFaceConfig, USE_CANVAS, USE_TEXTURE_BLACK, getTextPixel, getImgTextPixel, setTileConfig, TileConfig, };

package/lib/prod/src/owlly/utils/time-profiler.d.ts

@@ -0,0 +1,21 @@
+declare class TimeProfiler {
+    private frameTimeMillses;
+    private timingIntervalMills;
+    private fps;
+    /**
+     * 初始化FPS统计
+     * @param timingIntervalMills 统计FPS的时间区间间隔长度，单位毫秒
+     */
+    constructor(timingIntervalMills?: number);
+    reset(): void;
+    /**
+     * Tick一帧
+     * @param frameTimeMills 时间戳，是当前帧的相对时间，不是两帧之间的间隔。单位毫秒
+     */
+    tick(frameTimeMills: number): void;
+    /**
+     * 获得当前统计的FPS值
+     */
+    getFPS(): number | undefined;
+}
+export { TimeProfiler };

package/lib/prod/src/owlly/view/camera-view.d.ts

@@ -0,0 +1,35 @@
+import { NS_THREE } from '../stage/externals';
+import { View } from './view';
+import { Camera } from '../element/camera';
+/** 相机元素视图, 渲染相机元素所看到的图像, 用于虚拟部署, 需要在新版本中更新 */
+declare class CameraView extends View {
+    container: HTMLElement;
+    renderer: NS_THREE.WebGL1Renderer;
+    private activeCamera;
+    private eventListeners;
+    /**
+     * @param container 目标容器
+     */
+    constructor(container: HTMLElement);
+    /** @ignore */
+    resize(): void;
+    /** @ignore */
+    render(scene: NS_THREE.Scene): void;
+    dispose(): void;
+    /**
+     * 绑定相机元素, 绑定后视图将显示传入相机元素所看到的图像
+     * @param camera 绑定的相机元素
+     */
+    bindCamera(camera: Camera): void;
+    /**
+     * 解绑相机元素
+     * 取消相机辅助线，并清空画布
+     * edited by kxiao
+     */
+    unbindCamera(): void;
+    /**
+     * 获取当前绑定的相机元素
+     */
+    getActiveCamera(): Camera | undefined | null;
+}
+export { CameraView };

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

@@ -0,0 +1,3 @@
+export * from './view';
+export * from './perspective-view';
+export * from './orthographic-view';

package/lib/prod/src/owlly/view/orthographic-view.d.ts

@@ -0,0 +1,40 @@
+import { NS_THREE } from '../stage/externals';
+import { View } from './view';
+import { Screen } from '../screen/screen';
+/** 透视投影视图 */
+declare class OrthographicView extends View {
+    camera: NS_THREE.OrthographicCamera;
+    renderer: NS_THREE.WebGL1Renderer | NS_THREE.WebGLRenderer;
+    createCamera(): void;
+    /** @ignore */
+    resize(clientWidth: number, clientHeight: number): void;
+    bindScreen(screen: Screen): void;
+    unbindScreen(): void;
+    /** @ignore */
+    render(): void;
+    dispose(): void;
+    /**
+    * 设置View的裁剪区域，外部调用
+    */
+    setViewport(rendererOffset: NS_THREE.Vector4): void;
+    /**
+    * 更新相机和渲染区域的裁剪比例一致
+    */
+    private updateCameraAspect;
+    /**
+     * 设置相机姿态
+     * @param worldMatrix 相机的姿态矩阵
+     */
+    setCameraWorldMatrix(worldMatrix: number[]): void;
+    /**
+     * 设置相机裁剪
+     * @param fullWidth 多视图的全宽设置
+     * @param fullHeight 多视图的全高设置
+     * @param x 副摄像机的水平偏移
+     * @param y 副摄像机的垂直偏移
+     * @param width 副摄像机的宽度
+     * @param height 副摄像机的高度
+     */
+    setCameraViewPort(fullWidth: number, fullHeight: number, x: number, y: number, width: number, height: number): void;
+}
+export { OrthographicView };

package/lib/prod/src/owlly/view/perspective-view.d.ts

@@ -0,0 +1,40 @@
+import { NS_THREE } from '../stage/externals';
+import { View } from './view';
+import { Screen } from '../screen/screen';
+/** 透视投影视图 */
+declare class PerspectiveView extends View {
+    camera: NS_THREE.PerspectiveCamera;
+    renderer: NS_THREE.WebGL1Renderer | NS_THREE.WebGLRenderer | null;
+    createCamera(): void;
+    /** @ignore */
+    resize(clientWidth: number, clientHeight: number): void;
+    bindScreen(screen: Screen): void;
+    unbindScreen(): void;
+    /** @ignore */
+    render(): void;
+    dispose(): void;
+    /**
+    * 设置View的裁剪区域，外部调用
+    */
+    setViewport(rendererOffset: NS_THREE.Vector4): void;
+    /**
+    * 更新相机和渲染区域的裁剪比例一致
+    */
+    private updateCameraAspect;
+    /**
+     * 设置相机姿态
+     * @param worldMatrix 相机的姿态矩阵
+     */
+    setCameraWorldMatrix(worldMatrix: number[]): void;
+    /**
+     * 设置相机裁剪
+     * @param fullWidth 多视图的全宽设置
+     * @param fullHeight 多视图的全高设置
+     * @param x 副摄像机的水平偏移
+     * @param y 副摄像机的垂直偏移
+     * @param width 副摄像机的宽度
+     * @param height 副摄像机的高度
+     */
+    setCameraViewPort(fullWidth: number, fullHeight: number, x: number, y: number, width: number, height: number): void;
+}
+export { PerspectiveView };

package/lib/prod/src/owlly/view/svg-map-view.d.ts

@@ -0,0 +1,46 @@
+import { NS_THREE } from '../stage/externals';
+import { View } from './view';
+import { ModelSvgMapping } from '../utils/svgutils';
+/**
+ * 该 View 为早期为 BI 制作的专属 View, 可以不再进行维护. 其组成为两个定制开发的 Overlay. 这些 Overlay 也可以不再维护.
+ */
+declare class SvgMapView extends View {
+    camera: NS_THREE.PerspectiveCamera;
+    container: HTMLElement;
+    renderer: NS_THREE.WebGL1Renderer;
+    private pathOverlay;
+    private labelOverlay;
+    constructor(container: HTMLElement, shadowEnabled?: boolean);
+    update(): boolean;
+    setCameraPosition(x: number, y: number, z: number): void;
+    setCameraLookAt(x: number, y: number, z: number): void;
+    resize(): void;
+    render(scene: NS_THREE.Scene): void;
+    dispose(): void;
+    setPath(path: NS_THREE.Vector3[], startPointType: string | null, endPointType: string | null, message: string | null, fontSize: number, imageStyle: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    }, messageStyle: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    }, iconStyle: {
+        width: number;
+        height: number;
+    }): void;
+    setStores(stores: {
+        position: NS_THREE.Vector3;
+        name: string;
+        nodeId: string;
+        fontSize?: number;
+    }[]): void;
+    setPriorNodes(ids: string[]): void;
+    getCameraInfo(target: NS_THREE.Object3D): {
+        position: NS_THREE.Vector3;
+        lookAt: NS_THREE.Vector3 | null;
+    };
+}
+export { SvgMapView, ModelSvgMapping };