chbim-time-axis-v2 0.0.16 → 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/dist/chbim-time-axis-v2.es.js

@@ -12785,7 +12785,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     clock: {},
     tasks: {}
   },
-  emits: ["taskUpdate", "update:tasks", "add", "delete", "task-enter", "task-leave"],
+  emits: ["taskUpdate", "update:tasks", "add", "delete", "task-enter", "task-leave", "blockUpdate"],
   setup(__props, { expose: __expose, emit: __emit }) {
     const slots = useSlots();
     const props = __props;
@@ -13255,6 +13255,11 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             if (t.blocks && t.blocks[payload.blockIndex]) {
               t.blocks[payload.blockIndex].startTime = payload.startTime;
               t.blocks[payload.blockIndex].endTime = payload.endTime;
+              emit("blockUpdate", {
+                task: JSON.parse(JSON.stringify(t)),
+                block: JSON.parse(JSON.stringify(t.blocks[payload.blockIndex])),
+                index: payload.blockIndex
+              });
               emit("taskUpdate", JSON.parse(JSON.stringify(t)));
               return true;
             }
@@ -13628,8 +13633,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const CesiumGantt_vue_vue_type_style_index_0_scoped_6b42d8c6_lang = "";
-const CesiumGantt = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-6b42d8c6"]]);
+const CesiumGantt_vue_vue_type_style_index_0_scoped_bc47a9ac_lang = "";
+const CesiumGantt = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-bc47a9ac"]]);
 CesiumGantt.install = (app) => {
   app.component("CesiumGantt", CesiumGantt);
 };