react-native-cesium 1.2.9 → 1.2.11

package/android/src/main/cpp/CesiumBridgeAndroid.cpp

@@ -312,17 +312,15 @@ void CesiumBridgeAndroid::renderFrame(double nowSeconds) {
 
   // ── Terrain floor clamp ───────────────────────────────────────────────
   const float minAbove = engine_->getConfig().minAltitudeAboveTerrain;
-  if (minAbove > 0.0f) {
-    const double geoidOffset =
+  if (minAbove > 0.0f && engine_->terrainFloorKnown()) {
+    const double geoidN =
         reactnativecesium::mslToEllipsoidMeters(actual.latitude, actual.longitude, 0.0);
-    const double camEllipsoid =
-        reactnativecesium::mslToEllipsoidMeters(actual.latitude, actual.longitude, actual.altitude);
-    const double minEllipsoid =
-        static_cast<double>(engine_->terrainFloorEllipsoidMeters()) + minAbove;
-    if (camEllipsoid < minEllipsoid) {
-      const double clampedMsl = minEllipsoid - geoidOffset;
-      integrator_->clampActualAltitude(clampedMsl);
-      actual.altitude = clampedMsl;
+    const double floorMsl =
+        static_cast<double>(engine_->terrainFloorEllipsoidMeters()) - geoidN;
+    const double minMsl = floorMsl + static_cast<double>(minAbove);
+    if (actual.altitude < minMsl) {
+      integrator_->clampActualAltitude(minMsl);
+      actual.altitude = minMsl;
     }
   }
 

package/cpp/engine/CesiumEngine.cpp

@@ -13,7 +13,9 @@
 #include <Cesium3DTilesSelection/TilesetExternals.h>
 #include <Cesium3DTilesSelection/TilesetOptions.h>
 #include <CesiumGeospatial/BoundingRegion.h>
+#include <CesiumGeospatial/Ellipsoid.h>
 #include <CesiumGeospatial/GlobeRectangle.h>
+#include <CesiumGeospatial/GlobeTransforms.h>
 #include <CesiumAsync/CachingAssetAccessor.h>
 #include <CesiumAsync/SqliteCache.h>
 #include <CesiumCurl/CurlAssetAccessor.h>
@@ -607,7 +609,16 @@ void CesiumEngine::updateFrame(double w, double h, FrameResult& result) {
   const double camLatRad = glm::radians(camParams.latitude);
   const double camLonRad = glm::radians(camParams.longitude);
   float  bestTerrainFloor = terrainFloorEllipsoidM_; // carry previous value if no tile matches
-  double bestTerrainDist  = std::numeric_limits<double>::max();
+  double bestHorizDistSq  = std::numeric_limits<double>::max();
+  bool   floorScanFound   = false;
+
+  // Horizontal search radius for floor sampling (50m = reasonable for urban terrain).
+  // Vertices within this radius are candidates; we pick the lowest (ground level).
+  constexpr double kFloorSearchRadiusM  = 50.0;
+  constexpr double kFloorSearchRadiusSq = kFloorSearchRadiusM * kFloorSearchRadiusM;
+  // 3D fallback: if no vertices within horizontal radius, use closest 3D vertex.
+  double bestDist3D       = std::numeric_limits<double>::max();
+  float  bestDist3DFloor  = 0.0f;
 
   // ── floor-scan cache lookup ─────────────────────────────────────────
   // Skip the per-vertex scan when the camera has moved less than ~10 cm in
@@ -630,6 +641,18 @@ void CesiumEngine::updateFrame(double w, double h, FrameResult& result) {
   // semantics aligned).
   const bool runFloorScan = trackTerrainFloor && !floorScanFromCache;
 
+  // ENU basis at the camera — horizontal distance to each terrain vertex.
+  glm::dvec3 floorEast(1.0, 0.0, 0.0);
+  glm::dvec3 floorNorth(0.0, 1.0, 0.0);
+  if (runFloorScan) {
+    const auto& ellipsoid = CesiumGeospatial::Ellipsoid::WGS84;
+    const glm::dmat4 enuToEcef =
+        CesiumGeospatial::GlobeTransforms::eastNorthUpToFixedFrame(
+            cameraPos, ellipsoid);
+    floorEast  = glm::normalize(glm::dvec3(enuToEcef[0]));
+    floorNorth = glm::normalize(glm::dvec3(enuToEcef[1]));
+  }
+
   // ── fast path ────────────────────────────────────────────────────────
   // The visible primitive list has been identical for kMaxFramesInFlight
   // frames in a row, so every backend slot is guaranteed to hold a copy of
@@ -660,14 +683,35 @@ void CesiumEngine::updateFrame(double w, double h, FrameResult& result) {
             for (size_t vi = 0; vi < vc; ++vi) {
               const glm::dvec3 vECEF =
                   glm::dvec3(prim.localPositions[vi]) + prim.rtcCenter;
-              const double dist = glm::length(vECEF - cameraPos);
-              if (dist < bestTerrainDist) {
-                bestTerrainDist  = dist;
-                bestTerrainFloor = prim.altitudes[vi];
+              const glm::dvec3 delta  = vECEF - cameraPos;
+              const double    de      = glm::dot(delta, floorEast);
+              const double    dn      = glm::dot(delta, floorNorth);
+              const double    horizSq = de * de + dn * dn;
+              const float     vAlt    = prim.altitudes[vi];
+
+              // Primary: horizontal search within radius, pick minimum altitude.
+              if (horizSq <= kFloorSearchRadiusSq) {
+                if (!floorScanFound || vAlt < bestTerrainFloor) {
+                  bestTerrainFloor = vAlt;
+                  bestHorizDistSq  = horizSq;
+                  floorScanFound   = true;
+                }
+              }
+
+              // Fallback: track closest 3D vertex for sparse/ocean scenarios.
+              const double dist3D = glm::length(delta);
+              if (dist3D < bestDist3D) {
+                bestDist3D      = dist3D;
+                bestDist3DFloor = vAlt;
               }
             }
           }
         }
+        // If no vertices within horizontal radius, use 3D fallback.
+        if (!floorScanFound && bestDist3D < std::numeric_limits<double>::max()) {
+          bestTerrainFloor = bestDist3DFloor;
+          floorScanFound   = true;
+        }
       }
 
       const glm::dvec3 rtcCamRel = c.rtcCenter - glm::dvec3(cameraPos);
@@ -703,8 +747,9 @@ void CesiumEngine::updateFrame(double w, double h, FrameResult& result) {
     result.cameraLon = paramsFP.longitude;
     result.cameraAlt = paramsFP.altitude;
 
-    if (trackTerrainFloor) {
+    if (trackTerrainFloor && (floorScanFound || floorScanFromCache)) {
       terrainFloorEllipsoidM_ = bestTerrainFloor;
+      terrainFloorValid_      = true;
       // P5: refresh the floor cache on a fresh scan; skip when we hit the
       // cache (the stored value already reflects this signature).
       if (runFloorScan && signature != 0ULL) {
@@ -763,13 +808,34 @@ void CesiumEngine::updateFrame(double w, double h, FrameResult& result) {
           for (size_t vi = 0; vi < vertexCount; ++vi) {
             const glm::dvec3 vECEF =
                 glm::dvec3(prim.localPositions[vi]) + prim.rtcCenter;
-            const double dist = glm::length(vECEF - cameraPos);
-            if (dist < bestTerrainDist) {
-              bestTerrainDist  = dist;
-              bestTerrainFloor = prim.altitudes[vi];
+            const glm::dvec3 delta  = vECEF - cameraPos;
+            const double    de      = glm::dot(delta, floorEast);
+            const double    dn      = glm::dot(delta, floorNorth);
+            const double    horizSq = de * de + dn * dn;
+            const float     vAlt    = prim.altitudes[vi];
+
+            // Primary: horizontal search within radius, pick minimum altitude.
+            if (horizSq <= kFloorSearchRadiusSq) {
+              if (!floorScanFound || vAlt < bestTerrainFloor) {
+                bestTerrainFloor = vAlt;
+                bestHorizDistSq  = horizSq;
+                floorScanFound   = true;
+              }
+            }
+
+            // Fallback: track closest 3D vertex for sparse/ocean scenarios.
+            const double dist3D = glm::length(delta);
+            if (dist3D < bestDist3D) {
+              bestDist3D      = dist3D;
+              bestDist3DFloor = vAlt;
             }
           }
         }
+        // If no vertices within horizontal radius, use 3D fallback.
+        if (!floorScanFound && bestDist3D < std::numeric_limits<double>::max()) {
+          bestTerrainFloor = bestDist3DFloor;
+          floorScanFound   = true;
+        }
       }
     }
 
@@ -1018,8 +1084,9 @@ void CesiumEngine::updateFrame(double w, double h, FrameResult& result) {
   result.cameraLon     = params.longitude;
   result.cameraAlt     = params.altitude;
 
-  if (trackTerrainFloor) {
+  if (trackTerrainFloor && (floorScanFound || floorScanFromCache)) {
     terrainFloorEllipsoidM_ = bestTerrainFloor;
+    terrainFloorValid_      = true;
     // refresh the floor cache on a fresh scan (slow path always runs a
     // scan unless the cache short-circuit fired above). Only memoise when
     // the geometry signature is stable enough to key on.

package/cpp/engine/CesiumEngine.hpp

@@ -142,10 +142,11 @@ public:
 
   const EngineConfig& getConfig() const { return config_; }
 
-  // Ellipsoid height (metres) of the terrain vertex nearest to the camera nadir,
-  // updated each frame from the loaded tile mesh. 0.0 until the first terrain
-  // tile covering the camera position has been rendered.
+  // Ellipsoid height (metres) of the terrain surface under the camera nadir,
+  // sampled from loaded tile meshes. Meaningless until terrainFloorKnown().
   float terrainFloorEllipsoidMeters() const { return terrainFloorEllipsoidM_; }
+  // True after at least one frame has sampled the floor from real terrain tiles.
+  bool terrainFloorKnown() const { return terrainFloorValid_; }
 
 private:
   void createTileset();
@@ -184,9 +185,10 @@ private:
   GlobeCamera          camera_;
   TileLifecycleManager lifecycle_;
 
-  // Ellipsoid height of the terrain surface at the camera nadir, updated each
-  // frame. Initialised to 0 (sea level) until a terrain tile is first loaded.
+  // Ellipsoid height of the terrain surface at the camera nadir (horizontal
+  // nearest-neighbour sample). Only written after a successful tile scan.
   float terrainFloorEllipsoidM_ = 0.0f;
+  bool  terrainFloorValid_      = false;
 
   // Wall-clock timestamp of the previous updateFrame call. Used to compute
   // deltaTime for Tileset::updateViewGroup, which drives LOD transition fading.
@@ -225,7 +227,8 @@ private:
   // ── terrain-floor scan cache ──────────────────────────────────────
   // The minAltitudeAboveTerrain clamp scans every vertex of every tile whose
   // bounding region contains the camera lon/lat and picks the altitude of
-  // the vertex with the smallest 3D distance to the camera. That's an O(NV)
+  // the vertex with the smallest horizontal (ENU) distance to the camera
+  // nadir (tie-break: lower ellipsoid height). That's an O(NV)
   // scan over the visible primitives — dominant CPU cost when the camera
   // sits over a dense LOD chain. Result depends only on the camera lon/lat
   // and the set of visible primitives, so we cache it keyed on

package/ios/CesiumBridge.mm

@@ -387,17 +387,15 @@
     // Uses terrain floor from the previous frame (one-frame lag is
     // imperceptible at 60 fps). Skipped when minAltitudeAboveTerrain == 0.
     const float minAbove = _engine->getConfig().minAltitudeAboveTerrain;
-    if (minAbove > 0.0f) {
-      const double geoidOffset =
+    if (minAbove > 0.0f && _engine->terrainFloorKnown()) {
+      const double geoidN =
           reactnativecesium::mslToEllipsoidMeters(actual.latitude, actual.longitude, 0.0);
-      const double camEllipsoid =
-          reactnativecesium::mslToEllipsoidMeters(actual.latitude, actual.longitude, actual.altitude);
-      const double minEllipsoid =
-          static_cast<double>(_engine->terrainFloorEllipsoidMeters()) + minAbove;
-      if (camEllipsoid < minEllipsoid) {
-        const double clampedMsl = minEllipsoid - geoidOffset;
-        _integrator->clampActualAltitude(clampedMsl);
-        actual.altitude = clampedMsl;
+      const double floorMsl =
+          static_cast<double>(_engine->terrainFloorEllipsoidMeters()) - geoidN;
+      const double minMsl = floorMsl + static_cast<double>(minAbove);
+      if (actual.altitude < minMsl) {
+        _integrator->clampActualAltitude(minMsl);
+        actual.altitude = minMsl;
       }
     }
 

package/lib/typescript/src/specs/cesium-view.nitro.d.ts

@@ -84,10 +84,12 @@ export interface CesiumViewProps extends HybridViewProps {
      */
     taskProcessorThreads?: number;
     /**
-     * Minimum altitude above the loaded terrain surface, in metres MSL.
-     * Default 0 (no constraint). Set to e.g. 2 to prevent the camera from going underground.
-     * The clamp is applied every frame in native, based on the altitude of the nearest
-     * terrain mesh vertex to the camera nadir.
+     * Minimum clearance above the loaded terrain surface, in metres (added on top of the
+     * terrain MSL height at the camera position). Default 0 (no constraint).
+     * Set to e.g. 2 to prevent the camera from going underground.
+     * The clamp runs only after terrain tiles have been sampled; until then the demand
+     * altitude is used as-is. The demand altitude is not modified — only the rendered
+     * (actual) camera may be raised to meet this minimum.
      */
     minAltitudeAboveTerrain?: number;
     /** Maximum yaw rate (degrees per second). 0 = uncapped. */

package/lib/typescript/src/specs/cesium-view.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cesium-view.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/cesium-view.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cesium-view.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/cesium-view.nitro.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-cesium",
-  "version": "1.2.9",
-  "description": "Experimental Cesium rendering for React Native via Nitro (iOS/Metal today; Android planned)",
+  "version": "1.2.11",
+  "description": "Experimental Cesium rendering for React Native via Nitro",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -64,7 +64,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "react-native-nitro-modules": "^0.35.6"
+    "react-native-nitro-modules": "^0.35.7"
   },
   "publishConfig": {
     "access": "public",
@@ -77,7 +77,7 @@
     "@types/jest": "^29.5.14",
     "@types/react": "19.2.14",
     "conventional-changelog-conventionalcommits": "^9.3.1",
-    "nitrogen": "0.35.6",
+    "nitrogen": "0.35.7",
     "react": "19.2.3",
     "react-native": "0.85.3",
     "react-native-builder-bob": "^0.41.0",

package/src/specs/cesium-view.nitro.ts

@@ -98,10 +98,12 @@ export interface CesiumViewProps extends HybridViewProps {
    */
   taskProcessorThreads?: number
   /**
-   * Minimum altitude above the loaded terrain surface, in metres MSL.
-   * Default 0 (no constraint). Set to e.g. 2 to prevent the camera from going underground.
-   * The clamp is applied every frame in native, based on the altitude of the nearest
-   * terrain mesh vertex to the camera nadir.
+   * Minimum clearance above the loaded terrain surface, in metres (added on top of the
+   * terrain MSL height at the camera position). Default 0 (no constraint).
+   * Set to e.g. 2 to prevent the camera from going underground.
+   * The clamp runs only after terrain tiles have been sampled; until then the demand
+   * altitude is used as-is. The demand altitude is not modified — only the rendered
+   * (actual) camera may be raised to meet this minimum.
    */
   minAltitudeAboveTerrain?: number