@yangyongtao/gaea 1.1.24 → 1.1.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yangyongtao/gaea",
-  "version": "1.1.24",
+  "version": "1.1.26",
   "description": "Gaea 3D visualization component library - Vue 3 components based on Godot WASM engine. Includes WMTS layer loading, camera view control, Vite plugin auto-injection, etc.",
   "type": "module",
   "main": "src/index.cjs",

package/src/GaeaMethods.js

@@ -289,6 +289,9 @@ export class GaeaApp {
     this.layerCategories = this.config.layerCategories || [];
     this._screenIconList = [];
     this._hiddenCategories = new Set();
+    this._tilesetMap = {}; // 已加载的 3D Tiles 引用，key 为 tileset 名称
+    this._flattenTool = null; // 压平工具
+    this._flattenPolygon = null; // 压平多边形元素
     this._secIsClickArr = [];
     this._secScreenIconKeyValue = {};
     this._groundPolygonElements = [];
@@ -1180,6 +1183,7 @@ export class GaeaApp {
     const tilesetUrl = typeof item === 'string' ? item : item.jsonUrl
     const name = typeof item === 'string' ? '' : (item.tilName || '')
     const height = typeof item === 'string' ? 0 : (item.height || 0)
+    const enableFlatten = typeof item === 'object' ? (item.enableFlatten || false) : false
     const tileset = new Gaea.Gaea3DTileset()
     tileset.Name = name
     tileset.TilesetUrl = tilesetUrl
@@ -1188,6 +1192,7 @@ export class GaeaApp {
     tileset.SkipLevelOfDetail = false
     tileset.IsZUp = true
     tileset.RecalculateNormals = true
+    tileset.EnabledFlatten = enableFlatten
     tileset.BaseUrl = tilesetUrl.slice(0, tilesetUrl.lastIndexOf('/') + 1)
     tileset.InitTileSet(name, tilesetUrl)
     tileset.MaximumMemoryUsage = 512
@@ -1196,10 +1201,114 @@ export class GaeaApp {
       tileset.LocalOffset = new Gaea.Vector3(0, height, 0)
     }
     Gaea.World.Instance.RenderableObjectList.AddLast(tileset)
-    console.log('[GaeaApp] 3D Tiles 已加载:', name || tilesetUrl, height ? `高度: ${height}` : '')
+    if (name) {
+      this._tilesetMap[name] = tileset
+    }
+    console.log('[GaeaApp] 3D Tiles 已加载:', name || tilesetUrl, height ? `高度: ${height}` : '', enableFlatten ? '(压平已启用)' : '')
     return tileset
   };
 
+  // ---- 倾斜摄影压平 ----
+
+  /**
+   * 传入多边形坐标直接对倾斜摄影执行压平
+   * @param {Object} opts
+   * @param {string} [opts.tilesetName] - 目标 3D Tiles 名称（不传则默认使用第一个已加载的 tileset）
+   * @param {Array<{lat: number, lng: number}>} opts.polygon - 多边形顶点坐标数组，会自动闭合
+   * @param {number} opts.height - 压平目标高度
+   * @example
+   * app.flatten3DTiles({
+   *   tilesetName: '沿浦海塘倾斜',
+   *   polygon: [
+   *     { lat: 27.2205, lng: 120.456 },
+   *     { lat: 27.2210, lng: 120.458 },
+   *     { lat: 27.2195, lng: 120.458 },
+   *     { lat: 27.2190, lng: 120.456 }
+   *   ],
+   *   height: 30
+   * })
+   */
+  flatten3DTiles = ({ tilesetName, polygon, height }) => {
+    if (!polygon || polygon.length < 3) {
+      console.warn('[GaeaApp] flatten3DTiles: polygon 至少需要3个顶点')
+      return
+    }
+
+    // 查找目标 tileset
+    let tileset = null
+    if (tilesetName) {
+      tileset = this._tilesetMap[tilesetName]
+      if (!tileset) {
+        console.warn(`[GaeaApp] flatten3DTiles: 未找到 tileset "${tilesetName}"`)
+        return
+      }
+    } else {
+      const keys = Object.keys(this._tilesetMap)
+      if (keys.length === 0) {
+        console.warn('[GaeaApp] flatten3DTiles: 没有已加载的 3D Tiles')
+        return
+      }
+      tileset = this._tilesetMap[keys[0]]
+    }
+
+    tileset.EnabledFlatten = true
+
+    // 创建/更新压平工具
+    if (!this._flattenTool) {
+      this._flattenTool = new Gaea.FlattenTool()
+      this._flattenTool.NeedIntersectWithMesh = false
+      this._flattenTool.IsMovingIntersectWithMesh = false
+    }
+    this._flattenTool.Gdtvalue = height
+
+    // 构建多边形坐标（经纬度 → Vector3，闭合多边形）
+    const positions = polygon.map(p => new Gaea.Vector3(p.lat, p.lng, height))
+    positions.push(new Gaea.Vector3(polygon[0].lat, polygon[0].lng, height))
+
+    // 创建几何体
+    const geometry = Gaea.Geometry.Create1(Gaea.GeometryType.Polygon, positions)
+    const polygonElement = new Gaea.PolygonGeometryElement()
+    polygonElement.Shape = geometry
+    polygonElement.EnablePick = false
+    polygonElement.EnableEdit = false
+    polygonElement.NeedIntersectWithMesh = true
+    polygonElement.EnableVirtualPoint = true
+    Gaea.SimpleFillSymbol.ConvertBy(polygonElement.Symbol).HasOutLine = true
+
+    // 移除旧的压平多边形
+    if (this._flattenPolygon) {
+      try { Gaea.World.Instance.RenderableObjectList.RemoveChild(this._flattenPolygon) } catch (e) { /* ignore */ }
+    }
+
+    Gaea.World.Instance.RenderableObjectList.AddLast(polygonElement)
+    this._flattenPolygon = polygonElement
+    console.log('[GaeaApp] 压平已执行:', tileset.Name || tileset.TilesetUrl, `高度: ${height}`, `顶点数: ${polygon.length}`)
+  };
+
+  /**
+   * 清除倾斜摄影压平效果
+   * @param {string} [tilesetName] - 目标 tileset 名称（不传则清除压平多边形并重置工具）
+   */
+  clearFlatten = (tilesetName) => {
+    // 移除压平多边形
+    if (this._flattenPolygon) {
+      try { Gaea.World.Instance.RenderableObjectList.RemoveChild(this._flattenPolygon) } catch (e) { /* ignore */ }
+      this._flattenPolygon = null
+    }
+
+    // 重置压平工具状态
+    this._flattenTool = null
+    Gaea.World.Instance.SetCurrentTool(null)
+    Gaea.World.Instance.CurrentTool = null
+
+    // 可选：禁用特定 tileset 的压平
+    if (tilesetName && this._tilesetMap[tilesetName]) {
+      this._tilesetMap[tilesetName].EnabledFlatten = false
+    }
+
+    console.log('[GaeaApp] 压平效果已清除')
+  };
+
   /**
    * 根据经纬度飞到指定位置
    * @param {number} lat - 纬度