@yangyongtao/gaea 1.1.28 → 1.1.29

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [1.1.29] - 2026-09-04
+
+### Fixed
+- 2D/3D 切换严格隐藏 3D 图标：新增 `_markersVisible` 全局状态，`showAllMarkers` / `hideAllMarkers` 同步更新；`addScreenIcon` 新增图标按当前状态显隐；`setCategoryVisible` 显示分类、复位按钮、`lockedModesSwitch` 解锁恢复图标时均叠加全局可见性判断，杜绝 2D 模式下图标残留
+
 ## [1.1.28] - 2026-09-01
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yangyongtao/gaea",
-  "version": "1.1.28",
+  "version": "1.1.29",
   "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,6 +290,7 @@ export class GaeaApp {
     this.tLayers = [];
     this.layerCategories = this.config.layerCategories || [];
     this._screenIconList = [];
+    this._markersVisible = true; // 全局图标可见性（2D 模式下强制隐藏，3D 下恢复）
     this._hiddenCategories = new Set();
     this._tilesetMap = {}; // 已加载的 3D Tiles 引用，key 为 tileset 名称
     this._secIsClickArr = [];
@@ -560,9 +561,11 @@ export class GaeaApp {
       // 解锁视角（内部会调 UseAutoVisible 恢复非断面图标）
       this.lockedModesSwitch(false);
       // 恢复被 hiddenScreenWithClass 隐藏的图标 DOM
-      document.querySelectorAll('.gaea-locationLineStyle, .gaea-iconscreen, .gaea-iconGif').forEach(el => {
-        el.style.display = '';
-      });
+      if (this._markersVisible) {
+        document.querySelectorAll('.gaea-locationLineStyle, .gaea-iconscreen, .gaea-iconGif').forEach(el => {
+          el.style.display = '';
+        });
+      }
       // 断面模型缩回
       if (this._raisedSection) {
         this._raisedSection.TranslateObjectLocal(new Gaea.Vector3(0, -44, 0));
@@ -912,11 +915,11 @@ export class GaeaApp {
     }
     const els = document.querySelectorAll('.gaea-cat-' + categoryKey);
     console.log('[GaeaApp] setCategoryVisible:', categoryKey, visible, '元素数:', els.length);
-    els.forEach(el => { el.style.display = visible ? '' : 'none'; });
+    els.forEach(el => { el.style.display = visible && this._markersVisible ? '' : 'none'; });
     // 同步引擎可见性
     const items = this._screenIconList.filter(item => item.category === categoryKey);
     items.forEach(item => {
-      if (visible) {
+      if (visible && this._markersVisible) {
         item.element.UseAutoVisible();
         item.element.EnablePick = true;
       } else {
@@ -1799,6 +1802,7 @@ export class GaeaApp {
           child.AddChild(screen, false);
           const screenItem = { element: screen, type: type || null, category };
           this._screenIconList.push(screenItem);
+          this._applyMarkerVisibility(screenItem);
           return screen;
         }
       }
@@ -1810,9 +1814,19 @@ export class GaeaApp {
     Gaea.World.Instance.RenderableObjectList.AddLast(screen);
     const screenItem = { element: screen, type: type || null, category };
      this._screenIconList.push(screenItem);
+    this._applyMarkerVisibility(screenItem);
     return screen;
   }
 
+  /** 根据全局图标可见性状态（_markersVisible）应用单个图标显隐 */
+  _applyMarkerVisibility(screenItem) {
+    if (this._markersVisible) return;
+    screenItem.element.ForceSetVisible(false);
+    screenItem.element.EnablePick = false;
+    const el = document.getElementById(screenItem.element.DivID);
+    if (el) el.style.display = 'none';
+  }
+
   /** 记录当前视角，返回 URI 字符串 */
   favorite() {
     return Gaea.GaeaCamera.ConvertBy(Gaea.World.Instance.DefaultCamera).Favorite();
@@ -2095,7 +2109,7 @@ export class GaeaApp {
       Gaea.World.Instance.CameraController.LockedEntity = null;
       // 解锁时恢复非断面图标的自动可见
       this._screenIconList.forEach(item => {
-        if (!item.type) {
+        if (!item.type && this._markersVisible) {
           item.element.UseAutoVisible();
           item.element.EnablePick = true;
         }
@@ -2377,6 +2391,7 @@ export class GaeaApp {
 
   /** 显示所有屏幕标记 */
   showAllMarkers = () => {
+    this._markersVisible = true;
     this._screenIconList.forEach(item => {
       // 跳过被隐藏分类的标记
       if (this._hiddenCategories.has(item.category)) return
@@ -2390,6 +2405,7 @@ export class GaeaApp {
 
   /** 隐藏所有屏幕标记 */
   hideAllMarkers = () => {
+    this._markersVisible = false;
     this._screenIconList.forEach(item => {
       item.element.ForceSetVisible(false)
       item.element.EnablePick = false