3#include <Cesium3DTilesSelection/Library.h>
4#include <Cesium3DTilesSelection/LoadedTileEnumerator.h>
5#include <Cesium3DTilesSelection/RasterOverlayCollection.h>
6#include <Cesium3DTilesSelection/SampleHeightResult.h>
7#include <Cesium3DTilesSelection/Tile.h>
8#include <Cesium3DTilesSelection/TilesetContentLoader.h>
9#include <Cesium3DTilesSelection/TilesetContentLoaderFactory.h>
10#include <Cesium3DTilesSelection/TilesetExternals.h>
11#include <Cesium3DTilesSelection/TilesetLoadFailureDetails.h>
12#include <Cesium3DTilesSelection/TilesetOptions.h>
13#include <Cesium3DTilesSelection/TilesetViewGroup.h>
14#include <Cesium3DTilesSelection/ViewState.h>
15#include <Cesium3DTilesSelection/ViewUpdateResult.h>
16#include <CesiumAsync/AsyncSystem.h>
17#include <CesiumUtility/IntrusivePointer.h>
19#include <rapidjson/fwd.h>
28class TilesetContentManager;
30class TilesetHeightQuery;
31struct TilesetHeightRequest;
42class CESIUM3DTILESSELECTION_API
Tileset final {
54 std::unique_ptr<TilesetContentLoader>&& pCustomLoader,
55 std::unique_ptr<Tile>&& pRootTile,
66 const std::string& url,
83 const std::string& ionAccessToken,
85 const std::string& ionAssetEndpointUrl =
"https://api.cesium.com/");
155 return this->_externals;
163 return this->_asyncSystem;
168 return this->_asyncSystem;
183 return this->_options.ellipsoid;
188 return this->_options.ellipsoid;
227 [[deprecated(
"Instead of `tileset.updateViewOffline(...)`, call "
228 "`tileset.updateViewGroupOffline(tileset.getDefaultViewGroup(), "
247 [[deprecated(
"Instead of `tileset.updateView(...)`, call "
248 "`tileset.updateViewGroup(tileset.getDefaultViewGroup(), ...)` "
300 const
std::function<
void(const
Tile& tile)>& callback) const;
409 float deltaTime = 0.0f);
474 struct TraversalDetails {
482 bool allAreRenderable =
true;
493 bool anyWereRenderedLastFrame =
false;
513 uint32_t notYetRenderableCount = 0;
516 TraversalDetails _renderLeaf(
521 TraversalDetails _renderInnerTile(
525 bool _kickDescendantsAndRenderTile(
529 TraversalDetails& traversalDetails,
530 size_t firstRenderedDescendantIndex,
533 double tilePriority);
536 TraversalDetails _visitTile(
540 bool ancestorMeetsSse,
547 bool shouldVisit =
true;
555 const TilesetFrameState& frameState,
556 bool cullWithChildrenBounds,
557 CullResult& cullResult);
559 const TilesetFrameState& frameState,
560 const std::vector<double>& distances,
561 CullResult& cullResult);
563 const std::vector<ViewState>& frustums,
565 const std::vector<double>& distances,
566 bool culled)
const noexcept;
568 TraversalDetails _visitTileIfNeeded(
569 const TilesetFrameState& frameState,
571 bool ancestorMeetsSse,
573 ViewUpdateResult& result);
574 TraversalDetails _visitVisibleChildrenNearToFar(
575 const TilesetFrameState& frameState,
577 bool ancestorMeetsSse,
579 ViewUpdateResult& result);
596 bool _loadAndRenderAdditiveRefinedTile(
597 const TilesetFrameState& frameState,
599 ViewUpdateResult& result,
603 void _unloadCachedTiles(
double timeBudget)
noexcept;
605 void _updateLodTransitions(
606 const TilesetFrameState& frameState,
608 ViewUpdateResult& result)
const noexcept;
610 TilesetExternals _externals;
613 TilesetOptions _options;
617 std::vector<double> _distances;
621 std::vector<const TileOcclusionRendererProxy*> _childOcclusionProxies;
624 _pTilesetContentManager;
626 std::list<TilesetHeightRequest> _heightRequests;
628 TilesetViewGroup _defaultViewGroup;
630 void addTileToLoadQueue(
631 const TilesetFrameState& frameState,
633 TileLoadPriorityGroup priorityGroup,
636 static TraversalDetails createTraversalDetailsForSingleTile(
637 const TilesetFrameState& frameState,
A "virtual collection" that allows enumeration through the loaded tiles in a subtree rooted at a give...
A "virtual collection" that allows enumeration through the loaded tiles in a subtree rooted at a give...
A collection of CesiumRasterOverlays::RasterOverlay instances that are associated with a Tileset.
The base class for something that requests loading of specific tiles from a 3D Tiles Tileset.
A factory to create a tileset loader.
External interfaces used by a Tileset.
Captures information about the current frame during a call to Tileset::updateViewGroup.
Contains assets that are potentially shared across multiple Tilesets.
Represents a group of views that collectively select tiles from a particular Tileset.
Tileset(const TilesetExternals &externals, TilesetContentLoaderFactory &&loaderFactory, const TilesetOptions &options=TilesetOptions())
Constructs a new instance with the given TilesetContentLoaderFactory.
void setShowCreditsOnScreen(bool showCreditsOnScreen) noexcept
Sets whether or not the tileset's credits should be shown on screen.
CesiumGeospatial::Ellipsoid & getEllipsoid() noexcept
Gets the CesiumGeospatial::Ellipsoid used by this tileset.
LoadedConstTileEnumerator loadedTiles() const
Gets an object that can be used to enumerate the loaded tiles of this tileset.
Tileset(const TilesetExternals &externals, int64_t ionAssetID, const std::string &ionAccessToken, const TilesetOptions &options=TilesetOptions(), const std::string &ionAssetEndpointUrl="https://api.cesium.com/")
Constructs a new instance with the given asset ID on Cesium ion.
Tileset(const TilesetExternals &externals, const std::string &url, const TilesetOptions &options=TilesetOptions())
Constructs a new instance with a given tileset.json URL.
CesiumAsync::AsyncSystem & getAsyncSystem() noexcept
Returns the CesiumAsync::AsyncSystem that is used for dispatching asynchronous tasks.
Tile * getRootTile() noexcept
Gets the root tile of this tileset.
CesiumAsync::Future< SampleHeightResult > sampleHeightMostDetailed(const std::vector< CesiumGeospatial::Cartographic > &positions)
Initiates an asynchronous query for the height of this tileset at a list of cartographic positions (l...
const TilesetOptions & getOptions() const noexcept
Gets the TilesetOptions of this tileset.
const TilesetExternals & getExternals() const noexcept
Gets the TilesetExternals that summarize the external interfaces used by this tileset.
void forEachLoadedTile(const std::function< void(Tile &tile)> &callback)
Invokes a function for each tile that is currently loaded.
const CesiumAsync::AsyncSystem & getAsyncSystem() const noexcept
Returns the CesiumAsync::AsyncSystem that is used for dispatching asynchronous tasks.
void loadTiles()
Loads the tiles that are currently deemed the most important, across all height queries and TilesetVi...
int32_t getNumberOfTilesLoaded() const
Gets the total number of tiles that are currently loaded.
CesiumAsync::SharedFuture< void > & getAsyncDestructionCompleteEvent()
A future that resolves when this Tileset has been destroyed (i.e. its destructor has been called) and...
CesiumAsync::SharedFuture< void > & getRootTileAvailableEvent()
A future that resolves when the details of the root tile of this tileset are available....
void registerLoadRequester(TileLoadRequester &requester)
Registers a tile load requester with this Tileset. Registered tile load requesters get to influence w...
TilesetViewGroup & getDefaultViewGroup()
Gets the default view group that is used when calling updateView.
float computeLoadProgress() noexcept
Gets the percentage of tiles that had been loaded for the default view group as of the last time it w...
const ViewUpdateResult & updateViewOffline(const std::vector< ViewState > &frustums)
Updates this view but waits for all tiles that meet sse to finish loading and ready to be rendered be...
int64_t getTotalDataBytes() const noexcept
Gets the total number of bytes of tile and raster overlay data that are currently loaded.
TilesetOptions & getOptions() noexcept
Gets the TilesetOptions of this tileset.
std::optional< CesiumUtility::Credit > getUserCredit() const noexcept
Gets the CesiumUtility::Credit created from TilesetOptions::credit, if any.
const TilesetMetadata * getMetadata(const Tile *pTile=nullptr) const
Gets the TilesetMetadata associated with the main or external tileset.json that contains a given tile...
const ViewUpdateResult & updateView(const std::vector< ViewState > &frustums, float deltaTime=0.0f)
Updates this view, returning the set of tiles to render in this view.
const ViewUpdateResult & updateViewGroup(TilesetViewGroup &viewGroup, const std::vector< ViewState > &frustums, float deltaTime=0.0f)
Updates a view group, returning the set of tiles to render in this view.
const CesiumGeospatial::Ellipsoid & getEllipsoid() const
Gets the CesiumGeospatial::Ellipsoid used by this tileset.
~Tileset() noexcept
Destroys this tileset.
Tileset(const TilesetExternals &externals, std::unique_ptr< TilesetContentLoader > &&pCustomLoader, std::unique_ptr< Tile > &&pRootTile, const TilesetOptions &options=TilesetOptions())
Constructs a new instance with a given custom tileset loader.
const std::vector< CesiumUtility::Credit > & getTilesetCredits() const noexcept
Get tileset credits.
RasterOverlayCollection & getOverlays() noexcept
Returns the RasterOverlayCollection of this tileset.
CesiumAsync::Future< const TilesetMetadata * > loadMetadata()
Asynchronously loads the metadata associated with the main tileset.json.
const ViewUpdateResult & updateViewGroupOffline(TilesetViewGroup &viewGroup, const std::vector< ViewState > &frustums)
Updates a view group, returning the set of tiles to render in this view. Unlike updateViewGroup,...
TilesetExternals & getExternals() noexcept
Gets the TilesetExternals that summarize the external interfaces used by this tileset.
TilesetSharedAssetSystem & getSharedAssetSystem() noexcept
Returns the TilesetSharedAssetSystem of this tileset.
The state of the view that is used during the traversal of a tileset.
Reports the results of Tileset::updateViewGroup.
A system for managing asynchronous requests and tasks.
A quadratic surface defined in Cartesian coordinates.
A smart pointer that calls addReference and releaseReference on the controlled object.
Classes that implement the 3D Tiles standard.
TileOcclusionState
The occlusion state of a tile as reported by the renderer proxy.
Classes that support asynchronous operations.
Classes for geospatial computations in Cesium.
Utility classes for Cesium.
The result of sampling heights with Tileset::sampleHeightMostDetailed.
Additional options for configuring a Tileset.
A checkpoint within this view group's load queue.