Added an optional glTF model post-processing stage

after the tile loading step, before the tile can be displayed

Author: GhisBntly

CHANGES.md

@@ -5,6 +5,7 @@
 ##### Additions :tada:
 
 - Added support for `TRIANGLE_FAN` primitives in tile meshes.
+- Added an optional glTF model post-processing stage after the tile loading step, before the tile can be displayed.
 
 ##### Fixes :wrench:
 

Source/CesiumRuntime/Private/Cesium3DTileset.cpp

@@ -992,7 +992,10 @@ void ACesium3DTileset::LoadTileset() {
            ->EnableExperimentalOcclusionCullingFeature &&
        this->EnableOcclusionCulling && this->BoundingVolumePoolComponent)
           ? this->BoundingVolumePoolComponent->getPool()
-          : nullptr};
+          : nullptr,
+      {},
+      _gltfTuner
+  };
 
   this->_startTime = std::chrono::high_resolution_clock::now();
 
@@ -2325,3 +2328,8 @@ void ACesium3DTileset::RuntimeSettingsChanged(
   }
 }
 #endif
+
+void ACesium3DTileset::SetGltfTuner(
+    const std::shared_ptr<Cesium3DTilesSelection::GltfTuner>& tuner) {
+  _gltfTuner = tuner;
+}

Source/CesiumRuntime/Public/Cesium3DTileset.h

@@ -1257,6 +1257,15 @@ class CESIUMRUNTIME_API ACesium3DTileset : public AActor {
    */
   void UpdateTransformFromCesium();
 
+  /**
+   * Sets the glTF model tuner, an optional extension class that can edit
+   * each tile's glTF model after it has been loaded, before it can be
+   * displayed. Can only be called in the same engine tick after the tileset
+   * actor was spawned, or {@link RefreshTileset} was called.
+   */
+  void
+  SetGltfTuner(const std::shared_ptr<Cesium3DTilesSelection::GltfTuner>& tuner);
+
 private:
   /**
    * The event handler for ACesiumGeoreference::OnEllipsoidChanged.
@@ -1371,6 +1380,8 @@ class CESIUMRUNTIME_API ACesium3DTileset : public AActor {
 
   int32 _tilesetsBeingDestroyed;
 
+  std::shared_ptr<Cesium3DTilesSelection::GltfTuner> _gltfTuner;
+
   friend class UnrealPrepareRendererResources;
   friend class UCesiumGltfPointsComponent;
 };