@baidumap/mapv-three 1.0.0

package/dist/types/threemap/controls/measure/AreaMeasure.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 面积测量
+ * ```jsx
+ * const tiles = engine.add(new mapvthree.Default3DTiles({
+ *  url: tilesetUrl,
+ * }));
+ * tiles.addEventListener('click', e => {});
+ * tiles.addEventListener('mousemove', e => {});
+ * const measure = engine.add(new mapvthree.AreaMeasure(engine, {
+ *   clampToGround: true,
+ *   editingPolygonParameter: {
+ *      color: 'red',
+ *      opacity: 0.6,
+ *      maxHeight: 2500,
+ *   },
+ *   editedPolygonParameter: {
+ *      color: 'blue',
+ *      opacity: 0.6,
+ *      maxHeight: 2500,
+ *   }
+ * }))
+ * ```
+ */
+export class AreaMeasure extends Measure {
+    /**
+     * @param { Object } options 绘制参数
+     * @param {Object} options.editingPolygonParameter 绘制中的多边形参数，用来配置虚拟多边形的颜色等
+     * @param {Object} options.borderLineParameter 边框参数，用来配置边框的颜色、线宽等
+     * @param {Object} options.editedPolygonParameter 绘制完成后的多边形参数，用来配置多边形的颜色等
+     * @param {boolean} options.clampToGround 绘制时是否贴地
+     * @param {boolean} options.showLabel 是否展示测量信息
+     */
+    constructor(engine: any, options?: {
+        editingPolygonParameter: Object;
+        borderLineParameter: Object;
+        editedPolygonParameter: Object;
+        clampToGround: boolean;
+        showLabel: boolean;
+    });
+    /** @private */ private _area;
+    /** @private */ private _node;
+    /** @private */ private _editor;
+    /** @private */ private _infoMarker;
+    /** @private */ private _infoMarkerDataSource;
+    /** @private 面积的信息标注 */
+    private _infoMarkerData;
+    _engine: any;
+    _options: {
+        editingPolygonParameter: Object;
+        borderLineParameter: Object;
+        editedPolygonParameter: Object;
+        clampToGround: boolean;
+        showLabel: boolean;
+    };
+    _showLabel: any;
+    /** @private */
+    private initEditor;
+    /** @private */
+    private initInfoMarker;
+    /**
+     * 生成信息标注
+     */
+    createInfoMarker(feature: any): HTMLDivElement;
+    /** @private */
+    private _movePolygonNode;
+    /** @private */
+    private _moveRectNode;
+    /** @private */
+    private _moveCircleNode;
+    /** @private */
+    private _adjustNode;
+    /** @private */
+    private setInfoMarker;
+    clearBuffer(): void;
+    /**
+     * 清除绘制元素
+     */
+    clearAll(): void;
+    dispose(): void;
+    /**
+     * 总面积
+     */
+    get area(): number;
+    set showLabel(value: any);
+    get showLabel(): any;
+}
+import { Measure } from './Measure';

package/dist/types/threemap/controls/measure/CurvatureMeasure.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 曲率测量
+ */
+export class CurvatureMeasure extends PointMeasure {
+    createInfoMarkersDom(feature: any): HTMLDivElement;
+}
+import { PointMeasure } from './PointMeasure';

package/dist/types/threemap/controls/measure/LengthMeasure.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 距离量测
+ * ```jsx
+ * const tiles = engine.add(new mapvthree.Default3DTiles({
+ *  url: tilesetUrl,
+ * }));
+ * tiles.addEventListener('click', e => {});
+ * tiles.addEventListener('mousemove', e => {});
+ * const lengthMeasure = engine.add(new mapvthree.LengthMeasure(engine, {
+ *  clampToGround: true,
+ * }));
+ * ```
+ */
+export class LengthMeasure extends Measure {
+    /**
+     * @param { Object } options 绘制参数
+     * @param {string} options.lineColor 线颜色,默认为'rgb(200, 200, 50)'
+     * @param {Object} options.virtualLineParameter 虚拟线参数，用来配置虚拟线的颜色、线宽等
+     * @param {Object} options.lineParameter 线参数，用来配置线的颜色、线宽等
+     * @param {number} options.fixedNum 保留几位小数，默认保留两位小数
+     * @param {boolean} options.clampToGround 绘制时是否贴地
+     * @param {boolean} options.showLabel 是否展示测量信息
+     */
+    constructor(engine: any, options?: {
+        lineColor: string;
+        virtualLineParameter: Object;
+        lineParameter: Object;
+        fixedNum: number;
+        clampToGround: boolean;
+        showLabel: boolean;
+    });
+    /** @private */ private _editor;
+    /** @private */ private _node;
+    /** @private */ private _infoMarker;
+    /** @private */ private _infoMarkerDataSource;
+    /** @private */ private _totalMarker;
+    /** @private */ private _totalMarkerDataSource;
+    /** @private 总长度 */
+    private _length;
+    /** @private 分段距离 */
+    private _segmentLengths;
+    /** @private */ private _indexOffset;
+    /** @private */
+    private _infoMarkerData;
+    _totalMarkerData: any[];
+    _engine: any;
+    _options: {
+        lineColor: string;
+        virtualLineParameter: Object;
+        lineParameter: Object;
+        fixedNum: number;
+        clampToGround: boolean;
+        showLabel: boolean;
+    };
+    _showLabel: any;
+    fixedNum: any;
+    /** @private */
+    private initEditor;
+    /** @private */
+    private initInfoMarker;
+    /**
+     * 生成分段距离的标注
+     * @param {number} feature 分段距离
+     * @returns 分段距离的标注
+     */
+    createInfoMarker: (feature: number) => HTMLDivElement;
+    /**
+     * 生成总长度的信息标注
+     * @param {number} feature 总长度
+     * @returns 总长度的信息标注
+     */
+    createTotalMarker: (feature: number) => HTMLDivElement;
+    clearBuffer(): void;
+    /**
+     * 清除绘制元素
+     */
+    clearAll(): void;
+    dispose(): void;
+    /** @private */
+    private get selectedIndex();
+    /**
+     * 总长度
+     */
+    get length(): number;
+    get segmentLengths(): any[];
+    set showLabel(value: any);
+    get showLabel(): any;
+}
+import { Measure } from './Measure';

package/dist/types/threemap/controls/measure/Measure.d.ts

@@ -0,0 +1,47 @@
+export class Measure {
+    /**
+     * 根据两个坐标点和地球半径计算得到两点之间的距离
+     * @param {numberp[]} startCoordibates 起点坐标
+     * @param {number[]} endCoordinates 终点坐标
+     * @param {string} component 测量分量
+     * @param {number} radius 地球半径
+     * @returns 距离
+     */
+    static getLength(startCoordibates: numberp[], endCoordinates: number[], component: string, radius: number): number;
+    /**
+     * 根据一组坐标数组，得到相邻两点之间的分段距离
+     * @param {number[][]} points 坐标数组
+     * @returns {number[]} 分段距离
+     */
+    static getSegementLength(points: number[][], component: any): number[];
+    /**
+     * 根据一组坐标，计算得到面积
+     * @param {number[][]} coordinates 坐标数组
+     * @param {number} radius 地球半径
+     * @returns 面积
+     */
+    static getArea(coordinates: number[][], radius: number): number;
+    static getSpaceArea(coordinates: any, radius: any): number;
+    /** @protected */ protected _enabled: boolean;
+    /** @protected */ protected _fixedNum: number;
+    /** @protected */ protected _projectionName: string;
+    /** @protected */
+    protected afterAddToEngine(): void;
+    parseFeature: (item: any, type: any) => DataItem;
+    parsePointFeature: (item: any) => DataItem;
+    beforeRemoveFromEngine(): void;
+    /** @protected */
+    protected _addNode: (data: any) => void;
+    /** @protected */
+    protected _moveNode: (data: any) => void;
+    /** @protected */
+    protected _changeNode: (data: any) => void;
+    set fixedNum(value: number);
+    get fixedNum(): number;
+    set enabled(value: boolean);
+    /**
+     * 是否能够进行测量
+     */
+    get enabled(): boolean;
+}
+import { DataItem } from '../../dataSource/DataItem';

package/dist/types/threemap/controls/measure/PointMeasure.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 点测量
+ */
+export class PointMeasure extends Measure {
+    /**
+     * @param { Object } options 绘制点参数
+     * @param {string} options.pointColor 点颜色,默认为'rgb(200, 200, 50)'
+     * @param {string} options.pointSize 点尺寸，默认为10
+     * @param {number} options.fixedNum 保留几位小数
+     * @param {boolean} options.showLabel 是否展示测量信息
+     */
+    constructor(engine: any, options?: {
+        pointColor: string;
+        pointSize: string;
+        fixedNum: number;
+        showLabel: boolean;
+    });
+    /** @priuvate */ _editor: null;
+    /** @private */
+    private _infoMarkerData;
+    _engine: any;
+    _options: {
+        pointColor: string;
+        pointSize: string;
+        fixedNum: number;
+        showLabel: boolean;
+    };
+    _showLabel: any;
+    fixedNum: any;
+    /** @private */
+    private initEditor;
+    /**
+     * @private
+     * 测量信息展示，默认DomPoint，可以自定义
+     */
+    private initInfoMarker;
+    _infoMarker: DomPoints | undefined;
+    _infoMarkerDataSource: JSONDataSource | undefined;
+    createInfoMarkerDom(feature: any): HTMLDivElement;
+    createInfoMarker: () => DomPoints;
+    _node: any;
+    clearBuffer(): void;
+    /**
+     * 清除绘制元素
+     */
+    clearAll(): void;
+    /** @private */
+    private dispose;
+    set showLabel(value: any);
+    get showLabel(): any;
+}
+import { Measure } from './Measure';
+import { DomPoints } from '../../../threejs/objects/point/DomPoint';
+import { JSONDataSource } from '../../dataSource/JSONDataSource';

package/dist/types/threemap/controls/measure/SlopeMeasure.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 坡度测量
+ */
+export class SlopeMeasure extends Measure {
+    /**
+     * @param { Object } options 绘制点参数
+     * @param {string} options.pointColor 点颜色,默认为'rgb(200, 200, 50)'
+     * @param {string} options.pointSize 点尺寸，默认为10
+     * @param {number} options.fixedNum 保留几位小数
+     * @param {string} options.url 路线查询服务
+     */
+    constructor(engine: any, options?: {
+        pointColor: string;
+        pointSize: string;
+        fixedNum: number;
+        url: string;
+    });
+    /** @private */ private _editor;
+    /** @private */ private _node;
+    /** @private */ private _slopeFeatures;
+    /** @private */
+    private _infoMarkersBuffer;
+    _engine: any;
+    _options: {
+        pointColor: string;
+        pointSize: string;
+        fixedNum: number;
+        url: string;
+    };
+    /** @private */
+    private initEditor;
+    initSlopeLine(): any;
+    _slopeLine: any;
+    initInfoMarkers(): void;
+    _infoMarker: DomPoints | undefined;
+    _infoMarkerDataSource: DeprecatedDataSource | undefined;
+    createInfoMarkersDom(feature: any): HTMLDivElement;
+    createInfoMarkers: () => DomPoints;
+    clearBuffer(): void;
+    /**
+     * 清除绘制元素
+     */
+    clearAll(): void;
+    clearResult(): void;
+    dispose(): void;
+}
+import { Measure } from './Measure';
+import { DomPoints } from '../../../threejs/objects/point/DomPoint';
+import { DeprecatedDataSource } from '../../dataSource/DeprecatedDataSource';

package/dist/types/threemap/core/Intersect.d.ts

@@ -0,0 +1,24 @@
+declare const _default: Readonly<{
+    /**
+     * Represents that an object is not contained within the frustum.
+     *
+     * @type {number}
+     * @constant
+     */
+    OUTSIDE: number;
+    /**
+     * Represents that an object intersects one of the frustum's planes.
+     *
+     * @type {number}
+     * @constant
+     */
+    INTERSECTING: number;
+    /**
+     * Represents that an object is fully within the frustum.
+     *
+     * @type {number}
+     * @constant
+     */
+    INSIDE: number;
+}>;
+export default _default;

package/dist/types/threemap/dataSource/BufferDataSource_broken.d.ts

@@ -0,0 +1,29 @@
+export class DeprecatedDataSourceBroken {
+    /** @private */
+    private _expandStepSize;
+    /** @private */
+    private _attributesMap;
+    /** @private */
+    private _attributes;
+    /** @private */
+    private _idIndexMap;
+    /** @private */
+    private _indexIdMap;
+    /** @private */
+    private _instanceMatrixArray;
+    /** @private */
+    private _instanceMatrixArraySize;
+    /** @private */
+    private _currentCount;
+    addAttribute(name: any, itemSize?: number, Type?: Float32ArrayConstructor): void;
+    addAttributes(attributes: any): void;
+    expandInstanceArray: (count: any) => void;
+    /**
+     * 添加数据
+     * @param {*} bufferData
+     */
+    add(bufferData: any): void;
+    _rtc: any;
+    copyArrayData: (target: any, targetOffset: any, source: any, sourceOffset: any, length: any) => void;
+    remove(bufferData: any): void;
+}

package/dist/types/threemap/dataSource/CSVDataSource.d.ts

@@ -0,0 +1,80 @@
+/**
+ * CSV格式数据的数据源，支持加载标准CSV文件或通过URL加载远程数据
+ *
+ * CSVDataSource继承自{@link JSONDataSource}，专门用于处理CSV格式的数据。
+ * CSV数据会被解析为JSON对象数组，每行CSV数据对应一个对象，列名作为对象属性名。
+ *
+ * 支持两种方式创建数据源：
+ * - 从CSV字符串创建
+ * - 从URL异步加载
+ *
+ * @category DataSource
+ * @example
+ * ```javascript
+ * // 示例1: 从CSV字符串创建
+ * const csvString = `lat,lng,name,value
+ * 39.9,116.39,北京,100
+ * 31.23,121.47,上海,90
+ * 23.13,113.26,广州,80`;
+ * const dataSource = CSVDataSource.fromCSVString(csvString);
+ *
+ * // 示例2: 从URL加载
+ * const dataSource = await CSVDataSource.fromURL('path/to/data.csv');
+ * ```
+ */
+export class CSVDataSource extends JSONDataSource {
+    /**
+     * 从URL异步加载CSV数据
+     * @param {string} url 数据的URL路径
+     * @param {object} [options] 配置选项，传递给{@link JSONDataSource}构造函数
+     * @returns {Promise<CSVDataSource>} 包含数据源实例的Promise
+     * @example
+     * ```javascript
+     * const dataSource = await CSVDataSource.fromURL('path/to/data.csv');
+     * console.log(`加载了${dataSource.size}个数据项`);
+     * ```
+     */
+    static fromURL: (url: string, options?: object) => Promise<CSVDataSource>;
+    /**
+     * @internal
+     * @deprecated 已废弃，请使用{@link CSVDataSource.fromURL}
+     * @param {string} url 数据的URL路径
+     * @param {object} [options] 配置选项
+     * @returns {Promise<CSVDataSource>} 数据源实例
+     */
+    static fromUrl: (url: string, options?: object) => Promise<CSVDataSource>;
+    /**
+     * 从CSV字符串创建数据源实例
+     * @param {string} csvString CSV格式的字符串
+     * @param {object} [options] 配置选项，传递给{@link JSONDataSource}构造函数
+     * @returns {CSVDataSource} 新创建的数据源实例
+     * @example
+     * ```javascript
+     * const csvString = `lat,lng,name,value
+     * 39.9,116.39,北京,100
+     * 31.23,121.47,上海,90`;
+     * const dataSource = CSVDataSource.fromCSVString(csvString);
+     * ```
+     */
+    static fromCSVString: (csvString: string, options?: object) => CSVDataSource;
+    /**
+     * 创建CSVDataSource实例
+     * @param {object} [options] 配置选项，传递给{@link JSONDataSource}构造函数
+     */
+    constructor(options?: object);
+    /**
+     * 将响应流转换为文本
+     * @internal
+     * @param {Response} rs 请求响应对象
+     * @returns {Promise<string>} 解析后的文本内容
+     */
+    _convertStreamingDataToObjectData(rs: Response): Promise<string>;
+    /**
+     * 将CSV字符串转换为JSON对象数组
+     * @internal
+     * @param {string} dataString CSV格式字符串
+     * @returns {Array<object>} 解析后的JSON对象数组
+     */
+    _convertObjectDataToJSONData(dataString: string): Array<object>;
+}
+import { JSONDataSource } from './JSONDataSource';

package/dist/types/threemap/dataSource/DataItem.d.ts

@@ -0,0 +1,209 @@
+/**
+ * 数据元素类，表示单个可渲染的数据项
+ *
+ * DataItem是数据源中的基本单元，用于存储和管理单个地理要素的数据。
+ * 它支持多种几何类型（点、线、面）及其multi-*变体，并能处理不同投影之间的坐标转换。
+ *
+ * 每个DataItem包含：
+ * - 几何数据：坐标信息
+ * - 属性数据：与几何关联的业务数据
+ * - 投影信息：坐标的参考系统
+ *
+ * @category DataSource
+ * @example
+ * ```javascript
+ * // 创建一个点要素
+ * const point = new DataItem({
+ *   type: 'Feature',
+ *   geometry: {
+ *     type: 'Point',
+ *     coordinates: [116.39, 39.9]
+ *   },
+ *   properties: {
+ *     name: '北京',
+ *     value: 100
+ *   }
+ * });
+ *
+ * // 创建一个线要素
+ * const line = new DataItem({
+ *   type: 'Feature',
+ *   geometry: {
+ *     type: 'LineString',
+ *     coordinates: [
+ *       [116.39, 39.9],
+ *       [121.47, 31.23]
+ *     ]
+ *   },
+ *   properties: {
+ *     name: '北京-上海',
+ *     value: 500
+ *   }
+ * });
+ * ```
+ */
+export class DataItem {
+    /**
+     * 创建数据元素实例
+     * @param {Object|Array<number>|Vector3} feature 几何信息
+     *   - Object: GeoJSON格式的Feature数据
+     *   - Array<number>: 点坐标数组，如[lng, lat]或[lng, lat, alt]
+     *   - Vector3: Three.js的三维向量
+     * @param {object} [extraAttributes={}] 附加属性对象
+     *   - 特殊属性'id'：用于标识数据元素
+     *   - 特殊属性'crs'：源投影信息
+     * @param {boolean} [forceProjected=false] 是否强制视为已投影坐标
+     * @example
+     * ```javascript
+     * // 从GeoJSON特征创建
+     * const item = new DataItem({
+     *   type: 'Feature',
+     *   geometry: {
+     *     type: 'Point',
+     *     coordinates: [116.39, 39.9]
+     *   },
+     *   properties: { name: '北京' }
+     * });
+     *
+     * // 从坐标数组创建点
+     * const point = new DataItem([116.39, 39.9]);
+     *
+     * // 从Three.js向量创建
+     * const vector = new THREE.Vector3(116.39, 39.9, 0);
+     * const vectorPoint = new DataItem(vector);
+     * ```
+     */
+    constructor(feature: Object | Array<number> | Vector3, extraAttributes?: object, forceProjected?: boolean);
+    /** @private 原始坐标 */
+    private _originalCoordinates;
+    /** @private 属性数据 */
+    private _attributes;
+    /** @private 要素ID */
+    private _id;
+    /** @private 源投影名称 */
+    private _sourceProjectionName;
+    /** @private 经纬度坐标 */
+    private _coordinates;
+    /** @private 不同投影下的坐标缓存 */
+    private _projectedCoordinates;
+    /** @private 几何类型 */
+    private _type;
+    /** @private 是否为多要素类型 */
+    private _isMulti;
+    /** @private 多要素时的要素数量 */
+    private _size;
+    /** @private 数据是否有效 */
+    private _isValid;
+    /**
+     * 获取指定投影下的坐标
+     * @param {object} projection 投影对象
+     * @param {number} [index=0] 多要素时的索引
+     * @returns {Array} 投影后的坐标
+     * @example
+     * ```javascript
+     * // 获取Web墨卡托投影下的坐标
+     * const projection = getProjection('EPSG:3857');
+     * const coords = dataItem.getProjectedCoordinates(projection);
+     *
+     * // 对于MultiLineString，获取第2条线的坐标
+     * const lineCoords = dataItem.getProjectedCoordinates(projection, 1);
+     * ```
+     */
+    getProjectedCoordinates(projection: object, index?: number): any[];
+    /**
+     * 将数据转换为GeoJSON格式
+     * @returns {object} GeoJSON Feature对象
+     * @example
+     * ```javascript
+     * const geojson = dataItem.toGeoJSON();
+     * console.log(geojson.geometry.type); // 'Point'等
+     * console.log(geojson.properties); // 属性对象
+     * ```
+     */
+    toGeoJSON(): object;
+    /**
+     * 设置数据项的坐标
+     * @param {Array} coordinates 新的坐标数组
+     * @param {object} [projection] 坐标所属的投影
+     * @example
+     * ```javascript
+     * // 更新点的位置
+     * dataItem.setCoordinates([118.28, 40.22]);
+     *
+     * // 设置已投影的坐标
+     * const projection = getProjection('EPSG:3857');
+     * dataItem.setCoordinates([12620000, 4830000], projection);
+     * ```
+     */
+    setCoordinates(coordinates: any[], projection?: object): void;
+    /**
+     * 设置数据项的单个属性
+     * @param {string} key 属性名
+     * @param {*} value 属性值
+     * @example
+     * ```javascript
+     * dataItem.setAttribute('name', '北京');
+     * dataItem.setAttribute('value', 100);
+     * ```
+     */
+    setAttribute(key: string, value: any): void;
+    /**
+     * 设置数据项的多个属性
+     * @param {object} attributes 属性对象
+     * @example
+     * ```javascript
+     * dataItem.setAttributes({
+     *   name: '北京',
+     *   value: 100,
+     *   color: [255, 0, 0]
+     * });
+     * ```
+     */
+    setAttributes(attributes: object): void;
+    /**
+     * 获取数据项的所有属性
+     * @type {object}
+     */
+    get attributes(): object;
+    /**
+     * 设置数据项的ID，只能设置一次
+     * @param {string|number} value 新的ID值
+     */
+    set id(value: string | number);
+    /**
+     * 获取数据项的ID
+     * @type {string|number}
+     */
+    get id(): string | number;
+    /**
+     * 获取数据项的经纬度坐标
+     * @type {Array}
+     */
+    get coordinates(): any[];
+    /**
+     * 获取数据项的源投影名称
+     * @type {string}
+     */
+    get sourceProjectionName(): string;
+    /**
+     * 获取数据项的几何类型
+     * @type {number}
+     * @see {@link GEOMETRY_TYPE_POINT}, {@link GEOMETRY_TYPE_LINE}, {@link GEOMETRY_TYPE_POLYGON}
+     */
+    get type(): number;
+    /**
+     * 是否为多要素类型（MultiPoint, MultiLineString, MultiPolygon）
+     * @type {boolean}
+     */
+    get isMulti(): boolean;
+    /**
+     * 多要素时的要素数量，单要素时为1
+     * @type {number}
+     */
+    get size(): number;
+    /**
+     * 数据项是否有效
+     * @type {boolean}
+     */
+    get isValid(): boolean;
+}