cesium-native 0.50.0
Loading...
Searching...
No Matches
QuadtreeRasterOverlayTileProvider.h
1#pragma once
2
3#include <CesiumAsync/AsyncSystem.h>
4#include <CesiumAsync/IAssetAccessor.h>
5#include <CesiumAsync/SharedAssetDepot.h>
6#include <CesiumGeometry/QuadtreeTileID.h>
7#include <CesiumGeometry/QuadtreeTilingScheme.h>
8#include <CesiumRasterOverlays/IPrepareRasterOverlayRendererResources.h>
9#include <CesiumRasterOverlays/Library.h>
10#include <CesiumRasterOverlays/RasterOverlayTileProvider.h>
11#include <CesiumUtility/CreditSystem.h>
12#include <CesiumUtility/Result.h>
13#include <CesiumUtility/SharedAsset.h>
14
15#include <list>
16#include <memory>
17#include <optional>
18
19namespace CesiumRasterOverlays {
20
31class CESIUMRASTEROVERLAYS_API QuadtreeRasterOverlayTileProvider
33
34public:
59 const CesiumAsync::AsyncSystem& asyncSystem,
60 const std::shared_ptr<CesiumAsync::IAssetAccessor>& pAssetAccessor,
61 const std::shared_ptr<CesiumUtility::CreditSystem>& pCreditSystem,
62 std::optional<CesiumUtility::Credit> credit,
63 const std::shared_ptr<IPrepareRasterOverlayRendererResources>&
64 pPrepareRendererResources,
65 const std::shared_ptr<spdlog::logger>& pLogger,
66 const CesiumGeospatial::Projection& projection,
67 const CesiumGeometry::QuadtreeTilingScheme& tilingScheme,
68 const CesiumGeometry::Rectangle& coverageRectangle,
69 uint32_t minimumLevel,
70 uint32_t maximumLevel,
71 uint32_t imageWidth,
72 uint32_t imageHeight) noexcept;
73
77 uint32_t getMinimumLevel() const noexcept { return this->_minimumLevel; }
78
82 uint32_t getMaximumLevel() const noexcept { return this->_maximumLevel; }
83
87 uint32_t getWidth() const noexcept { return this->_imageWidth; }
88
92 uint32_t getHeight() const noexcept { return this->_imageHeight; }
93
99 return this->_tilingScheme;
100 }
101
112 const CesiumGeometry::Rectangle& rectangle,
113 const glm::dvec2& screenPixels);
114
115protected:
125
126private:
128 loadTileImage(RasterOverlayTile& overlayTile) override final;
129
130 struct LoadedQuadtreeImage
131 : public CesiumUtility::SharedAsset<LoadedQuadtreeImage> {
132 LoadedQuadtreeImage(
133 const std::shared_ptr<LoadedRasterOverlayImage>& pLoaded_,
134 const std::optional<CesiumGeometry::Rectangle>& subset_)
135 : pLoaded(pLoaded_), subset(subset_) {}
136 std::shared_ptr<LoadedRasterOverlayImage> pLoaded = nullptr;
137 std::optional<CesiumGeometry::Rectangle> subset = std::nullopt;
138
139 int64_t getSizeBytes() const {
140 int64_t accum = 0;
141 accum += int64_t(sizeof(LoadedQuadtreeImage));
142 if (pLoaded) {
143 accum += pLoaded->getSizeBytes();
144 }
145 return accum;
146 }
147 };
148
150 getQuadtreeTile(const CesiumGeometry::QuadtreeTileID& tileID);
151
162 std::vector<CesiumAsync::SharedFuture<
164 mapRasterTilesToGeometryTile(
165 const CesiumGeometry::Rectangle& geometryRectangle,
166 const glm::dvec2 targetScreenPixels);
167
168 struct CombinedImageMeasurements {
170 int32_t widthPixels;
171 int32_t heightPixels;
172 int32_t channels;
173 int32_t bytesPerChannel;
174 };
175
176 static CombinedImageMeasurements measureCombinedImage(
177 const CesiumGeometry::Rectangle& targetRectangle,
179 images);
180
181 static LoadedRasterOverlayImage combineImages(
182 const CesiumGeometry::Rectangle& targetRectangle,
183 const CesiumGeospatial::Projection& projection,
185
186 uint32_t _minimumLevel;
187 uint32_t _maximumLevel;
188 uint32_t _imageWidth;
189 uint32_t _imageHeight;
191
193 LoadedQuadtreeImage,
195 _pTileDepot;
196};
197} // namespace CesiumRasterOverlays
A system for managing asynchronous requests and tasks.
Definition AsyncSystem.h:36
A value that will be available in the future, as produced by AsyncSystem.
Definition Future.h:29
A depot for CesiumUtility::SharedAsset instances, which are potentially shared between multiple objec...
A value that will be available in the future, as produced by AsyncSystem. Unlike Future,...
Defines how a rectangular region is divided into quadtree tiles.
uint32_t getHeight() const noexcept
Returns the image height of this instance, in pixels.
uint32_t computeLevelFromTargetScreenPixels(const CesiumGeometry::Rectangle &rectangle, const glm::dvec2 &screenPixels)
Computes the best quadtree level to use for an image intended to cover a given projected rectangle wh...
uint32_t getMinimumLevel() const noexcept
Returns the minimum tile level of this instance.
uint32_t getWidth() const noexcept
Returns the image width of this instance, in pixels.
virtual CesiumAsync::Future< LoadedRasterOverlayImage > loadQuadtreeTileImage(const CesiumGeometry::QuadtreeTileID &tileID) const =0
Asynchronously loads a tile in the quadtree.
uint32_t getMaximumLevel() const noexcept
Returns the maximum tile level of this instance.
const CesiumGeometry::QuadtreeTilingScheme & getTilingScheme() const noexcept
Returns the CesiumGeometry::QuadtreeTilingScheme of this instance.
QuadtreeRasterOverlayTileProvider(const CesiumUtility::IntrusivePointer< const RasterOverlay > &pOwner, const CesiumAsync::AsyncSystem &asyncSystem, const std::shared_ptr< CesiumAsync::IAssetAccessor > &pAssetAccessor, const std::shared_ptr< CesiumUtility::CreditSystem > &pCreditSystem, std::optional< CesiumUtility::Credit > credit, const std::shared_ptr< IPrepareRasterOverlayRendererResources > &pPrepareRendererResources, const std::shared_ptr< spdlog::logger > &pLogger, const CesiumGeospatial::Projection &projection, const CesiumGeometry::QuadtreeTilingScheme &tilingScheme, const CesiumGeometry::Rectangle &coverageRectangle, uint32_t minimumLevel, uint32_t maximumLevel, uint32_t imageWidth, uint32_t imageHeight) noexcept
Creates a new instance.
RasterOverlayTileProvider(const CesiumUtility::IntrusivePointer< const RasterOverlay > &pOwner, const CesiumAsync::AsyncSystem &asyncSystem, const std::shared_ptr< CesiumAsync::IAssetAccessor > &pAssetAccessor, const std::shared_ptr< CesiumUtility::CreditSystem > &pCreditSystem, const CesiumGeospatial::Ellipsoid &ellipsoid=CesiumGeospatial::Ellipsoid::WGS84) noexcept
Raster image data for a tile in a quadtree.
A smart pointer that calls addReference and releaseReference on the controlled object.
An asset that is potentially shared between multiple objects, such as an image shared between multipl...
Definition SharedAsset.h:52
std::variant< GeographicProjection, WebMercatorProjection > Projection
A projection.
Definition Projection.h:25
Classes for raster overlays, which allow draping massive 2D textures over a model.
Result< IntrusivePointer< T > > ResultPointer
A convenient shortcut for CesiumUtility::Result<CesiumUtility::IntrusivePointer<T>>.
Definition Result.h:122
Uniquely identifies a node in a quadtree.
A 2D rectangle.
Definition Rectangle.h:14