Headless GPU rendering + PNG↔NumPy utilities (Rust + PyO3 + wgpu).

Current release: 1.8.0 — Draped terrain overlays with full PBR lighting integration, enabling lit and shadowed texture overlays on terrain surfaces.

# from source
pip install -U maturin
maturin develop --release
# or via wheel (if provided)
# pip install forge3d

New to forge3d? Launch the interactive viewer and capture a high-resolution snapshot of Mount Rainier:

1. Install prerequisites: Ensure you have Python 3.8+ and Rust installed
2. Install maturin: pip install -U maturin
3. Build forge3d: maturin develop --release
4. Build the interactive viewer:

cargo build --release --bin interactive_viewer

5. Launch the viewer with a high-quality preset:

python examples/terrain_viewer_interactive.py --dem assets/tif/dem_rainier.tif --preset high_quality --width 800 --height 800

6. Capture a high-resolution snapshot (type this in the viewer's terminal):

snap highres_rainier.png 4000x4000

This workflow demonstrates forge3d's supersampled snapshot capability: the viewer runs at interactive resolution (×ばつ800) for real-time exploration, then renders a single frame at ×ばつ4000 (16 megapixels) for publication-quality output. Because the GPU renders only one high-res frame on demand, you get print-ready imagery without the memory cost of a persistent 4K framebuffer.

Mount Rainier High-Resolution Snapshot

The swiss_terrain_landcover_viewer.py example showcases the new draped overlay system by rendering a Switzerland DEM with land cover classification data (water, trees, crops, built areas, snow, etc.) overlaid on the terrain. The land cover overlay is automatically resampled to match the DEM resolution and receives full PBR lighting—including sun shading, shadows, and ambient occlusion—because it is blended into the terrain's albedo before lighting calculations. Four high-quality presets (hq1–hq4) enable everything from standard 4K renders to cinematic shots with depth of field and lens effects.

python examples/swiss_terrain_landcover_viewer.py --preset hq4 --snapshot swiss_render.png

Swiss Terrain with Land Cover Legend

Runs anywhere wgpu supports: Vulkan / Metal / DX12 / GL (and Browser WebGPU for diagnostics). A discrete or integrated GPU is recommended. Examples/tests that need a GPU will skip if no compatible adapter is found.