Merge from main

Author: azrogers

CHANGES.md

@@ -1,5 +1,22 @@
 # Change Log {#changes}
 
+### v2.16.1 - 2025-06-02
+
+##### Additions :tada:
+
+- Added support for `TRIANGLE_FAN` primitives in tile meshes.
+
+##### Fixes :wrench:
+
+- Worked around an Unreal Engine limitation that prevented collisions and line traces from working correctly for tilesets with a very small scale factor.
+- Add a missing include for `GEngine` when packaging from source, introduced in `v2.16.0`.
+- Fixed a bug in `UCesiumFeaturesMetadataComponent` where multiple references to same feature ID set would cause improper encoding of its feature IDs.
+- Fixed a crash that would occur when duplicating an `ACesiumGeoreference`.
+- Fixed a bug that caused tilesets to render incorrectly when Dynamic Material Instances were used for their material settings.
+- Removed an unnecessary copy operation that happened while constructing tile meshes.
+
+In addition to the above, this release updates [cesium-native](https://github.com/CesiumGS/cesium-native) from v0.47.0 to v0.48.0. See the [changelog](https://github.com/CesiumGS/cesium-native/blob/main/CHANGES.md) for a complete list of changes in cesium-native.
+
 ### v2.16.0 - 2025-05-01
 
 ##### Additions :tada:

CesiumForUnreal.uplugin

@@ -1,7 +1,7 @@
 {
 	"FileVersion": 3,
-	"Version": 75,
-	"VersionName": "2.16.0",
+	"Version": 76,
+	"VersionName": "2.16.1",
 	"FriendlyName": "Cesium for Unreal",
 	"Description": "Unlock the 3D geospatial ecosystem in Unreal Engine with real-world 3D content and a high accuracy full-scale WGS84 globe.",
 	"Category": "Geospatial",

Content/Tests/Tilesets/BigCube/BigCube.glb

@@ -0,0 +1,14 @@
+{
+  "asset": { "version": "1.0" },
+  "root": {
+    "boundingVolume": {
+      "sphere": [
+        0,0,0,200000
+      ]
+    },
+    "children": [],
+    "content": { "uri": "BigCube.glb" },
+    "geometricError": 0.0,
+    "refine": "REPLACE"
+  }
+}

Content/Tests/Tilesets/BigCube/tileset.json

@@ -7,7 +7,7 @@ Unreal Insights can display the scope of timing events as well as activity acros
 
 # Set up a repeatable test
 
-In this example, we will use our Cesium performance tests. Follow the steps outlined [here](https://github.com/CesiumGS/cesium-unreal/blob/profiling-documentation/Documentation/performance-profiling-setup-test.md).
+In this example, we will use our Cesium performance tests. Follow the steps outlined [here](performance-profiling-setup-test.md).
 
 # Prepare for capture
 

Documentation/performance-profiling-with-unreal-insights.md

@@ -236,17 +236,20 @@ ACesiumGeoreference* ACesium3DTileset::ResolveGeoreference() {
         ACesiumGeoreference::GetDefaultGeoreferenceForActor(this);
   }
 
-  UCesium3DTilesetRoot* pRoot = Cast<UCesium3DTilesetRoot>(this->RootComponent);
-  if (pRoot) {
-    this->ResolvedGeoreference->OnGeoreferenceUpdated.AddUniqueDynamic(
-        pRoot,
-        &UCesium3DTilesetRoot::HandleGeoreferenceUpdated);
-    this->ResolvedGeoreference->OnEllipsoidChanged.AddUniqueDynamic(
-        this,
-        &ACesium3DTileset::HandleOnGeoreferenceEllipsoidChanged);
-
-    // Update existing tile positions, if any.
-    pRoot->HandleGeoreferenceUpdated();
+  if (this->ResolvedGeoreference) {
+    UCesium3DTilesetRoot* pRoot =
+        Cast<UCesium3DTilesetRoot>(this->RootComponent);
+    if (pRoot) {
+      this->ResolvedGeoreference->OnGeoreferenceUpdated.AddUniqueDynamic(
+          pRoot,
+          &UCesium3DTilesetRoot::HandleGeoreferenceUpdated);
+      this->ResolvedGeoreference->OnEllipsoidChanged.AddUniqueDynamic(
+          this,
+          &ACesium3DTileset::HandleOnGeoreferenceEllipsoidChanged);
+
+      // Update existing tile positions, if any.
+      pRoot->HandleGeoreferenceUpdated();
+    }
   }
 
   return this->ResolvedGeoreference;
@@ -1753,7 +1756,7 @@ ACesium3DTileset::CreateViewStateFromViewParameters(
   glm::dvec3 tilesetCameraUp = glm::normalize(
       glm::dvec3(unrealWorldToTileset * glm::dvec4(up.X, up.Y, up.Z, 0.0)));
 
-  return Cesium3DTilesSelection::ViewState::create(
+  return Cesium3DTilesSelection::ViewState(
       tilesetCameraLocation,
       tilesetCameraFront,
       tilesetCameraUp,

Source/CesiumRuntime/Private/Cesium3DTileset.cpp

@@ -62,10 +62,12 @@ void UCesium3DTilesetRoot::_updateAbsoluteLocation() {
 
 void UCesium3DTilesetRoot::_updateTilesetToUnrealRelativeWorldTransform() {
   ACesium3DTileset* pTileset = this->GetOwner<ACesium3DTileset>();
+  ACesiumGeoreference* pGeoreference = pTileset->ResolveGeoreference();
 
-  this->_tilesetToUnrealRelativeWorld = VecMath::createMatrix4D(
-      pTileset->ResolveGeoreference()
-          ->ComputeEarthCenteredEarthFixedToUnrealTransformation());
+  if (pGeoreference) {
+    this->_tilesetToUnrealRelativeWorld = VecMath::createMatrix4D(
+        pGeoreference->ComputeEarthCenteredEarthFixedToUnrealTransformation());
 
-  pTileset->UpdateTransformFromCesium();
+    pTileset->UpdateTransformFromCesium();
+  }
 }

Source/CesiumRuntime/Private/Cesium3DTilesetRoot.cpp

@@ -5,6 +5,7 @@
 #include "CesiumCreditSystemBPLoader.h"
 #include "CesiumRuntime.h"
 #include "CesiumUtility/CreditSystem.h"
+#include "Engine/Engine.h"
 #include "Engine/World.h"
 #include "EngineUtils.h"
 #include "ScreenCreditsWidget.h"