Fichiers
vercora/NOTES-PHASE25.md
T
2026-10-11 01:54:18 +02:00

190 lignes
8.6 KiB
Markdown
Brut Annotations Historique

Ce fichier contient des caractères Unicode ambigus.
Ce fichier contient des caractères Unicode qui peuvent être confondus avec d'autres caractères. Si vous pensez que c'est intentionnel, vous pouvez ignorer cet avertissement. Utilisez le bouton Échappe pour les dévoiler.
# Phase 25 — Indice visuel adret / ubac
## Le manque
Depuis la Phase 23, l'écart adret/ubac est **calculé, mesuré et journalisé** —
14,7 °C contre 10,7 °C à midi sur la zone de référence — et **strictement
invisible à l'écran**. La Phase 23 l'avait notée elle-même comme sa limite
assumée : « pas de capture adret/ubac, et c'est une limite assumée : le jeu n'a
aucun indice VISUEL de température ».
## La piste retenue : teinte du terrain (piste 1)
Retenue sans hésitation, et le rapport impact / effort n'est pas la seule
raison : c'est la seule des trois pistes qui **réutilise la grandeur existante
telle quelle**.
`WeatherSystem::sampleAt` définit l'adret/ubac par l'écart entre le cosinus
d'incidence du point et celui qu'aurait du terrain **plat** au même instant. Or
`shaders/terrain.frag` dispose déjà des deux moitiés de ce calcul : la normale
du relief par fragment, et `ubo.sun.xyz` — la direction solaire **de Weather**,
celle que la Phase 23 a fait descendre jusqu'au rendu précisément pour qu'il n'y
ait qu'un seul soleil dans le jeu.
Il n'y avait donc **rien à recalculer**, seulement à consommer.
### Le partage des rôles, et pourquoi il est là
| | qui | quoi |
|---|---|---|
| hauteur du soleil, nébulosité | **CPU** (`main.cpp`) | appartiennent à la météo, passés dans `ubo.terrain.w` |
| cosinus d'incidence par fragment | **shader** | seule part qui a besoin de la normale |
Les deux règles portées par le CPU le sont délibérément : ce sont exactement
celles qu'un shader re-dériverait « à peu près », et qui divergeraient ensuite
de la température sans que rien ne le signale. C'est la contrainte « pas de
seconde source de calcul » prise au sérieux — la même exigence qui, en Phase 23,
avait fait sortir la température de `Needs`.
Le champ `terrain.w` était marqué « réservé » depuis la Phase 11. Il l'est resté
jusqu'ici : **aucun octet d'uniforme ajouté, aucune allocation.**
### Conséquence gratuite : la cohérence avec le cycle jour/nuit
Aucune règle horaire n'est écrite nulle part. Le soleil tourne, l'incidence de
chaque versant change avec lui ; il se couche, `terrain.w` tombe à zéro.
La condition « le soleil doit être levé » est celle de la Phase 23 — celle dont
l'absence rendait un versant sud plus chaud à 2 h du matin.
## Les paramètres visuels
| paramètre | valeur | où |
|---|---|---|
| teinte adret | `(1.14, 1.04, 0.88)` | `shaders/terrain.frag` |
| teinte ubac | `(0.86, 0.96, 1.12)` | idem |
| écart de référence | `0.35` | = `WeatherParams::aspectIncidenceReference` |
| intensité maîtresse | `1.0` | `kAspectTintIntensity`, `src/main.cpp` |
Deux propriétés voulues :
- **Symétrie exacte autour de 1**, canal par canal. Sur du terrain ni adret ni
ubac le signal vaut 0, donc le mélange rend le *milieu* des deux teintes : un
milieu qui ne serait pas `(1,1,1)` teinterait tout le plat du massif. Un
premier jeu de valeurs le faisait, d'un demi pour cent vers le chaud.
- **Modulation, jamais remplacement** : l'orthophoto porte tout le détail, elle
est seulement réchauffée ou refroidie.
### L'amplitude a été corrigée après mesure, pas devinée
Premier essai à ±7 % : à **13 h — l'heure où l'écart thermique est maximal —
93,5 % des pixels ne bougeaient pas d'un cran sur 255.** Un indice invisible
manque sa seule raison d'être. Amplitude portée à ±14 % (rouge) / ±12 % (bleu).
**Le signal, lui, n'a pas changé** : c'est toujours celui de la météo. Seule
l'amplitude d'affichage a été revue, et c'est un choix de rendu, légitimement
distinct du modèle physique.
## Vérification
### La vue : un belvédère, pas un point
Première tentative : un point choisi pour ses pentes. Résultat — une image
entièrement remplie par le versant sous les pieds, 0 % de ciel, aucun relief
lisible. **Savoir où sont les versants ne dit pas d'où on les voit.**
La recherche a donc été refaite avec un vrai calcul de **visibilité** (balayage
d'horizon le long de chaque rayon : un point n'est vu que si son élévation
dépasse celle de tout ce qui est plus proche). Belvédère retenu :
E 900000 / N 6436000, altitude 1950 m, --look=270,-24
108 points d'adret franc et 107 d'ubac franc VISIBLES, ciel sur 15 rayons/15
### Avant / après, mesuré
Témoin : **même binaire, même vue, `kAspectTintIntensity` à 0**. La mesure porte
sur la variation de « chaleur » `(R−B)` pixel à pixel.
| heure | réchauffés | refroidis | inchangés |
|---|---|---|---|
| 09 h | 3,2 % | **52,2 %** | 44,6 % |
| **13 h** | **20,4 %** | **29,0 %** | 50,6 % |
| 18 h | **45,8 %** | 6,0 % | 48,2 % |
| 22 h | 2,0 % | 0,0 % | 98,0 % |
Ce qu'on cherchait n'était pas « les images diffèrent » — un filtre global
donnerait ça aussi et ne prouverait rien. C'est que l'écart soit **bipolaire
dans la même image** : à 13 h, 20 % des pixels se réchauffent *pendant que*
29 % se refroidissent. C'est la signature d'un indice qui distingue deux
versants.
La rotation est cohérente avec le soleil : à 9 h, en regardant au nord, les
faces ouest sont à l'ombre — refroidies ; à 18 h les mêmes sont au soleil —
réchauffées.
### Plancher de bruit : la mesure qui rend les chiffres lisibles
Deux captures du **même** binaire, pour savoir ce que vaut une différence :
| | 13 h | 22 h |
|---|---|---|
| bruit (même binaire) | 0,6 % | 1,2 % |
| effet (avant/après) | **49,4 %** | 2,0 % |
À midi, l'effet est **80 fois le bruit**. À 22 h il est **dans** le bruit :
l'indice est donc réellement éteint la nuit, et le résidu de 2 % est l'herbe
animée — vérifié, pas supposé. Le journal du jeu le confirme de son côté :
`versant -2.1` à 13 h, `versant 0.0` à 22 h.
### Coût
| | témoin | avec l'indice |
|---|---|---|
| `drawFrame` | 672 µs | **665 µs** |
| orthophoto GPU | 48 Mo | 48 Mo |
| géométrie terrain GPU | 30 Mo | 30 Mo |
L'écart sur `drawFrame` est du bruit, et dans le sens d'un gain : autrement dit,
non mesurable. Attendu — quelques opérations ALU par fragment, aucune texture
supplémentaire, aucune allocation.
### Validation Vulkan
**Zéro message `[Validation]`** sur les deux séries de captures (8 lancements du
jeu, couches de validation actives).
## La divergence possible, rendue bruyante
`kAspectIncidenceReference` (0,35) est écrit **en dur dans le shader** : un
shader ne peut pas lire un paramètre C++. Si quelqu'un règle
`WeatherParams::aspectIncidenceReference` sans toucher au shader, l'indice
visuel cesserait d'être d'accord avec la température — exactement la double
source de vérité que la Phase 23 avait pris soin d'éviter.
On ne peut pas empêcher la divergence ; on peut refuser qu'elle soit
silencieuse. `main.cpp` compare les deux au démarrage et émet un `[WARN]`
explicite si elles ont cessé de s'accorder.
## Les pistes NON retenues
**Piste 2 — végétation différenciée par versant.** Écartée pour cette session,
et pas par manque de temps : l'équilibre de densité d'herbe est calibré depuis
la Phase 18 (124 touffes sur la vue de référence, un repère qui sert encore), et
la végétation n'a **aucune distinction d'espèces** — pas de résineux contre
feuillus, un seul type d'arbre. « Résineux en ubac, feuillus en adret » n'est
donc pas un réglage mais un **prérequis manquant**. À traiter avec le chantier 4
(placement des arbres), où la distinction d'espèces devrait de toute façon
apparaître.
**Piste 3 — température affichée dans l'interface.** Non nécessaire : elle était
le filet de sécurité si la piste 1 s'avérait risquée, et la piste 1 a tenu. À
noter que la température ambiante **est déjà** dans le titre de la fenêtre
(`chaud 99%`) et dans le journal des besoins.
## Limites assumées
- **L'indice n'est pas quantitatif.** Il dit « ce versant reçoit plus de soleil
que celui-là », pas « il fait 4 °C de plus ». Un joueur ne peut pas en lire une
température.
- **Le terrain seulement.** L'herbe et les arbres (shader `foliage`) ne sont pas
teintés : un versant densément boisé montrera donc l'indice sur le sol entre
les arbres, moins sur le couvert.
- **Pas d'ombres portées** (limite héritée de la Phase 23) : un versant à
l'ombre d'une crête est traité comme s'il voyait le soleil. L'indice suit
l'orientation de la surface, pas l'occultation par le relief.
- **L'amplitude est un réglage d'auteur**, pas une grandeur physique. Le seul
bouton est `kAspectTintIntensity` dans `src/main.cpp`, nommé pour être trouvé
sans lire le shader.
- **L'effet sature** au-delà de 0,35 d'écart d'incidence, comme la température :
deux versants très raides d'orientations opposées ne se distinguent plus
au-delà de ce seuil.