为什么值得关注

它独特地结合了历史制图美学与未来感覆盖层，无需API密钥即可免费使用AWS开放数据的高程瓦片，并包含景深、雷达扫描和电影级相机游览等高级功能。

适合谁使用

制图爱好者和地图迷
需要程序化或真实地形的游戏开发者
用于地形可视化的地理学家和教育工作者
数据可视化和UI/UX设计师

典型使用场景

探索地球上任意地点的真实地形
为游戏环境生成程序化山脉
为演示或展示创建电影级飞越游览
通过交互式等高线和点高程教授地形知识

项目优势

通过AWS开放数据免费获取真实高程数据，无需API密钥
通过GUI实时大量参数自定义（地图叠加、材质、相机、HUD、性能）
独特的视觉风格，融合复古地形图和科幻界面
内置电影级相机游览，支持Catmull-Rom路径平滑和景深效果

使用前须知

需要WebGL支持，在高缩放/地形细节下可能出现性能问题
依赖Terrain Tiles数据集，某些区域分辨率可能有限
无离线模式，高程数据从AWS实时获取

README 快速开始

MONOLITH — interactive 3D topographic map

An interactive, real-time 3D terrain map in the style of a vintage USGS topographic sheet, crossed with a sci-fi FUI overlay. Load real-world elevation data for anywhere on Earth, or generate procedural mountain ranges — then explore them with contour lines, hypsometric tinting, survey grids, spot elevations, clickable peak markers, radar scans, and cinematic camera tours.

Live demo: https://kaolti.github.io/monolith-terrain/

How to use

Action	How
Look around	Drag to orbit, scroll to zoom, right-drag to pan
Inspect a peak / basin	Click a `PK-xx` / `DEP-xx` marker — the camera flies in and a data panel opens
Go back	Click ✕ on the panel — the camera returns to where you were
Cinematic flyover	Open Tour, pick from / to, press ▶ start tour (drag to cancel mid-flight)
Radar scan	HUD → trigger scan — a wave sweeps the terrain and physically lifts the surface
Change location	Terrain source → location presets, or Custom + latitude/longitude, then load location
Save your settings	copy parameters puts the full state on your clipboard as JSON

Terrain sources

real world (DEM) — fetches elevation tiles for the chosen coordinates and rebuilds the map with true landforms. Spot elevations and peak data show real values.
- detail (zoom) — z10–14: how large an area you get (z12 ≈ 28 km across, z13 ≈ 14 km)
- vertical scale — relief exaggeration; real proportions read flat at map scale, so 1.5–3 is typical
procedural noise — seeded multi-octave simplex terrain with a hovering monolith and an excavated instrument basin. Every knob (octaves, warp, amplitude…) is live.

Parameter folders

Map overlay (hypsometric gradient stops, contour interval/color, survey grid) · Surface material (roughness, micro bump) · Camera & focus (real depth of field with autofocus) · Look (exposure, contrast, grain, fog) · HUD (accent/ink colors, scan wave shape + displacement) · Motion / Tour (fly-to easing, tour path smoothing, banking, look-ahead) · Performance (render scale, static shadows, shadow resolution) · Light (sun azimuth/elevation, shadow softness).

Run locally

npm install
npm run dev     # http://localhost:5173
npm run build   # static build in dist/

No API ke

项目描述

Interactive 3D topographic map — real-world elevation data rendered as a vintage USGS topo sheet with a sci-fi HUD. Three.js.

monolith-terrain