terrain-codec

Terrain processing libraries for 3D tile generation.

Overview

This repository provides libraries for processing terrain data into formats suitable for 3D globe applications like CesiumJS.

Features

• Mesh Generation - Generate adaptive meshes from heightmap data using the RTIN algorithm
• Quantized Mesh - Encode/decode Cesium quantized-mesh-1.0 terrain format
• Coordinate Transformations - Convert between geodetic and ECEF coordinates

Implementations

Language	Path	Status
Rust	rust/	Available
JavaScript	js/	Planned
Go	go/	Planned

Libraries

martini

RTIN (Right-Triangulated Irregular Network) mesh generation from heightmaps. Based on the Martini algorithm by Mapbox.

• Source: rust/martini/
• Published on crates.io as martini

quantized-mesh

Encoder and decoder for Cesium quantized-mesh-1.0 terrain format.

• Source: rust/quantized-mesh/

terrain-codec

Higher-level utilities — re-exports martini + quantized_mesh, plus seamless DEM-gradient vertex normals (eliminates tile-boundary shading seams) and RGB heightmap codecs (Terrarium / Mapbox Terrain-RGB / GSI).

• Source: rust/terrain-codec/

Typical Workflow

1. Load a heightmap (GeoTIFF, PNG, etc.)
2. Mesh it with martini → vertices, indices, UVs
3. Encode with quantized-mesh → .terrain file (quantized-mesh-1.0)

License

MIT OR Apache-2.0