@baidumap/mapv-three 1.0.0

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

@@ -0,0 +1,188 @@
+/**
+ * 引擎核心入口，用来初始化渲染引擎。
+ * 内部核心系统包括：
+ * - {@link EngineMap} 地图系统
+ * - {@link EngineRendering} 渲染系统
+ * - {@link EngineEvent} 事件系统
+ * - {@link EngineWidgets} UI控件系统
+ * - {@link EngineSelection} 选择器系统
+ *
+ * @category Core
+ * @example
+ * ```javascript
+ * const engine = new Engine(container, options);
+ * ```
+ */
+export class Engine {
+    /**
+     *
+     * @param {HTMLElement} container 容器对象
+     * @param {object} options 配置选项
+     * @param {object} options.rendering 渲染选项，传入{@link EngineRendering.constructor}的参数
+     * @param {object} options.map 地图选项，传入 {@link EngineMap.constructor}的参数
+     * @param {object} options.event 事件选项，传入{@link EngineEvent.constructor}的参数
+     * @param {object} options.selection 选择器选项，传入{@link EngineSelection.constructor}的参数
+     * @param {object} options.widgets 控件选项，传入{@link EngineWidgets.constructor}的参数
+     */
+    constructor(container: HTMLElement, options?: {
+        rendering: object;
+        map: object;
+        event: object;
+        selection: object;
+        widgets: object;
+    });
+    /** @internal */ _container: HTMLElement;
+    /** @internal */ _event: EngineEvent;
+    /** @internal */ _map: EngineMap;
+    /** @internal */ _rendering: EngineRendering;
+    /** @internal */ _selection: EngineSelection;
+    /** @internal */ _widgets: EngineWidgets;
+    isEngine: boolean;
+    /**
+     * 将object放到渲染场景中
+     * @param {Object3D} object threejs或者mapvthree的object对象
+     * @returns {Object3D} 返回添加的object对象
+     * @example
+     * ```javascript
+     * const object = new THREE.Mesh();
+     * engine.add(object);
+     * ```
+     * @example
+     * ```javascript
+     * engine.add(new mapvthree.SimplePoint());
+     * ```
+     */
+    add(object: Object3D): Object3D;
+    /**
+     * 将object从渲染场景中移除
+     * @param {Object3D} object threejs或者mapvthree的object对象
+     */
+    remove(object: Object3D): void;
+    /**
+     * 请求一次引擎渲染，此方法会让引擎在下一帧进行一次渲染
+     */
+    requestRender(): void;
+    /**
+     * 添加callback函数到函数列表中，每次渲染更新之前执行。
+     * 此函数的调用时机发生在渲染循环的开始阶段，所有真实渲染操作均还未执行，物体的所有属性均和通过API设置的一致。
+     * @param {Function} callback
+     * @example
+     * ```javascript
+     * engine.addPrepareRenderListener(() => {
+     *     console.log('prepare render');
+     * });
+     * ```
+     */
+    addPrepareRenderListener(callback: Function): void;
+    /**
+     * 添加callback函数到函数列表中，每次渲染前时执行。
+     * 此时引擎已经将内部的状态更新到最新状态，所有物体的属性均和渲染一致。比如，自动相机偏移已经完成，物体的transform可能已经变为相对于偏移后的相机的transform。
+     * @param {Function} callback
+     * @example
+     * ```javascript
+     * engine.addBeforeRenderListener(() => {
+     *    console.log('before render');
+     * });
+     * ```
+     */
+    addBeforeRenderListener(callback: Function): void;
+    /**
+     * 从函数列表中移除callback函数，在渲染更新时不再执行
+     * @param {Function} callback
+     */
+    removeBeforeRenderListener(callback: Function): void;
+    /**
+     * 从函数列表中移除callback函数，在渲染更新之前不再执行
+     */
+    removePrepareRenderListener(callback: any): void;
+    /**
+     * 如果对象上有onBeforeScenePrepareRender，记录object对象，每次渲染更新之前执行object上的onBeforeScenePrepareRender函数
+     * @param {Object3D} object
+     * @private 暂时不对外开放
+     */
+    private addBeforePrepareRenderObject;
+    /**
+     * 从记录对象的列表中移除object
+     * @param {Object3D} object
+     * @private 暂时不对外开放
+     */
+    private removeBeforePrepareRenderObject;
+    /**
+     * 如果对象上有onBeforeSceneRender，记录object对象，每次渲染更新之前执行object上的onBeforeSceneRender函数
+     * @param {Object3D} object
+     * @private 暂时不对外开放，后续会移除
+     */
+    private addBeforeRenderObject;
+    /**
+     * 从记录对象的列表中移除object
+     * @param {Object3D} object
+     * @private 暂时不对外开放，后续会移除
+     */
+    private removeBeforeRenderObject;
+    /**
+     * 锁定相机视野
+     * @private
+     * // TODO: 暂时不对外开放，考虑移到engine.map中
+     */
+    private lockCamera;
+    /**
+     * 解锁相机视野
+     *  @private
+     * // TODO: 暂时不对外开放，考虑移到engine.map中
+     */
+    private unlockCamera;
+    /**
+     * 容器对象
+     * @type {HTMLElement}
+     */
+    get container(): HTMLElement;
+    /**
+     * map对象
+     */
+    get map(): EngineMap;
+    /**
+     * rendering对象
+     */
+    get rendering(): EngineRendering;
+    /**
+     * UI控件对象
+     */
+    get widgets(): EngineWidgets;
+    /**
+     * renderer对象，实际为rendering.renderer的代理对象，此处仅为方便使用
+     * @type {WebGLRenderer}
+     */
+    get renderer(): WebGLRenderer;
+    /**
+     * 场景对象，实际为rendering.scene的代理对象，此处仅为方便使用
+     * @type {Scene}
+     */
+    get scene(): Scene;
+    /**
+     * 相机对象，实际为rendering.camera的代理对象，此处仅为方便使用
+     * @type {Camera}
+     */
+    get camera(): Camera;
+    /**
+     * 事件对象
+     */
+    get event(): EngineEvent;
+    /**
+     * 物体选择器
+     */
+    get selection(): EngineSelection;
+    /**
+     * 释放全部资源，之后引擎实例不再可用
+    */
+    dispose(): void;
+    /**
+     * open版jsapi埋点数据统计
+     * @private
+    */
+    private trackingRequest;
+}
+import { EngineEvent } from './engine/Event';
+import { EngineMap } from './engine/Map';
+import { EngineRendering } from './engine/Rendering';
+import { EngineSelection } from './engine/Selection';
+import { EngineWidgets } from './engine/Widgets';

package/dist/types/threemap/animations/FlyManager.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ```javascript
+ * const flyManager = engine.add(new FlyManager())
+ * flyManager.flyTo({
+ *  zoom: 20,
+ *  center: center,
+ *  pitch: 0,
+ *  heading: 0
+ * }, {
+ *  duration: 3000,
+ * })
+ * ```
+ */
+export class FlyManager {
+    /** @private */ private _engine;
+    /** @private */ private _isRunning;
+    /** @private */ private _animationStartTime;
+    /** @private */ private _animationDuration;
+    /** @private */ private _animationStartState;
+    /** @private */ private _animationFinishState;
+    /**
+     * @protected
+     */
+    protected afterAddToEngine(engine: any): void;
+    /**
+     * @protected
+     */
+    protected update: (engine: any, renderState: any) => void;
+    _complete: any;
+    /**
+     * @internal
+     */
+    restrictHeading: (start: any, end: any) => any;
+    /**
+     * 视角按照animationParams中规定的动画参数切换至params指定的区域
+     * @param {object} params 视角切换的目标参数,格式例如{zoom: 14,center: [100, 20]}
+     * @param {Array} params.center 视角目标中心位置，格式为[lng, lat]
+     * @param {number?} params.zoom 视角目标缩放级别,在2D模式下使用
+     * @param {number?} params.range 视角目标距离,在3D模式下使用
+     * @param {number?} params.pitch 视角目标俯仰角
+     * @param {number?} params.heading 视角目标方位角
+     * @param {object} animationParams 视角切换的动画参数,格式例如{duration: 100}
+     * @param {number?} animationParams.duration 动画持续时间,单位为毫秒,默认为300
+     */
+    flyTo(params: {
+        center: any[];
+        zoom: number | null;
+        range: number | null;
+        pitch: number | null;
+        heading: number | null;
+    }, animationParams?: {
+        duration: number | null;
+    }): void;
+    beforeRemoveFromEngine(): void;
+}

package/dist/types/threemap/animations/ObjectTracker.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 对象跟踪
+ * 用于追踪指定物体，跟随对象调整视野
+ * ```javascript
+ * const objectTracker = engine.add(new ObjectTracker())
+ * objectTracker.track(car, {
+ *  radius: 50,
+ *  pitch: 40,
+ *  heading: 0
+ * })
+ * ```
+ */
+export class ObjectTracker {
+    static computeTransformedBoundingBox(box: any, transform: any): any;
+    /** @private */ private _trackObject;
+    /** @private */ private _trackStatus;
+    /** @private */ private _trackConfig;
+    /** @private */ private _trackParams;
+    /** @private */ private _lastTrackParams;
+    /**
+     * 追踪物体
+     * @param {*} object 物体
+     * @param {*} config 追踪配置
+     * @param {number?} config.radius 和对象的距离
+     * @param {number?} config.heading 视野偏航角
+     * @param {number?} config.pitch 视野俯仰角
+     * @param {boolean?} config.lock 锁定视角,默认为true
+     * @param {number?} config.height 相机高度
+     */
+    track(object: any, config: any): void;
+    /**
+     * 停止追踪
+     */
+    stop(): void;
+    /** @protected */
+    protected afterAddToEngine(engine: any): void;
+    _engine: any;
+    /** @protected */
+    protected onBeforeScenePrepareRender(engine: any, scene: any, camera: any, renderState: any): void;
+    onTrackFrame(lastTrackParams: any, trackParams: any): void;
+    /**
+     * 获取目标相机
+     * @param {Object} viewer 视图实例
+     * @param {any} target 可以是 Vector3或者[x,y,z]或者是几何体Mesh,Polygon,Line,Point等
+     * @param {Object} view 目标视线
+     * @param {Number} [view.yaw=0] 平视角
+     * @param {Number} [view.pitch=-0.5*PI] 俯仰角
+     * @param {Number} [view.radius=0] 和目标物之间的距离
+     * @returns {Object} 相机
+     */
+    getCameraByTargetAndView(engine: any, target: any, view?: {
+        yaw?: number | undefined;
+        pitch?: number | undefined;
+        radius?: number | undefined;
+    }): Object;
+}

package/dist/types/threemap/animations/PathTracker.d.ts

@@ -0,0 +1,136 @@
+export class PathTracker {
+    /** @private */ private _isRunning;
+    /** @private */ private _animationStartTime;
+    /** @private */ private _animationDuration;
+    /** @private */ private _animationTransform;
+    /** @private */ private _animationCurrenState;
+    /** @private */ private _engine;
+    /** @private */ private _track;
+    /** @private */ private _frameInfo;
+    /** @private */ private _sampledPath;
+    /** @private */ private _isPause;
+    /** @private */ private _pauseTime;
+    /** @private */ private _pauseTimestamp;
+    /** @private */ private _object;
+    /** @private */ private _interpolateDirectThreshold;
+    /** @private */ private _interpolateDirectThresholdPercent;
+    /** @private */ private _lockView;
+    /** @private */ private _viewFollow;
+    /** @private */ private _viewMode;
+    /** @private */ private _arcInfo;
+    /** @private */ private _pointHandle;
+    /** @protected */
+    protected afterAddToEngine(engine: any): void;
+    beforeRemoveFromEngine(): void;
+    _update: () => void;
+    /**
+     * @internal
+     * 控制地图视野移动
+     */
+    _updateCamera(camera: any, center: any, zoom: any, zoomUnits: any, heading: any, pitch: any): void;
+    _computeCameraMatrixGlobe(camera: any, center: any, zoom: any, zoomUnits: any, heading: any, pitch: any): void;
+    /**
+     * @internal
+     * 不用map的方法，直接修改相机，避免出现卡顿问题
+     */
+    _computeCameraMatrixBlankMap(camera: any, center: any, zoom: any, zoomUnits: any, heading: any, pitch: any): void;
+    /**
+     * @internal
+     * 3DControl的lookAt方法是直接操作相机
+     */
+    _computeCameraMatrixBlankMap3D(camera: any, center: any, zoom: any, zoomUnits: any, heading: any, pitch: any): void;
+    _updatePositionAndDirection(last: any, current: any, percent: any, isTrans: any, transPercent: any): {
+        point: any[];
+        direction: any;
+    };
+    _updatePitch(last: any, current: any, percent: any): number;
+    /**
+     * @internal
+     */
+    _interpolatePath(ratio: any): {
+        percent: any;
+        point: any[];
+        position: any;
+        distance: number;
+        direction: any;
+        pitch: number;
+        path: any;
+    };
+    /**
+     * @internal
+     */
+    _createSampledPath(path: any): {
+        percent: string;
+        point: any;
+        position: any;
+        distance: number;
+        direction: any;
+        pitch: number;
+    }[] | undefined;
+    /**
+     * @internal
+     * 计算v0到v1的地图倾斜角度
+     * @param {Array} v0 起点
+     * @param {Array} v1 终点
+     */
+    _getRadians(v0: any[], v1: any[]): number;
+    startByRouteServe(start: any, end: any, options?: {}): void;
+    /**
+     * 设置视野跟随的坐标
+     * @param {Array | GeoJSON} target 坐标数组或geojson对象
+     */
+    set track(target: any[] | GeoJSON);
+    get track(): any[] | GeoJSON;
+    set viewMode(value: string);
+    get viewMode(): string;
+    set pointHandle(value: any);
+    updateViewConfig(viewConfig: any): void;
+    /**
+     * 开始漫游动画，可设置动画时长、视野距离、视野偏移
+     * @param {{duration?: number, heading?: number, pitch?: number, distance?: number}} options 动画参数
+     */
+    start(options?: {
+        duration?: number;
+        heading?: number;
+        pitch?: number;
+        distance?: number;
+    }): void;
+    /**
+     * 暂停漫游动画
+     * @param {*} unlock 是否解锁视野
+     * @returns 当前视角参数
+     */
+    pause(unlock: any): null;
+    /**
+     * 停止漫游动画
+     */
+    stop(): void;
+    replay(): void;
+    /**
+     * 设置拐弯处的开始差值的距离
+     * @param {number} value 距离单位米
+     */
+    set interpolateDirectThreshold(value: number);
+    get interpolateDirectThreshold(): number;
+    /**
+     * 设置拐弯处的开始差值的距离百分比
+     * @param {number} value 百分比 0 < value < 0.5
+     */
+    set interpolateDirectThresholdPercent(value: number);
+    get interpolateDirectThresholdPercent(): number;
+    /**
+     * 锁定视角
+     * @param {boolean} value 是否锁定
+     */
+    set lockView(value: boolean);
+    get lockView(): boolean;
+    set viewFollow(value: boolean);
+    get viewFollow(): boolean;
+    /**
+     * 设置跟踪的object物体，如果参数为模型则需遵循以下要求：模型的前进方向为X正半轴，且按+Y UP导出
+     * @param {Object3D} value 传入threejs的Object对象
+     */
+    set object(value: Object3D);
+    get object(): Object3D;
+    curvePath: any;
+}

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

@@ -0,0 +1,65 @@
+/**
+ * 4326坐标系
+ */
+export const PROJECTION_GEO: "EPSG:4326";
+/**
+ * 3857坐标系
+ */
+export const PROJECTION_WEB_MERCATOR: "EPSG:3857";
+/**
+ * 4978坐标系，也称为ECEF坐标系
+ */
+export const PROJECTION_ECEF: "EPSG:4978";
+/**
+ * 百度墨卡托坐标系
+ */
+export const PROJECTION_BD_MERCATOR: "BD:MERCATOR";
+/**
+ * UTM坐标系
+ */
+export const PROJECTION_UTM: "UTM";
+/**
+ * 等地球坐标系
+ */
+export const PROJECTION_EQUAL_EARTH: "EPSG:8857";
+/**
+ * 屏幕像素坐标系
+ */
+export const PROJECTION_SCREEN_PIXEL: "SCREEN_PIXEL";
+/**
+ * 点几何类型
+ */
+export const GEOMETRY_TYPE_POINT: 1;
+/**
+ * 线几何类型
+ */
+export const GEOMETRY_TYPE_LINE: 2;
+/**
+ * 面几何类型
+ */
+export const GEOMETRY_TYPE_POLYGON: 3;
+/**
+ * 渲染阶段：准备阶段
+ * @internal
+ */
+export const RENDER_STAGE_PREPARE: 0;
+/**
+ * 渲染阶段：渲染场景内物体阶段
+ * @internal
+ */
+export const RENDER_STAGE_SCENE: 10;
+/**
+ * 渲染阶段：Bloom处理阶段
+ * @internal
+ */
+export const RENDER_STAGE_BLOOM: 11;
+/**
+ * 渲染阶段：渲染额外功能阶段
+ * @internal
+ */
+export const RENDER_STAGE_FEATURES: 20;
+/**
+ * 渲染阶段：后处理阶段
+ * @internal
+ */
+export const RENDER_STAGE_POSTPROCESSING: 30;

package/dist/types/threemap/controls/PointerLockControls.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 第一人称视角控制控件
+ * 使用方法：激活控件后，通过键盘进行移动，可以开启lock进行视野旋转
+ * - W：向前移动
+ * - A：向左移动
+ * - S：向后移动
+ * - D：向右移动
+ * - L：旋转视野
+ *
+ * ```js
+ * const control = new mapvthree.PointerLockControl(engine);
+ * // 开启鼠标控制
+ * control.enableKeyboardEvent = true;
+ * // 设置移动距离
+ * control.forwardStepSize = 10;
+ * control.rightStepSize = 20;
+ * ```
+ */
+export class PointerLockControl extends PointerLockControls {
+    constructor(engine: any);
+    /** @private */ private _enableKeyboardEvent;
+    /** @private */ private _moveForward;
+    /** @private */ private _moveBackward;
+    /** @private */ private _moveLeft;
+    /** @private */ private _moveRight;
+    /** @private */ private _moveTop;
+    /** @private */ private _moveBottom;
+    /** @private */ private _prevTime;
+    /** @private */ private _velocity;
+    /** @private */ private _direction;
+    _engine: any;
+    set stepSize(value: any);
+    set enableKeyboardEvent(value: any);
+    /**
+     * @private
+     */
+    private handleKeyDownEvent;
+    animationMove: () => void;
+    /**
+     * @private
+     */
+    private handleKeyUpEvent;
+    set forwardStepSize(value: any);
+    /** 前后方向步进 */
+    get forwardStepSize(): any;
+    _forwardStepSize: any;
+    set rightStepSize(value: any);
+    /** 左右方向步进 */
+    get rightStepSize(): any;
+    _rightStepSize: any;
+    set topStepSize(value: any);
+    /** 上下方向步进 */
+    get topStepSize(): any;
+    _topStepSize: any;
+}
+import { PointerLockControls } from '../../threejs/controls/PointerLockControls';

package/dist/types/threemap/controls/TransformControl.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 三维模型编辑控件
+ *
+ * 使用方法：激活控件后，通过键盘切换编辑功能，通过鼠标拖动控件编辑模型
+ * - Q：切换参考系，包含 自身参考系（默认）、世界参考系
+ * - W：切换编辑模式为 平移模式
+ * - E：切换编辑模式为 旋转模式
+ * - R：切换编辑模式为 缩放模式
+ * - +：编辑器控件大小 增加
+ * - -：编辑器控件大小 缩小
+ * - X：控件显示/隐藏 X轴
+ * - Y：控件显示/隐藏 Y轴
+ * - Z：控件显示/隐藏 Z轴
+ * - Space：开启/关闭 编辑状态
+ * - Esc：撤销此次编辑
+ *
+ * ```js
+ * const control = new mapvthree.TransformControl(engine);
+ * engine.add(control);
+ * // 使用attach绑定到三维模型上以激活控件
+ * control.attach(mesh);
+ * ```
+ * ![](media://transform_control.png)
+ */
+export class TransformControl extends TransformControls {
+    /**
+     * 构造函数
+     * @param {Engine} engine 引擎实例化对象
+     */
+    constructor(engine: Engine);
+    /** @private */ private _enableKeyboardEvent;
+    engine: Engine;
+    set enableKeyboardEvent(value: any);
+    handleKeyboardEvent: (event: any) => void;
+    showX: any;
+    showY: any;
+    showZ: any;
+    enabled: any;
+}
+import { TransformControls } from '../../threejs/controls/TransformControls';

package/dist/types/threemap/controls/editors/CircleEditor.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 圆形编辑器
+ */
+export class CircleEditor extends Editor {
+    /**
+     * @param { Object } options 绘制参数
+     * @param {string} options.circleColor 圆形颜色,默认为'rgb(200, 200, 50)'
+     * @param {Object} options.editingPolygonParameter 绘制中的圆的参数，用来配置虚拟圆的颜色等
+     * @param {Object} options.editedPolygonParameter 绘制完成后的圆参数，用来配置圆的颜色等
+     */
+    constructor(engine: any, options?: {
+        circleColor: string;
+        editingPolygonParameter: Object;
+        editedPolygonParameter: Object;
+    });
+    /** @private */
+    private _circleData;
+    /** @private */
+    private _virtualLineData;
+    /** @private */
+    private _helpersData;
+    /**
+     * @protected
+     * 是否允许编辑
+     */
+    protected _enableEdit: boolean;
+    /** @private */ private _hasBeenMove;
+    /** @private */ private _engine;
+    /** @private */ private _options;
+    /** @private */ private _circle;
+    /** @private */ private _circleDataSource;
+    /** @private */ private _virtualLine;
+    /** @private */ private _virtualLineDataSource;
+    /** @private */ private _helpers;
+    /** @private */ private _helpersDataSource;
+    /** @private */ private _completedDataSource;
+    /** @private */ private _completedElement;
+    /** @private */ private _isAdd;
+    /** @private */ private _selectedIndex;
+    /** @private */ private _transformIndex;
+    /** @private */ private _raycaster;
+    /** @private */ private _tempVector3;
+    /** @private */ private _mapPlane;
+    /** @private */
+    private initCircle;
+    /** @private */
+    private initvirtualLine;
+    /** @private */
+    private initHelper;
+    /** @private */
+    private initCompletedElement;
+    /** @private */
+    private graphInfo;
+    /** @private */
+    private _handleCompleteClick;
+    set vertex(value: any);
+    get vertex(): any;
+    /** @private */
+    private _handleAddClick;
+    /** @private */
+    private _handleAddFinish;
+    /** @private */
+    private _handleNodeClick;
+    /** @private */
+    private _handleTransformChanging;
+    /** @private */
+    private _handleTransformChanged;
+    /** @private */
+    private _handleAddMove;
+    /** @private */
+    private calcLength;
+    /** @private */
+    private addNode;
+    /**
+     * @private
+     * 移动圆心
+     */
+    private moveNode;
+    /**
+     * @private
+     * 调整绘制圆的半径
+     */
+    private adjustRadius;
+    dispose(): void;
+    /** @private */
+    private clearObjects;
+    /** @private */
+    private overwriteNodes;
+    _getProperties(attributes: any): {
+        scale: any;
+        size: any;
+    };
+    _vertex: any;
+    set data(value: any);
+    /**
+     * 绘制的圆形的数据信息
+     */
+    get data(): any;
+}
+import { Editor } from './Editor';