@baidumap/mapv-three 1.3.2 → 1.3.3

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

@@ -115,11 +115,6 @@ export class PathTracker extends TrackerAbstract {
      */
     set track(target: any[] | Object);
     get track(): any[] | Object;
-    dirUpToHPR(direction: any, position: any, up: any): {
-        heading: any;
-        pitch: any;
-        roll: any;
-    };
     set interpolateDirectThreshold(value: number);
     get interpolateDirectThreshold(): number;
     set pointHandle(value: 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';

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

@@ -26,11 +26,18 @@ export class TrackerAbstract {
     /** @public */ public onStart: null;
     /** @public */ public onFinish: null;
     /** @public */ public onUpdate: null;
+    /** @private */ private _loopMode;
+    /** @private */ private _runtime;
+    /** @private */ private _withoutTrack;
     _debug: boolean;
     _trackPoint: null;
     _trackLists: any[];
+    _startPoint: null;
+    _startLists: any[];
+    _stratIndex: number;
     _lockView: boolean;
     _viewFollow: boolean;
+    _keepRunning: boolean;
     _easingFn: (t: any) => any;
     _currentEasingFn: (t: any) => any;
     _resolveEasing(easing: any): any;
@@ -58,6 +65,11 @@ export class TrackerAbstract {
      * 更新动画状态
      */
     update: () => void;
+    dirUpToHPR(direction: any, position: any, up: any): {
+        heading: any;
+        pitch: any;
+        roll: any;
+    };
     updateObject(animationState: any): void;
     updateCamera(animationState: any): void;
     _updateDebug(point: any): void;
@@ -86,4 +98,6 @@ export class TrackerAbstract {
     set object(value: any);
     get object(): any;
     _object: any;
+    set loopMode(v: string);
+    get loopMode(): string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baidumap/mapv-three",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "A powerful 3D map engine.",
   "author": "mapopen-fe@baidu.com",
   "main": "dist/mapvthree.umd.js",