@baidumap/mapv-three 1.0.1 → 1.2.0

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

@@ -1,3 +1,8 @@
+export namespace projectBoundingBoxMethods {
+    let MIN_MAX: number;
+    let FOUR_CORNERS: number;
+    let FOUR_CORNERS_WITH_EQUATOR: number;
+}
 /**
  * 地图投影的基类，定义了投影坐标系统的基本接口
  *
@@ -32,6 +37,12 @@ export class Projection {
      * @readonly
      */
     readonly isAxisAligned: boolean;
+    /**
+     * 表示边界框的表示方法
+     * @type {number}
+     * @readonly
+     */
+    readonly projectBoundingBoxMethod: number;
     /**
      * 将地理坐标(经纬度)转换为投影坐标
      * @param {Vector3} input 输入的地理坐标
@@ -52,7 +63,7 @@ export class Projection {
      * @param {Box3} [projectedBox] 可选的输出边界框，如不提供则创建新的Box3
      * @returns {Box3} 投影坐标系中的边界框
      */
-    geoBoxToProjectedBox(geoBox: Box3, projectedBox?: Box3): Box3;
+    geoBoxToProjectedBox(geoBox: Box3, projectedBox?: Box3, extend?: boolean): Box3;
     /**
      * 获取地理表面在指定坐标点的法线向量
      * @param {Vector3} input 输入的地理坐标
@@ -73,18 +84,13 @@ export class Projection {
      * @param {Box3} [geoBox] 可选的输出边界框，如不提供则创建新的Box3
      * @returns {Box3} 地理坐标系中的边界框
      */
-    projectedBoxToGeoBox(projectedBox: Box3, geoBox?: Box3): Box3;
+    projectedBoxToGeoBox(projectedBox: Box3, geoBox?: Box3, extend?: boolean): Box3;
     /**
      * 判断两个投影是否相等
      * @param {Projection} projection 要比较的投影对象
      * @returns {boolean} 如果两个投影相等则返回true
      */
     equals(projection: Projection): boolean;
-    /**
-     * 获取当前投影的世界边界框
-     * @returns {Box3} 投影的世界边界框
-     */
-    getWorldBoundingBox(): Box3;
     /**
      * 将本地坐标系转换为固定坐标系
      * @param {Vector3} origin 本地坐标系的原点
@@ -92,4 +98,15 @@ export class Projection {
      * @returns {Matrix4} 转换后的固定坐标系矩阵
      */
     localFrameToFixedFrame(origin: Vector3, fixedFrame?: Matrix4): Matrix4;
+    /**
+     * 获取投影的地理边界框
+     * @returns {Box3} 投影的地理边界框, 可为空
+     */
+    get geoBoundingBox(): Box3;
+    /**
+     * 获取投影的投影边界框
+     * @returns {Box3} 投影的投影边界框
+     */
+    get projectedBoundingBox(): Box3;
+    _projectedBoundingBox: any;
 }

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

@@ -1,12 +1,31 @@
 /**
- * 屏幕像素投影，Y轴反的
- * @class ScreenPixelProjection
- * @extends {Projection}
+ * 屏幕像素投影，用于屏幕坐标系与WebGL坐标系的转换
+ *
+ * 屏幕像素投影是一种简单的坐标变换投影，主要用于处理屏幕坐标系与WebGL坐标系之间的差异：
+ * - Y轴翻转：将屏幕坐标系(原点在左上角，Y轴向下)转换为WebGL坐标系(原点在中心，Y轴向上)
+ * - 保持X轴和Z轴不变
+ * - 适用于2D屏幕空间的可视化
+ *
+ * 特点：
+ * - 简单的线性变换：仅对Y轴进行翻转
+ * - 无地理意义：不涉及地理坐标转换
+ * - 适用于屏幕空间：专门用于屏幕像素坐标处理
+ * - 高效计算：变换计算非常简单
+ *
+ * 该投影主要用于：
+ * - 屏幕坐标与WebGL坐标的转换
+ * - 2D界面元素的定位
+ * - 屏幕空间的可视化效果
+ *
+ * @category Internal
+ * ```
  */
 export class ScreenPixelProjection extends Projection {
-    name: string;
-    isAxisAligned: boolean;
-    projectCoordinate(input: any, output: any): any;
-    unprojectCoordinate(input: any, output: any): any;
+    /**
+     * 投影名称
+     * @type {string}
+     * @readonly
+     */
+    readonly name: string;
 }
 import { Projection } from './Projection';

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

@@ -19,5 +19,21 @@ export class WebMercatorProjection extends Projection {
      * @readonly
      */
     readonly name: string;
+    /**
+     * 将地理坐标(经纬度)转换为Web墨卡托投影坐标
+     * @param {Vector3} input 输入的地理坐标，x,y分别为经度和纬度
+     * @param {Vector3} [output] 可选的输出向量，如不提供则创建新的Vector3
+     * @param {boolean} [extend=false] 是否扩展坐标，如果为true，则将超出范围的坐标扩展到范围外
+     * @returns {Vector3} 转换后的墨卡托投影坐标(单位:米)
+     */
+    projectCoordinate(input: Vector3, output?: Vector3, extend?: boolean): Vector3;
+    /**
+     * 将Web墨卡托投影坐标转换为地理坐标(经纬度)
+     * @param {Vector3} input 输入的墨卡托投影坐标(单位:米)
+     * @param {Vector3} [output] 可选的输出向量，如不提供则创建新的Vector3
+     * @param {boolean} [extend=false] 是否扩展坐标，如果为true，则将超出范围的坐标扩展到范围外
+     * @returns {Vector3} 转换后的地理坐标，x,y分别为经度和纬度
+     */
+    unprojectCoordinate(input: Vector3, output?: Vector3, extend?: boolean): Vector3;
 }
 import { Projection } from './Projection';

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

@@ -0,0 +1,2 @@
+export function extendUnprojectCoordinate(inputValue: any, oldValue: any, maxGlobeValue: any, maxProjectedValue: any, keepMax?: boolean): any;
+export function extendProjectCoordinate(inputValue: any, oldValue: any, maxGlobeValue: any, maxProjectedValue: any, keepMax?: boolean): any;

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

@@ -1,2 +1,13 @@
+export const projectionDefs: {
+    'EPSG:5070': {
+        parameters: string;
+        projectBoundingBoxMethod: number;
+        geoBoundingBox: number[][];
+    };
+    'EPSG:8857': {
+        parameters: string;
+        projectBoundingBoxMethod: number;
+    };
+};
 export function normalizeProjectionName(name: any): any;
 export function getProjection(name: any): any;

package/dist/types/util/LRUCacheNew.d.ts

@@ -14,6 +14,7 @@ export class LRUCache {
     add(item: any, removeCb: any): boolean;
     remove(item: any): boolean;
     clear(): void;
+    foreachItem(callback: any): void;
     markUsed(item: any): void;
     markAllUnused(): void;
     unloadUnusedContent(): void;

package/dist/types/util/coordProjection.d.ts

@@ -1,5 +1,3 @@
-export function extendUnprojectCoordinate(inputValue: any, oldValue: any, maxGlobeValue: any, maxProjectedValue: any): any;
-export function extendProjectCoordinate(inputValue: any, oldValue: any, maxGlobeValue: any, maxProjectedValue: any): any;
 /**
  * Convert 900913 x/y values to lon/lat.
  * (from https://github.com/mapbox/sphericalmercator)

package/dist/types/util/geojsonUtils.d.ts

@@ -19,6 +19,7 @@ export function projectArrayCoordinates(coordinates: Array<number>, projection:
  * @param {string} projectionName 投影方式名
  */
 export function unprojectArrayCoordinates(coordinates: Array<number>, projection: any): any;
+export function transformArrayCoordinates(coordinates: any, sourceCoordType: any, targetCoordType: any): any;
 /**
  * 投影坐标转为原始经纬度坐标过程
  * @internal

package/dist/types/util/gradientMap.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 创建默认的渐变贴图（蓝-绿-黄-红）
+ */
+export function createDefaultGradientTexture(width?: number, height?: number): any;
+export function createGradientTexture(gradient?: {}, width?: number, height?: number): any;
+/**
+ * 更新已有 CanvasTexture 的渐变内容
+ */
+export function updateGradientTexture(canvasTexture: any, gradient: any, width?: number, height?: number): void;
+/**
+ * 创建颜色分带贴图
+ * @param {string[]} bandColors - 分带颜色数组
+ * @param {number} width - 纹理宽度（建议保持与 gradientMap 相同）
+ * @param {number} height - 纹理高度
+ * @returns {CanvasTexture}
+ */
+export function createBandTexture(bandColors?: string[], width?: number, height?: number): CanvasTexture;
+/**
+ * 更新已有 CanvasTexture 的颜色分带内容
+ * @param {CanvasTexture} canvasTexture - 需要更新的 CanvasTexture 实例
+ * @param {string[]} bandColors - 分带颜色数组
+ * @param {number} width - 纹理宽度
+ * @param {number} height - 纹理高度
+ */
+export function updateBandTexture(canvasTexture: CanvasTexture, bandColors?: string[], width?: number, height?: number): void;

package/dist/types/util/graphics/bezier.d.ts

@@ -1 +1,8 @@
-export function getCurve(line: any, divisions?: number): any[][];
+/**
+ * 获取贝塞尔曲线点集
+ * @param {number[][]} line [[x,y,z], [x,y,z]]
+ * @param {number} divisions 分段数
+ * @param {number} heightRatio 控制点高度比例，越小越高
+ * @returns {number[][]}
+ */
+export function getCurve(line: number[][], options: any): number[][];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baidumap/mapv-three",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "A powerful 3D map engine.",
   "author": "mapopen-fe@baidu.com",
   "main": "dist/mapvthree.umd.js",
@@ -42,6 +42,7 @@
     "geojson-vt": "^4.0.2",
     "js-md5": "^0.8.3",
     "kdbush": "^3.0.0",
+    "mapbox-to-css-font": "^3.2.0",
     "omggif": "^1.0.10",
     "pbf": "^3.2.1",
     "potpack": "^1.0.2",

package/dist/types/addons/highwaymap/Viewer.d.ts

@@ -1,164 +0,0 @@
-export class Viewer {
-    /**
-     * 构造函数
-     * @param {{
-     * trafficLayer?: boolean,
-     * host?: string,
-     * data?: object
-     * }} options 传入参数对象
-     * @param {boolean} options.trafficLayer 是否显示路况，默认不显示
-     * @param {string} options.host 设置svg动态接口数据的host，与data二选一
-     * @param {string} options.data 设置svg静态数据，与host二选一
-     */
-    constructor(options?: {
-        trafficLayer?: boolean;
-        host?: string;
-        data?: object;
-    });
-    /** @private */ private camera;
-    /** @private */ private defaultIcon;
-    /** @private */ private defaultIconGeo;
-    /** @private */ private defaultIconSrcs;
-    /** @private */ private textArrGeo;
-    /** @private */ private lineArrGeo;
-    /** @private */ private lukuangGeo;
-    /** @private */ private defaultLines;
-    /** @private */ private lukuangLines;
-    /** @private */ private linesLukuang;
-    /** @private */ private renderer;
-    /** @private */ private scene;
-    /** @private */ private selectIcon;
-    /** @private */ private zoom;
-    trafficLayer: boolean | undefined;
-    host: string;
-    subUrl: any;
-    data: object | undefined;
-    /** @private */
-    private afterAddToEngine;
-    engine: any;
-    /** @private */
-    private beforeRemoveFromEngine;
-    /**
-     * @ignore
-     */
-    initLights(): void;
-    /** @private */
-    private dispose;
-    /**
-     * 初始化图标对象
-     * @ignore
-     * @param options 图标设置选项
-     * @param {number} options.width icon宽度
-     * @param {number} options.height icon高度
-     * @param {boolean} options.keepSize 是否保持大小（即按像素为单位绘制）
-     * @param {boolean} options.transparent 图标是否透明，默认true
-     * @param {boolean} options.vertexSizes 是否通过数据携带尺寸配置
-     * @param {boolean} options.vertexIcons 是否通过数据携带图标src配置
-     * @param {string} options.mapSrc 图标src引用路径
-     * @param {array} options.offset 图标偏移两 [x, y]
-     * @returns 返回添加的图标对象
-     */
-    _initIcon(options: any): any;
-    /**
-     * 处理svg数据
-     * @ignore
-     */
-    _getSvgDom(data: any): void;
-    /**
-     * 根据svg数据设置道路颜色
-     * @ignore
-     */
-    _getLineColor(arr: any): "rgba(13, 31, 249, 0)" | "#4fd27d" | "#e80e0e" | "#ffd045" | undefined;
-    /**
-     * 初始化svg简图
-     * @param {{
-     * roadColor?: string,
-     * }} options 初始化所需配置文件
-     * @param {string} options.roadColor 道路颜色
-     * @param {object} params 可选参数
-     */
-    initSvg(options: {
-        roadColor?: string;
-    }, params: object): Promise<any>;
-    /**
-     * 获取坐标点，包括像素坐标和百度经纬度坐标
-     * @param {{location: string, type: number}} options
-     * @param {string} location 如：经纬度坐标'116.397428, 39.90923'或像素坐标：'20823.17191, 11755.66599'
-     * @param {number} type 1：百度经纬度坐标，2：像素坐标
-     */
-    getPointInfo(options: {
-        location: string;
-        type: number;
-    }): Promise<any>;
-    /**
-     * 自定义弹框
-     * @ignore
-     */
-    _domPointCallback(feature: any): HTMLDivElement;
-    /**
-     * 设置svg图层元素
-     * @ignore
-     */
-    _getMapLayer(data: any, baseConfig: any): Promise<any>;
-    /**
-     * 生成linelayer的geojson
-     * @ignore
-     */
-    _getLineJsonData(data: any, type: any): any[];
-    /**
-     * 生成icon的geojson
-     * @ignore
-     */
-    _getIconJsons(iconArrs: any): any;
-    /**
-     * 生成textlayer的geojson
-     * @ignore
-     */
-    _getTextJsons(textArrs: any): any;
-    /**
-     * 获取textlayer的字体颜色
-     * @ignore
-     */
-    _getTextColor(className: any): "red" | "#333";
-    /**
-     * 切换路况图层显示隐藏状态
-     * @param {boolean} flag 是否打开路况图层
-     */
-    toggleTrafficLayer(flag: boolean): void;
-    /**
-     * 新增自定义弹框
-     * @param {point: Array<number>, dom: object} options 图标详情框
-     * @param {Array<number>} options.point 定位坐标
-     * @param {object} options.dom 弹窗dom节点
-     */
-    setDOMOverlay(options: any): any;
-    /**
-     * 新增图标
-     * @param {object || array} iconData geojson数据
-     * @param infoWindow 图标详情框
-     * @param {function} infoWindow.callback 编写详情框内容的函数，返回node节点
-     * @param {array} infoWindow.offset 图标偏移两 [x, y]
-     * @param {boolean} infoWindow.keepSize 是否保持大小（即按像素为单位绘制）
-     */
-    setMaker(iconData: any, infoWindow: any): any;
-    /**
-     * 初始化线对象
-     *
-     * @param options 线设置选项
-     * @param {number} options.lineWidth 线宽
-     * @param {boolean} options.vertexColors 是否通过数据携带线的颜色配置
-     * @param {string} options.lineJoin 线拐角形状
-     * @param {string} options.lineCap 端头角形状
-     * @param {string} options.color 线颜色
-     * @returns 返回添加的线对象
-     */
-    setFatLine(options: any): any;
-    /**
-     * 更新engin
-     */
-    requestRender(): void;
-    /**
-     * @ignore
-     */
-    render(): void;
-}

package/dist/types/addons/highwaymap/index.d.ts

@@ -1,3 +0,0 @@
-import { Viewer } from './Viewer';
-import { Map } from './map/Map';
-export { Viewer, Map };

package/dist/types/addons/highwaymap/map/Map.d.ts

@@ -1,59 +0,0 @@
-export class Map {
-    static EARTH_RADIUS: number;
-    constructor(engine: any, map: any, options?: {});
-    isHighwayMap: boolean;
-    MERCATOR_LENGTH: number;
-    projectionName: string;
-    origin: number[];
-    center: number[];
-    zoom: number;
-    pitch: number;
-    heading: number;
-    bounds: number[][];
-    _engine: any;
-    domContainer: any;
-    afterInit(): void;
-    initControl(): void;
-    control: MapControl | undefined;
-    bindCanvas(): void;
-    releaseCanvas(): void;
-    getContainerSize(): any[];
-    getResolution(): any;
-    getCenter(): any;
-    getZoom(): number;
-    getPitch(): number;
-    getZoomUnitsByZoom(zoom: any): number;
-    getZoomByZoomUnits(zoomUnits: any): number;
-    getZoomUnits(): number;
-    getHeading(): number;
-    enableControl(): void;
-    disableControl(): void;
-    handleViewChange: () => void;
-    handleMapResize: () => void;
-    handleEventClick: (e: any) => void;
-    handleEventDblClick: (e: any) => void;
-    handleEventPointerDown: (e: any) => void;
-    handleEventPointerUp: (e: any) => void;
-    handleEventMouseMove: (e: any) => void;
-    _getPixelFromEvent: (e: any) => number[];
-    setCameraMatrix(): void;
-    updateCamera(): void;
-    computeMapCameraMatrix(camera: any, center: any, zoom: any, pitch: any, heading: any): void;
-    zoomUnits: number | undefined;
-    cameraDistance: number | undefined;
-    setCenter(center: any): void;
-    setProjectionCenter(projectionCenter: any): void;
-    setZoom(zoom: any): void;
-    zoomIn(): void;
-    zoomOut(): void;
-    setHeading(heading: any): void;
-    setPitch(pitch: any): void;
-    lookAt(target: any, offset?: {}): void;
-    setBounds(bounds: any): void;
-    getBounds(): any;
-    updateView(): void;
-    getCameraDistance(): number | undefined;
-    getProjectionCenter(): number[];
-    dispose(): void;
-}
-import { MapControl } from './MapControl';

package/dist/types/addons/highwaymap/map/MapControl.d.ts

@@ -1,57 +0,0 @@
-export class MapControl {
-    constructor(map: any);
-    map: any;
-    currentAction: number;
-    startX: any;
-    startY: any;
-    startCenterX: any;
-    startCenterY: any;
-    startPitch: any;
-    startHeading: any;
-    startZoom: any;
-    startZoomUnits: any;
-    startAtTop: any;
-    mapWidth: any;
-    mapHeight: any;
-    startCamera: any;
-    startCenter: any;
-    startNdc: any;
-    startPoint: any;
-    startScaleX: number;
-    startScaleY: number;
-    startBoundX: any;
-    startBoundY: any;
-    /** @private */
-    private _enabled;
-    minPitch: number;
-    maxPitch: number;
-    zoomSpeed: number;
-    headingSpeed: number;
-    pitchSpeed: number;
-    doubleClickTimer: null;
-    clickInterval: number;
-    set enabled(enabled: any);
-    init: () => void;
-    handleResize: (e: any) => void;
-    handleMouseMove: (e: any) => void;
-    handleMouseDown: (e: any) => void;
-    handleMouseDragging: (e: any) => void;
-    hasMoved: boolean | undefined;
-    currentPixelX: number | undefined;
-    currentPixelY: number | undefined;
-    handleMouseUp: (e: any) => void;
-    waitSecondClick: boolean | undefined;
-    clearDoubleClickTimer: () => void;
-    handleContextMenu: (e: any) => void;
-    handleWheel: (e: any) => void;
-    handlePan: (x: any, y: any) => void;
-    setPanStartState: (px: any, py: any) => void;
-    handleRotate: (x: any, y: any) => void;
-    handleZoom: (zoomOptions: any) => void;
-    ndcToPoint(pixel: any, camera: any, target: any): void;
-    getNdc(px: any, py: any, target: any): void;
-    makeZoomSafe: (zoom: any) => any;
-    makeHeadingSafe: (heading: any) => any;
-    makePitchSafe: (pitch: any) => any;
-    dispose: () => void;
-}

package/dist/types/addons/highwaymap/service/index.d.ts

@@ -1,3 +0,0 @@
-export function getTaiZhangSvg(host: string | undefined, subUrl: any, params: any): Promise<any>;
-export function getRoadByPoint(host: string | undefined, subUrl: any, params: any): Promise<any>;
-export const defaultUrl: "http://dsw.bcc-gzbh.baidu.com:8610";

package/dist/types/addons/highwaymap/utils/eventTypes.d.ts

@@ -1,15 +0,0 @@
-export function getStage(eventType: any): string;
-/**
- * @file 事件定义
- * @author hedongran [hdr01@126.com]
- */
-export const isSupportPointerEvent: true;
-export const isMobile: boolean;
-export function isPointerTouch(e: any): boolean;
-export function isTouchEvent(e: any): any;
-export namespace EVENTS {
-    let DOWN: string;
-    let MOVE: string;
-    let UP: string;
-    let CANCEL: string;
-}

package/dist/types/addons/index.d.ts

@@ -1,4 +0,0 @@
-import * as trafficAddon from './traffic/index';
-import * as visual from './visual/index';
-import * as highwayMap from './highwaymap/index';
-export { trafficAddon, visual, highwayMap };

package/dist/types/addons/traffic/config/assets.d.ts

@@ -1,78 +0,0 @@
-export const MODEL_TAG_DYNAMIC: 1001;
-export const MODEL_TAG_SIMPLE: 1002;
-export const MODEL_TAG_IMAGE: 1005;
-export namespace TEMPLTE_MODEL_CONFIG {
-    let x: number;
-    let y: number;
-    let z: number;
-    let color: string;
-    let name: string;
-    let rotateX: number;
-    let rotateY: number;
-    let rotateZ: number;
-    let scaleX: number;
-    let scaleY: number;
-    let scaleZ: number;
-    let scale: number;
-    let opacity: number;
-    let isTips: boolean;
-    let isVisible: boolean;
-    let isClick: boolean;
-    let isBloom: number;
-    let classType: string;
-    let lodMax: number;
-    let lodMin: number;
-    let text: string;
-    let encoding: number;
-    let reflectivity: number;
-    let roughness: number;
-    let metalness: number;
-    let modelName: string;
-    let modelChildName: never[];
-    let groupInfo: string;
-}
-export namespace TEMPLATE_POINT {
-    export let uuid: string;
-    export let project_id: string;
-    let x_1: number;
-    export { x_1 as x };
-    let y_1: number;
-    export { y_1 as y };
-    let z_1: number;
-    export { z_1 as z };
-    let name_1: string;
-    export { name_1 as name };
-    export let rotate_x: number;
-    export let rotate_y: number;
-    export let rotate_z: number;
-    export let scale_x: number;
-    export let scale_y: number;
-    export let scale_z: number;
-    let scale_1: number;
-    export { scale_1 as scale };
-    export let is_tips: number;
-    export let is_visible: number;
-    export let is_click: number;
-    export let class_type: string;
-    export let lod_max: number;
-    export let lod_min: number;
-    let opacity_1: string;
-    export { opacity_1 as opacity };
-    let text_1: string;
-    export { text_1 as text };
-    export let bounding_box: string;
-    export let has_bounding_box: number;
-    export let layer_type: string;
-    export let layer_name: string;
-    export let layer_id: number;
-    export let model_name: string;
-    export let status: number;
-    export let is_bloom: number;
-    export let material_id: string;
-    export let material_list: string;
-    export let images: string;
-    export let model_info: string;
-    export let device_id: string;
-    export let id: null;
-    export let group_info: string;
-}

package/dist/types/addons/traffic/config/element.d.ts

@@ -1,23 +0,0 @@
-/**
- * 地面每个格子长宽
- */
-export const PLANE_SEGMENT_SIZE: 50000;
-/**
- * HD元素包含内容
- */
-export const hdElements: string[];
-/**
- * SD元素包含内容
- */
-export const sdElements: string[];
-/**
- * 建筑物元素包含内容
- */
-export const buildingElements: string[];
-/**
- * 地图要素列表
- */
-export const MAP_ELEMENTS: {
-    name: string;
-    type: string;
-}[];