chbim-time-axis-v2 0.0.17 → 0.0.18

package/README.md

@@ -216,6 +216,66 @@ interface InstantTask extends GanttTask {
 }
 ```
 
+## 🎥 ViewportRoam (视角漫游)
+
+组件包内置了一个 `ViewportRoam` 工具类，用于在 Cesium 中实现平滑的视角漫游，支持位置、偏航角(heading)、俯仰角(pitch)和翻滚角(roll)的插值动画。
+
+### 1. 导入与定义
+
+```typescript
+import { ViewportRoam, type RoamPoint } from "chbim-time-axis-v2";
+
+// 漫游点数据结构
+interface RoamPoint {
+  id: number | string;
+  time: string; // ISO8601 时间字符串
+  lng: number; // 经度
+  lat: number; // 纬度
+  alt: number; // 高度
+  heading: number; // 偏航角 (度)
+  pitch: number; // 俯仰角 (度)
+  roll?: number; // 翻滚角 (度)，可选
+}
+```
+
+### 2. 使用示例
+
+```typescript
+// 1. 准备漫游数据
+const roamData: RoamPoint[] = [
+  {
+    id: 1,
+    time: "2023-01-01T10:00:00Z",
+    lng: 120.123,
+    lat: 30.456,
+    alt: 100,
+    heading: 0,
+    pitch: -45,
+  },
+  {
+    id: 2,
+    time: "2023-01-01T10:01:00Z",
+    lng: 120.124,
+    lat: 30.457,
+    alt: 120,
+    heading: 90,
+    pitch: -30,
+  },
+];
+
+// 2. 初始化漫游控制器
+const roamController = new ViewportRoam(viewer, roamData);
+
+// 3. 开始漫游 (将自动监听时钟 tick 事件并更新相机)
+roamController.start();
+
+// 4. 停止漫游
+// roamController.stop();
+
+// 5. 销毁 (组件卸载时调用)
+// roamController.destroy();
+```
+
 ## ⚙️ 组件 API
 
 ### Props (属性)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chbim-time-axis-v2",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "description": "一个专为 Vue 3 设计的甘特图组件，完美集成 Cesium 时间轴功能。",
   "main": "dist/chbim-time-axis-v2.umd.js",
   "module": "dist/chbim-time-axis-v2.es.js",