docs: task-24 river polish dials in the generator README (terrain-water task 24)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Stewart Howe 2026-08-11 20:25:40 -04:00
parent 0e39538604
commit 3cbe4c7967

View file

@ -128,6 +128,15 @@ Generates the entire 2D blueprint. Roughly in order:
re-captured after the river pass so the exported PNGs show them). Max-cut is now reported re-captured after the river pass so the exported PNGs show them). Max-cut is now reported
CUMULATIVELY vs the pre-pass surface. CUMULATIVELY vs the pre-pass surface.
**Polish (task 24)** — tributaries carry water too, gated by along-course flow
(`RiverTribWaterMinFlow`, 0 = water them end to end) and **tapered** at the wet→dry
transition over `RiverTribTaperPx`: the strip narrows and its surface drops to the bed, so a
stream head fades instead of ending in a wall of water. Lake-enders route to the nearest
**significant** water body (`RiverLakeMinTargetPx`, 20k cells) — "nearest wet cell" was
satisfied by a 322-px puddle beside a 197k-px lagoon. Steps are finer (`RiverStepDropM` 0.6 m)
and beds deeper (`RiverDepthScale` 1.5, `RiverWaterDepthM` 2.2 m) so the chain reads as a graded
descent rather than a pond staircase: 1034 reaches, adjacent-reach level gaps median 0.12 m.
3. **Sea level and water** — sea level per the configured model (`SeaLevelModel`: `"flat"` scalar 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 — 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. separates true ocean from inland lakes; a mainland fill guarantees one contiguous landmass.