deeptwins-engine-3d 0.1.47 → 0.1.49

package/dist/esm/material/primitive/ImageMaterialAppearance.js

@@ -0,0 +1,77 @@
+var _excluded = ["color"];
+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 _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+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 _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 _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+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';
+import { cloneDeep, merge } from 'lodash';
+import { DEFAULT_IMAGE_MATERIAL_STYLE, DEFAULT_MATERIAL_APPEARANCE } from "../../constant";
+import * as utils from "../../tool/utils";
+/* babel-plugin-inline-import '../shader/ImageShader.glsl' */
+var ImageShader = "uniform sampler2D image;\nuniform vec4 color;\nuniform float mixRatio;\n\nczm_material czm_getMaterial(czm_materialInput materialInput) {\n    czm_material material = czm_getDefaultMaterial(materialInput);\n    vec2 st = materialInput.st;\n\n    // \u91C7\u6837\u56FE\u7247\n    vec4 texColor = texture(image, st);\n\n    // \u989C\u8272\u6DF7\u5408\uFF1Amix(\u539F\u59CB\u989C\u8272, \u76EE\u6807\u989C\u8272, mixRatio)\n    vec3 mixedColor = mix(texColor.rgb, texColor.rgb * color.rgb, mixRatio);\n\n    // \u53D1\u5149\u589E\u5F3A\n    material.diffuse = mixedColor * 2.0;\n\n    // \u900F\u660E\u5EA6\u968F\u989C\u8272\u53D8\u5316\n    material.alpha = texColor.a * mix(color.a, 1.0, 1.0 - mixRatio);\n\n    return material;\n}\n";
+import BaseMaterialAppearance from "./BaseMaterialAppearance";
+
+// 图片材质 适用于primitive
+var ImageMaterialAppearance = /*#__PURE__*/function (_BaseMaterialAppearan) {
+  _inherits(ImageMaterialAppearance, _BaseMaterialAppearan);
+  var _super = _createSuper(ImageMaterialAppearance);
+  function ImageMaterialAppearance(material, appearance) {
+    var _this;
+    _classCallCheck(this, ImageMaterialAppearance);
+    var mergeMaterial = merge(DEFAULT_IMAGE_MATERIAL_STYLE(), cloneDeep(material || {}));
+    _this = _super.call(this, 'ImageMaterialAsset', mergeMaterial);
+    _defineProperty(_assertThisInitialized(_this), "currMaterial", void 0);
+    _defineProperty(_assertThisInitialized(_this), "currAppearance", void 0);
+    _this.currMaterial = ImageMaterialAppearance.handleMaterial(mergeMaterial);
+    _this.currAppearance = merge(DEFAULT_MATERIAL_APPEARANCE(), appearance || {});
+    _this._createMaterial();
+    return _this;
+  }
+
+  // 处理参数
+  _createClass(ImageMaterialAppearance, [{
+    key: "_createMaterial",
+    value: function _createMaterial() {
+      this.material = new Cesium.Material({
+        fabric: {
+          type: this.type,
+          uniforms: _objectSpread({}, this.currMaterial),
+          source: ImageShader
+        }
+      });
+      this._createAppearance();
+    }
+  }, {
+    key: "_createAppearance",
+    value: function _createAppearance() {
+      this.appearance = new Cesium.MaterialAppearance(_objectSpread({
+        material: this.material
+      }, this.currAppearance));
+    }
+  }], [{
+    key: "handleMaterial",
+    value: function handleMaterial(style) {
+      var color = style.color,
+        options = _objectWithoutProperties(style, _excluded);
+      var backStyle = _objectSpread({}, options);
+      backStyle.color = utils.colorString(color);
+      return backStyle;
+    }
+  }]);
+  return ImageMaterialAppearance;
+}(BaseMaterialAppearance);
+export default ImageMaterialAppearance;

package/dist/esm/material/shader/ImageShader.glsl

@@ -0,0 +1,22 @@
+uniform sampler2D image;
+uniform vec4 color;
+uniform float mixRatio;
+
+czm_material czm_getMaterial(czm_materialInput materialInput) {
+    czm_material material = czm_getDefaultMaterial(materialInput);
+    vec2 st = materialInput.st;
+
+    // 采样图片
+    vec4 texColor = texture(image, st);
+
+    // 颜色混合：mix(原始颜色, 目标颜色, mixRatio)
+    vec3 mixedColor = mix(texColor.rgb, texColor.rgb * color.rgb, mixRatio);
+
+    // 发光增强
+    material.diffuse = mixedColor * 2.0;
+
+    // 透明度随颜色变化
+    material.alpha = texColor.a * mix(color.a, 1.0, 1.0 - mixRatio);
+
+    return material;
+}

package/dist/esm/tool/BuildClampedPolygonGrid.d.ts

@@ -0,0 +1,11 @@
+import * as Cesium from 'deeptwins-cesium';
+/**
+ * 构建贴地的多边形网格
+ */
+export default function BuildClampedPolygonGrid(map: any, geoJson: any, gridSize?: number, heightBuffer?: number): Promise<{
+    type: string;
+    source: {
+        positions: Cesium.Cartesian3[];
+        indices: number[];
+    }[];
+}>;

package/dist/esm/tool/BuildClampedPolygonGrid.js

@@ -0,0 +1,151 @@
+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 _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+import * as Cesium from 'deeptwins-cesium';
+import BaseSource from "../graphicLayer/BaseSource";
+import { translateSource } from "../tool/common";
+import * as utils from "./utils";
+function pointInPolygon(pt, polygon) {
+  var inside = false;
+  for (var i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
+    var xi = polygon[i].x,
+      yi = polygon[i].y;
+    var xj = polygon[j].x,
+      yj = polygon[j].y;
+    var intersect = yi > pt.y !== yj > pt.y && pt.x < (xj - xi) * (pt.y - yi) / (yj - yi) + xi;
+    if (intersect) inside = !inside;
+  }
+  return inside;
+}
+
+// 修改 buildGridIndices：不删顶点，只生成 polygon 内部三角形索引
+function buildGridIndices(cols, rows, polygon, gridPoints2D, step) {
+  var indices = [];
+  for (var y = 0; y < rows - 1; y++) {
+    for (var x = 0; x < cols - 1; x++) {
+      var i0 = y * cols + x;
+      var i1 = i0 + 1;
+      var i2 = i0 + cols;
+      var i3 = i2 + 1;
+
+      // 三角形中心点，判断是否在 polygon 内
+      var cx = (x + 0.5) * step + gridPoints2D[0].x; // 这里偏移加上最小X
+      var cy = (y + 0.5) * step + gridPoints2D[0].y; // 偏移加上最小Y
+      if (pointInPolygon(new Cesium.Cartesian2(cx, cy), polygon)) {
+        indices.push(i0, i1, i2);
+        indices.push(i1, i3, i2);
+      }
+    }
+  }
+  return indices;
+}
+
+/**
+ * 构建贴地的多边形网格
+ */
+export default function BuildClampedPolygonGrid(_x, _x2) {
+  return _BuildClampedPolygonGrid.apply(this, arguments);
+}
+function _BuildClampedPolygonGrid() {
+  _BuildClampedPolygonGrid = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(map, geoJson) {
+    var gridSize,
+      heightBuffer,
+      translatedSource,
+      source,
+      finalSource,
+      _loop,
+      i,
+      _args2 = arguments;
+    return _regeneratorRuntime().wrap(function _callee$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          gridSize = _args2.length > 2 && _args2[2] !== undefined ? _args2[2] : 10;
+          heightBuffer = _args2.length > 3 && _args2[3] !== undefined ? _args2[3] : 0.5;
+          if (!(!map.terrainProvider || map.terrainProvider instanceof Cesium.EllipsoidTerrainProvider)) {
+            _context2.next = 4;
+            break;
+          }
+          throw new Error('请设置地形');
+        case 4:
+          translatedSource = translateSource(geoJson);
+          source = BaseSource.geoJsonToGeoCartesian3Array(translatedSource);
+          finalSource = [];
+          _loop = /*#__PURE__*/_regeneratorRuntime().mark(function _loop() {
+            var positions, ring, center, plane, poly2D, minX, minY, maxX, maxY, cols, rows, gridPoints2D, y, x, indices, positions3D, cartographics, clamped, finalPositions;
+            return _regeneratorRuntime().wrap(function _loop$(_context) {
+              while (1) switch (_context.prev = _context.next) {
+                case 0:
+                  positions = source[i].positions; // 1️⃣ 去闭合
+                  ring = utils.buildPolygonHierarchy(positions).positions; // 2️⃣ 局部切平面
+                  center = Cesium.BoundingSphere.fromPoints(ring).center;
+                  plane = new Cesium.EllipsoidTangentPlane(center, Cesium.Ellipsoid.WGS84); // 3️⃣ 投影到 2D
+                  poly2D = ring.map(function (p) {
+                    return plane.projectPointOntoPlane(p);
+                  }); // 4️⃣ 包围盒
+                  minX = Infinity, minY = Infinity;
+                  maxX = -Infinity, maxY = -Infinity;
+                  poly2D.forEach(function (p) {
+                    minX = Math.min(minX, p.x);
+                    minY = Math.min(minY, p.y);
+                    maxX = Math.max(maxX, p.x);
+                    maxY = Math.max(maxY, p.y);
+                  });
+                  cols = Math.floor((maxX - minX) / gridSize) + 1;
+                  rows = Math.floor((maxY - minY) / gridSize) + 1; // 5️⃣ 生成完整规则网格点（不删点）
+                  gridPoints2D = [];
+                  for (y = 0; y < rows; y++) {
+                    for (x = 0; x < cols; x++) {
+                      gridPoints2D.push(new Cesium.Cartesian2(minX + x * gridSize, minY + y * gridSize));
+                    }
+                  }
+
+                  // 6️⃣ 生成三角形索引（只保留 polygon 内部三角形）
+                  indices = buildGridIndices(cols, rows, poly2D, gridPoints2D, gridSize); // 7️⃣ 回投 3D
+                  positions3D = gridPoints2D.map(function (p) {
+                    return plane.projectPointOntoEllipsoid(p);
+                  }); // 8️⃣ 贴地
+                  cartographics = positions3D.map(function (p) {
+                    return Cesium.Cartographic.fromCartesian(p);
+                  });
+                  _context.next = 17;
+                  return Cesium.sampleTerrainMostDetailed(map.terrainProvider, cartographics);
+                case 17:
+                  clamped = _context.sent;
+                  finalPositions = clamped.map(function (c) {
+                    return Cesium.Cartesian3.fromRadians(c.longitude, c.latitude, c.height + heightBuffer);
+                  });
+                  finalSource.push({
+                    positions: finalPositions,
+                    indices: indices
+                  });
+                case 20:
+                case "end":
+                  return _context.stop();
+              }
+            }, _loop);
+          });
+          i = 0;
+        case 9:
+          if (!(i < source.length)) {
+            _context2.next = 14;
+            break;
+          }
+          return _context2.delegateYield(_loop(), "t0", 11);
+        case 11:
+          i++;
+          _context2.next = 9;
+          break;
+        case 14:
+          return _context2.abrupt("return", {
+            type: 'clampedPolygonGrid',
+            source: finalSource
+          });
+        case 15:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee);
+  }));
+  return _BuildClampedPolygonGrid.apply(this, arguments);
+}

package/dist/esm/tool/utils.d.ts

@@ -11,6 +11,11 @@ export declare const arrCartesian3: (data: any[]) => Cesium.Cartesian3;
 export declare const toDegrees: (radians: number, precision?: number) => number;
 export declare const toRadians: (degrees: number) => number;
 export declare const lngLatAltToCartographic: (lng: number, lat: number, alt?: number) => Cesium.Cartographic;
+export declare const cartographicToLngLatAlt: (cartographic: any) => {
+    lng: number;
+    lat: number;
+    alt: any;
+};
 export declare const cartesian3ToLngLatAlt: (cartesian3: any) => {
     lng: number;
     lat: number;
@@ -18,6 +23,8 @@ export declare const cartesian3ToLngLatAlt: (cartesian3: any) => {
 };
 export declare const lngLatAltToCartesian3: (lng: number, lat: number, alt?: number) => Cesium.Cartesian3;
 export declare const lngLatAltArrayToCartesian3Array: (lngLatAltArray: any[]) => Cesium.Cartesian3[];
+export declare const cartesian3ToCartographic: (cartesian3: any) => Cesium.Cartographic;
+export declare const cartographicToCartesian3: (cartographic: any) => Cesium.Cartesian3;
 export declare const isWKT: (str: string) => boolean;
 export declare const styleFun: (style: any, properties: any) => any;
 export declare const dateToJulianDate: (date: Date) => Cesium.JulianDate;
@@ -42,15 +49,25 @@ export declare const getHeightCompensatedScale: (map: Cesium.Viewer, entityHeigh
 export declare function calculateLength(positions: any[]): number;
 export declare function warn(message: string): void;
 export declare function error(message: string): void;
+/**
+ * 去除 Polygon ring 的闭合点（首尾重复）
+ */
+export declare function normalizeRing(ring: Cesium.Cartesian3[]): Cesium.Cartesian3[];
+/**
+ * 构建 Cesium 安全的 PolygonHierarchy
+ * 支持闭合 / 非闭合 / holes
+ */
+export declare function buildPolygonHierarchy(positions: Cesium.Cartesian3[], holes?: Cesium.Cartesian3[][]): Cesium.PolygonHierarchy;
 /**
  * 沿多边形平面局部坐标系计算 ST
  * @param positions Cartesian3[] 多边形顶点
  * @param rotation number 旋转
  * @returns Float32Array ST 坐标
  */
-export declare function computeSTAlongPlane(positions: any, rotation?: number): Float32Array;
+export declare function computeSTAlongPlane(positions: Cesium.Cartesian3[], rotation?: number): Float32Array;
 export declare function getMidpoint(position1: Cartesian3, position2: Cartesian3): {
     lng: number;
     lat: number;
     alt: number;
 };
+export declare function densifyLine(p1: Cartesian3, p2: Cartesian3, count?: number): Cesium.Cartesian3[];

package/dist/esm/tool/utils.js

@@ -149,6 +149,15 @@ export var lngLatAltToCartographic = function lngLatAltToCartographic(lng, lat)
   return Cesium.Cartographic.fromDegrees(lng, lat, alt);
 };
 
+// Cartographic转经纬度
+export var cartographicToLngLatAlt = function cartographicToLngLatAlt(cartographic) {
+  return {
+    lng: toDegrees(cartographic.longitude),
+    lat: toDegrees(cartographic.latitude),
+    alt: cartographic.height || 0
+  };
+};
+
 // Cartesian3转经纬度
 export var cartesian3ToLngLatAlt = function cartesian3ToLngLatAlt(cartesian3) {
   var cartographic = Cesium.Cartographic.fromCartesian(cartesian3);
@@ -178,6 +187,16 @@ export var lngLatAltArrayToCartesian3Array = function lngLatAltArrayToCartesian3
   return Cesium.Cartesian3.fromDegreesArrayHeights(lngLatAltArrayString);
 };
 
+// Cartesian3转Cartographic
+export var cartesian3ToCartographic = function cartesian3ToCartographic(cartesian3) {
+  return Cesium.Cartographic.fromCartesian(cartesian3);
+};
+
+// Cartographic转Cartesian3
+export var cartographicToCartesian3 = function cartographicToCartesian3(cartographic) {
+  return Cesium.Cartesian3.fromRadians(cartographic.longitude, cartographic.latitude, cartographic.height);
+};
+
 // 是否是wkt类型的字符串
 export var isWKT = function isWKT(str) {
   return str.startsWith('POINT') || str.startsWith('LINESTRING') || str.startsWith('POLYGON') || str.startsWith('MULTIPOINT') || str.startsWith('MULTILINESTRING') || str.startsWith('GEOMETRYCOLLECTION');
@@ -320,6 +339,41 @@ export function error(message) {
   console.error("[DeepTwinsEngine3d error]: ".concat(message));
 }
 
+/**
+ * 去除 Polygon ring 的闭合点（首尾重复）
+ */
+export function normalizeRing(ring) {
+  var _ring$slice;
+  if (!ring || ring.length < 3) return (_ring$slice = ring === null || ring === void 0 ? void 0 : ring.slice()) !== null && _ring$slice !== void 0 ? _ring$slice : [];
+  var first = ring[0];
+  var last = ring[ring.length - 1];
+  if (Cesium.Cartesian3.equals(first, last)) {
+    return ring.slice(0, -1);
+  }
+  return ring.slice();
+}
+
+/**
+ * 构建 Cesium 安全的 PolygonHierarchy
+ * 支持闭合 / 非闭合 / holes
+ */
+export function buildPolygonHierarchy(positions) {
+  var holes = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  var outer = normalizeRing(positions);
+  if (outer.length < 3) {
+    throw new Error('Polygon 外环至少需要 3 个不同的点');
+  }
+  var holeHierarchies = holes.map(function (h, i) {
+    var ring = normalizeRing(h);
+    if (ring.length < 3) {
+      console.warn("Polygon hole ".concat(i, " \u9876\u70B9\u4E0D\u8DB3\uFF0C\u5DF2\u5FFD\u7565"));
+      return null;
+    }
+    return new Cesium.PolygonHierarchy(ring);
+  }).filter(Boolean);
+  return new Cesium.PolygonHierarchy(outer, holeHierarchies);
+}
+
 /**
  * 沿多边形平面局部坐标系计算 ST
  * @param positions Cartesian3[] 多边形顶点
@@ -328,36 +382,56 @@ export function error(message) {
  */
 export function computeSTAlongPlane(positions) {
   var rotation = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-  var n = positions.length;
-  var stValues = new Float32Array(n * 2);
-
-  // 1️⃣ 计算中心
-  var center = Cesium.BoundingSphere.fromPoints(positions).center;
-
-  // 2️⃣ 计算法线
-  var v1 = Cesium.Cartesian3.subtract(positions[1], positions[0], new Cesium.Cartesian3());
-  var v2 = Cesium.Cartesian3.subtract(positions[2], positions[0], new Cesium.Cartesian3());
-  var normal = Cesium.Cartesian3.cross(v1, v2, new Cesium.Cartesian3());
-  Cesium.Cartesian3.normalize(normal, normal);
-
-  // 3️⃣ 选择 tangent/bitangent
-  var ref = Math.abs(normal.z) > 0.9 ? Cesium.Cartesian3.UNIT_X : Cesium.Cartesian3.UNIT_Z;
-  var tangent = Cesium.Cartesian3.cross(ref, normal, new Cesium.Cartesian3());
-  Cesium.Cartesian3.normalize(tangent, tangent);
-  var bitangent = Cesium.Cartesian3.cross(normal, tangent, new Cesium.Cartesian3());
-  Cesium.Cartesian3.normalize(bitangent, bitangent);
-
-  // 4️⃣ 投影到局部平面，收集 min/max
+  // 1️⃣ 去闭合
+  var ring = buildPolygonHierarchy(positions).positions;
+  var count = ring.length;
+  var center = Cesium.BoundingSphere.fromPoints(ring).center;
+
+  // 2️⃣ 官方切平面（稳定）
+  var tangentPlane = new Cesium.EllipsoidTangentPlane(center, Cesium.Ellipsoid.WGS84);
+
+  // 3️⃣ 投影到 2D
+  var pts2D = ring.map(function (p) {
+    return tangentPlane.projectPointOntoPlane(p);
+  });
+
+  // 4️⃣ 计算 2D 中心
+  var cx = 0,
+    cy = 0;
+  pts2D.forEach(function (p) {
+    cx += p.x;
+    cy += p.y;
+  });
+  cx /= count;
+  cy /= count;
+
+  // 5️⃣ PCA 求主方向（S 轴）
+  var xx = 0,
+    xy = 0,
+    yy = 0;
+  pts2D.forEach(function (p) {
+    var dx = p.x - cx;
+    var dy = p.y - cy;
+    xx += dx * dx;
+    xy += dx * dy;
+    yy += dy * dy;
+  });
+  var theta = 0.5 * Math.atan2(2 * xy, xx - yy);
+  var cosT = Math.cos(theta + rotation);
+  var sinT = Math.sin(theta + rotation);
+
+  // 6️⃣ 投影到主轴坐标系
   var minS = Infinity,
     maxS = -Infinity,
     minT = Infinity,
     maxT = -Infinity;
-  var localST = [];
-  positions.forEach(function (p) {
-    var local = Cesium.Cartesian3.subtract(p, center, new Cesium.Cartesian3());
-    var s = Cesium.Cartesian3.dot(local, tangent);
-    var t = Cesium.Cartesian3.dot(local, bitangent);
-    localST.push({
+  var local = [];
+  pts2D.forEach(function (p) {
+    var dx = p.x - cx;
+    var dy = p.y - cy;
+    var s = dx * cosT + dy * sinT;
+    var t = -dx * sinT + dy * cosT;
+    local.push({
       s: s,
       t: t
     });
@@ -366,25 +440,16 @@ export function computeSTAlongPlane(positions) {
     minT = Math.min(minT, t);
     maxT = Math.max(maxT, t);
   });
-  var rangeS = maxS - minS || 1.0;
-  var rangeT = maxT - minT || 1.0;
-  var cosA = Math.cos(rotation);
-  var sinA = Math.sin(rotation);
-
-  // 5️⃣ 归一化并旋转
-  localST.forEach(function (pt, i) {
-    var s = (pt.s - minS) / rangeS;
-    var t = (pt.t - minT) / rangeT;
-
-    // 旋转 around center (0.5,0.5)
-    var s0 = s - 0.5;
-    var t0 = t - 0.5;
-    s = s0 * cosA - t0 * sinA + 0.5;
-    t = s0 * sinA + t0 * cosA + 0.5;
-    stValues[i * 2] = s;
-    stValues[i * 2 + 1] = t;
+  var rangeS = maxS - minS || 1;
+  var rangeT = maxT - minT || 1;
+
+  // 7️⃣ 归一化
+  var st = new Float32Array(count * 2);
+  local.forEach(function (p, i) {
+    st[i * 2] = (p.s - minS) / rangeS;
+    st[i * 2 + 1] = (p.t - minT) / rangeT;
   });
-  return stValues;
+  return st;
 }
 
 // 计算两点的中心点
@@ -402,4 +467,14 @@ export function getMidpoint(position1, position2) {
     lat: lat,
     alt: alt
   };
+}
+
+// 对两点间进行插值
+export function densifyLine(p1, p2) {
+  var count = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 10;
+  var result = [];
+  for (var i = 0; i <= count; i++) {
+    result.push(Cesium.Cartesian3.lerp(p1, p2, i / count, new Cesium.Cartesian3()));
+  }
+  return result;
 }

package/dist/esm/videoFusion/VideoProject.js

@@ -71,7 +71,7 @@ var VideoProject = /*#__PURE__*/function (_BaseVideo) {
         _this2.type = type;
         _this2.frustum = frustum;
         // 取后4个点
-        var points = _this2.frustum.getFrustumVertexPoints().slice(-4);
+        var points = _this2.frustum.getFarPlane();
         if (_this2.type === 'projection') {
           // 交点数组
           var interPoints = [];

package/dist/esm/visualization/Frustum.d.ts

@@ -1,5 +1,30 @@
-import BaseFrustum from './BaseFrustum';
-export default class Frustum extends BaseFrustum {
+import { MapContext } from "../map/Map";
+export default class Frustum {
+    _mapContext: MapContext | undefined;
+    options: any;
+    frustumPrimitive: any;
+    frustumLinePrimitive: any;
+    isDestroyed: boolean;
     constructor(map: any, options: any);
+    getMap(): any;
+    private _canOperate;
     private _addFrustum;
+    /**
+     * 获取视锥体投影面的顶点坐标
+     * @param type 投影面类型: 'near'(近裁剪面) 或 'far'(远裁剪面)
+     * @returns 投影面的4个顶点坐标数组 [[lng, lat, alt], ...]
+     */
+    getProjectionPlane(type?: 'near' | 'far'): any;
+    /**
+     * 获取近裁剪面的顶点坐标
+     * @returns 近裁剪面的4个顶点坐标数组
+     */
+    getNearPlane(): any;
+    /**
+     * 获取远裁剪面的顶点坐标
+     * @returns 远裁剪面的4个顶点坐标数组
+     */
+    getFarPlane(): any;
+    show(isShow: boolean): void;
+    destroy(): void;
 }