add wmts wms tms urltemplate rasterOverlay

src/vsgCs/CMakeLists.txt

@@ -8,6 +8,10 @@ set(LIB_PUBLIC_HEADERS
   ${PROJECT_BINARY_DIR}/include/vsgCs/Config.h
   CRS.h
   CsDebugColorizeTilesOverlay.h
+  CsWebMapServiceRasterOverlay.h
+  CsWebMapTileServiceRasterOverlay.h
+  CsTileMapServiceRasterOverlay.h
+  CsUrlTemplateRasterOverlay.h
   CsOverlay.h
   CesiumGltfBuilder.h
   ${CMAKE_CURRENT_BINARY_DIR}/Export.h
@@ -32,6 +36,10 @@ set(LIB_PUBLIC_HEADERS
 set(SOURCES
   CRS.cpp
   CsDebugColorizeTilesOverlay.cpp
+  CsWebMapServiceRasterOverlay.cpp
+  CsWebMapTileServiceRasterOverlay.cpp
+  CsTileMapServiceRasterOverlay.cpp
+  CsUrlTemplateRasterOverlay.cpp
   CsOverlay.cpp
   CesiumGltfBuilder.cpp
   CompilableImage.cpp

src/vsgCs/CsTileMapServiceRasterOverlay.cpp

@@ -0,0 +1,82 @@
+/* <editor-fold desc="MIT License">
+
+Copyright(c) 2023 Timothy Moore
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+</editor-fold> */
+
+#include "CsTileMapServiceRasterOverlay.h"
+
+#include "jsonUtils.h"
+#include <CesiumRasterOverlays/TileMapServiceRasterOverlay.h>
+#include <CesiumUtility/JsonHelpers.h>
+
+using namespace vsgCs;
+
+CesiumRasterOverlays::RasterOverlay* CsTileMapServiceRasterOverlay::createOverlay(
+    const CesiumRasterOverlays::RasterOverlayOptions& options)
+{
+    if (this->Url.empty())
+    {
+        // Don't create an overlay with an empty URL.
+        return nullptr;
+    }
+
+    CesiumRasterOverlays::TileMapServiceRasterOverlayOptions tmsOptions;
+    if (MaximumLevel > MinimumLevel && bSpecifyZoomLevels)
+    {
+        tmsOptions.minimumLevel = MinimumLevel;
+        tmsOptions.maximumLevel = MaximumLevel;
+    }
+
+    std::vector<CesiumAsync::IAssetAccessor::THeader> headers;
+
+    for (const auto& [Key, Value] : this->RequestHeaders)
+    {
+        headers.push_back(CesiumAsync::IAssetAccessor::THeader{
+            (Key),
+            (Value) });
+    }
+
+    return new CesiumRasterOverlays::TileMapServiceRasterOverlay(
+        (this->MaterialLayerKey),
+        (this->Url),
+        headers,
+        tmsOptions,
+        options);
+}
+
+namespace vsgCs
+{
+    vsg::ref_ptr<vsg::Object> buildCsTileMapServiceRasterOverlay(const rapidjson::Value& json,
+        JSONObjectFactory* factory,
+        const vsg::ref_ptr<vsg::Object>& object)
+    {
+        auto overlay = create_or<CsTileMapServiceRasterOverlay>(object);
+        factory->build(json, "CsOverlay", overlay);
+        overlay->MaterialLayerKey = CesiumUtility::JsonHelpers::getStringOrDefault(json, "materialKey",
+            "Overlay0");
+        overlay->Url = CesiumUtility::JsonHelpers::getStringOrDefault(json, "url", "");
+
+        return overlay;
+    }
+
+    // XXX See jsonUtils for registration.
+}

src/vsgCs/CsTileMapServiceRasterOverlay.h

@@ -0,0 +1,71 @@
+/* <editor-fold desc="MIT License">
+
+Copyright(c) 2023 Timothy Moore
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+</editor-fold> */
+
+#pragma once
+
+#include "CsOverlay.h"
+
+namespace vsgCs
+{
+    class VSGCS_EXPORT CsTileMapServiceRasterOverlay : public vsg::Inherit<CsOverlay,
+        CsTileMapServiceRasterOverlay>
+    {
+    public:
+        CsTileMapServiceRasterOverlay(
+            std::string in_Url = std::string())
+            : Url(in_Url)
+        {
+        }
+
+        /**
+         * The base URL of the Tile Map Service (TMS).
+         */
+        std::string Url;
+
+        /**
+         * True to directly specify minum and maximum zoom levels available from the
+         * server, or false to automatically determine the minimum and maximum zoom
+         * levels from the server's tilemapresource.xml file.
+         */
+        bool bSpecifyZoomLevels = false;
+
+        /**
+         * Minimum zoom level.
+         */
+        int32_t MinimumLevel = 0;
+
+        /**
+         * Maximum zoom level.
+         */
+        int32_t MaximumLevel = 10;
+
+        /**
+         * HTTP headers to be attached to each request made for this raster overlay.
+         */
+        std::map<std::string, std::string> RequestHeaders;
+
+        CesiumRasterOverlays::RasterOverlay* createOverlay(
+            const CesiumRasterOverlays::RasterOverlayOptions& options) override;
+    };
+}

src/vsgCs/CsUrlTemplateRasterOverlay.cpp

@@ -0,0 +1,118 @@
+/* <editor-fold desc="MIT License">
+
+Copyright(c) 2023 Timothy Moore
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+</editor-fold> */
+
+#include "CsUrlTemplateRasterOverlay.h"
+
+#include "jsonUtils.h"
+#include <CesiumRasterOverlays/UrlTemplateRasterOverlay.h>
+#include <CesiumUtility/JsonHelpers.h>
+
+using namespace vsgCs;
+
+CesiumRasterOverlays::RasterOverlay* CsUrlTemplateRasterOverlay::createOverlay(
+    const CesiumRasterOverlays::RasterOverlayOptions& options)
+{
+    if (this->TemplateUrl.empty())
+    {
+        // Don't create an overlay with an empty base URL.
+        return nullptr;
+    }
+
+    CesiumRasterOverlays::UrlTemplateRasterOverlayOptions urlTemplateOptions;
+
+    urlTemplateOptions.minimumLevel = MinimumLevel;
+    urlTemplateOptions.maximumLevel = MaximumLevel;
+
+    urlTemplateOptions.tileWidth = this->TileWidth;
+    urlTemplateOptions.tileHeight = this->TileHeight;
+
+    const CesiumGeospatial::Ellipsoid& ellipsoid = options.ellipsoid;
+
+    if (this->Projection ==
+        ECesiumUrlTemplateRasterOverlayProjection::Geographic)
+    {
+        urlTemplateOptions.projection =
+            CesiumGeospatial::GeographicProjection(ellipsoid);
+    }
+    else
+    {
+        urlTemplateOptions.projection =
+            CesiumGeospatial::WebMercatorProjection(ellipsoid);
+    }
+
+    if (bSpecifyTilingScheme)
+    {
+        CesiumGeospatial::GlobeRectangle globeRectangle =
+            CesiumGeospatial::GlobeRectangle::fromDegrees(
+                RectangleWest,
+                RectangleSouth,
+                RectangleEast,
+                RectangleNorth);
+        CesiumGeometry::Rectangle coverageRectangle =
+            CesiumGeospatial::projectRectangleSimple(
+                *urlTemplateOptions.projection,
+                globeRectangle);
+        urlTemplateOptions.coverageRectangle = coverageRectangle;
+        urlTemplateOptions.tilingScheme = CesiumGeometry::QuadtreeTilingScheme(
+            coverageRectangle,
+            RootTilesX,
+            RootTilesY);
+    }
+
+    std::vector<CesiumAsync::IAssetAccessor::THeader> headers;
+
+    for (const auto& [Key, Value] : this->RequestHeaders)
+    {
+        headers.push_back(CesiumAsync::IAssetAccessor::THeader{
+            (Key),
+            (Value) });
+    }
+
+    return new CesiumRasterOverlays::UrlTemplateRasterOverlay(
+        (this->MaterialLayerKey),
+        (this->TemplateUrl),
+        headers,
+        urlTemplateOptions,
+        options);
+}
+
+namespace vsgCs
+{
+    vsg::ref_ptr<vsg::Object> buildCsUrlTemplateRasterOverlay(const rapidjson::Value& json,
+        JSONObjectFactory* factory,
+        const vsg::ref_ptr<vsg::Object>& object)
+    {
+        auto overlay = create_or<CsUrlTemplateRasterOverlay>(object);
+        factory->build(json, "CsOverlay", overlay);
+        overlay->MaterialLayerKey = CesiumUtility::JsonHelpers::getStringOrDefault(json, "materialKey",
+            "Overlay0");
+        overlay->TemplateUrl = CesiumUtility::JsonHelpers::getStringOrDefault(json, "url", "");
+        std::string projection = CesiumUtility::JsonHelpers::getStringOrDefault(json, "projection", "");
+        overlay->Projection = projection == "geographic" ? ECesiumUrlTemplateRasterOverlayProjection::Geographic : ECesiumUrlTemplateRasterOverlayProjection::WebMercator;
+
+        return overlay;
+    }
+
+    // XXX See jsonUtils for registration.
+}