Skip to content
Library for generating terrain tiles in Cesium's quantized-mesh format from a GDAL raster file.
C++ Python CMake
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
3rdParty
cmake/modules
docs/logos
scripts Added error handling, now the script ends if one of the commands fails. Jan 15, 2019
src
.gitignore
CMakeLists.txt Solved compilation issues. Dec 4, 2018
DeveloperNotes.md
LICENSE.txt
Readme.md
doxyfile.cfg

Readme.md

EMODnet Quantized Mesh Generator for Cesium

Library for generating terrain tiles in Cesium's quantized-mesh format from a GDAL raster file.

Requirements

This project depends on the following C++ libraries:

Also, Python is required to run the scripts provided.

Compilation

This project uses the typical cmake pipeline. Thus, assuming that all the libraries listed above are installed, it should be as easy as:

mkdir build
cd build
cmake ..
make

Optionally, you can create the documentation using:

make doc

An already compiled version of the documentation can be found in the web of this project.

Usage

The main functionality of the project is provided by the qm_tiler app. A simple usage is:

qm_tiler -i <input_raster> -o <output_tiles_dir>

However, the method has many parameters that may be tuned, and that are explained in the wiki. You can list them by running:

qm_tiler -h

After creating the TMS pyramid of tiles, use the script create_layer_file.py to create the layer.json file required by Cesium.

Finally, in order to easily test the project, we also provide the simple_tiles_server.py, which creates a simple web server of tiles.

Please refer to the wiki page of this project for further information.

Known issues

  • As previously stated, this project depends on Cesium Terrain Builder library (https://github.com/geo-data/cesium-terrain-builder), and thus it shares the same limitation when creating tiles at lower zoom levels from large DEMs. In this case, an error similar to the following one may raise:
ERROR 1: Integer overflow : nSrcXSize=20979, nSrcYSize=28800
ERROR 1: IReadBlock failed at X offset 0, Y offset 0
terminate called after throwing an instance of 'ctb::CTBException'

Acknowledgements

This project has been developed by Coronis Computing S.L. within the EMODnet Bathymetry project.

You can’t perform that action at this time.