s3m-three 0.1.1 → 0.3.0

package/src/render/GroundManager.ts

@@ -38,6 +38,8 @@ export class GroundManager {
   gridSize: number;
   excavationBounds: [number, number, number, number] | null = null;
   size: number;
+  /** 物理地表网格的高度（米，场景 ENU Z 坐标），默认 0 */
+  groundHeight = 0;
 
   readonly group: THREE.Group;
   private _mesh: THREE.Mesh | null = null;
@@ -153,7 +155,18 @@ export class GroundManager {
    */
   update(camera?: THREE.Camera | null): void {
     if (!camera || this.mode === 'none') return;
-    this.group.position.set(camera.position.x, camera.position.y, 0);
+    this.group.position.set(camera.position.x, camera.position.y, this.groundHeight);
+  }
+
+  /**
+   * 设置物理地表网格的高度（米，场景 ENU Z 坐标）
+   *
+   * 数据集被抬到真实地面高程后，地表网格需要同步抬高，
+   * 否则「地表覆盖 / 地下透视」的物理关系会与被抬升的模型脱节。
+   */
+  setGroundHeight(height: number): void {
+    this.groundHeight = height;
+    this.group.position.z = height;
   }
 
   setMode(mode: GroundMode): void {

package/src/render/S3MViewer.ts

@@ -508,15 +508,18 @@ export class S3MViewer {
   }
 
   /**
-   * 获取指定数据集的垂直高程偏移（米）。
-   * 若不传 id，默认获取第一个（或默认）数据集的高程偏移。
+   * 获取指定数据集的应用层附加垂直偏移（米，不含 align 基准）。
+   * 若不传 id，默认获取第一个（或默认）数据集的偏移。
    */
   getDatasetHeight(id?: string): number {
     return this._datasetManager.getDatasetHeight(id);
   }
 
   /**
-   * 设置指定数据集的垂直高程偏移（米），正数抬升，负数下降。
+   * 设置指定数据集的应用层附加垂直偏移（米），正数抬升，负数下降。
+   *
+   * 语义为「在当前 align 基准之上再抬升多少米」：贴地（把模型抬到真实地面高程）
+   * 不会破坏 align='top' 等对齐语义。
    */
   setDatasetHeight(idOrHeight: string | number, heightOffset?: number): void {
     let id: string;
@@ -529,10 +532,22 @@ export class S3MViewer {
       h = heightOffset ?? 0;
     }
     this._datasetManager.setDatasetHeight(id, h, this.geo);
+    this._syncGroundHeight();
     this._refreshAllHeights();
     this._requestRepaint();
   }
 
+  /**
+   * 物理地表网格的高度跟随「主数据集的应用层抬升量」，
+   * 保证贴地后地表覆盖 / 地下透视的物理关系与被抬升的模型一致。
+   */
+  private _syncGroundHeight(): void {
+    const primaryId = this.datasets.keys().next().value;
+    if (!primaryId) return;
+    const userOffset = this._datasetManager.getDatasetHeight(primaryId);
+    this.groundManager.setGroundHeight(userOffset);
+  }
+
   /**
    * 动态设置指定数据集的垂直对齐基准（'origin' | 'bottom' | 'top' | 'center'）。
    */

package/src/tileset/S3MTileset.ts

@@ -387,13 +387,15 @@ export class S3MTileset {
 
       this._onTile(node);
     } catch (e) {
-      this.stats.failed++;
       const attempts = (this._retryCount.get(url) ?? 0) + 1;
       this._retryCount.set(url, attempts);
       if (attempts <= this._maxRetries) {
         // 退避重试：不进 failed，下一帧 update() 会重新入队，避免网络抖一下就留个永久空洞
         this._retryAt.set(url, performance.now() + 800 * attempts);
       } else {
+        // 只有重试耗尽的瓦片才计入 failed：瞬态失败下一轮就成功了，
+        // 计进去会让状态栏永久挂着一个「N 个瓦片失败」的假警告
+        this.stats.failed++;
         this.failed.add(url);
         this._retryAt.delete(url);
       }