@vesium/plot 1.0.1-beta.47 → 1.0.1-beta.49

package/dist/index.cjs

@@ -9,30 +9,49 @@ const core = require("@vueuse/core");
 const vue = require("vue");
 const _PlotScheme = class _PlotScheme {
   constructor(options) {
+    /**
+     * 标绘类型。应当是全局唯一的字符串，会作为键名缓存
+     */
     __publicField(this, "type");
     /**
-     * 是否立即执行完成标绘操作
-     *
-     * 每次控制点发生变变化时，执行该回调函数，如果返回`true`则标绘完成
+     * 判断是否立即完成标绘.
+     * 每次控制点发生变变化时，执行该回调函数，返回`true`则完成标绘
      */
     __publicField(this, "complete");
     /**
-     * 双击时，是否执行完成标绘操作
+     * 判断是否允许手动完成标绘。
+     * 每次控制点发生变变化时，执行该回调函数，返回`true`则后续左键双击即完成标绘
      */
-    __publicField(this, "forceComplete");
+    __publicField(this, "allowManualComplete");
     /**
+     * 处于定义态时鼠标的样式
      * @default 'crosshair'
      */
     __publicField(this, "definingCursor");
+    /**
+     * 当前标绘的框架点数据
+     */
     __publicField(this, "skeletons");
+    /**
+     * 初始化时创建`Entity`的函数，创建后的`Entity`会作为配置项传入`render`中
+     */
     __publicField(this, "initEntites");
+    /**
+     * 初始化时创建`Primitive`的函数，创建后的`Primitive`会作为配置项传入`render`中
+     */
     __publicField(this, "initPrimitives");
+    /**
+     * 初始化时创建贴地`Primitive`的函数，创建后的`Primitive`会作为配置项传入`render`中
+     */
     __publicField(this, "initGroundPrimitives");
+    /**
+     * 当标绘数据变化时，会触发`render`回调，返回的数据会被添加到cesium中
+     */
     __publicField(this, "render");
     var _a;
     this.type = options.type;
     this.complete = options.complete;
-    this.forceComplete = options.forceComplete;
+    this.allowManualComplete = options.allowManualComplete;
     this.definingCursor = options.definingCursor ?? "crosshair";
     this.skeletons = ((_a = options.skeletons) == null ? void 0 : _a.map((item) => item())) ?? [];
     this.initEntites = options.initEntites;
@@ -40,16 +59,31 @@ const _PlotScheme = class _PlotScheme {
     this.initGroundPrimitives = options.initGroundPrimitives;
     this.render = options.render;
   }
+  /**
+   * 标绘方案缓存。
+   * 每次标绘时都会将`PlotScheme.type`作为键名缓存，
+   * 后续可用过`PlotScheme.getCache(type)`获取完整的`PlotScheme`配置。
+   */
   static getCacheTypes() {
     return [...this._record.keys()];
   }
+  /**
+   * 通过`PlotScheme.type`获取缓存中的`PlotScheme`配置。
+   */
   static getCache(type) {
     return _PlotScheme._record.get(type);
   }
+  /**
+   * 缓存标绘方案。
+   */
   static setCache(scheme) {
     vesium.assertError(!scheme.type, "`scheme.type` is required");
     _PlotScheme._record.set(scheme.type, scheme);
   }
+  /**
+   * 解析传入的maybeScheme，maybeScheme可能是一个完整的PlotScheme，也可能是缓存中的`PlotScheme.type`，并返回 PlotScheme 实例。
+   * 若传入的是`PlotScheme.type`字符串，并且缓存中不存在该标绘方案，则抛出错误。
+   */
   static resolve(maybeScheme) {
     if (typeof maybeScheme === "string") {
       const _scheme = _PlotScheme.getCache(maybeScheme);
@@ -121,7 +155,7 @@ const _SampledPlotProperty = class _SampledPlotProperty {
     (_a = options == null ? void 0 : options.packables) == null ? void 0 : _a.forEach((packable) => this.setSample(packable));
     if (!this._times.length) {
       this.setSample({
-        time: cesium.JulianDate.now(),
+        time: new cesium.JulianDate(0, 0),
         positions: [],
         derivative: void 0
       });
@@ -195,7 +229,7 @@ const _SampledPlotProperty = class _SampledPlotProperty {
    * @template D 数据类型。
    */
   getValue(time, result) {
-    var _a, _b;
+    var _a;
     result ?? (result = { time });
     Object.assign(result, {
       time: time == null ? void 0 : time.clone(),
@@ -203,8 +237,8 @@ const _SampledPlotProperty = class _SampledPlotProperty {
       derivative: void 0
     });
     if (!time) {
-      result.time = (_a = this._times[0]) == null ? void 0 : _a.clone();
-      result.positions = (_b = this._sampleds[0]) == null ? void 0 : _b.map((c) => c.clone(c));
+      result.time = this._times[0].clone();
+      result.positions = (_a = this._sampleds[0]) == null ? void 0 : _a.map((c) => c.clone(c));
       result.derivative = this._derivatives[0];
       return result;
     }
@@ -229,14 +263,13 @@ const _SampledPlotProperty = class _SampledPlotProperty {
     return result;
   }
   /**
-   * 设置样本数据
-   *
+   * 设置样本数据，如果传入的数据不含时间，则会存入时间最早的集合中
    * @param value 样本数据对象，包含时间、位置和导数信息
    */
   setSample(value) {
-    var _a, _b, _c;
-    const time = ((_a = value.time) == null ? void 0 : _a.clone()) ?? ((_b = this._times[0]) == null ? void 0 : _b.clone());
-    const positions = ((_c = value.positions) == null ? void 0 : _c.map((item) => item.clone())) ?? [];
+    var _a, _b;
+    const time = ((_a = value.time) == null ? void 0 : _a.clone()) ?? this._times[0].clone();
+    const positions = ((_b = value.positions) == null ? void 0 : _b.map((item) => item.clone())) ?? [];
     const derivative = value.derivative;
     const index = this._times.findIndex((t) => cesium.JulianDate.equals(time, t));
     if (index !== -1) {
@@ -296,6 +329,9 @@ const _SampledPlotProperty = class _SampledPlotProperty {
       cesium.TimeInterval.contains(interval2, time) && this.removeSample(time);
     }
   }
+  /**
+   * 判断两个property是否相等
+   */
   equals(other) {
     return other === this;
   }
@@ -320,6 +356,9 @@ class PlotFeature {
      * @internal
      */
     __publicField(this, "_defining");
+    /**
+     * @internal
+     */
     __publicField(this, "_disabled");
     /**
      * @internal
@@ -376,6 +415,12 @@ class PlotFeature {
       plot._defining = value;
     }
   }
+  /**
+   * 获取禁用状态
+   *
+   * 当为 `true` 时，标绘实例将停止响应交互和更新；
+   * 为 `false` 时恢复正常功能。
+   */
   get disabled() {
     return this._disabled;
   }
@@ -423,64 +468,6 @@ class PlotFeature {
     this._skeletons = value;
   }
 }
-class PlotFeatureCollection {
-  constructor(options = {}) {
-    /**
-     * @internal
-     */
-    __publicField(this, "_id");
-    /**
-     * @internal
-     */
-    __publicField(this, "_isDestroyed");
-    const { id } = options;
-    this._id = id || cesium.createGuid();
-    this._isDestroyed = false;
-  }
-  get id() {
-    return this._id;
-  }
-  get collectionChanged() {
-    return this._collectionChanged;
-  }
-  get values() {
-    return Array.from(this._values);
-  }
-  add(value) {
-    if (this._isDestroyed) {
-      throw new Error(`PlotFeatureCollection is isDestroyed`);
-    }
-    return this._values.has(value) ? false : !!this._values.add(value);
-  }
-  remove(value) {
-    return this._values.delete(value);
-  }
-  get entities() {
-    return this._dataSource.entities;
-  }
-  get primitives() {
-    return this._primitives;
-  }
-  get groundPrimitives() {
-    return this._groundPrimitives;
-  }
-  get skeletons() {
-    return this._skeletonDataSource.entities;
-  }
-  isDestroyed() {
-    return this._isDestroyed;
-  }
-  destroy() {
-    if (!this._isDestroyed) {
-      this._viewer.dataSources.remove(this._dataSource);
-      this._viewer.dataSources.remove(this._skeletonDataSource);
-      this._viewer.scene.primitives.remove(this._primitives);
-      this._viewer.scene.groundPrimitives.remove(this._groundPrimitives);
-      this._viewer.dataSources.remove(this._skeletonDataSource);
-      this._isDestroyed = true;
-    }
-  }
-}
 var PlotAction = /* @__PURE__ */ ((PlotAction2) => {
   PlotAction2[PlotAction2["IDLE"] = 0] = "IDLE";
   PlotAction2[PlotAction2["HOVER"] = 1] = "HOVER";
@@ -627,7 +614,7 @@ function useSampled(current, getCurrentTime) {
       if (!position) {
         return;
       }
-      const completed = (_a = scheme.forceComplete) == null ? void 0 : _a.call(scheme, packable.value);
+      const completed = (_a = scheme.allowManualComplete) == null ? void 0 : _a.call(scheme, packable.value);
       completed && PlotFeature.setDefining(current.value, false);
     }
   );
@@ -863,8 +850,8 @@ function usePlot(options) {
   const time = (options == null ? void 0 : options.time) || vue.shallowRef();
   const viewer = vesium.useViewer();
   const getCurrentTime = () => {
-    var _a, _b, _c;
-    return ((_a = time.value) == null ? void 0 : _a.clone()) || ((_c = (_b = viewer.value) == null ? void 0 : _b.clock.currentTime) == null ? void 0 : _c.clone()) || cesium.JulianDate.now();
+    var _a;
+    return ((_a = time.value) == null ? void 0 : _a.clone()) || new cesium.JulianDate(0, 0);
   };
   const collection = vue.shallowReactive(/* @__PURE__ */ new Set());
   const plots = vue.computed(() => Array.from(collection));
@@ -904,7 +891,7 @@ function usePlot(options) {
     if (previous) {
       if (previous.defining) {
         const packable2 = previous.sampled.getValue(getCurrentTime());
-        const completed = (_b = (_a = previous.scheme).forceComplete) == null ? void 0 : _b.call(_a, packable2);
+        const completed = (_b = (_a = previous.scheme).allowManualComplete) == null ? void 0 : _b.call(_a, packable2);
         if (completed) {
           PlotFeature.setDefining(previous, false);
           operateResolve == null ? void 0 : operateResolve(previous);
@@ -1250,7 +1237,7 @@ async function area(positions, options) {
 }
 const schemeMeasureArea = new PlotScheme({
   type: "measureArea",
-  forceComplete: (packable) => packable.positions.length >= 3,
+  allowManualComplete: (packable) => packable.positions.length >= 3,
   skeletons: [
     control,
     interval
@@ -1362,7 +1349,7 @@ const schemeLabel = new PlotScheme({
 });
 const schemePolygon = new PlotScheme({
   type: "polygon",
-  forceComplete: (packable) => packable.positions.length >= 3,
+  allowManualComplete: (packable) => packable.positions.length >= 3,
   skeletons: [
     control,
     interval,
@@ -1412,7 +1399,7 @@ const schemePolygon = new PlotScheme({
 const schemePolyline = new PlotScheme(
   {
     type: "polyline",
-    forceComplete: (packable) => packable.positions.length >= 2,
+    allowManualComplete: (packable) => packable.positions.length >= 2,
     skeletons: [
       control,
       intervalNonclosed,
@@ -1472,7 +1459,6 @@ const schemeRectangle = new PlotScheme({
 });
 exports.PlotAction = PlotAction;
 exports.PlotFeature = PlotFeature;
-exports.PlotFeatureCollection = PlotFeatureCollection;
 exports.PlotScheme = PlotScheme;
 exports.PlotSkeletonEntity = PlotSkeletonEntity;
 exports.SampledPlotProperty = SampledPlotProperty;