cesium-native 0.64.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
33public:
54 const CesiumGeospatial::Projection& projection,
55 const CesiumGeometry::QuadtreeTilingScheme& tilingScheme,
56 const CesiumGeometry::Rectangle& coverageRectangle,
57 uint32_t minimumLevel,
58 uint32_t maximumLevel,
59 uint32_t imageWidth,
60 uint32_t imageHeight) noexcept;
61
65 uint32_t getMinimumLevel() const noexcept { return this->_minimumLevel; }
66
70 uint32_t getMaximumLevel() const noexcept { return this->_maximumLevel; }
71
75 uint32_t getWidth() const noexcept { return this->_imageWidth; }
76
80 uint32_t getHeight() const noexcept { return this->_imageHeight; }
81
87 return this->_tilingScheme;
88 }
89
100 const CesiumGeometry::Rectangle& rectangle,
101 const glm::dvec2& screenPixels);
102
103protected:
113
114private:
116 loadTileImage(const RasterOverlayTile& overlayTile) override final;
117
118 struct LoadedQuadtreeImage
119 : public CesiumUtility::SharedAsset<LoadedQuadtreeImage> {
120 LoadedQuadtreeImage(
121 const std::shared_ptr<LoadedRasterOverlayImage>& pLoaded_,
122 const std::optional<CesiumGeometry::Rectangle>& subset_)
123 : pLoaded(pLoaded_), subset(subset_) {}
124 std::shared_ptr<LoadedRasterOverlayImage> pLoaded = nullptr;
125 std::optional<CesiumGeometry::Rectangle> subset = std::nullopt;
126
127 int64_t getSizeBytes() const {
128 int64_t accum = 0;
129 accum += int64_t(sizeof(LoadedQuadtreeImage));
130 if (pLoaded) {
131 accum += pLoaded->getSizeBytes();
132 }
133 return accum;
134 }
135 };
136
138 getQuadtreeTile(const CesiumGeometry::QuadtreeTileID& tileID);
139
150 std::vector<CesiumAsync::SharedFuture<
152 mapRasterTilesToGeometryTile(
153 const CesiumGeometry::Rectangle& geometryRectangle,
154 const glm::dvec2 targetScreenPixels);
155
156 struct CombinedImageMeasurements {
158 int32_t widthPixels;
159 int32_t heightPixels;
160 int32_t channels;
161 int32_t bytesPerChannel;
162 };
163
164 static CombinedImageMeasurements measureCombinedImage(
165 const CesiumGeometry::Rectangle& targetRectangle,
167 images);
168
169 static LoadedRasterOverlayImage combineImages(
170 const CesiumGeometry::Rectangle& targetRectangle,
171 const CesiumGeospatial::Projection& projection,
173
174 uint32_t _minimumLevel;
175 uint32_t _maximumLevel;
176 uint32_t _imageWidth;
177 uint32_t _imageHeight;
179
181 LoadedQuadtreeImage,
183 _pTileDepot;
184};
185} // namespace CesiumRasterOverlays
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.
QuadtreeRasterOverlayTileProvider(const CesiumUtility::IntrusivePointer< const RasterOverlay > &pCreator, const CreateRasterOverlayTileProviderParameters &parameters, 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.
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.
RasterOverlayTileProvider(const CesiumUtility::IntrusivePointer< const RasterOverlay > &pCreator, const CreateRasterOverlayTileProviderParameters &parameters, const CesiumGeospatial::Projection &projection, const CesiumGeometry::Rectangle &coverageRectangle) noexcept
Creates a new instance.
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:55
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