docs: ADR 0012 amendment, READMEs and brief for the landform vocabulary

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
OlivierandClaude Fable 5.1 committed 2026-10-06 21:49:00 +02:00
1 parent caa74b3ee1
commit abffa737ec
5 files changed
+55 -11

No files matched your search

@@ -2,6 +2,7 @@
- Statut : accepté
- Date : 2026-10-06
- Amendé : 2026-10-06 (vocabulaire de formes, voir « Amendement 1 »)
- Remplace : aucun
## Contexte
@@ -58,6 +59,31 @@ dépôt et sa production.
- Une sculpture manuelle (Blender) ultérieure devra ré-exporter vers le même
`SiteTerrainData` ; le contrat ne change pas.
## Amendement 1 — vocabulaire de formes (2026-10-06)
Le point 3 est précisé sans changer le contrat de données. La recette est une
somme de **primitives** additives, suivie de **modificateurs** qui reçoivent la
pente locale du champ en cours, puis du plancher, de la règle de matériau par
pente, des matériaux imposés par primitive et des `MaterialPatch`.
- Primitives lisses : plan incliné, bosse gaussienne, crête, sillon, rupture
de pente, rides, rugosité déterministe.
- Primitives de relief marqué : `Canyon` (tranchée à fond plat le long d'une
polyligne, contour bruité), `Escarpment` (rupture de pente le long d'une
polyligne, le terrain descend à droite du sens de parcours), `Outcrop`
(butte ou fosse à sommet plat, contour bruité, matériau roche imposé),
`BoulderField` (blocs semi-ellipsoïdaux tirés par graine, combinés par
maximum, roche imposée).
- Modificateur : `Strata` quantifie les pentes raides en gradins horizontaux ;
les fonds et sommets plats ne bougent pas.
Tout aléa passe par une graine explicite (`FastNoiseLite`,
`RandomNumberGenerator`) ; `tests/unit/run_site_baker_tests.gd` vérifie que
le Banc du Vigilant se recuit à l'identique. Le site de démonstration
`content/sites/terrain_showcase.tres` (« Jardin des Formes ») sert de
catalogue et de banc d'essai des contrats géométriques
(`docs/briefs/terrain-varied-landforms.md`).
## Alternatives considérées
- **Plugin de terrain externe** : rejeté, dépendance et ADR supplémentaires