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

Brut Annotations Historique

Phase 27 — Météo visible, micro-relief du sol, profil de performance

Règle de la phase : aucune valeur ni mécanique météo inventée. Tout effet visuel ajouté est piloté par une grandeur que WeatherSystem calculait déjà, ou par une donnée réelle du projet (orthophoto, heightmap LiDAR). Ce qui aurait demandé une mécanique nouvelle est listé en fin de chantier 1 comme prérequis manquant, et n'est pas implémenté.

Ordre de travail : chantier 1 (météo visible), chantier 3 (micro-relief), chantier 2 (profilage), conformément à la priorité demandée.


Outillage ajouté (préalable aux trois chantiers)

  • --day=N (src/main.cpp) : jour de partie de départ. --hour seul ne choisissait que l'heure du jour 0, qui ne contient aucune perturbation : il était impossible de capturer la pluie. Le calendrier est déterministe (seed fixe), donc --day + --hour + --time-scale=0 épinglent exactement un état météo.
  • tools/shot_weather.ps1 : captures épinglées (position, cadrage, jour, heure, horloge gelée, --lock-input) avec journal du jeu à côté de chaque image — nombre de [Validation] et ligne Visuels meteo relus pour chaque capture. Une capture dont on ne sait pas quel temps il faisait ne prouve rien.
  • tools/profile_phase27.ps1 : mesure A/B entrelacée, poste témoin, santé machine (voir chantier 2).
  • --no-weather-visuals, --no-ground-detail : témoins étroits. Chacun coupe l'ajout de la phase et lui seul (la météo continue de peser sur les besoins et les activités ; le terrain garde son orthophoto).
  • Bilan de fin de partie : poste visuels meteo (CPU) et ligne Cadence de boucle (PHASE 27) — images / secondes de boucle réelles, sans dépendre du titre de fenêtre (±15 %, leçon de la Phase 18).

Instants de référence (calendrier déterministe, seed fixe)

Trouvés en balayant synopticAt() sur 30 jours puis sur un an, pas choisis au hasard :

instant nébulosité précipitation usage
j12 13 h 0,14 0 grand beau
j0 13 h 0,54 (0,61 local) 0 mi-couvert
j8 13 h 0,95 (0,99 local) 4,9 mm/h (9,2 local) pluie franche
j8 22 h 0,98 local 8,6 mm/h local pluie au crépuscule
j169 9 h 15 0,99 local 9,2 mm/h local, neige, −3 °C neige de jour

L'écart synoptique/local vient du renforcement orographique et du gradient altitudinal déjà modélisés (section 7 de WeatherParams) : la vue de l'alpage est à ~1 480 m sur un versant au vent.


CHANTIER 1 — Rendre la météo visible

Constat avant

Un jour de pluie à 95 % de nébulosité se rendait exactement comme un jour de grand beau : ciel bleu vif, soleil franc (captures build/phase27/avant/). Au passage, un commentaire mensonger dans sunLightFor() affirmait depuis la Phase 23 que l'ambiante était « écrasée par les nuages en plein jour » ; le code n'a jamais lu la nébulosité. Corrigé.

Architecture

Une seule fonction pure, weatherVisualsFor(sky, local, params) (world/Weather.hpp/.cpp), est la traduction météo → image de tout le jeu. Elle ne calcule aucune grandeur météo : elle lit l'état synoptique et l'échantillon local au joueur que main.cpp calculait déjà une fois par image, et part de sunLightFor(). Par ciel clair et sol sec, elle rend sunLightFor() au bit près (testé).

Traçabilité : quelle grandeur pilote quel effet

effet visuel grandeur Weather qui le pilote coefficient d'affichage (PROVISOIRE, WeatherParams §6 ter)
soleil direct voilé WeatherSample::cloudCover (local) aucun nouveau : réutilise cloudAspectDamping (0,85), qui modélisait déjà « les nuages cachent le soleil » pour l'adret
ambiante diffuse renforcée, de jour seulement cloudCover × part de jour (daylight) overcastAmbientGain = 1,0
ciel grisé (désaturé vers sa propre luminance, jour/nuit intact) cloudCover overcastSkyDarkening = 0,80
pluie / neige à l'écran : densité et opacité precipitationMmPerHour (local) / precipitationMaxMmPerHour aucun (ratio de deux valeurs existantes)
neige plutôt que pluie snowing (donc temperatureC local vs snowThresholdC) —
inclinaison des traits windVector (vent local : sondage amont, cols, abris) rainFallSpeedMps 6,5 / snowFallSpeedMps 1,2 (vitesses terminales usuelles)
brouillard de distance precipitationMmPerHour (local), snowing rainExtinctionPerKm 0,25 × R^0,63 (1/km), × snowExtinctionMultiplier 8 pour la neige
sol assombri wetness (relecture de la pluie des 6 dernières heures, Phase 23) wetGroundDarkening = 0,35
couleur du brouillard = couleur du ciel ci-dessus —

Aucun effet n'existe sans sa grandeur. C'est vérifié par testWeatherVisuals() : ciel clair et sec ⇒ lumière de la Phase 23 au bit près, brouillard nul, pluie nulle, sol non assombri ; et, sur 30 jours de jeu à la minute, pluie et brouillard à l'écran exactement quand la météo calcule une précipitation, jamais sinon (0 écart sur 43 200 minutes).

Cohérence temporelle (point 4 du cahier des charges)

Mesurée, pas supposée : sur 30 jours à la minute, le saut maximal d'une minute à l'autre vaut 0,022 pour la couleur du ciel, 0,004 pour l'intensité de pluie, 6,5·10⁻⁵ /m pour le brouillard (montée d'une averse de neige, lisse). Les effets suivent le calendrier synoptique comme le cycle jour/nuit, sans aléa propre.

Une discontinuité, trouvée par le test et laissée telle quelle : la bascule pluie ↔ neige (j1 6 h 55 à 1 500 m : visibilité de 1,6 km à 13 km en une minute). Elle vient du modèle — snowing est un booléen au seuil snowThresholdC — et non du rendu. La lisser demanderait une phase mixte que Weather ne modélise pas (voir prérequis). Le test isole ces minutes (2 bascules sur 30 jours) et fait échouer tout autre saut.

Rendu

  • UniformBufferObject : quatre vec4 en fin de bloc (fog, precip, fall, detail), neutres par défaut — sans appel, l'image est celle de la Phase 26.
  • Brouillard : extinction de Beer-Lambert exp(-σ d), même fonction dans terrain.frag, foliage.frag, cube.frag (sinon les arbres ressortiraient nets du voile). σ = 0 ⇒ couleur rendue inchangée.
  • Pluie/neige : precip.vert/.frag, un triangle plein écran sans buffer de sommets, trois couches de traits procéduraux, mélange alpha, sans profondeur. La passe est sautée entièrement (aucun bind, aucun draw) quand l'intensité vaut 0. Les traits sont collés à l'écran : ils ne passent pas derrière un tronc — compromis assumé « effet d'écran simple ».
  • Sol mouillé : albedo *= 1 − precip.w dans terrain.frag.

Un effet mort trouvé par le journal des captures

Première série « après » : le journal affichait ambiante x1.00 sous 99 % de nuages. Le multiplicateur d'ambiante était écrêté à [0, 1] deux fois (dans weatherVisualsFor et dans Renderer::setSun) ; or il vaut déjà 1 en plein jour : le gain de ciel couvert ne s'appliquait jamais. Le test « monotone » ne pouvait pas le voir (une constante ne décroît pas). Corrigé (borne à 4), et un test exige désormais que l'effet existe (> ×1,5 sous ciel couvert).

Vérification

  • Tests headless : 3631 / 3631 (3607 + 24 nouveaux, testWeatherVisuals).
  • Captures build/phase27/planche_meteo.png (témoin --no-weather-visuals à gauche, Phase 27 à droite), 5 instants, 0 [Validation] sur les 20 lancements Debug (avant, après, témoin, v1).
  • Neutralité du témoin : témoin vs capture d'avant = 0,4 à 2,9 % de pixels à plus de 8 niveaux (herbe animée) — le drapeau rend bien la Phase 26.
  • Effet proportionné à la donnée : grand beau (nébulosité 0,14) = 3,5 % de pixels changés ; mi-couvert 88 % ; pluie 94 %.
  • Fausse alerte écartée par la mesure : le ciel « gris clair » de j8 22 h n'est pas un bug — à 22 h fin mai c'est encore le crépuscule ; ciel témoin (48, 56, 84), ciel Phase 27 (51, 51, 52) : même luminance, désaturée.

Prérequis manquants — NON implémentés, faute de grandeur Weather

effet envisagé ce qui manque dans Weather
brume par temps sec, brume de vallée dans les cuvettes (la carte de piégeage d'air froid existe) humidité relative / point de rosée : sans eux, rien ne dit quand l'air froid piégé condense
nuages accrochés au relief, plafond bas altitude de la base des nuages : la nébulosité est une fraction de ciel, pas une hauteur
transition douce pluie ↔ neige (neige fondue) une phase mixte de précipitation ; snowing est un booléen
sol blanchi par la neige un manteau neigeux (accumulation / fonte) ; aujourd'hui une chute de neige mouille le sol (wetness) et le fonce, ce qui est ce que dit le modèle
nuages visibles, soleil voilé localement, éclaircies qui défilent une nébulosité spatialisée (champ 2D advecté par le vent) ; la nébulosité est 0D + un renforcement orographique au point
éclairs / orage aucune convection profonde modélisée

CHANTIER 3 — Micro-relief du sol vu de près

Approche retenue

Texture de détail procédurale perturbant la normale (le grain réagit au soleil de Weather) et, légèrement, l'albédo — pas de micro-déplacement géométrique (il aurait fallu densifier les tuiles CDLOD proches : bien plus cher et plus risqué pour le LOD).

  • Bande de fréquences : de 0,61 m (= le texel de l'orthophoto, lu sur la texture réellement chargée, TextureData::metresPerTexel()) jusqu'à ~5 mm, en 7 octaves de rapport 2,2. Rien au-dessus du texel : le grain ne contredit jamais la photo.
  • Amplitude pilotée par des données réelles : contraste local de l'orthophoto (photo nette contre sa version 2 mipmaps plus floue — éboulis contrasté contre prairie lisse) et pente du relief LiDAR (1 − N.y). Plancher 50 %. Le motif lui-même est un bruit et ne représente aucun caillou réel ; c'est dit dans le shader.
  • La normale perturbée ne sert qu'à l'éclairage : l'indice adret/ubac garde la normale du relief (il doit dire la même chose que la météo).
  • Deux fondus : par distance (5 → 20 m) et par octave selon l'empreinte du pixel (fwidth, Nyquist : plein poids ≥ 4 px, éteint à 2 px) — c'est ce second fondu qui interdit le moiré en vue rasante. Les mipmaps de la texture filtrent en plus le sous-pixel. Lectures en textureGrad avec dérivées prises hors branche (boucle à sortie non uniforme).

Paramètres finaux

paramètre valeur où
force 1,0 kGroundDetailStrength (main.cpp)
fondu distance 5 → 20 m kGroundDetailFadeStart/End
motif de base texel de l'ortho (0,610 m), 0,61 par défaut groundDetailPattern
octaves / lacunarité 7 / 2,2 terrain.frag
pente max du grain 1,3 × amplitude kDetailSlope
couleur ±30 % en crête, ±10 % typique kDetailAlbedo = 0,30
rugosité pleine contraste photo 0,12 ou pente 0,35 kDetailFullContrast/Slope
texture de bruit 256², 32 cellules, RGBA8 + 9 mips (341 Ko) assets/DetailNoise.cpp, binding 2, adressage REPEAT

Vérification

build/phase27/planche_sol.png (témoin --no-ground-detail à gauche). Énergie haute fréquence (laplacien) mesurée sur les captures :

vue sol proche (moitié basse) loin (tiers haut)
au ras du sol 5,92 → 7,24 (+22 %) —
vue de marche — 3,01 → 3,01 (inchangé)

Le sol est visiblement grenu sous les pieds, et rien n'est ajouté au loin (pas de moiré mesurable sur image fixe). Limite : des images fixes ne prouvent pas l'absence de scintillement en mouvement ; le fondu de Nyquist le prévient par construction, non vérifié en déplacement.

Une première version rejetée PAR LA MESURE

La v1 calculait le bruit dans le shader. Première mesure de l'effet visuel : énergie HF proche inchangée (5,92 → 5,91) — 4 octaves s'arrêtaient à 6 cm, soit 15 pixels à 2 m : de l'ondulation, pas du grain ; et l'amplitude était divisée deux fois (normalisation + moyenne des gradients). Corrigé à 7 octaves. Puis son coût s'est révélé inacceptable → bruit en texture (chantier 2).


CHANTIER 2 — Profilage et optimisation

Protocole (tools/profile_phase27.ps1)

  • Paires A/B entrelacées (AB, BA, AB…), B = témoin étroit de l'ajout mesuré (--no-weather-visuals, --no-ground-detail, ou les deux = Phase 26).
  • Métrique : Cadence de boucle (µs par image réelles) et les postes Cout par image (PHASE 19).
  • Santé machine par run : charge totale échantillonnée pendant le run moins le CPU de vercora. Plus d'un cœur entier ⇒ NON CONCLUANT, exclu des médianes ; moins de 20 img/s ⇒ NON CONCLUANT (« n'a pas pu rendre »).
  • Machine : i5-14600K, UHD 770 intégré, 1280×720.

Deux défauts de l'outil trouvés en l'écrivant : la 1re version du témoin de santé sommait TotalProcessorTime sur une liste de processus qui change pendant le run (« 318 910 % d'un cœur ») — remplacée par un échantillonnage de charge ; et le bureau au repos (application Claude, webviews, Discord) consomme 25 à 130 % d'un cœur, d'où un seuil à 1 cœur, justifié dans le script. Beaucoup de runs ont été écartés à ce titre : les tableaux ci-dessous n'utilisent que les runs sains, et le signalent quand il n'en restait pas.

Leçon de méthode : un poste CPU n'est pas un témoin sur GPU intégré

Sous la pluie, l'herbe (CPU) a été systématiquement plus lente en A qu'en B (495 contre 374 µs, +32 %), tour après tour, dans les deux ordres — donc pas une dérive de la machine. Par beau temps, où A et B chargent le GPU pareil : écart 4 %. Sur un GPU intégré, CPU et GPU partagent le budget de puissance du boîtier ; charger le GPU ralentit le CPU. Le témoin CPU est donc couplé à toute modification GPU et ne peut pas la valider. Il reste valide quand la condition ne change pas la charge GPU (beau temps : 4 % ; vue de marche finale : 2 %).

Profil actuel (tout le contenu depuis la Phase 19), médianes

config / vue total drawFrame herbe arbres fibres streaming
Release, vue fixe alpage, beau 4 962 µs 4 228 (85 %) 408 253 17 14
Release, survol 900 m/s (Phase 26) 1 495 µs 1 126 (75 %) 1 241 10 82
Debug, vue fixe alpage, beau 7 838 µs 2 099 (27 %) 3 482 (44 %) 1 775 191 95
Debug, survol 900 m/s (Phase 26) 4 429 µs 1 236 (28 %) 9 1 987 124 939
  • Release est limité par le GPU (75–85 % dans drawFrame) : optimiser les postes CPU (herbe 0,4 ms, arbres 0,25 ms) ne rendrait rien, conformément à la Phase 19. Aucune optimisation CPU n'a donc été faite.
  • Debug est limité par le CPU (herbe 44 %) : le même changement GPU y est invisible — la pluie y coûte −83 µs (bruit). Mesurer en Debug seul aurait conclu « gratuit ». La leçon de la Phase 19 se vérifie encore.
  • Les chiffres de survol ne sont pas comparables tels quels à ceux de l'audit (378 img/s) : l'audit ne précisait ni jour, ni heure, ni drapeaux ; ici le survol est épinglé à j8/j12 13 h.

Coût des ajouts de la Phase 27 (Release, A − B)

mesure coût statut
beau temps, vue fixe (contrôle négatif météo) −28 µs (0) gratuit par temps sec
survol beau temps (shaders modifiés, rien d'actif) +54 µs (+3,6 %) surcoût fixe des shaders
pluie, vue fixe (passe plein écran + brouillard + sol mouillé) +608 µs (+12 %) accepté : seulement quand il pleut, ~180 img/s
survol sous la pluie +684 µs idem (≈ passe de pluie)
micro-relief v1, au ras du sol +1 683 µs (×1,94) rejeté
v1 + Nyquist resserré à 8 px +1 490 µs insuffisant
v1 sans aucune octave (bissection) +330 µs ⇒ ~200 µs par octave
v1 à 2 octaves (bissection) +720 µs confirme : ALU, pas un surcoût fixe
v1 avec hash flottant au lieu d'entier ≈ inchangé hypothèse réfutée
v3 : bruit en texture, au ras du sol ≈ +900 µs −47 %
v3 sans la lecture floue d'ortho (bissection) ≈ inchangé lecture gratuite, conservée
v3, vue de marche, fondu 35 m +623 µs (+15 %)
v3, vue de marche, fondu 20 m (final) +480 µs (+11 %) retenu, témoin stable (2 %)

(Les valeurs « ≈ » viennent de runs dont les A ont tous dépassé de peu le seuil de santé, sans médiane formelle ; leur dispersion était de ±0,2 %.)

Seule optimisation livrée : le micro-relief, le seul poste nouveau mesuré comme significatif — de +1 683 à ~+900 µs dans le pire cas, et +480 µs en vue de marche. Trois hypothèses ont été réfutées par la mesure avant de trouver la bonne (octaves fines, hash entier, lecture floue) ; aucune n'a été gardée « au cas où ».

Non fait, et pourquoi : la passe de pluie (+608 µs) n'est active que pendant les précipitations (~9 % du temps sur 30 jours de jeu) et le jeu y reste vers 180 img/s ; l'alléger (moins de couches, demi-résolution) dégraderait la lisibilité, qui est l'objectif du chantier 1. À reprendre si une cible plus faible que l'UHD 770 est visée.


Vérification globale

  • Tests headless : 3636 / 3636 (3607 + 29 : testWeatherVisuals, testDetailNoise).
  • 0 [Validation] sur toutes les captures Debug de la phase et sur les runs Debug de profilage.
  • Suite run_vulkan_check.ps1 (build Debug final, couches de validation) : verte au premier passage — scénarios A à J3 (14 processus : gameplay, collision, dalle LiDAR, parapente, vélo, escalade « sommet atteint : True », éditeur G1-G3, besoins, faune, récolte et fibres), Messages [Validation] : 0, fermeture propre. Un seul passage : la flakiness historique du harnais (D2 de l'audit) n'a donc pas été re-mesurée ici.

Où je me suis arrêté

Les trois chantiers sont livrés. Restent ouverts, sciemment :

  • scintillement du micro-relief en mouvement : non vérifié (images fixes seulement) ;
  • passe de pluie à +608 µs : non optimisée (voir chantier 2) ;
  • effets météo qui demanderaient une mécanique absente de Weather : listés dans « Prérequis manquants », non implémentés, par règle.