@baidumap/mapv-three 1.0.0

package/dist/types/threejs/objects/GeoObject.d.ts

@@ -0,0 +1,145 @@
+/** @protected */
+export class GeoObject extends ThreeObject {
+    /**
+     * @readonly
+     * 类型为GeoObject的标识
+     */
+    readonly isGeoObject: true;
+    /**
+     * @internal
+     * 是否自动更新渲染数据
+     * 默认为TRUE，如果需要手动管理数据的更新则需要置为FALSE
+     */
+    dataAutoUpdate: boolean;
+    /** @private */ private _parameters;
+    /** @private */ private _dataSource;
+    /** @private */ private _dataSourceUpdated;
+    /** @private */ private _needsUpdate;
+    /** @private */ private _zooms;
+    /** @private */ private _zoomVisibleCache;
+    /** @protected */ protected engine: any;
+    /** @protected */
+    set parameters(value: any);
+    /**
+     * object的传入参数
+     */
+    get parameters(): any;
+    /**
+     * 设置object的数据源
+     * @param {DataSource} dataSource 数据源
+     */
+    set dataSource(dataSource: DataSource);
+    /** object连接的数据源[[DataSource]]类 */
+    get dataSource(): DataSource;
+    /**
+     * 设置object是否在下一帧更新
+     * @param {boolean} value 设置为true，则下一帧渲染前更新该object
+     */
+    set needsUpdate(value: boolean);
+    /**
+     * 是否需要更新
+     */
+    get needsUpdate(): boolean;
+    /**
+     * 设置显示object的zoom级别范围
+     * @internal
+     * @param {Array} value 级别范围数组
+     */
+    set zooms(value: any[]);
+    /**
+     * 显示object的zoom级别范围
+     * @internal
+     */
+    get zooms(): any[];
+    /**
+     * 当前zoom级别是否在zooms设定的显示级别范围内
+     * @internal
+     */
+    get inZoomsRange(): boolean;
+    /** @protected */
+    protected afterAddToEngine(engine: any): void;
+    /**
+     * @internal
+     */
+    beforeRemoveFromEngine(engine: any): void;
+    /**
+     * @protected
+     */
+    protected initObject(): void;
+    /** @protected */
+    protected getDefaultParams(): {};
+    /**
+     * @protected
+     * 通过index获取该index对应的数据源的实体信息entity，entity中包括数据索引、
+     * 索引对应的原始数据和经过解析之后的数据
+     * @param {number} index
+     * @returns {object}
+     */
+    protected getEntityByIndex(index: number): object;
+    /**
+     * @internal
+     */
+    setDataSource(dataSource: any): void;
+    /**
+     * @internal
+     */
+    onBeforeScenePrepareRender(engine: any, scene: any, camera: any, renderState: any): void;
+    visible: any;
+    /**
+     * @internal
+     */
+    onBeforeSceneRender(engine: any, scene: any, camera: any, renderState: any): void;
+    _collisionUpdated: boolean | undefined;
+    /**
+     * TODO: 重命名为 _updateData()
+     * object接入数据的入口
+     * @internal
+     */
+    _updateData(): void;
+    /**
+     * object元素碰撞检测时计算自身尺寸的方法
+     * @protected
+     */
+    protected collisionTest(data: any): {};
+    /**
+     * @internal
+     */
+    travelFeatureLineCoordinate: (feature: any, coordinateName: any, callback: any) => void;
+    /**
+     * @internal
+     * 遍历线型边界， [[x1, y1],[x2, y2], ...]
+     */
+    travelLineCoordinates: (features: any, coordinateName: string | undefined, callback: any, offsetIndex?: number) => void;
+    /**
+     * @internal
+     * 遍历多边形边界， [[[x1, y1],[x2, y2], ...],...]
+     */
+    travelPolygonCoordinates: (features: any, coordinateName: string | undefined, callback: any, offsetIndex?: number) => void;
+    /**
+     * @internal
+     * 遍历点， [x1, y1]
+     */
+    travelPointCoordinates: (features: any, coordinateName: string | undefined, callback: any, offsetIndex?: number) => void;
+    /**
+     * @internal
+     */
+    getPointsBounding: (features: any, coordinateName?: string) => number[];
+    /**
+     * dispose时调用该函数，执行节点在object上的geometry和material实例销毁之后
+     * @internal
+     * @example
+     * ```javascript
+     *  object.onDispose = () => {
+     *      console.log('object disposed');
+     *  }
+     * ```
+     */
+    onDispose(): void;
+    /**
+     * 销毁object上的geometry和material实例，释放资源, 调用`engine.remove(object)`会自动销毁资源，不需要手动调用
+     */
+    dispose(): void;
+    bindTerrain(terrain: any): void;
+    _terrain: any;
+}
+import { ThreeObject } from './ThreeObject';

package/dist/types/threejs/objects/GeoPoints.d.ts

@@ -0,0 +1,26 @@
+/** @protected */
+export class GeoPoints extends GeoObject {
+    /**
+     * @readonly
+     * 类型为Points的标识
+     */
+    readonly isPoints: true;
+    /** @protected */
+    protected isEventEntitySupported: boolean;
+    /**
+     * 设置object尺寸
+     * @param {number} value 尺寸值
+     */
+    set size(value: number);
+    /**
+     * object尺寸
+     */
+    get size(): number;
+    /** @protected */
+    protected getEntityByIndex(index: any): {
+        value: any;
+        itemIndex: any;
+        pairs: {};
+    };
+}
+import { GeoObject } from './GeoObject';

package/dist/types/threejs/objects/ThreeObject.d.ts

@@ -0,0 +1,49 @@
+/** @protected */
+export class ThreeObject {
+    constructor(options: any);
+    /** @private */ private _enableRtc;
+    /** @private */ private _cachedRtc;
+    /**
+     * @internal
+     */
+    makeMeshPositionOffset: (offset: any) => void;
+    /**
+    * @internal
+    * @param {*} geometry 要偏移坐标的geometry
+    */
+    makeGeometryOffsetPosition: (geometry: any, positions: any) => void;
+    /**
+     * @internal
+     */
+    makePostionArrayOffset: (positions: any, x: any, y: any, z: any, origin: any) => void;
+    /**
+     * @internal
+     */
+    updateTransform: () => void;
+    /**
+     * 将this.geometry下挂载的同名getter与setter属性挂载到this上，方便操作
+     * @param {Array<string>} properties 属性名数组
+     * @internal
+     */
+    defineGeometryProxyProperties(properties?: Array<string>): void;
+    defineGeometryUpdateProxyProperties(properties?: any[]): void;
+    /**
+     * 将this.material下挂载的同名getter与setter属性挂载到this上，方便操作
+     * @param {Array<string>} properties 属性名数组
+     * @internal
+     */
+    defineMaterialProxyProperties(properties?: Array<string>): void;
+    /**
+     * 将this.material下挂载的同名的相关的getter与setter属性挂载到this上
+     * 这些属性重新赋值会重新更新材质, 如transparent不需要用户手动设置material.needsUpdate = true, 简化操作
+     * @internal
+     */
+    defineMaterialUpdateProxyProperties(properties?: any[]): void;
+    /**
+     * 将this.material下挂载Color相关的getter与setter属性挂载到this上，方便操作
+     * @param {Array<string>} properties 属性名数组
+     * @internal
+     */
+    defineMaterialColorProxyProperties(properties?: Array<string>): void;
+    raycast(raycaster: any, intersects: any): void;
+}

package/dist/types/threejs/objects/element/RoadLight.d.ts

@@ -0,0 +1,8 @@
+export class RoadLight {
+    constructor(geometry: any);
+    geometry: any;
+    material: any;
+    mesh: any;
+    set color(color: any);
+    get color(): any;
+}

package/dist/types/threejs/objects/element/TileLightManager.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 瓦片红绿灯管理者，有两种数据更新模式
+ * 1. _periodUpdate: false 循环刷新（数据符合条件）
+ * 2. _periodUpdate: true 定时刷新，周期时间到了就重新请求
+ */
+export class TileLightManager {
+    constructor(api: any, params?: {});
+    maxRange: number;
+    /** @private */
+    private _maxCount;
+    /** @private */
+    private _tileSize;
+    /** @private */
+    private _range;
+    /** @private */
+    private _queueCollection;
+    /** @private */
+    private _pendingSet;
+    /** @private */
+    private _currentTiles;
+    /** @private */
+    private _maxShowLevel;
+    /** @private */
+    private _api;
+    /** @private */
+    private _height;
+    /** @private */
+    private _lampConfig;
+    /** @private */
+    private _periodUpdate;
+    /** @private */
+    private _autoHide;
+    /** @private */
+    private _debounceTime;
+    /** @private */
+    private _showLight;
+    type: string;
+    afterAddToEngine(engine: any): void;
+    engine: any;
+    onBeforeScenePrepareRender(engine: any, scene: any, camera: any, renderState: any): void;
+    _timeOutId: number | undefined;
+    _updateTiles(engine: any, camera: any, zoom: any): void;
+    _searchLight(engine: any, camera: any): {
+        list: any;
+        visibleList: any;
+    };
+    _updateCurrentTiles(list: any): void;
+    _render(): void;
+    _fetchLight(list: any): void;
+    _renderWithTable(tileKey: any, lampGroup: any, time: any): void;
+    _renderWithStatus(id: any, lampGroup: any): void;
+    _checkIsExpired(key: any, time: any): any;
+    _updateLightVisible(visible: any): void;
+    set visible(visible: boolean);
+    get visible(): boolean;
+}
+export class LampRequest {
+    fetchLamps(params: any): Promise<{}>;
+}
+export class DefaultLampRequest extends LampRequest {
+    constructor(requestConfig?: {});
+    path: string;
+    /** @private */
+    private _requestConfig;
+    fetchLamps(params: any): Promise<any>;
+}

package/dist/types/threejs/objects/element/TileTrafficLight.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 瓦片信号灯，这是同一个方向上的几个灯态组合
+ */
+export class TileLampGroup extends TrafficGroup {
+    constructor(count: any, id: any, options?: {});
+    useTable: boolean;
+    /** @private */
+    private _id;
+    /** @private */
+    private _sizeAttention;
+    /** @private */
+    private _pixelHeight;
+    isTileLampGroup: boolean;
+    _initLight(count: any, options?: {}): void;
+    onBeforeScenePrepareRender(engine: any, scene: any, camera: any, renderState: any): void;
+    updateState(time: any): void;
+    get lightId(): string;
+    set timeTable(timeTable: any);
+    get timeTable(): any;
+    _timeTable: any;
+    raycast(raycaster: any, intersects: any): void;
+}
+/**
+ * 每一个灯是一个TileLamp的实例
+ * 每个灯态都是竖向的3个图标展示：颜色、方向、倒计时
+ *
+ * timeTable: {
+ *     startTime: 1724931141000,
+ *     reuse: true,
+ *     iconOffset: 1,
+ *     table: [
+ *         {
+ *             stats: 1,
+ *             period: 40,
+ *             text: false,
+ *         },
+ *         {
+ *             status: 2,
+ *             period: 20,
+ *             text: false,
+ *         }
+ *     ]
+ * }
+ */
+export class TileLamp {
+    constructor(width: any, height: any, options?: {});
+    isMesh: boolean;
+    isTileLamp: boolean;
+    geometry: any;
+    material: TileTrafficLightMaterial;
+    updateState(time: any): void;
+    set timeTable(timeTable: any);
+    get timeTable(): any;
+    _timeTable: any;
+    raycast(raycaster: any, intersects: any): void;
+}
+import { TrafficGroup } from '../../../addons/traffic/objects/TrafficGroup';
+import { TileTrafficLightMaterial } from '../../materials/element/TileTrafficLightMaterial';

package/dist/types/threejs/objects/element/TrafficLight.d.ts

@@ -0,0 +1,32 @@
+export class TrafficLight {
+    constructor(geometry: any);
+    isMesh: boolean;
+    /** @private */
+    private _slots;
+    /** @private */
+    private _slotCount;
+    /** @private */
+    private _numberSlot;
+    /** @private */
+    private _timeTable;
+    /** @private */
+    private _channelCount;
+    geometry: any;
+    material: TrafficLightMaterial;
+    set number(value: any);
+    get number(): any;
+    set slots(value: any[]);
+    get slots(): any[];
+    get slotCount(): number;
+    get numberSlot(): number;
+    _number: any;
+    set timeTable(value: any);
+    get timeTable(): any;
+    _lightState: any;
+    set lightState(value: any);
+    get lightState(): any;
+    updateState(time: any): void;
+    _active: boolean | undefined;
+    updateMaterial(): void;
+}
+import { TrafficLightMaterial } from '../../materials/element/TrafficLightMaterial';

package/dist/types/threejs/objects/ground/groundObject.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 贴地绘制
+ * ```javascript
+ * const groundObject = new GroundObject({
+ *     type: 'Polygon',
+ *     color: '#ff0000',
+ *     opacity: 0.5,
+ * }, engine);
+ * const dataSource = await mapvthree.GeoJSONDataSource.fromObject('polygon.geojson');
+ * groundObject.dataSource = dataSource;
+ * // 销毁
+ * groundObject.destroy();j
+ * ```
+ */
+export class GroundObject {
+    /**
+     * @param {{color?: string, minHeight?: number, maxHeight?: number, nearScale?: number
+     * type: string, opacity?: number,
+     * }} parameter 参数对象
+     * @param {string} parameter.type 类型, 可选值: Polygon, Line
+     * @param {number} parameter.minHeight 最小高度, 默认 -1000，只贴在minHeight到maxHeight之间的对象
+     * @param {number} parameter.maxHeight 最大高度, 默认 1000，只贴在minHeight到maxHeight之间的对象
+     * @param {number} parameter.nearScale 近平面缩放, 默认 1
+     * @param {string} parameter.color 颜色
+     * @param {number} parameter.opacity 不透明度
+     * @param {*} engine
+     */
+    constructor(parameter: {
+        color?: string;
+        minHeight?: number;
+        maxHeight?: number;
+        nearScale?: number;
+        type: string;
+        opacity?: number;
+    }, engine: any);
+    /** @private */ private _dataSource;
+    engine: any;
+    parameters: {
+        color?: string;
+        minHeight?: number;
+        maxHeight?: number;
+        nearScale?: number;
+        type: string;
+        opacity?: number;
+    };
+    _renderOrder: number;
+    initPolygonObject(): void;
+    frontObject: Polygon | undefined;
+    backObject: Polygon | undefined;
+    renderObject: any;
+    initLineObject(): void;
+    set dataSource(value: any);
+    get dataSource(): any;
+    set renderOrder(value: number);
+    get renderOrder(): number;
+    addEventListener(type: any, callback: any): void;
+    removeEventListener(type: any, callback: any): void;
+    destroy(): void;
+}
+import { Polygon } from '../../objects/polygon/Polygon';

package/dist/types/threejs/objects/heatmap/Heatmap.d.ts

@@ -0,0 +1,148 @@
+/**
+ * 2D热力图，用于在地图上展示数据密度分布。支持自定义颜色渐变、透明度、半径等属性，可以高效渲染大量数据点。
+ * 主要功能：
+ * - 支持自定义颜色渐变配置
+ * - 支持数据权重设置
+ * - 支持保持大小（按像素为单位绘制）
+ * - 支持径向渐变速度调整
+ * @category Objects
+ * @example
+ * ```javascript
+ * const heatmap = engine.add(new mapvthree.Heatmap({
+ *     gradient: {
+ *         0.4: 'blue',
+ *         0.65: 'lime',
+ *         1: 'red'
+ *     },
+ *     radius: 30,
+ *     opacity: 0.8,
+ *     keepSize: true
+ * }));
+ * let data = mapvthree.GeoJSONDataSource.fromGeoJSON(data);
+ * heatmap.dataSource = data;
+ * ```
+ * ![](media://heatmap.png)
+ */
+export class Heatmap extends GeoMesh {
+    /**
+     * 创建热力图实例
+     * @param {Object} parameters 热力图配置参数
+     * @param {Object} [parameters.gradient] 热力渐变颜色配置，格式为{stop: 'color'}，例如{0.4: 'blue', 0.65: 'lime', 1: 'red'}
+     * @param {number} [parameters.opacity=1] 透明度整体系数
+     * @param {number} [parameters.minValue=0] 最小热力值
+     * @param {number} [parameters.maxValue=100] 最大热力值
+     * @param {number} [parameters.radius=30] 热力绘制半径
+     * @param {boolean} [parameters.keepSize=false] 是否保持大小（即按像素为单位绘制）
+     * @param {number} [parameters.attenuateMValueFactor=0] 径向渐变速度
+     */
+    constructor(parameters: {
+        gradient?: Object | undefined;
+        opacity?: number | undefined;
+        minValue?: number | undefined;
+        maxValue?: number | undefined;
+        radius?: number | undefined;
+        keepSize?: boolean | undefined;
+        attenuateMValueFactor?: number | undefined;
+    });
+    /**
+     * 是否为热力图
+     * @readonly
+     */
+    readonly isHeatmap: true;
+    /** @protected 是否进行视锥体剔除 */
+    protected frustumCulled: boolean;
+    /** @protected 几何体 */
+    protected geometry: any;
+    /** @protected 材质 */
+    protected material: any;
+    /** @private 场景 */
+    private scene;
+    /** @private 点网格 */
+    private pointMesh;
+    /** @private 点材质 */
+    private pointMaterial;
+    /** @private 点几何体 */
+    private pointGeometry;
+    /** @private 渲染目标 */
+    private renderTarget;
+    /** @private 深度材质 */
+    private depthMaterial;
+    /** @private 深度渲染目标 */
+    private depthRenderTarget;
+    parameters: {
+        gradient?: Object | undefined;
+        opacity?: number | undefined;
+        minValue?: number | undefined;
+        maxValue?: number | undefined;
+        radius?: number | undefined;
+        keepSize?: boolean | undefined;
+        attenuateMValueFactor?: number | undefined;
+    };
+    /**
+     * 获取默认参数
+     * @internal
+     * @returns {Object} 默认参数对象
+     */
+    getDefaultParams(): Object;
+    /**
+     * 热力渐变颜色配置，格式为{stop: 'color'}，例如{0.4: 'blue', 0.65: 'lime', 1: 'red'}
+     */
+    set gradient(value: any);
+    /**
+     * 设置热力绘制半径
+     * @param {number} value 半径值
+     */
+    set radius(value: number);
+    /**
+     * 获取热力绘制半径
+     * @returns {number} 半径值
+     */
+    get radius(): number;
+    /**
+     * 设置最小热力值
+     * @param {number} value 最小热力值
+     */
+    set minValue(value: number);
+    /**
+     * 获取最小热力值
+     * @returns {number} 最小热力值
+     */
+    get minValue(): number;
+    /**
+     * 设置最大热力值
+     * @param {number} value 最大热力值
+     */
+    set maxValue(value: number);
+    /**
+     * 获取最大热力值
+     * @returns {number} 最大热力值
+     */
+    get maxValue(): number;
+    /**
+     * 设置透明度
+     * @param {number} value 透明度值
+     */
+    set opacity(value: number);
+    /**
+     * 获取透明度
+     * @returns {number} 透明度值
+     */
+    get opacity(): number;
+    /**
+     * 设置是否保持大小（即按像素为单位绘制）
+     * @param {boolean} value 是否保持大小
+     */
+    set keepSize(value: boolean);
+    /**
+     * 获取是否保持大小（即按像素为单位绘制）
+     * @returns {boolean} 是否保持大小
+     */
+    get keepSize(): boolean;
+    /**
+     * 径向渐变速度
+     */
+    set attenuateMValueFactor(value: any);
+    /** @internal */
+    onBeforeSceneRenderHook(engine: any, scene: any, camera: any, renderState: any): void;
+}
+import { GeoMesh } from '../GeoMesh';

package/dist/types/threejs/objects/heatmap/Heatmap3D.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 3D热力图，立体热力图，平面热力图见[[Heatmap]]
+ *
+ * **注意：3D热力图目前只适用于小面积覆盖范围（区、乡镇级别以下），在大面积覆盖场景下（省、市级别以上）会有明显性能问题**
+ * ```js
+ * const heatmap = engine.add(new mapvthree.Heatmap3D());
+ * let data = mapvthree.GeoJSONDataSource.fromGeoJSON(data);
+ * heatmap.dataSource = data;
+ * ```
+ * ![](media://heatmap3d.png)
+ */
+export class Heatmap3D extends GeoMesh {
+    /**
+     * 构造函数
+     * @param {{
+     * gradient?: object, opacity?: number, heightRatio?: number, maxValue?: number, radius?: number
+     * }} parameters 传入参数对象
+     * @param {object} parameters.gradient 热力渐变颜色配置，格式为{stop: 'color'}，例如{0.4: 'blue', 0.65: 'lime', 1: 'red'}
+     * @param {number} parameters.opacity 透明度整体系数，默认1
+     * @param {number} parameters.heightRatio 高度系数，默认100
+     * @param {number} parameters.maxValue 最大热力值，默认1
+     * @param {number} parameters.radius 热力绘制半径，默认100
+     */
+    constructor(parameters: {
+        gradient?: object;
+        opacity?: number;
+        heightRatio?: number;
+        maxValue?: number;
+        radius?: number;
+    });
+    /** @private */ private _gradient;
+    /** @private */ private _radius;
+    /** @private */ private _maxValue;
+    /** @protected */ protected isHeatmap3D: boolean;
+    /** @protected */ protected frustumCulled: boolean;
+    /** @protected */ protected geometry: any;
+    /** @protected */ protected material: any;
+    /** 透明度整体系数 */ opacity: any;
+    /** 高度系数 */ heightRatio: any;
+    parameters: {
+        gradient?: object;
+        opacity?: number;
+        heightRatio?: number;
+        maxValue?: number;
+        radius?: number;
+    };
+    texture: any;
+    set gradient(value: object);
+    /** 热力渐变颜色配置，格式为{stop: 'color'}，例如{0.4: 'blue', 0.65: 'lime', 1: 'red'} */
+    get gradient(): object;
+    set radius(value: number);
+    /** 热力绘制半径 */
+    get radius(): number;
+    set maxValue(value: number);
+    /** 最大热力值 */
+    get maxValue(): number;
+}
+import { GeoMesh } from '../GeoMesh';