This builder class allows to create a multi-level tiled raster model.
The multi-level tile structure is defined by a reference and a number of levels where each level has a bounds and a number of columns and rows. The structure of the tiles is organized as follows:
-
Level 0 is the least detailed level.
-
The tile coordinate
(N,0,0)
on level N
is the top-left tile.
The IMultilevelTiledRasterDataRetriever
interface allows to load the tile data, or it allows to indicate that there is no data available for a tile. The latter for example allows to create low resolution overlays on high resolution data.
The following figure shows how such a multi-level tile structure looks like.
Multi-level tile structure.
This builder supports either imagery (RGBA) data or elevation data. The latter can be enabled by calling MultilevelTiledRasterModelBuilder.Elevation
.
This article gives an example of how to use this class.
- Tile Matrix Set limitations.
- The tiles of detail levels should overlap with tiles of the parent level. If this is not the case such tiles are not painted on the map.
- Since
- 2022.1
Adds a level of detail to the raster data structure.
At least 1 level must be created.
The order in which this method is called matters: it determines which level is added. The first call is for level 0 (the least detailed level), the second call for level 1, and so on..
All levels must be defined in the same reference.
- Parameters
-
tileWidthPixels | the width, in pixels, for a tile within the tiled structure. |
tileHeightPixels | the height, in pixels, for a tile within the tiled structure. |
columnCount | the number of columns within the tiled structure. |
rowCount | the number of rows within the tiled structure. |
bounds | the extent of the tiled structure. |
- Returns
- this builder.
Sets a no-data value for elevation data.
When the provided elevation data in IMultilevelTiledRasterDataRetrieverCallback
contains this value, it is interpreted as a no-data value. This means that consumers of the data will have information that no data is available at that location, and that they can choose an appropriate fallback. For example when terrain is visualized, it can decide to fall back on other elevation data when it encounters a no-data elevation value.
This method is optional.
This method must only be called when the Elevation
method is also called. If not, the Build
method will throw an exception.
- Parameters
-
noDataValue | the no-data value to use for elevation |
- Returns
- this builder
- Since
- 2023.0