@baidumap/mapv-three 1.0.0

package/dist/types/threemap/overlay/Popup.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 信息弹窗覆盖物，用于在地图上显示标题和内容信息。继承自{@link DOMOverlay}。
+ *
+ * @category Objects
+ * @example
+ * ```javascript
+ * // 创建一个基础信息弹窗
+ * const popup = engine.add(new mapvthree.Popup({
+ *     point: [116.404, 39.915, 0],
+ *     title: '位置信息',
+ *     content: '北京市天安门广场',
+ *     offset: [0, -20],  // 向上偏移20像素
+ * }));
+ *
+ * // 动态更新内容
+ * popup.content = '新的内容';
+ * popup.title = '新的标题';
+ * ```
+ */
+export class Popup extends DOMOverlay {
+    constructor(parameters: any);
+    /** @private */ private _titleDiv;
+    /** @private */ private _contentDiv;
+    /** @private */ private _title;
+    /** @private */ private _content;
+    /** @private */ private _closePopup;
+    isPopup: boolean;
+    initDom(): HTMLDivElement;
+    /**
+     * 设置标题
+     * @param {string} value 标题
+     */
+    set title(value: string);
+    /**
+     * 获取标题
+     * @returns {string} 标题
+     */
+    get title(): string;
+    /**
+     * 设置内容
+     * @param {string} value 内容
+     */
+    set content(value: string);
+    /**
+     * 获取内容
+     * @returns {string} 内容
+     */
+    get content(): string;
+    click: () => void;
+}
+import { DOMOverlay } from './DOMOverlay';

package/dist/types/threemap/panorama/DataParser.d.ts

@@ -0,0 +1,6 @@
+/**
+ * sdata类型请求响应解析
+ * @param {Object} sdata - 要解析的JSON对象
+ * @return {PanoData | null} - 解析出来PanoData对象
+ */
+export function parseSData(sdata: Object): PanoData | null;

package/dist/types/threemap/panorama/DataStruct/PanoramaData.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @file 全景引擎输入数据结构定义
+ * @author quda
+ */
+export class PanoramaData {
+    /**
+     * TODO: 实验属性！！！
+     * 直接传入的全景图片资源
+     * 单张图片使用球模型渲染
+     * 六张图片使用天空盒渲染，顺序[px, nx, py, ny, pz, nz]
+     */
+    image: any;
+    /**
+     * 场景点的Id
+     */
+    panoId: string;
+    /**
+     * 内景ID，相册功能新增iid，这个iid其实是一个场景组id，对于一个场景组，存在多个场景即多个pid，
+     * 切换场景而不更改场景组（panoId变化iid不变）不重新加载相册图片
+     */
+    iid: string;
+    /**
+     * 场景点的类型，内景or外景，street or inter 用于区分内景和外景
+     */
+    panoType: string;
+    /**
+     * 场景点空间位置，墨卡托坐标X（单位米）
+     */
+    panoX: number;
+    /**
+     * 场景点空间位置，墨卡托坐标Y（单位米）
+     */
+    panoY: number;
+    /**
+     * 场景点空间位置，墨卡托坐标Z（单位米）
+     */
+    panoZ: number;
+    /**
+     * 水平偏航角（角度值）
+     * 承接街景sdata接口内的行车角度
+     */
+    heading: number;
+    /**
+     * 垂直视角（角度值）
+     * 供街景sdata接口内的行车角度
+     */
+    pitch: number;
+    /**
+     * 当前场景初始化默认水平视角
+     */
+    defaultHeading: any;
+    /**
+     * 当前场景初始化默认垂直视角
+     */
+    defaultPitch: any;
+    /**
+     * 图片起始点与北的夹角
+     */
+    northDir: number;
+    /**
+     * 用于纠正球模型姿态的偏航角heading（角度值）
+     */
+    fixHeading: number;
+    /**
+     * 用于纠正球模型姿态的俯仰角pitch 用于纠正车行驶过程中上下坡（角度值）
+     */
+    fixPitch: number;
+    /**
+     * 用于纠正球模型姿态倾斜角roll 用于纠正车行驶过程中左右不平（角度值）
+     */
+    fixRoll: number;
+    /**
+     * 采集设备离地面的高度（单位米）
+     */
+    deviceHeight: number;
+    /**
+     * 拍摄日期
+     */
+    date: string;
+    /**
+     * 街景拍摄时间
+     */
+    time: string;
+    /**
+     * 数据提供商
+     */
+    provider: number;
+    /**
+     * 审图号
+     */
+    admission: string;
+    /**
+     * 相册数据
+     * @property photos
+     */
+    photos: any[];
+    /**
+     * 当前pano点所属的道路名字
+     */
+    roadName: string;
+    /**
+     * 道路数据，每条道路是道路信息和道路上的场景点的集合
+     */
+    roads: any[];
+    /**
+     * 连接点数据
+     */
+    vpoints: any[];
+    /**
+     * 当前场景点的topo点，紧挨着当前场景的场景点数组
+     * @type {Array}
+     */
+    topoArray: any[];
+    /**
+     * 街景点属于的道路
+     * @property currentRoad
+     */
+    currentRoad: undefined;
+    /**
+     * 道路的宽度
+     * @property roadWidth
+     * @type {number}
+     */
+    roadWidth: number;
+    /**
+     * 获取当前道路信息
+     * @return {Array} - 包含了很多道路节点的数组
+     */
+    getCurrentRoad: () => any[];
+    /**
+     * 返回一个数组 每一项为一个object
+     *     {
+     *         panoId:'',       // String 场景点ID
+     *         topoDir:'',      // Number 拓扑朝向，角度值
+     *         roadName:'',  // String  道路名称
+     *         panoType:'',   // String  场景点类型
+     *         panoX:'',        // Number 墨卡托坐标（单位米）
+     *         panoY:'',        // Number 墨卡托坐标（单位米）
+     *         cPoint:{x:'', y:''},      // link路口的连接点坐标
+     *     }
+     * @return  {Array} - 拓扑点数组
+     */
+    getTopos: () => any[];
+    getRoadWidth: () => number;
+}

package/dist/types/threemap/panorama/DataStruct/RoadData.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @file 道路数据定义
+ * @author quda
+ */
+export class RoadData {
+    /**
+     * 道路ID
+     * @property rid
+     * @type {string}
+     */
+    rid: string;
+    /**
+     * 道路名称
+     * @property roadName
+     * @type {string}
+     */
+    roadName: string;
+    /**
+     * 路宽（单位米）
+     * @property roadWidth
+     * @type {number}
+     * @default 5
+     */
+    roadWidth: number;
+    /**
+     * 用来标识是否是当前点所在道路
+     * @property isCurrentRoad
+     */
+    isCurrentRoad: number;
+    /**
+     * 当前道路的数据点数组，
+     * 每一个元素是一个道路点对象
+     * @property pointList
+     * @type {Array}
+     */
+    pointList: any[];
+    /**
+     * 如果街景点落在当前道路上， 求街景点在当前道路上的拓扑点。
+     * @param {string} panoId - 场景点ID
+     * @return {Array} - 返回一个弧度的数组 每一项为一个object
+     */
+    getTopoInRoad: (panoId: string) => any[];
+    /**
+     * 生成一个拓扑对象， 用来生成拓扑数据对象。
+     * @method generateTopoData
+     * @param {number} degree - 拓扑箭头的朝向
+     * @param {Object} pointData - 道路上的场景点对象
+     * @return {Object} - 添加了topoDir和roadName的pointData
+     */
+    generateTopoData(degree: number, pointData: Object): Object;
+    /**
+     * 获取场景点ID对应在当前道路上的场景点信息，
+     * 如果查找不到，则返回undefined
+     * @method getPointBypanoId
+     * @param  {string}  panoId - 场景点ID
+     * @return  {Object} - 道路上的单点对象
+     */
+    getPointByPanoId: (panoId: string) => Object;
+}

package/dist/types/threemap/panorama/Pano.d.ts

@@ -0,0 +1,65 @@
+export class Pano {
+    constructor(options: any);
+    isPano: boolean;
+    /**
+     * 全景id
+     * @internal
+     */
+    _sid: any;
+    /**
+     * 服务锁，防止同时多次触发setID导致的异常
+     * @private
+     * @type {boolean}
+     */
+    private _panoServiceLock;
+    /**
+     * 全景瓦片精细层级
+     * @private
+     * @type {number} 2 | 3 | 4 | 5
+     */
+    private _level;
+    /**
+     * 存储全景的箭头PanoArrow对象
+     * @private
+     */
+    private linkInfos;
+    /**
+     * 存储全景的箭头Mesh实例
+     * @private
+     */
+    private arrowMeshes;
+    /**
+     * 全景箭头url
+     * @private
+     */
+    private topoUrl;
+    options: any;
+    _panoService: PanoService;
+    topoArrowTexture: any;
+    _group: any;
+    afterAddToEngine(engine: any): void;
+    _engine: any;
+    _sphere: PanoSphere | undefined;
+    beforeRemoveFromEngine(): void;
+    setID(sid: any): Promise<void>;
+    resetArrow(): void;
+    /**
+     * 设置道路箭头可见性
+     * @public
+     * @param {boolean} visible - 可见性
+     */
+    public setArrowVisible(visible: boolean): void;
+    linkVisible: boolean | undefined;
+    /**
+     * 加载箭头相关纹理
+     * @private
+     */
+    private loadArrowTextures;
+    dispose(): void;
+    set sid(value: any);
+    get sid(): any;
+    set level(value: number);
+    get level(): number;
+}
+import { PanoService } from './PanoService';
+import { PanoSphere } from './PanoSphere';

package/dist/types/threemap/panorama/PanoArrow.d.ts

@@ -0,0 +1,42 @@
+export class PanoArrow {
+    constructor(engine: any, linkData: any, northDir: any);
+    _engine: any;
+    linkData: any;
+    northDir: any;
+    yAxisDis: number;
+    material: any;
+    mesh: any;
+    /**
+     * 初始化箭头网格
+     */
+    initMesh(): any;
+    createArrowMaterial(): any;
+    /**
+     * 设置箭头纹理，供上层调用
+     * @public
+     *
+     * @param {Texture} texture - 箭头纹理
+     */
+    public setTopoTexture(texture: Texture): void;
+    /**
+     * 设置单个箭头的显隐
+     * @public
+     *
+     * @param {Boolean} v - 显隐
+     */
+    public setVisible(v: boolean): void;
+    createGeometry(): any;
+    /**
+     * 更改箭头姿态
+     * @private
+     * @param {Mesh} mesh - 箭头网格对象
+     */
+    private changePose;
+    /**
+     * 根据箭头方向获取箭头文字纹理坐标
+     * @param {number} deg - 箭头相对北的角度
+     * @return {Array} - 纹理坐标
+     */
+    getTextCoord(deg: number): any[];
+    dispose(): void;
+}

package/dist/types/threemap/panorama/PanoService.d.ts

@@ -0,0 +1,20 @@
+export class PanoService {
+    /**
+     * 默认请求域名
+     */
+    static SERVICE_URL: string;
+    constructor(pano: any);
+    _cache: LRUCache;
+    /**
+     * 根据panoId请求全景数据
+     * @param {string} panoId - 全景ID
+     */
+    getPanoById: (panoId: string) => Promise<any>;
+    /**
+     * 数据请求封装
+     * @param {string} url - 请求地址
+     * @return {Promise} 请求状态机
+     */
+    getDataByUrl(url: string): Promise<any>;
+}
+import { LRUCache } from '../../util/LRUCache';

package/dist/types/threemap/panorama/PanoSphere.d.ts

@@ -0,0 +1,61 @@
+export class PanoSphere {
+    static TILE_URL_TEMPLATE: string;
+    cdnList: string[];
+    _imageCache: LRUCache;
+    canvas: HTMLCanvasElement;
+    ctx: CanvasRenderingContext2D | null;
+    texture: any;
+    mesh: any;
+    setID(panoId: any, level: any): Promise<void>;
+    /**
+     * 加载当前场景缩略图纹理
+     * @param {string} panoId - 全景ID
+     */
+    loadThumbTextures(panoId: string): Promise<any>;
+    /**
+     * 加载当前场景缩略图纹理
+     * @param {string} panoId - 全景ID
+     */
+    loadTextures(panoId: string, level: any): Promise<any>;
+    /**
+     * 计算图块id编号
+     * @public
+     *
+     * @param {string} id - 全景id
+     * @param {number} x - 图块行号
+     * @param {number} y - 图块列号
+     * @param {number} zoom - 图块级别
+     * @return {string} 图块编号id
+     */
+    public calcTileKey: (id: string, x: number, y: number, zoom: number) => string;
+    /**
+     * 从CDN列表中获取一个随机的作为请求地址
+     * @private
+     *
+     * @param {Array} cdnList - cdnlist
+     * @return {string} - 地址
+     */
+    private getCDN;
+    /**
+     * 生成瓦片url
+     * @param {string} id - 全景id
+     * @param {Object} tileCoord - 瓦片坐标 {x, y}
+     * @param {number} zoom - 瓦片级别
+     * @return {string} 瓦片url
+     */
+    getTilesUrl(id: string, tileCoord: Object, zoom: number): string;
+    /**
+     * 加载图片
+     * 发起图片请求，并缓存结果。如果已在缓存内，则从缓存中获取。
+     * @private
+     *
+     * @param {string} panoId - 全景ID
+     * @param {number} tileX - 瓦片行号
+     * @param {number} tileY - 瓦片列号
+     * @param {number} zoom - 瓦片级别
+     * @return {Promise} - 图片加载的回调
+     */
+    private loadImage;
+    dispose(): void;
+}
+import { LRUCache } from '../../util/LRUCache';

package/dist/types/threemap/projections/BaiduMercatorProjection.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 百度墨卡托投影，用于百度地图的坐标系统
+ *
+ * 百度墨卡托投影是基于Web墨卡托投影的变体，专用于百度地图服务。
+ * 它对标准墨卡托投影进行了偏移和变换，使其与百度地图系统匹配。
+ * 特点：
+ * - 坐标系原点位于中国地区
+ * - 坐标单位为米
+ * - 与WGS84坐标系存在非线性偏移
+ *
+ * 该投影主要用于：
+ * - 与百度地图服务对接
+ * - 处理百度地图提供的数据
+ * - 开发基于百度地图的应用
+ *
+ * @category Internal
+ */
+export class BaiduMercatorProjection extends Projection {
+    /**
+     * 投影名称
+     * @type {string}
+     * @readonly
+     */
+    readonly name: string;
+}
+import { Projection } from './Projection';

package/dist/types/threemap/projections/ECEFProjection.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 地球中心地固坐标系(ECEF)投影，用于3D地球表示
+ *
+ * ECEF坐标系是一种以地球中心为原点的笛卡尔坐标系：
+ * - X轴通过赤道面和本初子午线(0°经线)的交点
+ * - Z轴通过北极
+ * - Y轴与X和Z轴垂直，形成右手坐标系
+ *
+ * 特点：
+ * - 坐标单位为米
+ * - 可以精确表示地球曲面
+ * - 适用于全球尺度的3D可视化
+ * - 随地球自转而旋转
+ *
+ * 该投影主要用于：
+ * - 3D地球表示
+ * - 卫星轨道计算
+ * - 精确的全球定位
+ *
+ * @category Internal
+ */
+export class ECEFProjection extends Projection {
+    /**
+     * 投影名称
+     * @type {string}
+     * @readonly
+     */
+    readonly name: string;
+    /**
+     * 将地理边界框转换为投影坐标系边界框
+     * @param {Box3} geoBox 地理坐标系中的边界框
+     * @param {OrientedBoundingBox} [projectedBox] 可选的输出边界框，如不提供则创建新的OrientedBoundingBox
+     * @returns {OrientedBoundingBox} 投影坐标系中的有向边界框
+     */
+    geoBoxToProjectedBox(geoBox: Box3, projectedBox?: OrientedBoundingBox): OrientedBoundingBox;
+    /**
+     * 获取地理边界框的LOD缩放因子
+     * @param {Box3} geoBoundingBox 地理坐标系中的边界框
+     * @returns {number} LOD缩放因子
+     */
+    getLODSacleOfGeoBoundingBox(geoBoundingBox: Box3): number;
+    localFrameToFixedFrame(origin: any, fixedFrame: any): any;
+}
+import { Projection } from './Projection';
+import { OrientedBoundingBox } from '../engine/map/earth/OrientedBoundingBox';

package/dist/types/threemap/projections/EqualEarthProjection.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @class EqualEarthProjection
+ * @extends {Projection}
+ */
+export class EqualEarthProjection extends Projection {
+    name: string;
+    projectCoordinate(input: any, output: any): any;
+    unprojectCoordinate(input: any, output: any): any;
+    geoBoxToProjectedBox(geoBox: any, projectedBox: any): any;
+}
+import { Projection } from './Projection';

package/dist/types/threemap/projections/GeoProjection.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 地理经纬度投影，将经纬度坐标按比例缩放
+ *
+ * GeoProjection是最简单的投影方式，它仅将经纬度坐标按一定比例缩放，不改变坐标的拓扑关系。
+ * 缩放系数为地球半径(6378137米)乘以π/180，将角度单位转换为近似的米单位。
+ * 该投影主要用于：
+ * - 简单的地理数据可视化
+ * - 不要求高精度的场景
+ * - 作为其他投影的基础
+ *
+ * @category Internal
+ */
+export class GeoProjection extends Projection {
+    /**
+     * 投影名称
+     * @type {string}
+     * @readonly
+     */
+    readonly name: string;
+}
+import { Projection } from './Projection';

package/dist/types/threemap/projections/Projection.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 地图投影的基类，定义了投影坐标系统的基本接口
+ *
+ * 投影类负责在地理坐标(经纬度)和投影坐标(米、像素等)之间进行转换。
+ * 所有的具体投影类都继承自这个基类，并实现其定义的接口方法。
+ *
+ * 主要功能：
+ * - 坐标正向投影与反向投影
+ * - 边界框转换
+ * - 投影平面法线计算
+ *
+ * @category Internal
+ */
+export class Projection {
+    /**
+     * 标识该对象是投影类
+     * @type {boolean}
+     * @readonly
+     * */
+    readonly isProjection: boolean;
+    /**
+     * 表示该投影是否是地理投影(经纬度为基础的投影)
+     * @type {boolean}
+     * @readonly
+     */
+    readonly isGeo: boolean;
+    /**
+     * 表示该投影坐标延续方向是否和世界坐标方向是平行的
+     * 即投影后的坐标不会出现曲线、曲面的情况
+     * 这些投影在绘制背景面（Rectangle类型）等元素时，可以使用更高效的简化绘制方式
+     * @type {boolean}
+     * @readonly
+     */
+    readonly isAxisAligned: boolean;
+    /**
+     * 将地理坐标(经纬度)转换为投影坐标
+     * @param {Vector3} input 输入的地理坐标
+     * @param {Vector3} [output] 可选的输出向量，如不提供则创建新的Vector3
+     * @returns {Vector3} 转换后的投影坐标
+     */
+    projectCoordinate(input: Vector3, output?: Vector3): Vector3;
+    /**
+     * 将投影坐标转换为地理坐标(经纬度)
+     * @param {Vector3} input 输入的投影坐标
+     * @param {Vector3} [output] 可选的输出向量，如不提供则创建新的Vector3
+     * @returns {Vector3} 转换后的地理坐标
+     */
+    unprojectCoordinate(input: Vector3, output?: Vector3): Vector3;
+    /**
+     * 将地理边界框转换为投影坐标系边界框
+     * @param {Box3} geoBox 地理坐标系中的边界框
+     * @param {Box3} [projectedBox] 可选的输出边界框，如不提供则创建新的Box3
+     * @returns {Box3} 投影坐标系中的边界框
+     */
+    geoBoxToProjectedBox(geoBox: Box3, projectedBox?: Box3): Box3;
+    /**
+     * 获取地理表面在指定坐标点的法线向量
+     * @param {Vector3} input 输入的地理坐标
+     * @param {Vector3} [output] 可选的输出向量，如不提供则创建新的Vector3
+     * @returns {Vector3} 法线向量
+     */
+    getGeodeticSurfaceNormal(input: Vector3, output?: Vector3): Vector3;
+    /**
+     * 获取投影表面在指定坐标点的法线向量
+     * @param {Vector3} input 输入的投影坐标
+     * @param {Vector3} [output] 可选的输出向量，如不提供则创建新的Vector3
+     * @returns {Vector3} 法线向量
+     */
+    getProjectedSurfaceNormal(input: Vector3, output?: Vector3): Vector3;
+    /**
+     * 将投影坐标系边界框转换为地理边界框
+     * @param {Box3} projectedBox 投影坐标系中的边界框
+     * @param {Box3} [geoBox] 可选的输出边界框，如不提供则创建新的Box3
+     * @returns {Box3} 地理坐标系中的边界框
+     */
+    projectedBoxToGeoBox(projectedBox: Box3, geoBox?: Box3): Box3;
+    /**
+     * 判断两个投影是否相等
+     * @param {Projection} projection 要比较的投影对象
+     * @returns {boolean} 如果两个投影相等则返回true
+     */
+    equals(projection: Projection): boolean;
+    /**
+     * 获取当前投影的世界边界框
+     * @returns {Box3} 投影的世界边界框
+     */
+    getWorldBoundingBox(): Box3;
+    /**
+     * 将本地坐标系转换为固定坐标系
+     * @param {Vector3} origin 本地坐标系的原点
+     * @param {Matrix4} [fixedFrame] 可选的输出矩阵，如不提供则创建新的Matrix4
+     * @returns {Matrix4} 转换后的固定坐标系矩阵
+     */
+    localFrameToFixedFrame(origin: Vector3, fixedFrame?: Matrix4): Matrix4;
+}

package/dist/types/threemap/projections/ScreenPixelProjection.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 屏幕像素投影，Y轴反的
+ * @class ScreenPixelProjection
+ * @extends {Projection}
+ */
+export class ScreenPixelProjection extends Projection {
+    name: string;
+    isAxisAligned: boolean;
+    projectCoordinate(input: any, output: any): any;
+    unprojectCoordinate(input: any, output: any): any;
+}
+import { Projection } from './Projection';

package/dist/types/threemap/projections/UTMProjection.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @class UTMProjection
+ * @extends {Projection}
+ */
+export class UTMProjection extends Projection {
+    constructor(zone?: number, isSouth?: boolean);
+    categoryName: string;
+    _zone: number;
+    _isSouth: boolean;
+    projectCoordinate(input: any, output: any): any;
+    unprojectCoordinate(input: any, output: any): any;
+    geoBoxToProjectedBox(geoBox: any, projectedBox: any): any;
+    equals(projection: any): boolean;
+    get name(): string;
+    _name: string | undefined;
+    get zone(): number;
+    get isSouth(): boolean;
+    get geoBoundingBox(): any;
+    _geoBoundingBox: any;
+}
+import { Projection } from './Projection';