winsent/quantized-mesh-viewer repository overview

⁠Quantized Mesh Viewer

Render custom quantized mesh⁠ tiles in Cesium and debug individual tiles using THREE.js renderer.

For generation quantized-mesh tiles from raster you can use the heremaps/tin-terrain⁠ tool.

Note: This is experimental code, expect changes.

⁠Run

npm i
npm start

At http://localhost:8080⁠ you'll see a Cesium map with example terrain tiles.

To debug individual tile go to http://localhost:8080/tile.html⁠.

On the right panel change the path to the tile and adjust debug parameters.

You can also start the app in a Docker container.

docker build -t qm-viewer .
docker run -t -i --name qm-viewer -p 8080:8080 -v $(pwd):/usr/src/app qm-viewer

⁠Custom Tiles

By default application renders example tiles from ./example-tiles folder. To serve files from different location customize SurfaceProvider parameters in the ./src/map/index.js.

Application serves statics from its whole root directory so you can put folder with custom tiles next to the ./example-tiles folder.

⁠Configuring SurfaceProvider

new SurfaceProvider(options)

Options:

• getUrl: (x: Number, y: Number, level: Number) → String
  Required
  Constructs URL to fetch a tile using provided grid coordinates.
• tilingScheme: Cesium.TilingScheme
  Optional
  Default — Cesium.WebMercatorTilingScheme
• credit: [Cesium.Credit]
  Optional
  Credits for a tiles data

⁠Notes

• Cesium cannot render tiles for a specific zoom level unless you provide tiles for all parent level. The SurfaceProvider mocks missing tiles with a plane geometry.

⁠Links

• Quantized Mesh Decoder⁠
• Quantized Mesh Format Specification⁠

⁠Contribute

See CONTRIBUTING⁠.

⁠License

Copyright © 2018 HERE Europe B.V.

See the LICENSE⁠ file in the root of this project for license details.