190 lignes
8.6 KiB
Markdown
190 lignes
8.6 KiB
Markdown
# 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.
|