@baidumap/mapv-three 1.3.0 → 1.3.3

package/dist/types/assets/wasm/lanelet.d.ts

@@ -0,0 +1,2 @@
+export default Module;
+declare function Module(moduleArg?: {}): Promise<{}>;

package/dist/types/index.d.ts

@@ -34,6 +34,7 @@ export { GridCoordProvider } from "./threemap/mapView/tileProvider/imagery/GridC
 export { PlaneTerrainTileProvider } from "./threemap/mapView/tileProvider/terrain/PlaneTerrainTileProvider";
 export { CesiumTerrainTileProvider } from "./threemap/mapView/tileProvider/terrain/CesiumTerrainTileProvider";
 export { BaiduVectorTileProvider } from "./threemap/mapView/tileProvider/vector/BaiduVectorTileProvider";
+export { BaiduLaneVectorTileProvider } from "./threemap/mapView/tileProvider/vector/BaiduLaneVectorTileProvider";
 export { GeoJSONVectorTileProvider } from "./threemap/mapView/tileProvider/vector/GeoJSONVectorTileProvider";
 export { BaiduTrafficTileProvider } from "./threemap/mapView/tileProvider/vector/BaiduTrafficTileProvider";
 export { MapboxVectorTileProvider } from "./threemap/mapView/tileProvider/vector/MapboxVectorTileProvider";
@@ -159,6 +160,7 @@ export { FoliageLeafMaterial } from "./threejs/materials/natural/FoliageLeafMate
 export { BatchBuildingMaterial } from "./threemap/materials/BatchBuildingMaterial";
 export { ColorAdjustPass } from "./threejs/postprocessing/ColorAdjustPass";
 export { Transforms } from "../src/threemap/engine/map/earth/Transforms";
+export { VideoConfig } from "./threemap/video/VideoConfig";
 export * as urlUtils from "./util/urlUtils";
 export * as geojsonUtils from "./util/geojsonUtils";
 export * as colorUtils from "./util/colorUtils";

package/dist/types/threejs/loaders/gltf/GLTFCesiumRTCExtension.d.ts

@@ -0,0 +1,4 @@
+export class GLTFCesiumRTCExtension {
+    name: string;
+    afterRoot(res: any): void;
+}

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

@@ -5,6 +5,9 @@ export class OctahedralImpostor extends GeoInstancedMesh {
         normalDepth: null;
         orm: null;
     };
+    static _defaultTexturesPromise: null;
+    static _bitmapPromises: Map<any, any>;
+    static _getBitmap(url: any): any;
     static initDefaultTextures(): Promise<void>;
     static createTextures(diffuseUrl: any, normalDepthUrl: any, ormUrl: any): Promise<{
         diffuseTexture: any;

package/dist/types/threejs/objects/polygon/Polygon.d.ts

@@ -197,6 +197,7 @@ export class Polygon extends GeoMesh {
      * @protected
      */
     protected onBeforeSceneRenderHook(engine: Engine, scene: Scene, camera: Camera, renderState: Object): void;
+    getNormal(): any;
     /**
      * 计算矩形边界
      * @returns {Array<number>} 边界数组 [minX, minY, maxX, maxY]

package/dist/types/threemap/3dtiles/elements/TileInstancedElementManager.d.ts

@@ -153,14 +153,21 @@ export class TileInstancedElementManager {
             isFoliage: boolean;
             isBox: boolean;
             scaleByZ: boolean;
-            instances: {
+            instances: ({
                 subtype: string;
                 diffuseTexture: string;
                 normalDepthTexture: string;
                 ormTexture: string;
                 imposterScale: number;
                 uvOffset: number;
-            }[];
+            } | {
+                subtype: string;
+                imposterScale: number;
+                uvOffset: number;
+                diffuseTexture?: undefined;
+                normalDepthTexture?: undefined;
+                ormTexture?: undefined;
+            })[];
         };
     });
     get config(): {
@@ -169,14 +176,21 @@ export class TileInstancedElementManager {
             isFoliage: boolean;
             isBox: boolean;
             scaleByZ: boolean;
-            instances: {
+            instances: ({
                 subtype: string;
                 diffuseTexture: string;
                 normalDepthTexture: string;
                 ormTexture: string;
                 imposterScale: number;
                 uvOffset: number;
-            }[];
+            } | {
+                subtype: string;
+                imposterScale: number;
+                uvOffset: number;
+                diffuseTexture?: undefined;
+                normalDepthTexture?: undefined;
+                ormTexture?: undefined;
+            })[];
         };
     };
     set labelEnabled(enabled: boolean);

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

@@ -131,6 +131,11 @@ export class Engine {
      * // TODO: 暂时不对外开放，考虑移到engine.map中
      */
     private unlockCamera;
+    /**
+     * 渲染电影
+     * @param {Movie} movie 电影对象
+     */
+    renderVideo(videoConfig: any): Promise<void>;
     /**
      * 容器对象
      * @type {HTMLElement}

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

@@ -1,56 +1,66 @@
-/**
- * 对象跟踪
- * 用于追踪指定物体，跟随对象调整视野
- * ```javascript
- * const objectTracker = engine.add(new ObjectTracker())
- * objectTracker.track(car, {
- *  radius: 50,
- *  pitch: 40,
- *  heading: 0
- * })
- * ```
- */
-export class ObjectTracker {
+export class ObjectTracker extends TrackerAbstract {
+    /**
+     * 计算世界坐标系下的变换后 AABB（修正为 8 个唯一顶点）
+     */
     static computeTransformedBoundingBox(box: any, transform: any): any;
     /** @private */ private _trackObject;
-    /** @private */ private _trackStatus;
     /** @private */ private _trackConfig;
-    /** @private */ private _trackParams;
-    /** @private */ private _lastTrackParams;
+    /** @private */ private _lastState;
     /**
-     * 追踪物体
-     * @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;
+   * 开始追踪
+   * @param {Object3D|Vector3|[number,number,number]|{instance:any,instanceIndex:number}} object
+   * @param {{
+   *   radius?:number, pitch?:number, heading?:number,
+   *   lock?:boolean, height?:number, extraDir?:number,
+   *   duration?:number, easing?:string|Function
+   * }} config
+   */
+    track(object: Object3D | Vector3 | [number, number, number] | {
+        instance: any;
+        instanceIndex: number;
+    }, config?: {
+        radius?: number;
+        pitch?: number;
+        heading?: number;
+        lock?: boolean;
+        height?: number;
+        extraDir?: number;
+        duration?: number;
+        easing?: string | Function;
+    }): void;
+    /**
+   * 基类要求：根据 ratio（0~1）返回当前帧状态
+   * 返回 { point: 地图坐标数组, hpr: {heading, pitch, roll} }
+   */
+    updatePositionByPercentage(): {
+        point: any[];
+        hpr: {
+            heading: number;
+            pitch: number;
+            roll: number;
+        };
+    } | null;
+    onTrackFrame(): 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;
+    _computeTargetState(target: any, view: any): {
+        point: any[];
+        hpr: {
+            heading: number;
+            pitch: number;
+            roll: number;
+        };
+    };
     /**
-     * 获取目标相机
-     * @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} 相机
+     * 采样目标的“世界中心点 + 朝向”
+     * - 支持 instanced entity
+     * - 支持 Object3D（合并子层级包围盒 → 取 boundingSphere.center）
+     * - 支持 Vector3 / [x,y,z]
      */
-    getCameraByTargetAndView(engine: any, target: any, view?: {
-        yaw?: number | undefined;
-        pitch?: number | undefined;
-        radius?: number | undefined;
-    }): Object;
+    _sampleTargetWorldPose(target: any, view: any): {
+        worldCenter: any;
+        targetEuler: any;
+    };
 }
+import { TrackerAbstract } from './TrackerAbstract';

package/dist/types/threemap/animations/ObjectTracker_deprecated.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

@@ -1,64 +1,84 @@
-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;
+export class PathTracker extends TrackerAbstract {
+    _sampledPath: any[];
+    _arcInfo: {};
     /** @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): {
+    updatePositionByPercentage(ratio: any): {
+        point: any;
+        hpr: {
+            heading: number;
+            pitch: number;
+            roll: number;
+        };
+        direction: any;
+    } | {
+        point: any[];
+        hpr: {
+            heading: any;
+            pitch: any;
+            roll: any;
+        };
+    } | undefined;
+    _interpolatePath(ratio: any): {
+        point: any;
+        hpr: {
+            heading: number;
+            pitch: number;
+            roll: number;
+        };
+        direction: any;
+    } | {
         point: any[];
+        hpr: {
+            heading: any;
+            pitch: any;
+            roll: any;
+        };
+    };
+    _handleFrame(lastFrame: any, currentFrame: any, last: any, current: any, next: any, point: any, transPercent: any, percent: any, ratio: any): {
+        point: any;
+        hpr: {
+            heading: number;
+            pitch: number;
+            roll: number;
+        };
         direction: any;
     };
-    _updatePitch(last: any, current: any, percent: any): number;
-    /**
-     * @internal
-     */
-    _interpolatePath(ratio: any): {
-        percent: any;
+    _getSegment(ratio: any, dataLength: any): {
+        last: any;
+        current: any;
+        next: any;
+        isStart: boolean;
+        isEnd: boolean;
+        segmentPercent: number;
+        lastFrame: any;
+        currentFrame: any;
+    };
+    _computeTransition(percent: any, last: any, current: any, next: any, isStart: any, isEnd: any): {
+        isTransition: any;
+        transPercent: number;
+    };
+    _updatePositionAndDirection(last: any, current: any, percent: any, isTrans: any, transPercent: any): {
+        point: any[];
+        hpr: {
+            heading: any;
+            pitch: any;
+            roll: any;
+        };
+    };
+    _findCurrentSegment(ratio: any): {
+        last: any;
+        current: any;
+        next: any;
+        percent: number;
+        lastFrame: null;
+        currentFrame: null;
+        index: number;
+    } | null;
+    _calculateLocation(last: any, current: any, percent: any): {
         point: any[];
-        position: any;
-        distance: number;
         direction: any;
-        pitch: number;
-        path: any;
     };
-    /**
-     * @internal
-     */
     _createSampledPath(path: any): {
         percent: string;
         point: any;
@@ -68,69 +88,38 @@ export class PathTracker {
         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;
+    _getRadians(v0: any, v1: any): number;
+    _parseCoordinateArray(target: any): {
+        track: any[];
+        frameInfo: never[];
+    } | undefined;
+    _parseGeoJSON(target: any): {
+        track: any;
+        frameInfo: any;
+    } | undefined;
+    _parseFrameArray(target: any): {
+        track: any[][];
+        frameInfo: {
+            pitch: any;
+            yaw: any;
+            aim: any;
+            speed: any;
+            time: any;
+        }[];
+    } | undefined;
     /**
-     * 暂停漫游动画
-     * @param {*} unlock 是否解锁视野
-     * @returns 当前视角参数
-     */
-    pause(unlock: any): null;
-    /**
-     * 停止漫游动画
-     */
-    stop(): void;
-    replay(): void;
-    /**
-     * 设置拐弯处的开始差值的距离
-     * @param {number} value 距离单位米
+     * 设置路径数据
+     * @param {Array|Object} target 路径数据
      */
+    set track(target: any[] | Object);
+    get track(): any[] | Object;
     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;
+    set pointHandle(value: any);
+    get pointHandle(): any;
+    _pointHandle: any;
     curvePath: any;
 }
+import { TrackerAbstract } from './TrackerAbstract';

package/dist/types/threemap/animations/PathTracker_deprecated.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/animations/RotateTracker.d.ts

@@ -0,0 +1,29 @@
+export class RotateTracker extends TrackerAbstract {
+    center: number[];
+    radius: number;
+    _orbitNormal: any;
+    _startVector: any;
+    _pitchOffset: number;
+    _runConfig: {
+        center: any;
+        radius: any;
+        startAngle: any;
+        endAngle: any;
+        clockwise: any;
+        loopMode: any;
+        height: any;
+    } | undefined;
+    /**
+     * 根据 ratio 计算圆周位置
+     */
+    updatePositionByPercentage(ratio: any): {
+        point: any;
+        hpr: {
+            heading: any;
+            pitch: any;
+            roll: any;
+        };
+        direction: any;
+    };
+}
+import { TrackerAbstract } from './TrackerAbstract';