Add VectorTilesRasterOverlay

CHANGES.md

@@ -2,10 +2,15 @@
 
 ### ? - ?
 
+##### Breaking Changes :mega:
+
+- `CesiumRasterOverlays::GeoJsonDocumentRasterOverlay` has been moved to the `CesiumVectorOverlays` library and namespace.
+
 ##### Additions :tada:
 
 - Added support for [`EXT_mesh_primitive_edge_visibility`](https://github.com/KhronosGroup/glTF/pull/2479) in `CesiumGltf`, `CesiumGltfReader`, and `CesiumGltfWriter`.
 - Added support for [`3DTILES_content_conditional`](https://github.com/CesiumGS/3d-tiles/pull/834) in `Cesium3DTiles`, `Cesium3DTilesReader`, and `Cesium3DTilesWriter`.
+- Added `CesiumVectorOverlays::VectorTilesRasterOverlay` supporting vector data loaded from 3D Tiles tilesets.
 
 ### v0.60.0 - 2026-05-01
 

CMakeLists.txt

@@ -437,6 +437,7 @@ add_subdirectory(CesiumIonClient)
 add_subdirectory(CesiumITwinClient)
 add_subdirectory(CesiumQuantizedMeshTerrain)
 add_subdirectory(CesiumVectorData)
+add_subdirectory(CesiumVectorOverlays)
 
 if(NOT CESIUM_DISABLE_CURL)
     add_subdirectory(CesiumCurl)

Cesium3DTilesSelection/include/Cesium3DTilesSelection/Tileset.h

@@ -205,6 +205,13 @@ class CESIUM3DTILESSELECTION_API Tileset final {
    */
   const Tile* getRootTile() const noexcept;
 
+  /**
+   * @brief Gets the root tile of this tileset.
+   *
+   * This may be `nullptr` if there is currently no root tile.
+   */
+  Tile* getRootTile() noexcept;
+
   /**
    * @brief Returns the {@link RasterOverlayCollection} of this tileset.
    */
@@ -438,6 +445,21 @@ class CESIUM3DTILESSELECTION_API Tileset final {
    */
   void loadTiles();
 
+  /**
+   * @brief Updates the content of the given tile based on its current state.
+   *
+   * This may involve steps such as updating tile properties based on content,
+   * creating tile children, handling tile unloading, and more.
+   *
+   * @note This is automatically called as part of the normal tile selection
+   * process, such as when using \ref updateViewGroup or \ref
+   * updateViewGroupOffline. This method should only be called manually when
+   * tile selection is being driven by code external to the `Tileset`.
+   *
+   * @param tile The tile to update.
+   */
+  void updateTileContent(Tile& tile);
+
   /**
    * @brief Registers a tile load requester with this Tileset. Registered tile
    * load requesters get to influence which tiles are loaded when

Cesium3DTilesSelection/src/Tileset.cpp

@@ -24,6 +24,7 @@
 #include <CesiumAsync/Promise.h>
 #include <CesiumAsync/SharedFuture.h>
 #include <CesiumGeospatial/Cartographic.h>
+#include <CesiumRasterOverlays/ActivatedRasterOverlay.h>
 #include <CesiumRasterOverlays/RasterOverlayTile.h>
 #include <CesiumUtility/Assert.h>
 #include <CesiumUtility/CreditSystem.h>
@@ -170,6 +171,10 @@ const Tile* Tileset::getRootTile() const noexcept {
   return this->_pTilesetContentManager->getRootTile();
 }
 
+Tile* Tileset::getRootTile() noexcept {
+  return this->_pTilesetContentManager->getRootTile();
+}
+
 RasterOverlayCollection& Tileset::getOverlays() noexcept {
   return this->_pTilesetContentManager->getRasterOverlayCollection();
 }
@@ -472,6 +477,15 @@ void Tileset::loadTiles() {
   this->_pTilesetContentManager->processWorkerThreadLoadRequests(
       this->_options);
   this->_pTilesetContentManager->processMainThreadLoadRequests(this->_options);
+  for (const IntrusivePointer<ActivatedRasterOverlay>& pOverlay :
+       this->_pTilesetContentManager->getRasterOverlayCollection()
+           .getActivatedOverlays()) {
+    pOverlay->tick();
+  }
+}
+
+void Tileset::updateTileContent(Tile& tile) {
+  this->_pTilesetContentManager->updateTileContent(tile, this->_options);
 }
 
 void Tileset::registerLoadRequester(TileLoadRequester& requester) {

CesiumGltf/generated/include/CesiumGltf/ExtensionExtMeshPolygon.h

@@ -0,0 +1,65 @@
+// This file was generated by generate-classes.
+// DO NOT EDIT THIS FILE!
+#pragma once
+
+#include <CesiumGltf/Library.h>
+#include <CesiumUtility/ExtensibleObject.h>
+
+#include <cstdint>
+
+namespace CesiumGltf {
+/**
+ * @brief glTF extension adding an encoding of polygon primitive topology
+ */
+struct CESIUMGLTF_API ExtensionExtMeshPolygon final
+    : public CesiumUtility::ExtensibleObject {
+  /**
+   * @brief The original name of this type.
+   */
+  static constexpr const char* TypeName = "ExtensionExtMeshPolygon";
+  /** @brief The official name of the extension. This should be the same as its
+   * key in the `extensions` object. */
+  static constexpr const char* ExtensionName = "EXT_mesh_polygon";
+
+  /**
+   * @brief Integer number of polygons encoded in the mesh primitive.
+   */
+  int32_t count = -1;
+
+  /**
+   * @brief Index of an accessor containing indices of the polygons' exterior
+   * and interior loops. The accessor MUST have SCALAR type and an unsigned
+   * integer component type.
+   */
+  int32_t loopIndices = -1;
+
+  /**
+   * @brief Index of an accessor containing one integer offset per polygon in
+   * the primitive, indicating the first index of the first linear ring
+   * associated with that polygon.
+   */
+  int32_t loopIndicesOffsets = -1;
+
+  /**
+   * @brief Index of an accessor containing one integer offset per polygon in
+   * the primitive, indicating the first index of the first triangle associated
+   * with that polygon.
+   */
+  int32_t indicesOffsets = -1;
+
+  /**
+   * @brief Calculates the size in bytes of this object, including the contents
+   * of all collections, pointers, and strings. This will NOT include the size
+   * of any extensions attached to the object. Calling this method may be slow
+   * as it requires traversing the object's entire structure.
+   */
+  int64_t getSizeBytes() const {
+    int64_t accum = 0;
+    accum += int64_t(sizeof(ExtensionExtMeshPolygon));
+    accum += CesiumUtility::ExtensibleObject::getSizeBytes() -
+             int64_t(sizeof(CesiumUtility::ExtensibleObject));
+
+    return accum;
+  }
+};
+} // namespace CesiumGltf

CesiumGltf/generated/include/CesiumGltf/ExtensionKhrGaussianSplatting.h

@@ -22,17 +22,15 @@ struct CESIUMGLTF_API ExtensionKhrGaussianSplatting final
   static constexpr const char* ExtensionName = "KHR_gaussian_splatting";
 
   /**
-   * @brief Known values for Property specifying parameters regarding the kernel
-   * used to generate the Gaussians.
+   * @brief Known values for The kernel used to generate the Gaussians.
    */
   struct Kernel {
     /** @brief `ellipse` */
     inline static const std::string ellipse = "ellipse";
   };
 
   /**
-   * @brief Known values for Property specifying the color space of the
-   * spherical harmonics.
+   * @brief Known values for The color space of the reconstructed color values.
    */
   struct ColorSpace {
     /** @brief `srgb_rec709_display` */
@@ -43,53 +41,47 @@ struct CESIUMGLTF_API ExtensionKhrGaussianSplatting final
   };
 
   /**
-   * @brief Known values for Optional property specifying how to project the
-   * Gaussians to achieve a perspective correct value. This property defaults to
-   * perspective.
+   * @brief Known values for The projection method for rendering the Gaussians.
    */
   struct Projection {
     /** @brief `perspective` */
     inline static const std::string perspective = "perspective";
   };
 
   /**
-   * @brief Known values for Optional property specifying how to sort the
-   * Gaussians during rendering. This property defaults to cameraDistance.
+   * @brief Known values for The sorting method for rendering the Gaussians.
    */
   struct SortingMethod {
     /** @brief `cameraDistance` */
     inline static const std::string cameraDistance = "cameraDistance";
   };
 
   /**
-   * @brief Property specifying parameters regarding the kernel used to generate
-   * the Gaussians.
+   * @brief The kernel used to generate the Gaussians.
    *
    * Known values are defined in {@link Kernel}.
    *
    */
   std::string kernel = Kernel::ellipse;
 
   /**
-   * @brief Property specifying the color space of the spherical harmonics.
+   * @brief The color space of the reconstructed color values.
    *
    * Known values are defined in {@link ColorSpace}.
    *
    */
   std::string colorSpace = ColorSpace::srgb_rec709_display;
 
   /**
-   * @brief Optional property specifying how to project the Gaussians to achieve
-   * a perspective correct value. This property defaults to perspective.
+   * @brief The projection method for rendering the Gaussians.
    *
    * Known values are defined in {@link Projection}.
    *
    */
   std::string projection = Projection::perspective;
 
   /**
-   * @brief Optional property specifying how to sort the Gaussians during
-   * rendering. This property defaults to cameraDistance.
+   * @brief The sorting method for rendering the Gaussians.
    *
    * Known values are defined in {@link SortingMethod}.
    *

CesiumGltf/include/CesiumGltf/AccessorUtility.h

@@ -154,6 +154,49 @@ typedef std::variant<
 IndexAccessorType
 getIndexAccessorView(const Model& model, const MeshPrimitive& primitive);
 
+/**
+ * Retrieves an indices accessor view of the accessor at the given index.
+ */
+IndexAccessorType getIndexAccessorView(const Model& model, int32_t index);
+
+/**
+ * Visitor that returns the number of indices contained in an IndexAccessorType
+ * variant.
+ */
+struct NumIndicesFromAccessor {
+  /**
+   * @brief Attempts to obtain a number of indices from an empty
+   * IndexAccessorType, resulting in 0.
+   */
+  int64_t operator()(std::monostate) { return 0; }
+
+  /**
+   * @brief Attempts to obtain a number of indices from an \ref AccessorView.
+   */
+  template <typename T> int64_t operator()(const AccessorView<T>& value) {
+    return value.size();
+  }
+};
+
+/**
+ * @brief Returns the maximum possible index value for the given
+ * IndexAccessorType.
+ */
+struct MaxIndexValueFromAccessor {
+  /**
+   * @brief Attempts to obtain a maximum index value from an empty
+   * IndexAccessorType, resulting in -1.
+   */
+  int64_t operator()(std::monostate) { return -1; }
+
+  /**
+   * @brief Attempts to obtain a maximum index value from an \ref AccessorView.
+   */
+  template <typename T> int64_t operator()(const AccessorView<T>& /*value*/) {
+    return static_cast<int64_t>(std::numeric_limits<T>::max());
+  }
+};
+
 /**
  * Visitor that retrieves the vertex indices from the given accessor type
  * corresponding to a given face index. These indices are returned as an array

CesiumGltf/src/AccessorUtility.cpp

@@ -117,12 +117,15 @@ FeatureIdAccessorType getFeatureIdAccessorView(
 
 IndexAccessorType
 getIndexAccessorView(const Model& model, const MeshPrimitive& primitive) {
-  if (primitive.indices < 0) {
+  return getIndexAccessorView(model, primitive.indices);
+}
+
+IndexAccessorType getIndexAccessorView(const Model& model, int32_t index) {
+  if (index < 0) {
     return IndexAccessorType();
   }
 
-  const Accessor* pAccessor =
-      model.getSafe<Accessor>(&model.accessors, primitive.indices);
+  const Accessor* pAccessor = model.getSafe<Accessor>(&model.accessors, index);
   if (!pAccessor || pAccessor->type != Accessor::Type::SCALAR ||
       pAccessor->normalized) {
     return AccessorView<uint8_t>();

CesiumGltfReader/generated/include/CesiumGltfReader/ExtensionExtMeshPolygonReader.h

@@ -0,0 +1,76 @@
+// This file was generated by generate-classes.
+// DO NOT EDIT THIS FILE!
+#pragma once
+
+#include <CesiumGltf/ExtensionExtMeshPolygon.h>
+#include <CesiumGltfReader/Library.h>
+#include <CesiumJsonReader/JsonReader.h>
+#include <CesiumJsonReader/JsonReaderOptions.h>
+
+#include <rapidjson/fwd.h>
+
+#include <span>
+#include <vector>
+
+namespace CesiumGltf {
+struct ExtensionExtMeshPolygon;
+} // namespace CesiumGltf
+
+namespace CesiumGltfReader {
+
+/**
+ * @brief Reads \ref CesiumGltf::ExtensionExtMeshPolygon
+ * "ExtensionExtMeshPolygon" instances from JSON.
+ */
+class CESIUMGLTFREADER_API ExtensionExtMeshPolygonReader {
+public:
+  /**
+   * @brief Constructs a new instance.
+   */
+  ExtensionExtMeshPolygonReader();
+
+  /**
+   * @brief Gets the options controlling how the JSON is read.
+   */
+  CesiumJsonReader::JsonReaderOptions& getOptions();
+
+  /**
+   * @brief Gets the options controlling how the JSON is read.
+   */
+  const CesiumJsonReader::JsonReaderOptions& getOptions() const;
+
+  /**
+   * @brief Reads an instance of ExtensionExtMeshPolygon from a byte buffer.
+   *
+   * @param data The buffer from which to read the instance.
+   * @return The result of reading the instance.
+   */
+  CesiumJsonReader::ReadJsonResult<CesiumGltf::ExtensionExtMeshPolygon>
+  readFromJson(const std::span<const std::byte>& data) const;
+
+  /**
+   * @brief Reads an instance of ExtensionExtMeshPolygon from a
+   * rapidJson::Value.
+   *
+   * @param value The value from which to read the instance.
+   * @return The result of reading the instance.
+   */
+  CesiumJsonReader::ReadJsonResult<CesiumGltf::ExtensionExtMeshPolygon>
+  readFromJson(const rapidjson::Value& value) const;
+
+  /**
+   * @brief Reads an array of instances of ExtensionExtMeshPolygon from a
+   * rapidJson::Value.
+   *
+   * @param value The value from which to read the array of instances.
+   * @return The result of reading the array of instances.
+   */
+  CesiumJsonReader::ReadJsonResult<
+      std::vector<CesiumGltf::ExtensionExtMeshPolygon>>
+  readArrayFromJson(const rapidjson::Value& value) const;
+
+private:
+  CesiumJsonReader::JsonReaderOptions _options;
+};
+
+} // namespace CesiumGltfReader