Merge pull request #1683 from GhisBntly/advviz-gltf-tuner

Access to glTF tuner and tuned tiles versions in the Unreal plugin

Author: kring

CHANGES.md

@@ -1,5 +1,11 @@
 # Change Log {#changes}
 
+### ? - ?
+
+##### Additions :tada:
+
+- Added an optional glTF model post-processing stage after the tile loading step, before the tile can be displayed.
+
 ### v2.21.1 - 2025-12-01
 
 This is the last release of Cesium for Unreal that will support Unreal Engine v5.4. Future versions will require Unreal Engine v5.5+.

Source/CesiumRuntime/Private/Cesium3DTileset.cpp

@@ -6,6 +6,7 @@
 #include "Camera/CameraTypes.h"
 #include "Camera/PlayerCameraManager.h"
 #include "Cesium3DTilesSelection/EllipsoidTilesetLoader.h"
+#include "Cesium3DTilesSelection/GltfModifier.h"
 #include "Cesium3DTilesSelection/Tile.h"
 #include "Cesium3DTilesSelection/TilesetLoadFailureDetails.h"
 #include "Cesium3DTilesSelection/TilesetOptions.h"
@@ -86,23 +87,32 @@ ACesium3DTileset::ACesium3DTileset()
       _pStateDebug(nullptr),
 #endif
 
+      _featuresMetadataDescription(),
+      _metadataDescription_DEPRECATED(),
+
       _lastTilesRendered(0),
       _lastWorkerThreadTileLoadQueueLength(0),
       _lastMainThreadTileLoadQueueLength(0),
 
       _lastTilesVisited(0),
+      _lastCulledTilesVisited(0),
       _lastTilesCulled(0),
       _lastTilesOccluded(0),
       _lastTilesWaitingForOcclusionResults(0),
       _lastMaxDepthVisited(0),
 
-      _captureMovieMode{false},
-      _beforeMoviePreloadAncestors{PreloadAncestors},
-      _beforeMoviePreloadSiblings{PreloadSiblings},
-      _beforeMovieLoadingDescendantLimit{LoadingDescendantLimit},
-      _beforeMovieUseLodTransitions{true},
+      _captureMovieMode(false),
+      _beforeMoviePreloadAncestors(PreloadAncestors),
+      _beforeMoviePreloadSiblings(PreloadSiblings),
+      _beforeMovieLoadingDescendantLimit(LoadingDescendantLimit),
+      _beforeMovieUseLodTransitions(true),
+
+      _scaleUsingDPI(false),
+      _tilesToHideNextFrame(),
 
-      _tilesetsBeingDestroyed(0) {
+      _tilesetsBeingDestroyed(0),
+      _pGltfModifier(nullptr),
+      _pLifecycleEventReceiver(nullptr) {
   PrimaryActorTick.bCanEverTick = true;
   PrimaryActorTick.TickGroup = ETickingGroup::TG_PostUpdateWork;
 
@@ -996,7 +1006,9 @@ void ACesium3DTileset::LoadTileset() {
            ->EnableExperimentalOcclusionCullingFeature &&
        this->EnableOcclusionCulling && this->BoundingVolumePoolComponent)
           ? this->BoundingVolumePoolComponent->getPool()
-          : nullptr};
+          : nullptr,
+      Cesium3DTilesSelection::TilesetSharedAssetSystem::getDefault(),
+      this->_pGltfModifier};
 
   this->_startTime = std::chrono::high_resolution_clock::now();
 
@@ -2320,15 +2332,28 @@ void ACesium3DTileset::RuntimeSettingsChanged(
 }
 #endif
 
+const std::shared_ptr<Cesium3DTilesSelection::GltfModifier>&
+ACesium3DTileset::GetGltfModifier() const {
+  return this->_pGltfModifier;
+}
+
+void ACesium3DTileset::SetGltfModifier(
+    const std::shared_ptr<Cesium3DTilesSelection::GltfModifier>& Modifier) {
+  if (Modifier != this->_pGltfModifier) {
+    this->_pGltfModifier = Modifier;
+    this->RefreshTileset();
+  }
+}
+
 ICesium3DTilesetLifecycleEventReceiver*
 ACesium3DTileset::GetLifecycleEventReceiver() {
   return Cast<ICesium3DTilesetLifecycleEventReceiver>(
       this->_pLifecycleEventReceiver);
 }
 
-void ACesium3DTileset::SetLifecycleEventReceiver(UObject* InEventReceiver) {
+void ACesium3DTileset::SetLifecycleEventReceiver(UObject* EventReceiver) {
   if (UKismetSystemLibrary::DoesImplementInterface(
-          InEventReceiver,
+          EventReceiver,
           UCesium3DTilesetLifecycleEventReceiver::StaticClass()))
-    this->_pLifecycleEventReceiver = InEventReceiver;
+    this->_pLifecycleEventReceiver = EventReceiver;
 }

Source/CesiumRuntime/Public/Cesium3DTileset.h

@@ -41,6 +41,7 @@ struct FCesiumCamera;
 class ICesium3DTilesetLifecycleEventReceiver;
 
 namespace Cesium3DTilesSelection {
+class GltfModifier;
 class Tileset;
 class TilesetView;
 class TileOcclusionRendererProxyPool;
@@ -1259,6 +1260,24 @@ class CESIUMRUNTIME_API ACesium3DTileset : public AActor {
    */
   void UpdateTransformFromCesium();
 
+  /**
+   * Gets the glTF modifier, an optional extension class that can edit
+   * each tile's glTF model after it has been loaded, before it can be
+   * displayed.
+   */
+  const std::shared_ptr<Cesium3DTilesSelection::GltfModifier>&
+  GetGltfModifier() const;
+
+  /**
+   * Sets the glTF modifier, an optional extension class that can edit
+   * each tile's glTF model after it has been loaded, before it can be
+   * displayed.
+   *
+   * Setting this property will call @ref RefreshTileset.
+   */
+  void SetGltfModifier(
+      const std::shared_ptr<Cesium3DTilesSelection::GltfModifier>& Modifier);
+
   /**
    * Gets the optional receiver of events related to the lifecycle of tiles
    * created by this tileset.
@@ -1274,7 +1293,7 @@ class CESIUMRUNTIME_API ACesium3DTileset : public AActor {
    * ICesium3DTilesetLifecycleEventReceiver, otherwise it will be as if nullptr
    * were passed.
    */
-  void SetLifecycleEventReceiver(UObject* InEventReceiver);
+  void SetLifecycleEventReceiver(UObject* EventReceiver);
 
 private:
   /**
@@ -1389,6 +1408,8 @@ class CESIUMRUNTIME_API ACesium3DTileset : public AActor {
 
   int32 _tilesetsBeingDestroyed;
 
+  std::shared_ptr<Cesium3DTilesSelection::GltfModifier> _pGltfModifier;
+
   // Make this visible to the garbage collector, but don't save/load/copy it.
   // Use UObject instead of TScriptInterface as suggested by
   // https://www.stevestreeting.com/2020/11/02/ue4-c-interfaces-hints-n-tips/,