leiting-bim 2.1.133 → 2.1.136

package/plugins/cesium-core/dist/components/HtmlOverlayLabelPool.d.ts

@@ -52,6 +52,24 @@ export { LabelOptions, LabelInstance, ThemeOptions };
  * 自定义事件与 DOM 事件的映射
  */
 export declare const DOM_EVENT_MAP: Record<MarkerEventKey, keyof HTMLElementEventMap>;
+interface OcclusionOptions {
+    enabled: boolean;
+    throttleMs: number;
+    distanceEpsilon: number;
+}
+type OcclusionCheckReason = 'label-missing' | 'invalid-coordinate' | 'screen-position-undefined' | 'runtime-missing' | 'pick-unsupported' | 'pick-empty' | 'pick-error' | 'distance-compare';
+interface OcclusionCheckLog {
+    timestamp: number;
+    id: string;
+    lon?: number;
+    lat?: number;
+    height?: number;
+    occluded: boolean;
+    reason: OcclusionCheckReason;
+    epsilon?: number;
+    labelDistance?: number;
+    pickedDistance?: number;
+}
 /**
  * 用于管理 Cesium HTML 标签的池，支持主题渲染、事件分发、动态更新等功能
  */
@@ -61,8 +79,18 @@ export declare class HtmlOverlayLabelPool {
     private container;
     private labels;
     private activeIds;
+    private occludedIds;
     private _updateFn;
+    private _cameraChangedFn;
     private themes;
+    occlusionCheckLogs: OcclusionCheckLog[];
+    private occlusionLogEnabled;
+    private occlusionLogMax;
+    private occlusionOptions;
+    private _occlusionTimer;
+    private _lastOcclusionAt;
+    private _occlusionChecking;
+    private _occlusionPending;
     eventBus: MarkerEventBus;
     openWheel: boolean;
     /**
@@ -152,6 +180,14 @@ export declare class HtmlOverlayLabelPool {
      * 每帧刷新所有活跃标签的位置
      */
     private _update;
+    private _scheduleOcclusionCheck;
+    private _pushOcclusionLog;
+    private _computeLabelOccluded;
+    runOcclusionCheckNow(): void;
+    setOcclusionEnabled(enabled: boolean): void;
+    getOcclusionOptions(): OcclusionOptions;
+    setOcclusionOptions(options: Partial<Pick<OcclusionOptions, 'throttleMs' | 'distanceEpsilon'>>): void;
+    setOcclusionLogEnabled(enabled: boolean, clearExisting?: boolean): void;
     /**
      * 销毁标签池，清理监听器和 DOM
      */

package/plugins/cesium-core/dist/components/draw/handlers/LineDrawer.d.ts

@@ -8,6 +8,7 @@ export default class LineDrawer implements IDrawer {
     private tooltip;
     private tempPoints;
     constructor(Cesium: any, viewer: any);
+    private getPickPosition;
     startDrawing(options: DrawOptions): void;
     stopDrawing(): void;
     clear(): void;

package/plugins/cesium-core/dist/components/draw/handlers/PolygonDrawer.d.ts

@@ -8,6 +8,7 @@ export default class PolygonDrawer implements IDrawer {
     private tooltip;
     private tempPoints;
     constructor(Cesium: any, viewer: any);
+    private getPickPosition;
     startDrawing(options: DrawOptions): void;
     stopDrawing(): void;
     clear(): void;

package/plugins/cesium-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leiting-bim/plugins-methods",
-  "version": "0.0.3",
+  "version": "1.1.1",
   "main": "dist/cesium-core.umd.js",
   "module": "dist/cesium-core.mjs",
   "types": "dist/index.d.ts",

package/plugins/cesium-vue/dist/HtmlOverlayLabelPool-CbiNlyAM.js

@@ -0,0 +1,510 @@
+var m = /* @__PURE__ */ ((h) => (h.Click = "marker:click", h.DoubleClick = "marker:dblclick", h.RightClick = "marker:rightclick", h.MouseEnter = "marker:mouseenter", h.MouseLeave = "marker:mouseleave", h.MouseDown = "marker:mousedown", h.MouseUp = "marker:mouseup", h))(m || {});
+class _ {
+  listenerMap = /* @__PURE__ */ new Map();
+  /**
+   * 添加监听器
+   * @param key 事件 key
+   * @param listener 监听器项
+   * @param overwrite 是否覆盖同名监听器
+   * @returns 是否成功添加
+   */
+  addListener(e, t, s = !1) {
+    let i = this.listenerMap.get(e);
+    return i || (i = /* @__PURE__ */ new Map(), this.listenerMap.set(e, i)), i.has(t.name) ? s ? (console.warn(
+      `[MarkerEventBus] Overwriting listener "${t.name}" for event "${e}".`
+    ), i.set(t.name, t), !0) : (console.warn(
+      `[MarkerEventBus] Listener "${t.name}" for event "${e}" already exists. Use overwrite=true to replace it.`
+    ), !1) : (i.set(t.name, t), !0);
+  }
+  /**
+   * 移除某个 key 的所有监听器
+   */
+  removeListenerByKey(e) {
+    const t = this.listenerMap.has(e);
+    return this.listenerMap.set(e, /* @__PURE__ */ new Map()), t;
+  }
+  /**
+   * 移除某个 key 下的指定名字的监听器
+   */
+  removeListenerByKeyAndName(e, t) {
+    const s = this.listenerMap.get(e);
+    return s ? s.delete(t) : !1;
+  }
+  /**
+   * 运行监听器
+   */
+  runListener(e, t, s) {
+    const i = this.listenerMap.get(e);
+    if (i)
+      for (const [o, l] of i.entries()) {
+        try {
+          l.fn(t, s);
+        } catch (n) {
+          console.error(`Error in listener "${o}" for event "${e}":`, n);
+        }
+        l.once && i.delete(o);
+      }
+  }
+}
+const O = {
+  [m.Click]: "click",
+  [m.DoubleClick]: "dblclick",
+  [m.RightClick]: "contextmenu",
+  [m.MouseEnter]: "mouseenter",
+  [m.MouseLeave]: "mouseleave",
+  [m.MouseDown]: "mousedown",
+  [m.MouseUp]: "mouseup"
+};
+class L {
+  viewer;
+  Cesium;
+  container;
+  labels = /* @__PURE__ */ new Map();
+  activeIds = /* @__PURE__ */ new Set();
+  occludedIds = /* @__PURE__ */ new Set();
+  _updateFn;
+  _cameraChangedFn;
+  themes = {};
+  occlusionCheckLogs = [];
+  occlusionLogEnabled = !1;
+  occlusionLogMax = 1e4;
+  occlusionOptions = {
+    enabled: !1,
+    throttleMs: 120,
+    distanceEpsilon: 1
+  };
+  _occlusionTimer = null;
+  _lastOcclusionAt = 0;
+  _occlusionChecking = !1;
+  _occlusionPending = !1;
+  eventBus;
+  openWheel = !0;
+  /**
+   * 构造函数
+   * @param Cesium Cesium 命名空间
+   * @param viewer Cesium Viewer 实例
+   * @param containerId HTML 容器 ID（默认："html-label-container"）
+   * @param eventBus 可选：自定义事件总线
+   */
+  constructor(e, t, s = "html-label-container", i, o = !0) {
+    this.Cesium = e, this.viewer = t, this.container = this._createContainer(s), this._updateFn = this._update.bind(this), this.viewer.scene.postRender.addEventListener(this._updateFn), this._cameraChangedFn = this._scheduleOcclusionCheck.bind(this), this.viewer.camera.changed.addEventListener(this._cameraChangedFn), this.eventBus = i || new _(), this.openWheel = o, this.runOcclusionCheckNow();
+  }
+  /**
+   * 创建标签容器
+   */
+  _createContainer(e) {
+    let t = document.getElementById(e);
+    return t || (t = document.createElement("div"), t.id = e, Object.assign(t.style, {
+      position: "absolute",
+      top: "0",
+      left: "0",
+      pointerEvents: "none",
+      width: "100%",
+      height: "100%",
+      zIndex: "100",
+      overflow: "hidden"
+    }), document.body.appendChild(t)), t;
+  }
+  /**
+   * 注册标签主题
+   */
+  registerTheme(e, t) {
+    this.themes[e] = t;
+  }
+  /**
+   * 添加单个标签
+   */
+  add(e, t) {
+    const {
+      id: s,
+      lon: i,
+      lat: o,
+      height: l = 0,
+      theme: n,
+      show: a = !0,
+      notCreateElement: r = !1,
+      style: f
+    } = t, u = this.themes[n];
+    if (!u) {
+      console.warn(`Theme "${n}" not registered`);
+      return;
+    }
+    let c = this.labels.get(s);
+    if (c) {
+      c.theme = n, c.data = e, c.notCreateElement = r;
+      try {
+        c.unload = u.createElement(c.el, { id: s, theme: n, data: e }, u), (!r || a) && this.container.appendChild(c.el);
+      } catch (d) {
+        console.error(`Error updating label element for id "${s}":`, d);
+      }
+    } else {
+      const d = document.createElement("div");
+      Object.assign(d.style, {
+        position: "absolute",
+        transform: "translate(0, 0)",
+        pointerEvents: "auto",
+        ...t.style || {}
+      });
+      for (const [C, v] of Object.entries(O)) {
+        d.addEventListener(v, (g) => {
+          g.stopPropagation();
+          const b = this.labels.get(s);
+          this.eventBus.runListener(C, b, g);
+        });
+        let w = 0;
+        d.addEventListener("wheel", (g) => {
+          if (!this.openWheel) return;
+          const b = g.currentTarget;
+          w = Date.now();
+          const y = w;
+          b.style.pointerEvents = "none", setTimeout(() => {
+            w === y && (b.style.pointerEvents = "auto");
+          }, 2e3);
+        });
+      }
+      let p = null;
+      if (!r || a) {
+        try {
+          p = u.createElement(d, { id: s, theme: n, data: e }, u) || {};
+        } catch (C) {
+          console.error(`Error updating label element for id "${s}":`, C);
+        }
+        this.container.appendChild(d);
+      }
+      c = { id: s, el: d, theme: n, data: e, notCreateElement: r, unload: p }, this.labels.set(s, c);
+    }
+    c.el.dataset.lon = String(i), c.el.dataset.lat = String(o), c.el.dataset.height = String(l), c.el.style.zIndex = f?.zIndex || "1", c.el.style.display = a ? "block" : "none", a && this.activeIds.add(s), a ? this._scheduleOcclusionCheck() : this.occludedIds.delete(s);
+  }
+  /**
+   * 批量添加标签
+   */
+  addBatch(e) {
+    for (const { data: t, options: s } of e)
+      this.add(t, s);
+  }
+  /**
+   * 根据 ID 批量移除标签
+   */
+  removeByIds(e) {
+    for (const t of e) {
+      const s = this.labels.get(t);
+      s && (this.unloadByLabel(s), this.labels.delete(t), this.activeIds.delete(t), this.occludedIds.delete(t));
+    }
+  }
+  unloadByLabel(e) {
+    e.el.remove(), e?.unload && typeof e.unload == "function" && e?.unload(), e.unload = null;
+  }
+  /**
+   * 移除所有标签
+   */
+  removeAll() {
+    for (const e of this.labels.values())
+      this.unloadByLabel(e);
+    this.labels.clear(), this.activeIds.clear(), this.occludedIds.clear();
+  }
+  /**
+   * 更新标签的数据并刷新内容
+   */
+  update(e, t) {
+    const s = this.labels.get(e);
+    if (!s) {
+      console.warn(`Label with id "${e}" not found for update.`);
+      return;
+    }
+    const i = this.themes[s.theme];
+    if (!i) {
+      console.warn(`Theme "${s.theme}" not registered.`);
+      return;
+    }
+    try {
+      i.createElement(s.el, { id: e, theme: s.theme, data: t }, i);
+    } catch (o) {
+      console.error(`Failed to update label "${e}":`, o);
+    }
+  }
+  /**
+   * 根据 ID 批量隐藏标签
+   */
+  hideByIds(e) {
+    for (const t of e) {
+      const s = this.labels.get(t);
+      s && (s.notCreateElement && this.unloadByLabel(s), s.el.style.display = "none", this.activeIds.delete(t), this.occludedIds.delete(t));
+    }
+  }
+  /**
+   * 隐藏所有标签
+   */
+  hideAll() {
+    for (const e of this.labels.values())
+      e.notCreateElement && this.unloadByLabel(e), e.el.style.display = "none", this.activeIds.delete(e.id), this.occludedIds.delete(e.id);
+  }
+  /**
+   * 条件过滤隐藏标签
+   */
+  hideFilter(e) {
+    for (const t of this.labels.values())
+      e(t.data) && (t.notCreateElement && this.unloadByLabel(t), t.el.style.display = "none", this.activeIds.delete(t.id), this.occludedIds.delete(t.id));
+  }
+  /**
+   * 根据 ID 显示标签
+   */
+  showByIds(e) {
+    for (const t of e) {
+      const s = this.labels.get(t);
+      if (s) {
+        if ((s.notCreateElement || !s.el.parentNode) && this.container.appendChild(s.el), !s.unload)
+          try {
+            const i = this.themes[s.theme];
+            if (!i) {
+              console.warn(`Theme "${s.theme}" not registered`);
+              return;
+            }
+            s.unload = i.createElement(
+              s.el,
+              { id: t, theme: s.theme, data: s.data },
+              i
+            ) || {};
+          } catch (i) {
+            console.error(`Error creating label element for theme "${s.theme}":`, i);
+            return;
+          }
+        s.el.style.display = "block", this.activeIds.add(t), this.occludedIds.delete(t);
+      }
+    }
+    this._scheduleOcclusionCheck();
+  }
+  /**
+   * 检查标签是否存在
+   */
+  has(e) {
+    return this.labels.has(e);
+  }
+  /**
+   * 清空活跃 ID 列表（不影响 DOM）
+   */
+  reset() {
+    for (const e of this.activeIds.values()) {
+      let t = this.labels.get(e);
+      t && this.unloadByLabel(t);
+    }
+    this.activeIds.clear();
+  }
+  /**
+   * 清理当前未活跃的标签（隐藏而不移除 DOM）
+   */
+  cleanup() {
+    for (const [e, t] of this.labels.entries())
+      this.activeIds.has(e) || (t.el.style.display = "none", this.occludedIds.delete(e));
+  }
+  /**
+   * 经纬度 -> 自动地形高度修正 -> Cartesian3 -> 屏幕坐标
+   */
+  async toWindowPositionByLonLat(e, t) {
+    const s = this.Cesium, i = this.viewer.scene, o = [s.Cartographic.fromDegrees(e, t)];
+    let l;
+    try {
+      l = await i.clampToHeightMostDetailed(o);
+    } catch {
+      console.warn("clampToHeightMostDetailed failed, fallback to ellipsoid height.");
+    }
+    let n = 0;
+    l && l[0] && l[0].height != null ? n = l[0].height : n = 0;
+    const a = s.Cartesian3.fromDegrees(e, t, n);
+    return this.toWindowCoordinates(a);
+  }
+  /**
+   * 坐标转换：经纬度 -> 屏幕像素坐标
+   */
+  toWindowCoordinates(e) {
+    const t = this.viewer.scene, s = this.Cesium.SceneTransforms;
+    if (typeof s?.wgs84ToWindowCoordinates == "function")
+      return s.wgs84ToWindowCoordinates(t, e);
+    if (typeof s?.worldToWindowCoordinates == "function")
+      return s.worldToWindowCoordinates(t, e);
+    console.warn("No compatible window coordinate transform function found.");
+  }
+  /**
+   * 检查经纬度是否有效
+   * @param lon 经度
+   * @param lat 纬度
+   * @returns 是否有效
+   */
+  _isValidCoordinate(e, t) {
+    return !(Number.isNaN(e) || Number.isNaN(t) || e === 0 && t === 0 || e < -180 || e > 180 || t < -90 || t > 90);
+  }
+  /**
+   * 每帧刷新所有活跃标签的位置
+   */
+  async _update() {
+    for (const e of this.activeIds) {
+      const t = this.labels.get(e);
+      if (!t) continue;
+      const s = parseFloat(t.el.dataset.lon), i = parseFloat(t.el.dataset.lat), o = parseFloat(t.el.dataset.height || "0");
+      if (!this._isValidCoordinate(s, i)) {
+        t.el.style.display = "none";
+        continue;
+      }
+      const l = this.Cesium.Cartesian3.fromDegrees(s, i, o), n = this.toWindowCoordinates(l);
+      if (this.Cesium.defined(n)) {
+        const r = this.themes[t.theme].options?.offset || {}, f = r.x || 0, u = r.y || 0, c = this.occludedIds.has(e);
+        t.el.style.left = `${n.x}px`, t.el.style.top = `${n.y}px`, t.el.style.transform = `translate(${f}px, ${u}px)`, t.el.style.display = c ? "none" : "block";
+      } else
+        t.el.style.display = "none";
+    }
+  }
+  _scheduleOcclusionCheck() {
+    if (!this.occlusionOptions.enabled) return;
+    const e = Date.now(), t = Math.max(0, Number(this.occlusionOptions.throttleMs) || 0), s = e - this._lastOcclusionAt, i = Math.max(0, t - s);
+    if (i === 0) {
+      this.runOcclusionCheckNow();
+      return;
+    }
+    this._occlusionTimer === null && (this._occlusionTimer = window.setTimeout(() => {
+      this._occlusionTimer = null, this.runOcclusionCheckNow();
+    }, i));
+  }
+  _pushOcclusionLog(e) {
+    this.occlusionLogEnabled && (this.occlusionCheckLogs.push(e), this.occlusionCheckLogs.length > this.occlusionLogMax && this.occlusionCheckLogs.splice(0, this.occlusionCheckLogs.length - this.occlusionLogMax));
+  }
+  _computeLabelOccluded(e, t, s, i, o, l) {
+    const n = this.viewer?.scene, a = this.viewer?.camera, r = this.Cesium;
+    if (!n || !a || !r)
+      return this._pushOcclusionLog({
+        timestamp: Date.now(),
+        id: e,
+        lon: i,
+        lat: o,
+        height: l,
+        occluded: !0,
+        reason: "runtime-missing"
+      }), !0;
+    if (!n.pickPositionSupported || !s)
+      return this._pushOcclusionLog({
+        timestamp: Date.now(),
+        id: e,
+        lon: i,
+        lat: o,
+        height: l,
+        occluded: !0,
+        reason: "pick-unsupported"
+      }), !0;
+    try {
+      const f = n.pickPosition(s);
+      if (!f || !a.positionWC)
+        return this._pushOcclusionLog({
+          timestamp: Date.now(),
+          id: e,
+          lon: i,
+          lat: o,
+          height: l,
+          occluded: !0,
+          reason: "pick-empty"
+        }), !0;
+      const u = Number(this.occlusionOptions.distanceEpsilon) || 0, c = r.Cartesian3.distance(a.positionWC, t), d = r.Cartesian3.distance(a.positionWC, f), p = d + u < c;
+      return this._pushOcclusionLog({
+        timestamp: Date.now(),
+        id: e,
+        lon: i,
+        lat: o,
+        height: l,
+        occluded: p,
+        reason: "distance-compare",
+        epsilon: u,
+        labelDistance: c,
+        pickedDistance: d
+      }), p;
+    } catch {
+      return this._pushOcclusionLog({
+        timestamp: Date.now(),
+        id: e,
+        lon: i,
+        lat: o,
+        height: l,
+        occluded: !0,
+        reason: "pick-error"
+      }), !0;
+    }
+  }
+  runOcclusionCheckNow() {
+    if (!this.occlusionOptions.enabled) {
+      this.occludedIds.clear();
+      return;
+    }
+    if (this._occlusionChecking) {
+      this._occlusionPending = !0;
+      return;
+    }
+    this._occlusionChecking = !0;
+    try {
+      for (const e of this.activeIds) {
+        const t = this.labels.get(e);
+        if (!t) {
+          this.occludedIds.delete(e), this._pushOcclusionLog({
+            timestamp: Date.now(),
+            id: e,
+            occluded: !1,
+            reason: "label-missing"
+          });
+          continue;
+        }
+        const s = parseFloat(t.el.dataset.lon), i = parseFloat(t.el.dataset.lat), o = parseFloat(t.el.dataset.height || "0");
+        if (!this._isValidCoordinate(s, i)) {
+          this.occludedIds.delete(e), this._pushOcclusionLog({
+            timestamp: Date.now(),
+            id: e,
+            lon: s,
+            lat: i,
+            height: o,
+            occluded: !1,
+            reason: "invalid-coordinate"
+          });
+          continue;
+        }
+        const l = this.Cesium.Cartesian3.fromDegrees(s, i, o), n = this.toWindowCoordinates(l);
+        if (!this.Cesium.defined(n)) {
+          this.occludedIds.delete(e), this._pushOcclusionLog({
+            timestamp: Date.now(),
+            id: e,
+            lon: s,
+            lat: i,
+            height: o,
+            occluded: !1,
+            reason: "screen-position-undefined"
+          });
+          continue;
+        }
+        this._computeLabelOccluded(e, l, n, s, i, o) ? this.occludedIds.add(e) : this.occludedIds.delete(e);
+      }
+    } finally {
+      this._lastOcclusionAt = Date.now(), this._occlusionChecking = !1, this._occlusionPending && (this._occlusionPending = !1, this._scheduleOcclusionCheck());
+    }
+  }
+  setOcclusionEnabled(e) {
+    this.occlusionOptions.enabled = !!e, this.occlusionOptions.enabled ? this.runOcclusionCheckNow() : (this.occludedIds.clear(), this._occlusionTimer !== null && (clearTimeout(this._occlusionTimer), this._occlusionTimer = null));
+  }
+  getOcclusionOptions() {
+    return {
+      enabled: this.occlusionOptions.enabled,
+      throttleMs: this.occlusionOptions.throttleMs,
+      distanceEpsilon: this.occlusionOptions.distanceEpsilon
+    };
+  }
+  setOcclusionOptions(e) {
+    e.throttleMs != null && (this.occlusionOptions.throttleMs = Math.max(0, Number(e.throttleMs) || 0)), e.distanceEpsilon != null && (this.occlusionOptions.distanceEpsilon = Math.max(0, Number(e.distanceEpsilon) || 0)), this.occlusionOptions.enabled && this._scheduleOcclusionCheck();
+  }
+  setOcclusionLogEnabled(e, t = !1) {
+    this.occlusionLogEnabled = !!e, t && (this.occlusionCheckLogs = []);
+  }
+  /**
+   * 销毁标签池，清理监听器和 DOM
+   */
+  destroy() {
+    this.viewer.scene.postRender.removeEventListener(this._updateFn), this.viewer.camera.changed.removeEventListener(this._cameraChangedFn), this._occlusionTimer !== null && (clearTimeout(this._occlusionTimer), this._occlusionTimer = null), this.labels.clear(), this.activeIds.clear(), this.occludedIds.clear();
+  }
+}
+export {
+  L as H,
+  m as M,
+  _ as a
+};
+//# sourceMappingURL=HtmlOverlayLabelPool-CbiNlyAM.js.map