@baidumap/mapv-three 1.3.3 → 1.4.1

package/dist/types/threemap/engine/Clock.d.ts

@@ -0,0 +1,156 @@
+/**
+ * 引擎时钟系统，用于管理和控制时间流逝。<br/>
+ * 该类会随{@link Engine}的初始化自动实例化，不需要开发者手动执行初始化，通过`engine.clock`访问。<br/>
+ * 提供多种时钟模式，支持时间循环、限制、速度控制等功能。
+ *
+ * @category Internal
+ * @example
+ * ```javascript
+ * // 访问时钟
+ * const clock = engine.clock;
+ *
+ * // 设置当前时间
+ * clock.currentTime = new Date('2024-01-01 10:00:00');
+ * ```
+ */
+export class EngineClock {
+    /** 无任何限制模式，时间不会自动流逝 */
+    static TICK_NONE: number;
+    /** 正常模式，忽略起止时间限制 */
+    static TICK_NORMAL: number;
+    /** 循环模式，时间到达停止时间后循环到开始时间 */
+    static TICK_LOOP: number;
+    /** 限制模式，时间会被限制在开始和停止时间之间 */
+    static TICK_CLAMP: number;
+    /**
+     * @param {object} options 时钟配置选项
+     * @param {Date} [options.startTime] 开始时间，未设置则使用当前时间
+     * @param {Date} [options.stopTime] 停止时间，未设置则使用当前时间
+     * @param {Date} [options.currentTime] 当前时间，未设置则使用当天10:00:00
+     * @param {number} [options.speed=1] 时间流速倍率
+     * @param {number} [options.tickMode=0] 时钟模式，可选值：TICK_NONE、TICK_NORMAL、TICK_LOOP、TICK_CLAMP
+     * @param {number} [options.timeZoneOffset=8] 时区偏移量（小时），例如东八区为8
+     */
+    constructor(options?: {
+        startTime?: Date | undefined;
+        stopTime?: Date | undefined;
+        currentTime?: Date | undefined;
+        speed?: number | undefined;
+        tickMode?: number | undefined;
+        timeZoneOffset?: number | undefined;
+    });
+    /** @private 时区偏移量（小时） */
+    private _timeZoneOffset;
+    private _tzMs;
+    /** @private 当前UTC时间（内部缓存） */
+    private _currentTimeUTC;
+    /** @private 开始时间（毫秒） */
+    private _startMs;
+    /** @private 停止时间（毫秒） */
+    private _stopMs;
+    /** @private 缓存返回的本地时间对象 */
+    private _currentTime;
+    /** @private 时间流速倍率 */
+    private _speed;
+    /** @private 时钟模式 */
+    private _tickMode;
+    /**
+     * 时钟滴答，推进时间
+     * @private
+     * @param {number} deltaMilliseconds 自上一帧以来经过的毫秒数
+     */
+    private tick;
+    /**
+     * 未适配天空时钟的旧方法
+     * @deprecated
+     * @private
+     * @param {number} value 时间值（秒）
+     */
+    private _setTimeLegacy;
+    /**
+     * 设置时间值（本地时间）
+     * @private
+     * @param {number} value 时间戳（毫秒）
+     */
+    private _setTimeValue;
+    /**
+     * 设置时间值（UTC时间）
+     * @private
+     * @param {number} value 时间戳（毫秒）
+     */
+    private _setTimeValueUTC;
+    /**
+     * 重置时钟到开始时间
+     */
+    reset(): void;
+    /**
+     * 设置当前本地时间
+     * @param {Date} value 要设置的本地时间
+     */
+    set currentTime(value: Date);
+    /**
+     * 获取当前本地时间
+     * @returns {Date} 当前本地时间（缓存对象，请勿修改）
+     */
+    get currentTime(): Date;
+    /**
+     * 设置当前UTC时间
+     * @param {Date} value 要设置的UTC时间
+     */
+    set currentTimeUTC(value: Date);
+    /**
+     * 获取当前UTC时间
+     * @returns {Date} 当前UTC时间（缓存对象，请勿修改）
+     */
+    get currentTimeUTC(): Date;
+    /**
+     * 设置开始时间
+     * @param {Date} value 要设置的开始时间（本地时区）
+     */
+    set startTime(value: Date);
+    /**
+     * 获取开始时间
+     * @returns {Date} 开始时间（本地时区）
+     */
+    get startTime(): Date;
+    /**
+     * 设置停止时间
+     * @param {Date} value 要设置的停止时间（本地时区）
+     */
+    set stopTime(value: Date);
+    /**
+     * 获取停止时间
+     * @returns {Date} 停止时间（本地时区）
+     */
+    get stopTime(): Date;
+    /**
+     * 设置时区偏移量
+     * @param {number} value 时区偏移量（小时），例如东八区为8，西五区为-5
+     */
+    set timeZoneOffset(value: number);
+    /**
+     * 获取时区偏移量
+     * @returns {number} 时区偏移量（小时）
+     */
+    get timeZoneOffset(): number;
+    /**
+     * 设置时间流速倍率
+     * @param {number} value 时间流速倍率，例如2表示2倍速，0.5表示0.5倍速
+     */
+    set speed(value: number);
+    /**
+     * 获取时间流速倍率
+     * @returns {number} 时间流速倍率
+     */
+    get speed(): number;
+    /**
+     * 设置时钟模式
+     * @param {number} value 时钟模式：TICK_NONE、TICK_NORMAL、TICK_LOOP、TICK_CLAMP
+     */
+    set tickMode(value: number);
+    /**
+     * 获取时钟模式
+     * @returns {number} 时钟模式：TICK_NONE、TICK_NORMAL、TICK_LOOP、TICK_CLAMP
+     */
+    get tickMode(): number;
+}

package/dist/types/threemap/engine/Controller.d.ts

@@ -0,0 +1,141 @@
+/**
+ * 键鼠交互控制器API
+* @category Internal
+ * @example
+ * ```javascript
+ * // 访问控制器
+ * const controller = engine.controller;
+ *
+ *  // 设置是否启用
+ * controller.enabled = true;
+ *
+ * // 设置是否启用旋转
+ * controller.enableRotate = true;
+ *
+ * // 设置是否启用缩放
+ * controller.enableZoom = true;
+ *
+ * // 设置是否启用平移
+ * controller.enablePan = true;
+ *
+ * // 设置惯性拖拽
+ * controller.inertiaDragging = 0.9;
+ *
+ * // 设置惯性缩放
+ * controller.inertiaZoom = 0.8;
+ * ```
+ *
+ */
+export class EngineController {
+    constructor(engine: any, options?: {});
+    /** @internal */ _engine: any;
+    _enabled: boolean;
+    _enableRotate: boolean;
+    _enableZoom: boolean;
+    _enablePan: boolean;
+    _enableTilt: boolean;
+    _enableFixCenter: boolean;
+    _enableTerrainCollision: boolean;
+    _inertiaDragging: number;
+    _inertiaZoom: number;
+    _maximumMovementRatio: number;
+    _bounceAnimationTime: number;
+    _minimumZoomDistance: number;
+    _maximumZoomDistance: number;
+    /**
+     * 设置是否启用控制器，设置为false时，地图将无法响应任何交互事件
+     * @type {Boolean}
+     * @default true
+     */
+    set enabled(value: boolean);
+    /**
+     * 是否启用控制器
+     * @type {Boolean}
+     * @default true
+     */
+    get enabled(): boolean;
+    /**
+     * 设置是否启用旋转
+     * @type {Boolean}
+     * @default true
+     */
+    set enableRotate(value: boolean);
+    /**
+     * 是否启用旋转
+     * @type {Boolean}
+     * @default true
+     */
+    get enableRotate(): boolean;
+    /**
+     * 设置是否启用缩放
+     * @type {Boolean}
+     * @default true
+     */
+    set enableZoom(value: boolean);
+    /**
+     * 是否启用缩放
+     * @type {Boolean}
+     * @default true
+     */
+    get enableZoom(): boolean;
+    /**
+     * 设置是否启用平移
+     * @type {Boolean}
+     * @default true
+     */
+    set enablePan(value: boolean);
+    /**
+     * 是否启用平移
+     * @type {Boolean}
+     * @default true
+     */
+    get enablePan(): boolean;
+    /**
+     * 设置是否启用倾斜
+     * @type {Boolean}
+     * @default true
+     */
+    set enableTilt(value: boolean);
+    /**
+     * 是否启用倾斜
+     * @type {Boolean}
+     * @default true
+     */
+    get enableTilt(): boolean;
+    set enableFixCenter(value: boolean);
+    get enableFixCenter(): boolean;
+    set enableTerrainCollision(value: boolean);
+    get enableTerrainCollision(): boolean;
+    inertiaTranslate: any;
+    /**
+     * 设置惯性缩放，0-1，0表示完全禁用惯性缩放，1表示惯性达到最大
+     * @type {Number}
+     * @default 0.8
+     */
+    set inertiaZoom(value: number);
+    /**
+     * 惯性缩放值
+     * @type {Number}
+     * @default 0.8
+     */
+    get inertiaZoom(): number;
+    set maximumMovementRatio(value: number);
+    get maximumMovementRatio(): number;
+    set bounceAnimationTime(value: number);
+    get bounceAnimationTime(): number;
+    set minimumZoomDistance(value: number);
+    get minimumZoomDistance(): number;
+    set maximumZoomDistance(value: number);
+    get maximumZoomDistance(): number;
+    /**
+     * 设置惯性拖拽，0-1，0表示完全禁用惯性拖拽，1表示惯性达到最大
+     * @default 0.9
+     */
+    set inertiaDragging(value: number);
+    /**
+     * 惯性拖拽值
+     * @type {Number}
+     * @default 0.9
+     */
+    get inertiaDragging(): number;
+}

package/dist/types/threemap/engine/Map.d.ts

@@ -1,5 +1,5 @@
 /**
- * 地图管理器<br/>
+ * 地图管理器，主要负责地图视野控制相关功能<br/>
  * 该类会随{@link Engine}的初始化自动实例化，不需要开发者手动执行初始化调用，通过`engine.map`访问
  *
  * @category Internal
@@ -99,9 +99,14 @@ export class EngineMap {
      * @param {number} range 距离
      */
     setMaxRange(range: number): void;
+    /**
+     * 设置3d地图最近视距
+     * @param {number} range 距离
+     */
+    setMinRange(range: number): void;
     /**
      * 设置地图视野
-     * @param {Array | Vector3} target 目标视野中心点
+     * @param {Array | Vector3} target 目标视野中心点, 经纬度和海拔高度
      * @param {Object} offset 视野角度，包括 heading、pitch，其中3d支持range、2d支持zoom
      * @param {number} offset.heading 视野旋转角度，以正北向为起始，逆时针方向递增。单位为角度。
      * @param {number} offset.pitch 视野俯仰角，俯视为0，平时地平线为90。单位为角度。
@@ -160,7 +165,25 @@ export class EngineMap {
      * @returns {number}
      */
     getHeading(): number;
-    flyTo(target: any, offset?: {}): any;
+    /**
+     * 视野通过动画过渡的方式飞到目标位置
+     * @param {Array | Vector3} target 目标视野中心点
+     * @param {Object} options 目标视野与动画参数
+     * @param {number} options.heading 视野旋转角度，以正北向为起始，逆时针方向递增。单位为角度。
+     * @param {number} options.pitch 视野俯仰角，俯视为0，平时地平线为90。单位为角度。
+     * @param {number} options.range 视野距离地面的距离。单位为米。
+     * @param {number} options.duration 动画持续时间。单位为毫秒。
+     * @param {Function} options.complete 动画完成回调。
+     * @param {Function} options.cancel 动画取消回调。
+     */
+    flyTo(target: any[] | Vector3, options?: {
+        heading: number;
+        pitch: number;
+        range: number;
+        duration: number;
+        complete: Function;
+        cancel: Function;
+    }): any;
     /**
      * 获取地图当前倾斜角度
      * @returns {number}
@@ -241,11 +264,15 @@ export class EngineMap {
      */
     projectArrayCoordinates(coordinates: any): number[];
     /**
+     * @internal
+     * @deprecated
      * 开启地图控制，允许用户拖动、平移、旋转等操作
      */
     enableControl(): void;
     /**
      * 禁用地图控制
+     * @internal
+     * @deprecated
      */
     disableControl(): void;
     /**
@@ -315,6 +342,7 @@ export class EngineMap {
      */
     pickSeaLevelWorldPosition(pixel: Array<number>): Vector3;
     /**
+     * @internal 引擎销毁时内部自动调用
      * 销毁地图实例，移除其绑定事件
      */
     dispose(): void;
@@ -339,9 +367,11 @@ export class EngineMap {
      */
     get mapType(): string | undefined;
     /**
+     * @internal
+     * @deprecated
      * 获取map的dom容器
      */
-    get container(): any;
+    get container(): HTMLElement | undefined;
     set fov(fov: any);
     /**
      * 获取地图视野开角

package/dist/types/threemap/engine/Rendering.d.ts

@@ -67,6 +67,11 @@ export class EngineRendering {
     /** @private */ private _renderer;
     /** @private */ private _scene;
     /** @private */ private _weather;
+    /**
+     * @private
+     * 原始相机，用于获取原始相机参数，如投影矩阵、视图矩阵等
+     */
+    private _rawCamera;
     /** @private */ private _useMRT;
     /** @private */ private _isUseMRTChanged;
     /** @private */ private _freezeUpdate;
@@ -83,6 +88,7 @@ export class EngineRendering {
     /** @private */ private _beforeScenePrepareRenderObjects;
     /** @private */ private _beforeSceneRenderObjects;
     /** @private */ private _onRenderModeChangedObjects;
+    /** @private */ private _onRenderPassChangedObjects;
     /** @private */ private _useClip;
     /** @private */
     private _wireframe;
@@ -99,6 +105,8 @@ export class EngineRendering {
     /** @private */
     private lastRenderTime;
     /** @private */
+    private _lastClockTime;
+    /** @private */
     private _contextParameters;
     /** @private */
     private _needsReCreateRenderer;
@@ -244,6 +252,7 @@ export class EngineRendering {
      * 请求一次渲染更新
      */
     requestRender(): void;
+    _copyRawCamera(): void;
     /**
      * @internal
      * 渲染场景
@@ -556,6 +565,12 @@ export class EngineRendering {
      * 是否自动计算相机近远裁剪面
      */
     get clampCameraNearFar(): boolean;
+    get hasWater(): boolean;
+    /**
+     * @internal
+     * 内部使用，部分场景需要获取原始相机参数，如投影矩阵、视图矩阵等
+     */
+    get rawCamera(): any;
 }
 import { RenderingStats } from './rendering/Stats';
 import { Picking } from './rendering/Picking';

package/dist/types/threemap/engine/event/EntityProxy.d.ts

@@ -9,6 +9,7 @@ export class EntityProxy {
     _object: any;
     _intersection: any;
     _computeEntity(): any;
+    _addPointProperty(entity: any): void;
     get entity(): any;
     _entity: any;
     get intersection(): any;

package/dist/types/threemap/engine/map/BlankMap.d.ts

@@ -108,4 +108,4 @@ export class BlankMap extends BaseMap {
     get far(): number;
 }
 import { BaseMap } from './BaseMap';
-import { MapControl } from '../../../threejs/controls/MapControl';
+import { MapControl } from './controls/MapControl';

package/dist/types/threemap/engine/map/BlankMap3DControl.d.ts

@@ -2,7 +2,8 @@ export class BlankMap3DControl extends BlankMap {
     isBlankMap3D: boolean;
     /** @private */
     private _viewStateDirty;
-    maxRange: any;
+    maxRange: number;
+    minRange: number;
     range: any;
     bounds: any[];
     /**
@@ -23,6 +24,7 @@ export class BlankMap3DControl extends BlankMap {
      */
     getCameraDistance(forceUpdate: any): any;
     setRange(range: any): void;
+    setMinRange(range: any): void;
     /**
      * 相机指向某个具体目标，
      * @param {*} target 目标点
@@ -41,5 +43,6 @@ export class BlankMap3DControl extends BlankMap {
     };
     lockDrag(status: any): void;
     handleEventCameraChange: () => boolean;
+    get controller(): import("./controls/MapControl").MapControl | undefined;
 }
 import { BlankMap } from './BlankMap';

package/dist/types/{threejs → threemap/engine/map}/controls/DraggingMovementAggregator.d.ts

@@ -16,8 +16,11 @@ export class DraggingMovementAggregator {
     _amplitudeY: number;
     _targetX: number;
     _targetY: number;
+    _scale: number;
     start(x: any, y: any, time: any): void;
     update(x: any, y: any, time: any): void;
     startInertia(isOperateRotation?: boolean): void;
     getInertiaPosition(time: any): any[];
+    set scale(scale: number);
+    get scale(): number;
 }

package/dist/types/{threejs → threemap/engine/map}/controls/MapControl3D.d.ts

@@ -25,7 +25,16 @@ export class MapControl3D {
     startProjectionCenter: any;
     /** @private */
     private _enabled;
-    enableInertia: boolean;
+    /** @private */
+    private _enableRotate;
+    /** @private */
+    private _enableZoom;
+    /** @private */
+    private _enablePan;
+    /** @private */
+    private _enableTilt;
+    /** @private 历史遗留问题，不对外暴露 */
+    private enableInertia;
     minPitch: number;
     maxPitch: number;
     zoomSpeed: number;
@@ -154,7 +163,15 @@ export class MapControl3D {
     _tiltBounceBack: () => void;
     _pickPosition(mouse: any): Promise<any>;
     dispose: () => void;
+    set enableRotate(enabled: any);
+    set enableZoom(enabled: any);
+    set enablePan(enabled: any);
+    set enableTilt(enabled: any);
+    set inertiaDragging(scale: number);
+    get inertiaDragging(): number;
+    set inertiaZoom(scale: number);
+    get inertiaZoom(): number;
 }
-import { EventThrottle } from '../../threemap/engine/event/EventThrottle';
+import { EventThrottle } from '../../event/EventThrottle';
 import { DraggingMovementAggregator } from './DraggingMovementAggregator';
 import { PointerMovementAggregator } from './PointerMovementAggregator';

package/dist/types/{threejs → threemap/engine/map}/controls/PointerMovementAggregator.d.ts

@@ -14,10 +14,13 @@ export class PointerMovementAggregator {
     private _inertiaSpeed;
     /** @private */
     private _inertiaDirection;
+    _scale: number;
     start(x: any, y: any, time: any): void;
     update(x: any, y: any, time: any): void;
     setInertiaState(speed: any, direction: any, time: any): void;
     startInertia(): void;
     getInertiaPosition(time: any): any[];
     get inertiaDirection(): any;
+    set scale(scale: number);
+    get scale(): number;
 }

package/dist/types/threemap/engine/map/earth/Earth.d.ts

@@ -105,6 +105,7 @@ export class Earth extends BaseMap {
     _canvas: any;
     set farScale(value: number);
     get farScale(): number;
+    get controller(): ScreenSpaceCameraController | undefined;
 }
 import { BaseMap } from '../BaseMap';
 import { Ellipsoid } from './Ellipsoid';

package/dist/types/threemap/engine/rendering/Collision.d.ts

@@ -121,6 +121,11 @@ export class RenderingCollision {
      */
     _collisionTest(): false | undefined;
     _getScreenPosition(position: any, matrix: any, width: any, height: any): any[];
+    /**
+     * 计算已投影的字符包围盒（屏幕坐标）
+     * @private
+     */
+    private _computeProjectedCharBoundingBoxes;
     _computeCharBoundingBoxes(chars: any, pixelSize: any, rotationMatrix: any, basePosition: any, camera: any, cameraOffset: any, matrix4: any, margin: any, tolerance: any, containerWidth: any, containerHeight: any): {
         minX: number;
         minY: number;

package/dist/types/threemap/engine/rendering/Label.d.ts

@@ -68,11 +68,15 @@ export class RenderingLabel {
     _iconText: any;
     _iconTextUvDataSource: DataSource | undefined;
     _iconTextUv: any;
+    _roadLabelDataSource: DataSource | undefined;
+    _roadLabel: any;
     initLabel(): void;
     _labelIconDataSource: DataSource | undefined;
     _labelIcon: any;
     _labelIconFlatDataSource: DataSource | undefined;
     _labelIconFlat: any;
+    _labelIconFlatDepthDataSource: DataSource | undefined;
+    _labelIconFlatDepth: any;
     _labelTextFlatDataSource: DataSource | undefined;
     _labelTextFlat: any;
     _labelTextFixedDataSource: DataSource | undefined;
@@ -160,6 +164,17 @@ export class RenderingLabel {
     */
     removeLabel(label: DataItem): void;
     removeLabels(labels: any, id: any): void;
+    /**
+     * 添加道路标签（沿线文字）
+     * @param {Array<Object>} roadLabels 道路标签数组
+     * @param {string} tileKey 瓦片key
+     */
+    addRoadLabels(roadLabels: Array<Object>, tileKey: string): void;
+    /**
+     * 移除道路标签（沿线文字）
+     * @param {Array<Object>} roadLabels 道路标签数组
+     */
+    removeRoadLabels(roadLabels: Array<Object>): void;
     dispose(): void;
 }
 import { DataSource } from '../../dataSource/DataSource';

package/dist/types/threemap/engine/rendering/MainNew.d.ts

@@ -27,7 +27,7 @@ export class RenderingMainNew {
     private _opaquePostprocessings;
     _sharedFullScreenRenderTargets: SharedFullScreenRenderTargets;
     beginFrame(): void;
-    render(): void;
+    render(renderPassChangedObjects: any): void;
     isInStableRenderState(): any;
     endFrame(): void;
     setSize(width: any, height: any): void;

package/dist/types/threemap/engine/rendering/postprocessing/OpaquePostprocessings.d.ts

@@ -2,7 +2,7 @@ export class OpaquePostprocessings extends Postprocessings {
     _enableOpaqueCopy: boolean;
     _testRenderTarget: any;
     _testScene: any;
-    _opaqueCopyPass: OpaqueCopyPass | undefined;
+    _opaqueCopyPass: OpaqueCopyPass;
     _geometry: any;
     _material: any;
     _mesh: any;

package/dist/types/threemap/engine/rendering/postprocessing/SkyAtmospherePass.d.ts

@@ -16,6 +16,7 @@ export class SkyAtmospherePass {
      */
     render(renderer: any, writeBuffer: any, readBuffer: any): void;
     _sphereCamera: EllipsoidCamera | undefined;
+    getCurrentUsedTextures(): any[];
     dispose(): void;
 }
 import { EllipsoidCamera } from '../../map/earth/EllipsoidCamera';

package/dist/types/threemap/engine/rendering/scene/DirectSceneRendering.d.ts

@@ -1,14 +1,19 @@
 export class DirectSceneRendering extends SceneRendering {
     isDirectSceneRendering: boolean;
+    _normalMaterial: any;
     _emissiveRenderTarget: any;
+    _normalRenderTarget: any;
+    render(renderPassChangedObjects: any): void;
     _sceneRenderTarget: any;
     _tDepth: any;
     _fsQuad: any;
     _isBlackColor(color: any): boolean;
     _isEmissiveMaterial(material: any): any;
     _disposeEmissiveRenderTarget(): void;
+    _disposeNormalRenderTarget(): void;
     setSize(width: any, height: any): void;
     get emissiveTexture(): any;
+    get normalTexture(): any;
     get depthTexture(): any;
     get diffuseTexture(): any;
 }

package/dist/types/threemap/mapView/geo/terrainData/QuantizedMeshTerrainData.d.ts

@@ -2,7 +2,7 @@
  * QuantizedMeshTerrainData
  */
 export class QuantizedMeshTerrainData {
-    static createQuantizedMeshTerrainData(buffer: any): QuantizedMeshTerrainData;
+    static createQuantizedMeshTerrainData(provider: any, buffer: any): QuantizedMeshTerrainData;
     constructor(options: any);
     _quantizedVertices: any;
     _encodedNormals: any;

package/dist/types/threemap/mapView/grid/BaiduVectorOfflineGrid.d.ts

@@ -4,6 +4,7 @@
  */
 export class BaiduVectorOfflineGrid extends Grid {
     name: string;
+    supportLevelReuse: boolean;
     /** @private */
     private _rootBoundingBox;
     /**
@@ -12,6 +13,10 @@ export class BaiduVectorOfflineGrid extends Grid {
      */
     getRootTiles(): MapTile[];
     getRootBoundingBox(): any;
+    getTileSizeAtLevel(level: any): number;
+    getTileCoordX(x: any, tileSize: any, clampToEdge: any): number;
+    getTileCoordY(y: any, tileSize: any, clampToEdge: any): number;
+    getResuedTileConfig(z: any, x: any, y: any): any[];
     getTileLoaderConfig(tile: any): {
         baseZ: any;
         startZ: any;