@yangyongtao/gaea 1.1.25 → 1.1.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yangyongtao/gaea",
-  "version": "1.1.25",
+  "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

@@ -290,7 +290,8 @@ export class GaeaApp {
     this._screenIconList = [];
     this._hiddenCategories = new Set();
     this._tilesetMap = {}; // 已加载的 3D Tiles 引用，key 为 tileset 名称
-    this._flattenTool = null; // 压平绘制工具
+    this._flattenTool = null; // 压平工具
+    this._flattenPolygon = null; // 压平多边形元素
     this._secIsClickArr = [];
     this._secScreenIconKeyValue = {};
     this._groundPolygonElements = [];
@@ -1210,24 +1211,41 @@ export class GaeaApp {
   // ---- 倾斜摄影压平 ----
 
   /**
-   * 进入倾斜摄影压平绘制模式
-   * 调用后可以在 3D Tiles 上绘制多边形，多边形区域内将被压平
-   * @param {string} [tilesetName] - 目标 3D Tiles 名称（不传则默认使用第一个已加载的 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
+   * })
    */
-  startFlattenDraw = (tilesetName) => {
+  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] startFlattenDraw: 未找到 tileset "${tilesetName}"`)
+        console.warn(`[GaeaApp] flatten3DTiles: 未找到 tileset "${tilesetName}"`)
         return
       }
     } else {
-      // 取第一个有名字的 tileset
       const keys = Object.keys(this._tilesetMap)
       if (keys.length === 0) {
-        console.warn('[GaeaApp] startFlattenDraw: 没有已加载的 3D Tiles')
+        console.warn('[GaeaApp] flatten3DTiles: 没有已加载的 3D Tiles')
         return
       }
       tileset = this._tilesetMap[keys[0]]
@@ -1235,38 +1253,60 @@ export class GaeaApp {
 
     tileset.EnabledFlatten = true
 
+    // 创建/更新压平工具
     if (!this._flattenTool) {
       this._flattenTool = new Gaea.FlattenTool()
       this._flattenTool.NeedIntersectWithMesh = false
       this._flattenTool.IsMovingIntersectWithMesh = false
     }
+    this._flattenTool.Gdtvalue = height
 
-    Gaea.World.Instance.SetCurrentTool(this._flattenTool)
-    Gaea.World.Instance.CurrentTool = this._flattenTool
-    console.log('[GaeaApp] 压平绘制模式已启动:', tileset.Name || tileset.TilesetUrl)
-  };
+    // 构建多边形坐标（经纬度 → 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))
 
-  /**
-   * 设置压平高度
-   * @param {number} height - 压平目标高度
-   */
-  setFlattenHeight = (height) => {
-    if (!this._flattenTool) {
-      console.warn('[GaeaApp] setFlattenHeight: 尚未启用压平绘制模式，请先调用 startFlattenDraw()')
-      return
+    // 创建几何体
+    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 */ }
     }
-    this._flattenTool.Gdtvalue = height
-    console.log('[GaeaApp] 压平高度已设置为:', height)
+
+    Gaea.World.Instance.RenderableObjectList.AddLast(polygonElement)
+    this._flattenPolygon = polygonElement
+    console.log('[GaeaApp] 压平已执行:', tileset.Name || tileset.TilesetUrl, `高度: ${height}`, `顶点数: ${polygon.length}`)
   };
 
   /**
-   * 结束压平绘制模式（保留已绘制的压平效果）
+   * 清除倾斜摄影压平效果
+   * @param {string} [tilesetName] - 目标 tileset 名称（不传则清除压平多边形并重置工具）
    */
-  stopFlattenDraw = () => {
+  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
-    this._flattenTool = null
-    console.log('[GaeaApp] 压平绘制模式已退出')
+
+    // 可选：禁用特定 tileset 的压平
+    if (tilesetName && this._tilesetMap[tilesetName]) {
+      this._tilesetMap[tilesetName].EnabledFlatten = false
+    }
+
+    console.log('[GaeaApp] 压平效果已清除')
   };
 
   /**