beezm/islaApocalypse
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: TDTL v2 body, shelf-edge variation, erosion deferred (terrain-water task 10)

Browse source 
BLUEPRINT_FORMAT.md: TDTL rewritten for the v2 body (30 B) with the
version-skip rule spelled out -- this is the one section whose body is
VERSIONED rather than extended, because v1's layout was retired rather
than grown, and a reader that guesses would mint plausible nonsense.
Records edgeAmpM as APPLIED (post-clamp), so the file always describes
the terrain rather than the request. Config-knobs section updated:
ShelfEdgeVariation is metres of INPUT height -- a boundary displacement,
not an elevation.

Tools/Scripts/README.md: the two detail passes and why neither can breach
the red ceiling or the 420 m cap (K2/K6 do not move). Adds an explicit
"no rivers, no erosion, no flow routing anywhere in this pipeline" note
with the reverted D8 pass and its lesson on the record, so the next
reader does not re-derive it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Stewart Howe 2026-08-08 20:55:39 -04:00
parent ed16a7f668
commit af1a6d912b
2 changed files with 19 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

17
Tools/Scripts/README.md
View file

@ -19,10 +19,19 @@ Generates the entire 2D blueprint. Roughly in order:
ring — and a per-seed-normalized summit spike to the 420 m cap) reshapes above-sea terrain
after noise/falloff/Trench and before the crater carve; biome classification reads a
retained uncurved map, so biomes are identical either way. With `TerrainDetail: "v1"` (the
default) two detail passes follow the curve: shelf micro-relief (±3 m rolling skin on the
benches/plateaus) and D8 drainage incision (rain-cut ravines in the risers — the future
river routes; `TerrainDetailPass.cs`). Drops the `0_height` hillshade snapshot (hypsometric
bands × NW hillshade) in both modes.
default) two detail passes ride along with the curve (`TerrainDetailPass.cs`): shelf
micro-relief (`ShelfReliefAmp`, ±3 m rolling skin on the benches/plateaus) and shelf-edge
variation (`ShelfEdgeVariation`, 12 m) — a per-column shift of the shelf/riser knot block that
makes the shelf edge scallop into notches, coves and peninsulas instead of tracing a clean
height contour. Both touch exported heights only, and neither can reach below the red ceiling
or above the 420 m cap: the curve's K2 and K6 knots do not move, so a warped column is
bit-identical to an unwarped one outside the shelf/riser stack. Drops the `0_height` hillshade
snapshot (hypsometric bands × NW hillshade) in both modes.
**No rivers, no erosion, no flow routing anywhere in this pipeline.** A D8 drainage-incision
pass was written and reverted in task 10 — per-cell steepest descent on a regular grid can only
route along eight headings, and at map scale that reads as straight hatching, not drainage.
Erosion is Phase C work: a hydraulic pass over final terrain, after the shape stops moving.
3. **Sea level and water** — sea level per the configured model (`SeaLevelModel`: `"flat"` scalar
— the default, `SeaLevelValue` 0.15 — or the legacy `"field"` latitude Lerp); flood fill
separates true ocean from inland lakes; a mainland fill guarantees one contiguous landmass.