deeptwins-engine-3d 0.1.39 → 0.1.40

package/dist/esm/deepTwins/index.d.ts

@@ -2,10 +2,11 @@ export default class DeepTwins {
     private _isLoaded;
     private _loadEvent;
     private _YunJing;
+    private _YunjingCesiumPlugins;
     constructor();
     private _init;
     private isLoaded;
-    private onLoad;
+    onLoad(fun: any): void;
     _getBaseLayer(): any;
     _getTerrain(type: string): any;
     _getModuleLayer(options: any): {

package/dist/esm/deepTwins/index.js

@@ -17,13 +17,14 @@ var DeepTwins = /*#__PURE__*/function () {
     _defineProperty(this, "_isLoaded", false);
     _defineProperty(this, "_loadEvent", []);
     _defineProperty(this, "_YunJing", void 0);
+    _defineProperty(this, "_YunjingCesiumPlugins", void 0);
     this._init();
   }
   _createClass(DeepTwins, [{
     key: "_init",
     value: function () {
       var _init2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
-        var i, loadFun;
+        var i, _this$_YunjingCesiumP, loadFun;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
@@ -31,6 +32,22 @@ var DeepTwins = /*#__PURE__*/function () {
               return utils.loadUMDModule(utils.getDeepTwinsFile('YunJing/yunjing-for-cesium.js'), 'YunJing');
             case 2:
               this._YunJing = _context.sent;
+              _context.prev = 3;
+              _context.next = 6;
+              return utils.loadUMDModule(utils.getDeepTwinsFile('YunJing/yunjing-cesium-plugins.min.js'), 'YunjingCesiumPlugins');
+            case 6:
+              this._YunjingCesiumPlugins = _context.sent;
+              _context.next = 13;
+              break;
+            case 9:
+              _context.prev = 9;
+              _context.t0 = _context["catch"](3);
+              // 如果加载失败，尝试从 window 获取（可能已经通过其他方式加载）
+              this._YunjingCesiumPlugins = window.YunjingCesiumPlugins;
+              if (!this._YunjingCesiumPlugins) {
+                console.warn('DeepTwins: 无法加载 YunjingCesiumPlugins，GridVTLayer 可能不可用');
+              }
+            case 13:
               this._isLoaded = true;
               for (i = 0; i < this._loadEvent.length; i++) {
                 loadFun = this._loadEvent[i];
@@ -40,14 +57,15 @@ var DeepTwins = /*#__PURE__*/function () {
                   moduleLayer: this._getModuleLayer.bind(this),
                   trafficHistoryLayer: this._YunJing.TrafficHistoryLayer,
                   trafficLayer: this._YunJing.TrafficLayer,
-                  gridVTLayer: this._YunJing.GridVTLayer
+                  // 优先从 YunjingCesiumPlugins 获取 GridVTLayer（与示例代码一致）
+                  gridVTLayer: (_this$_YunjingCesiumP = this._YunjingCesiumPlugins) === null || _this$_YunjingCesiumP === void 0 ? void 0 : _this$_YunjingCesiumP.GridVTLayer
                 });
               }
-            case 5:
+            case 15:
             case "end":
               return _context.stop();
           }
-        }, _callee, this);
+        }, _callee, this, [[3, 9]]);
       }));
       function _init() {
         return _init2.apply(this, arguments);

package/dist/esm/index.d.ts

@@ -7,6 +7,7 @@ export declare class DeepTwinsEngine3D {
     static WmsLayer: any;
     static WmtsLayer: any;
     static ArcGisLayer: any;
+    static BarrierLayer: any;
     static DeepTwins: any;
     static WeatherEffects: any;
     static Drawer: any;

package/dist/esm/index.js

@@ -31,6 +31,7 @@ import ImageGlowingMaterialAppearance from "./material/primitive/ImageGlowingMat
 import Measure from "./measure";
 import PositionProperty from "./property/PositionProperty";
 import ArcGisLayer from "./tileLayer/ArcGisLayer";
+import BarrierLayer from "./tileLayer/BarrierLayer";
 import RasterLayer from "./tileLayer/RasterLayer";
 import WmsLayer from "./tileLayer/WmsLayer";
 import WmtsLayer from "./tileLayer/WmtsLayer";
@@ -52,17 +53,18 @@ DEEP_TWINS_BASE_URL && (window.CESIUM_BASE_URL = DEEP_TWINS_BASE_URL);
 // 全局加载css
 loadCss(Cesium.buildModuleUrl('Widgets/widgets.css'));
 // 打印版本信息
-console.log('DeepTwinsEngine3D Version:', "0.1.39");
+console.log('DeepTwinsEngine3D Version:', "0.1.40");
 export var DeepTwinsEngine3D = /*#__PURE__*/_createClass(function DeepTwinsEngine3D() {
   _classCallCheck(this, DeepTwinsEngine3D);
 });
-_defineProperty(DeepTwinsEngine3D, "Version", "0.1.39");
+_defineProperty(DeepTwinsEngine3D, "Version", "0.1.40");
 _defineProperty(DeepTwinsEngine3D, "Map", Map);
 _defineProperty(DeepTwinsEngine3D, "GroundSkyBox", GroundSkyBox);
 _defineProperty(DeepTwinsEngine3D, "RasterLayer", RasterLayer);
 _defineProperty(DeepTwinsEngine3D, "WmsLayer", WmsLayer);
 _defineProperty(DeepTwinsEngine3D, "WmtsLayer", WmtsLayer);
 _defineProperty(DeepTwinsEngine3D, "ArcGisLayer", ArcGisLayer);
+_defineProperty(DeepTwinsEngine3D, "BarrierLayer", BarrierLayer);
 _defineProperty(DeepTwinsEngine3D, "DeepTwins", DeepTwins);
 _defineProperty(DeepTwinsEngine3D, "WeatherEffects", WeatherEffects);
 _defineProperty(DeepTwinsEngine3D, "Drawer", Drawer);

package/dist/esm/tileLayer/BarrierLayer.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 障碍物图层 - 基于MVT数据渲染障碍物网格
+ *
+ * 使用方式：
+ * ```js
+ * const DeepTwins = new DeepTwinsEngine3D.DeepTwins();
+ * DeepTwins.onLoad(async ({ gridVTLayer }) => {
+ *   const barrierLayer = new BarrierLayer(viewer, {
+ *     gridVTLayer: gridVTLayer,
+ *     url: 'https://...',
+ *   });
+ * });
+ * ```
+ */
+export default class BarrierLayer {
+    private _gridVTLayer;
+    private _viewer;
+    private _options;
+    private _heightColors;
+    private static readonly DEFAULT_HEIGHT_COLORS;
+    /**
+     * 创建障碍物图层
+     * @param viewer Cesium Viewer实例
+     * @param options 配置选项
+     * @param options.gridVTLayer GridVTLayer类（从DeepTwins.onLoad中获取）
+     * @param options.url MVT数据URL模板，默认为障碍物数据地址
+     * @param options.dataType 数据类型，默认为'barrier'
+     * @param options.zooms 缩放级别范围，默认[10, 22]
+     * @param options.dataZooms 数据缩放级别，默认[16, 16]
+     * @param options.cacheSize 缓存大小，默认20
+     * @param options.heightColors 高度颜色映射数组，默认使用内置颜色
+     * @param options.minHeight 最小高度（米），低于此高度的障碍物不渲染，默认0
+     * @param options.maxHeight 最大高度（米），高于此高度的障碍物不渲染，默认Infinity
+     */
+    constructor(viewer: any, options?: any);
+    /**
+     * 创建primitives
+     * 按照示例代码的逻辑实现，每个feature创建一个障碍物实例
+     */
+    private _createPrimitives;
+    /**
+     * 销毁primitives
+     */
+    private _destroyPrimitives;
+    /**
+     * 显示primitives
+     */
+    private _showPrimitives;
+    /**
+     * 隐藏primitives
+     */
+    private _hidePrimitives;
+    /**
+     * 更新primitives
+     */
+    private _updatePrimitives;
+    /**
+     * 显示图层
+     */
+    show(): void;
+    /**
+     * 隐藏图层
+     */
+    hide(): void;
+    /**
+     * 销毁图层
+     */
+    destroy(): void;
+    /**
+     * 获取底层GridVTLayer实例
+     */
+    getGridVTLayer(): any;
+}

package/dist/esm/tileLayer/BarrierLayer.js

@@ -0,0 +1,281 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import * as Cesium from 'deeptwins-cesium';
+
+/**
+ * 障碍物图层 - 基于MVT数据渲染障碍物网格
+ *
+ * 使用方式：
+ * ```js
+ * const DeepTwins = new DeepTwinsEngine3D.DeepTwins();
+ * DeepTwins.onLoad(async ({ gridVTLayer }) => {
+ *   const barrierLayer = new BarrierLayer(viewer, {
+ *     gridVTLayer: gridVTLayer,
+ *     url: 'https://...',
+ *   });
+ * });
+ * ```
+ */
+var BarrierLayer = /*#__PURE__*/function () {
+  /**
+   * 创建障碍物图层
+   * @param viewer Cesium Viewer实例
+   * @param options 配置选项
+   * @param options.gridVTLayer GridVTLayer类（从DeepTwins.onLoad中获取）
+   * @param options.url MVT数据URL模板，默认为障碍物数据地址
+   * @param options.dataType 数据类型，默认为'barrier'
+   * @param options.zooms 缩放级别范围，默认[10, 22]
+   * @param options.dataZooms 数据缩放级别，默认[16, 16]
+   * @param options.cacheSize 缓存大小，默认20
+   * @param options.heightColors 高度颜色映射数组，默认使用内置颜色
+   * @param options.minHeight 最小高度（米），低于此高度的障碍物不渲染，默认0
+   * @param options.maxHeight 最大高度（米），高于此高度的障碍物不渲染，默认Infinity
+   */
+  function BarrierLayer(viewer) {
+    var _this = this;
+    var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    _classCallCheck(this, BarrierLayer);
+    _defineProperty(this, "_gridVTLayer", null);
+    _defineProperty(this, "_viewer", null);
+    _defineProperty(this, "_options", {});
+    _defineProperty(this, "_heightColors", []);
+    this._viewer = viewer;
+    if (!options.gridVTLayer) {
+      console.error('BarrierLayer: 请提供gridVTLayer参数，可通过DeepTwins.onLoad获取');
+      return;
+    }
+    var GridVTLayer = options.gridVTLayer;
+
+    // 验证并设置 dataZooms
+    var dataZooms = options.dataZooms || [16, 16];
+    if (!Array.isArray(dataZooms) || dataZooms.length !== 2) {
+      console.warn('BarrierLayer: dataZooms 应该是 [minZoom, maxZoom] 格式的数组，使用默认值 [16, 16]');
+      dataZooms = [16, 16];
+    }
+
+    // 设置颜色配置
+    if (options.heightColors && Array.isArray(options.heightColors)) {
+      this._heightColors = options.heightColors;
+    } else {
+      this._heightColors = _toConsumableArray(BarrierLayer.DEFAULT_HEIGHT_COLORS);
+    }
+    this._options = _objectSpread({
+      url: options.url || 'https://amappc.oss-cn-zhangjiakou.aliyuncs.com/yunjing/data/dikong/barrier/mvt/{z}_{x}_{y}.mvt',
+      dataType: options.dataType || 'barrier',
+      zooms: options.zooms || [10, 22],
+      dataZooms: dataZooms,
+      cacheSize: options.cacheSize || 20,
+      minHeight: options.minHeight !== undefined ? options.minHeight : 0,
+      maxHeight: options.maxHeight !== undefined ? options.maxHeight : Infinity
+    }, options);
+
+    // 创建 GridVTLayer
+    var customPrimitiveCallbacks = {
+      createPrimitives: function createPrimitives(tileNum, renderData, viewer) {
+        var targetViewer = viewer || _this._viewer;
+        return _this._createPrimitives(tileNum, renderData, targetViewer);
+      },
+      destroyPrimitives: function destroyPrimitives(tileNum, primitives) {
+        return _this._destroyPrimitives(tileNum, primitives);
+      },
+      showPrimitives: function showPrimitives(tileNum, primitives) {
+        return _this._showPrimitives(tileNum, primitives);
+      },
+      hidePrimitives: function hidePrimitives(tileNum, primitives) {
+        return _this._hidePrimitives(tileNum, primitives);
+      },
+      updatePrimitives: function updatePrimitives(tileNum, primitives) {
+        return _this._updatePrimitives(tileNum, primitives);
+      }
+    };
+    this._gridVTLayer = new GridVTLayer({
+      viewer: this._viewer,
+      url: this._options.url,
+      cacheSize: this._options.cacheSize,
+      dataZooms: this._options.dataZooms,
+      zooms: this._options.zooms,
+      dataType: this._options.dataType,
+      customPrimitive: customPrimitiveCallbacks
+    });
+
+    // 默认显示图层
+    if (typeof this._gridVTLayer.show === 'function') {
+      this._gridVTLayer.show();
+    } else if (this._gridVTLayer.visible !== undefined) {
+      this._gridVTLayer.visible = true;
+    }
+  }
+
+  /**
+   * 创建primitives
+   * 按照示例代码的逻辑实现，每个feature创建一个障碍物实例
+   */
+  _createClass(BarrierLayer, [{
+    key: "_createPrimitives",
+    value: function _createPrimitives(tileNum, renderData, viewer) {
+      var features = (renderData === null || renderData === void 0 ? void 0 : renderData.default) || [];
+      var instances = [];
+      var minHeight = this._options.minHeight || 0;
+      var maxHeight = this._options.maxHeight !== undefined ? this._options.maxHeight : Infinity;
+      for (var i = 0; i < features.length; i++) {
+        var feature = features[i];
+        if (!feature || !feature.lnglat || !feature.gridSize) {
+          continue;
+        }
+        var lnglat = [feature.lnglat[0], feature.lnglat[1], feature.lnglat[2]];
+
+        // 根据高度范围过滤障碍物
+        var height = lnglat[2];
+        if (height < minHeight || height > maxHeight) {
+          continue;
+        }
+        var modelMatrix = Cesium.Matrix4.multiplyByTranslation(Cesium.Transforms.eastNorthUpToFixedFrame(Cesium.Cartesian3.fromDegrees(lnglat[0], lnglat[1], lnglat[2])), new Cesium.Cartesian3(0, 0, 0), new Cesium.Matrix4());
+
+        // 根据高度计算颜色索引
+        var colorIndex = Math.floor(feature.lnglat[2] / 7.66 / 3);
+        var clampedIndex = Math.max(0, Math.min(colorIndex, this._heightColors.length - 1));
+        var color = this._heightColors[clampedIndex] || '#d8daeb';
+        var instance = new Cesium.GeometryInstance({
+          geometry: Cesium.BoxGeometry.fromDimensions({
+            vertexFormat: Cesium.VertexFormat.POSITION_AND_NORMAL,
+            dimensions: new Cesium.Cartesian3(feature.gridSize[0], feature.gridSize[1], feature.gridSize[2])
+          }),
+          modelMatrix: modelMatrix,
+          attributes: {
+            color: Cesium.ColorGeometryInstanceAttribute.fromColor(Cesium.Color.fromCssColorString(color))
+          }
+        });
+        instances.push(instance);
+      }
+      var primitives = [];
+      if (instances.length > 0) {
+        var primitive = new Cesium.Primitive({
+          geometryInstances: instances,
+          appearance: new Cesium.PerInstanceColorAppearance({
+            translucent: false,
+            closed: true
+          })
+        });
+        var targetViewer = viewer || this._viewer;
+        targetViewer.scene.primitives.add(primitive);
+        primitives.push(primitive);
+      }
+      return primitives;
+    }
+
+    /**
+     * 销毁primitives
+     */
+  }, {
+    key: "_destroyPrimitives",
+    value: function _destroyPrimitives(tileNum, primitives) {
+      var _this2 = this;
+      if (!(primitives !== null && primitives !== void 0 && primitives.length)) return;
+      primitives.forEach(function (primitive) {
+        primitive.show = false;
+        _this2._viewer.scene.primitives.remove(primitive);
+        primitive.destroy();
+      });
+      primitives.length = 0;
+    }
+
+    /**
+     * 显示primitives
+     */
+  }, {
+    key: "_showPrimitives",
+    value: function _showPrimitives(tileNum, primitives) {
+      primitives.forEach(function (primitive) {
+        if (primitive) {
+          primitive.show = true;
+        }
+      });
+    }
+
+    /**
+     * 隐藏primitives
+     */
+  }, {
+    key: "_hidePrimitives",
+    value: function _hidePrimitives(tileNum, primitives) {
+      primitives.forEach(function (primitive) {
+        primitive.show = false;
+      });
+    }
+
+    /**
+     * 更新primitives
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  }, {
+    key: "_updatePrimitives",
+    value: function _updatePrimitives(_tileNum, _primitives) {
+      // 预留接口，可根据需要实现更新逻辑
+    }
+
+    /**
+     * 显示图层
+     */
+  }, {
+    key: "show",
+    value: function show() {
+      if (this._gridVTLayer) {
+        if (typeof this._gridVTLayer.show === 'function') {
+          this._gridVTLayer.show();
+        } else if (this._gridVTLayer.visible !== undefined) {
+          this._gridVTLayer.visible = true;
+        }
+      }
+    }
+
+    /**
+     * 隐藏图层
+     */
+  }, {
+    key: "hide",
+    value: function hide() {
+      if (this._gridVTLayer) {
+        this._gridVTLayer.hide();
+      }
+    }
+
+    /**
+     * 销毁图层
+     */
+  }, {
+    key: "destroy",
+    value: function destroy() {
+      if (this._gridVTLayer) {
+        var _this$_gridVTLayer$de, _this$_gridVTLayer;
+        (_this$_gridVTLayer$de = (_this$_gridVTLayer = this._gridVTLayer).destroy) === null || _this$_gridVTLayer$de === void 0 || _this$_gridVTLayer$de.call(_this$_gridVTLayer);
+        this._gridVTLayer = null;
+      }
+    }
+
+    /**
+     * 获取底层GridVTLayer实例
+     */
+  }, {
+    key: "getGridVTLayer",
+    value: function getGridVTLayer() {
+      return this._gridVTLayer;
+    }
+  }]);
+  return BarrierLayer;
+}();
+// 默认高度颜色映射（从低到高）
+_defineProperty(BarrierLayer, "DEFAULT_HEIGHT_COLORS", ['#9e0142', '#d53e4f', '#f46d43', '#fdae61', '#fee08b', '#ffffbf', '#e6f598', '#abdda4', '#66c2a5', '#3288bd', '#5e4fa2'].reverse());
+export { BarrierLayer as default };