cesium-native  0.41.0
CesiumRasterOverlays::TileMapServiceRasterOverlay Class Referencefinal

A RasterOverlay based on tile map service imagery. More...

#include <CesiumRasterOverlays/TileMapServiceRasterOverlay.h>

Inheritance diagram for CesiumRasterOverlays::TileMapServiceRasterOverlay:
CesiumRasterOverlays::RasterOverlay CesiumUtility::ReferenceCounted< T, isThreadSafe > CesiumUtility::ThreadIdHolder< true >

Public Member Functions

 TileMapServiceRasterOverlay (const std::string &name, const std::string &url, const std::vector< CesiumAsync::IAssetAccessor::THeader > &headers={}, const TileMapServiceRasterOverlayOptions &tmsOptions={}, const RasterOverlayOptions &overlayOptions={})
 Creates a new instance. More...
 
virtual CesiumAsync::Future< CreateTileProviderResult > createTileProvider (const CesiumAsync::AsyncSystem &asyncSystem, const std::shared_ptr< CesiumAsync::IAssetAccessor > &pAssetAccessor, const std::shared_ptr< CesiumUtility::CreditSystem > &pCreditSystem, const std::shared_ptr< IPrepareRasterOverlayRendererResources > &pPrepareRendererResources, const std::shared_ptr< spdlog::logger > &pLogger, CesiumUtility::IntrusivePointer< const RasterOverlay > pOwner) const override
 Begins asynchronous creation of a tile provider for this overlay and eventually returns it via a Future. More...
 
- Public Member Functions inherited from CesiumRasterOverlays::RasterOverlay
 RasterOverlay (const std::string &name, const RasterOverlayOptions &overlayOptions=RasterOverlayOptions())
 Creates a new instance. More...
 
CesiumAsync::SharedFuture< void > & getAsyncDestructionCompleteEvent (const CesiumAsync::AsyncSystem &asyncSystem)
 A future that resolves when this RasterOverlay has been destroyed (i.e. its destructor has been called) and all async operations that it was executing have completed. More...
 
const std::string & getName () const noexcept
 Gets the name of this overlay.
 
RasterOverlayOptionsgetOptions () noexcept
 Gets options for this overlay.
 
const RasterOverlayOptionsgetOptions () const noexcept
 Gets options for this overlay. More...
 
const std::vector< CesiumUtility::Credit > & getCredits () const noexcept
 Gets the credits for this overlay.
 
std::vector< CesiumUtility::Credit > & getCredits () noexcept
 Gets the credits for this overlay.
 
CesiumUtility::IntrusivePointer< RasterOverlayTileProvidercreatePlaceholder (const CesiumAsync::AsyncSystem &asyncSystem, const std::shared_ptr< CesiumAsync::IAssetAccessor > &pAssetAccessor, const CesiumGeospatial::Ellipsoid &ellipsoid CESIUM_DEFAULT_ELLIPSOID) const
 Create a placeholder tile provider can be used in place of the real one while createTileProvider completes asynchronously. More...
 
- Public Member Functions inherited from CesiumUtility::ReferenceCounted< T, isThreadSafe >
void addReference () const
 Adds a counted reference to this object. Use CesiumUtility::IntrusivePointer instead of calling this method directly.
 
void releaseReference () const
 Removes a counted reference from this object. When the last reference is removed, this method will delete this instance. Use CesiumUtility::IntrusivePointer instead of calling this method directly.
 
std::int32_t getReferenceCount () const noexcept
 Returns the current reference count of this instance.
 

Additional Inherited Members

- Public Types inherited from CesiumRasterOverlays::RasterOverlay
using CreateTileProviderResult = nonstd::expected< CesiumUtility::IntrusivePointer< RasterOverlayTileProvider >, RasterOverlayLoadFailureDetails >
 

Detailed Description

A RasterOverlay based on tile map service imagery.

Definition at line 97 of file TileMapServiceRasterOverlay.h.

Constructor & Destructor Documentation

◆ TileMapServiceRasterOverlay()

CesiumRasterOverlays::TileMapServiceRasterOverlay::TileMapServiceRasterOverlay ( const std::string &  name,
const std::string &  url,
const std::vector< CesiumAsync::IAssetAccessor::THeader > &  headers = {},
const TileMapServiceRasterOverlayOptions tmsOptions = {},
const RasterOverlayOptions overlayOptions = {} 
)

Creates a new instance.

Parameters
nameThe user-given name of this overlay layer.
urlThe base URL.
headersThe headers. This is a list of pairs of strings of the form (Key,Value) that will be inserted as request headers internally.
tmsOptionsThe TileMapServiceRasterOverlayOptions.
overlayOptionsThe RasterOverlayOptions for this instance.

Member Function Documentation

◆ createTileProvider()

virtual CesiumAsync::Future<CreateTileProviderResult> CesiumRasterOverlays::TileMapServiceRasterOverlay::createTileProvider ( const CesiumAsync::AsyncSystem asyncSystem,
const std::shared_ptr< CesiumAsync::IAssetAccessor > &  pAssetAccessor,
const std::shared_ptr< CesiumUtility::CreditSystem > &  pCreditSystem,
const std::shared_ptr< IPrepareRasterOverlayRendererResources > &  pPrepareRendererResources,
const std::shared_ptr< spdlog::logger > &  pLogger,
CesiumUtility::IntrusivePointer< const RasterOverlay pOwner 
) const
overridevirtual

Begins asynchronous creation of a tile provider for this overlay and eventually returns it via a Future.

Parameters
asyncSystemThe async system used to do work in threads.
pAssetAccessorThe interface used to download assets like overlay metadata and tiles.
pCreditSystemThe CreditSystem to use when creating a per-TileProvider Credit.
pPrepareRendererResourcesThe interface used to prepare raster images for rendering.
pLoggerThe logger to which to send messages about the tile provider and tiles.
pOwnerThe overlay that owns this overlay, or nullptr if this overlay is not aggregated.
Returns
The future that resolves to the tile provider when it is ready, or to error details in the case of an error.

Implements CesiumRasterOverlays::RasterOverlay.


The documentation for this class was generated from the following file: