LuciadCPillar 2023.1.03
luciad::IMultilevelTiledRasterDataRetriever Class Referenceabstract

The interface to implement to retrieve the raster tile for a given tile coordinate. More...

#include <luciad/models/rasters/IMultilevelTiledRasterDataRetriever.h>

Public Member Functions

virtual ~IMultilevelTiledRasterDataRetriever ()=default
 
virtual void retrieveTileData (const MultilevelTileCoordinate &tileCoordinate, const CancellationToken &cancellationToken, const std::shared_ptr< IMultilevelTiledRasterDataRetrieverCallback > &callback)=0
 Retrieves the raster tile data for a give tile coordinate. More...
 

Detailed Description

The interface to implement to retrieve the raster tile for a given tile coordinate.

Since
2022.1

Constructor & Destructor Documentation

◆ ~IMultilevelTiledRasterDataRetriever()

virtual luciad::IMultilevelTiledRasterDataRetriever::~IMultilevelTiledRasterDataRetriever ( )
virtualdefault

Member Function Documentation

◆ retrieveTileData()

virtual void luciad::IMultilevelTiledRasterDataRetriever::retrieveTileData ( const MultilevelTileCoordinate tileCoordinate,
const CancellationToken cancellationToken,
const std::shared_ptr< IMultilevelTiledRasterDataRetrieverCallback > &  callback 
)
pure virtual

Retrieves the raster tile data for a give tile coordinate.

Call one of the methods on the callback.

When the data is retrieved successfully you can call either onDataAvailable or onImageAvailable depending on whether you provide the 'raw' tile data or decoded already as an image.

When there is no tile data available for a tile coordinate call the method onDataNotAvailable.

When an error occurred while retrieving the raster tile data call the method onError.

When the request has been canceled call the method onCanceled. Note that while handling the tile data retrieval you need to check within your implementation whether the cancellation token has changed its value to true using the method isCanceled.

When none of the callback methods is called the data cannot be visualized.

This function must be thread-safe.

Parameters
tileCoordinatethe tile coordinate.
cancellationTokena cancellation token.
callbackthe callback on which to invoke methods depending on success, unavailable data, or errors.
See also
IMultilevelTiledRasterDataRetrieverCallback