# Phase 15 (2026-08-23) : éditeur de niveau interne Outil de **développement**, pas de jeu. La consigne demandait explicitement de privilégier la complétude et le contrôle sur l'ergonomie : il n'y a donc aucune interface graphique, le catalogue est une liste texte dans le journal, et l'état courant de l'outil s'affiche sur une ligne de log. En revanche tout ce qui est demandé fonctionne de bout en bout — poser, régler, déplacer, supprimer, annuler, sauvegarder, recharger — et **les objets posés font partie du monde** : une partie normale les charge d'elle-même, les dessine et s'y cogne. Note de numérotation : il n'existe pas de `NOTES-PHASE14.md`. La Phase 14 (escalade) est documentée dans `NOTES-PHASE-ESCALADE.md`, comme la Phase 13 l'est dans `NOTES-PHASE-VELO.md`. --- ## 1. Ce qui a été livré | Demande de la consigne | État | |---|---| | Mode éditeur, bascule depuis le jeu | **fait** — touche `F2`, ou `--editor` au lancement | | Caméra de vol libre, sans collision ni gravité | **fait** — `CameraMode::Free` verrouillé, vitesse réglable à la molette (2 à 600 m/s) | | Catalogue scanné depuis un dossier | **fait** — `assets/editor/`, plus 5 modèles générés en code | | Extension d'`ObjLoader` au glTF | **NON FAIT**, documenté en §8 | | Liste texte avec sélection au clavier | **fait** — `TAB`, `PAGE_PREC`/`PAGE_SUIV`, rangs `1`..`9` | | Fantôme suivant la visée | **fait** — teinté cyan, au point exact où le regard rencontre le sol | | Pose au clic, à la position visée | **fait** — clic gauche, ou `INSER` au clavier | | Déplacer / pivoter / redimensionner | **fait** — saisie à la visée (`G`), flèches, `DEBUT`/`FIN` | | Sélectionner et supprimer | **fait** — `E` puis `SUPPR` | | Sérialisation dans un fichier texte | **fait** — format `.vcsc`, §4 | | Chargement automatique en jeu normal | **fait** — vérifié sous Vulkan, §7 | | Undo | **fait** — pile de 128 actions, regroupement des retouches | | Premier lot d'assets de test | **fait** — 5 modèles générés en code + 1 `.obj` témoin | | Collision des objets posés | **fait** — cylindre englobant, réglable par objet ; limite en §8 | --- ## 2. Architecture Nouveau dossier `src/editor/`, plus deux en-têtes ajoutés à `src/core/`. ``` src/core/TerrainRay.hpp intersection rayon / surface du terrain src/core/CompositeCollisionSolver.hpp plusieurs sources d'obstacles, un solveur src/editor/EditorAssets.{hpp,cpp} les 5 modèles générés en code src/editor/AssetCatalog.{hpp,cpp} catalogue : builtins + scan de dossier src/editor/PlacedObject.hpp un objet posé (donnée pure) src/editor/EditorScene.{hpp,cpp} la liste, la visée, la collision, l'undo src/editor/EditorController.{hpp,cpp} la machine à états de l'outil src/editor/SceneFile.{hpp,cpp} lecture / écriture du .vcsc ``` **Aucun de ces fichiers ne connaît Vulkan.** C'est le même découpage que celui des quatre activités : `Paraglider`, `Bike` et `Climber` ne dépendent que de GLM et sont donc *exécutés* dans les tests headless. Ici tout l'éditeur sauf le dessin l'est aussi — catalogue, raycast, scène, pile d'annulation, collision, format de fichier, et la machine à états complète. ### Ce qui rend la machine à états testable `EditorController` **ne lit pas le clavier**. Il reçoit une structure `EditorInput` déjà dépouillée par `main.cpp`. Trois raisons, la dernière étant la vraie : 1. il ne dépend alors ni de GLFW ni de `Window` ; 2. les touches restent décrites en un seul endroit, à côté de celles du jeu ; 3. **le harnais automatisé ne peut pas piloter la souris** — GLFW lit le curseur *système* et non les messages postés (limite connue depuis la Phase 8). Un contrôleur qui lirait lui-même les entrées ne serait donc testable qu'à la main. ### Les trois cibles de réglage, et leur ordre ``` SAISIE > SÉLECTION > PINCEAU ``` * **Saisie** : un objet décroché suit la visée. **La scène n'est pas modifiée tant qu'il est en main** — c'est seulement en le reposant qu'une *unique* action annulable est empilée. Sans ça, déplacer un rocher de trente mètres empilerait une annulation par image. * **Sélection** : les retouches l'atteignent directement, et celles qui s'enchaînent à moins de 0,75 s l'une de l'autre sont **regroupées** en une seule annulation. Sans ce regroupement, tourner un rocher d'un quart de tour laisserait six annulations et « annuler » ne rendrait jamais l'état d'avant la manipulation — la seule chose qu'on veuille. * **Pinceau** : l'asset armé et *ses* réglages (cap, échelle, hauteur, solidité), **conservés d'une pose à l'autre**. ### La pose ne sélectionne pas — corrigé après essai sous Vulkan La première version sélectionnait l'objet qu'on venait de poser, par analogie avec les éditeurs 3D. Le premier essai réel a montré que c'était le mauvais choix **ici** : les réglages visant la sélection en priorité, poser un objet détournait silencieusement les flèches du *pinceau* vers l'objet posé. Régler une fois puis poser dix blocs alignés — le geste le plus courant de l'outil — devenait impossible sans désélectionner entre chaque. Corrigé et figé par test. Dans la foulée, la ligne d'état a été corrigée aussi : elle n'affichait que le cap du *pinceau*, donc tourner un objet sélectionné affichait `cap 0 deg` pendant que l'objet tournait. Elle décrit maintenant la cible réelle des réglages. Une troisième incohérence, trouvée à la relecture : reposer un objet à la touche de saisie écrivait la prévisualisation de l'image **précédente**, alors que le reposer au clic écrivait celle de l'image **courante** — deux gestes censés faire la même chose n'avaient donc pas exactement le même résultat. Le début de saisie et la repose sont maintenant séparés de part et d'autre du calcul de prévisualisation, et les deux gestes passent par le même code. Enfin, le mode éditeur se voit dans le **titre de la fenêtre** (`[EDITEUR]`) : c'est le seul retour permanent à l'écran, rien dans la vue elle-même ne distinguant une caméra d'édition d'un simple vol libre. ### Le raycast terrain `Forest::pickTree` (Phase 5) intersecte un rayon avec des **cylindres**, ce qui a une solution analytique. La surface du terrain n'est pas une primitive : c'est une grille bilinéaire de plusieurs millions de cellules. `core/TerrainRay.hpp` marche donc le long du rayon, à **pas croissant** (0,5 m près de l'œil, plafonné à 8 m), puis dichotomie sur 24 itérations dès que le signe de `hauteurDuRayon − hauteurDuTerrain` s'inverse. Environ 150 échantillons pour 400 m de portée, une fois par image. Deux points qui comptent : * **L'emprise doit être passée explicitement.** `HeightSampler::heightAt` est *totale* par contrat — hors des données elle prolonge le bord. Sans le paramètre `halfExtent`, un rayon partant vers l'extérieur accrocherait une étagère plate infinie. Vérifié par un test qui compare les deux cas. * **Limite assumée** : une marche à pas fini peut *enjamber* une arête plus fine que le pas courant (une crête vue de loin et par-dessus). Le remède exact — un parcours cellule par cellule façon DDA — exigerait de connaître la grille, donc de renoncer à l'interface `HeightSampler`. ### La collision : la première fois que l'interface de la Phase 6 sert vraiment Le monde avait jusqu'ici **une seule** source d'obstacles (`Forest`), et `Camera::setCollisionSolver` prenait un pointeur unique. `CompositeCollisionSolver` implémente le même contrat et le délègue à une liste ; les répoussements sont **chaînés** et non moyennés (sortir d'un tronc peut faire entrer dans un rocher). **Ni `Camera`, ni `Bike`, ni `Climber` n'ont été modifiés pour ça** — seul l'objet qu'on leur passe a changé. C'est exactement ce que l'interface de la Phase 6 permettait, et c'est la première fois qu'on s'en sert. --- ## 3. Le fantôme est teinté, pas transparent Trois états du **même** maillage doivent se distinguer : l'objet posé, le fantôme qui suit la visée, l'objet sélectionné. Ils passent tous par le même pipeline ; seule une **teinte témoin** poussée en push constant les sépare (`params.x` = force, `params.yzw` = couleur, lu par `shaders/cube.frag`). Une teinte plutôt qu'une transparence — pourtant le rendu habituel d'un fantôme — parce que le mélange alpha impose de trier les objets par profondeur à chaque image. C'est le choix que le projet a déjà fait deux fois pour la même raison : la végétation de la Phase 11 fond ses arbres par **rétrécissement**, et l'herbe est faite de quads **opaques**. Conséquence : ni second pipeline, ni état de blending, ni tri — et **une force nulle laisse le rendu bit à bit identique à celui d'avant la Phase 15**, ce qui est ce qui autorisait à toucher au shader du matériau `Object` sans risquer les phases précédentes. Cyan pour le fantôme, ambre pour la sélection : deux couleurs qu'aucun asset de cette session ne porte (tous gris, bruns ou ocres) et que le terrain ne porte pas non plus. --- ## 4. Le format de scène `.vcsc` Fichier **texte**, une directive par ligne, champs séparés par des espaces, commentaires après `#`. Documentation de référence : `src/editor/SceneFile.hpp`. ``` # Vercora scene v1 - genere par l'editeur (Phase 15). version 1 terrain LHD_0907_6440_1m.vchm crs 2154 object rocher 907500.000 6439501.840 0.000 0.000 1.0000 1 object cairn 907503.500 6439505.000 0.000 0.000 1.0000 1 ``` | directive | rôle | |---|---| | `version ` | obligatoire, **en premier**. 1 pour cette session. | | `terrain ` | **informatif** : ne sert jamais à refuser un chargement. | | `crs ` | `2154` = les objets portent des coordonnées **projetées** ; `0` = terrain sans référence géographique, coordonnées locales. | | `object …` | sept champs : `asset`, `est`, `nord`, `dz`, `cap` (deg), `échelle`, `solide` (0/1). | ### Deux décisions qui font tout l'intérêt du format **Coordonnées projetées, pas locales.** Le repère du moteur est *centré sur le terrain chargé* : une position locale ne veut rien dire sans savoir quelle emprise était chargée. Cette zone existe déjà sous quatre emprises différentes (la dalle de Phase 7, la zone de 25 km², chacune à 1 m et à 2 m). Du Lambert 93 rend la scène indépendante de tout ça : un rocher posé sur la dalle isolée se retrouve au même endroit du massif quand on charge la zone entière. **Altitude relative au terrain (`dz`), pas absolue.** Même raisonnement sur la verticale. La surface au pas de 2 m n'est pas exactement celle au pas de 1 m, et le repli sur l'ancêtre du quadtree (Phase 12) peut afficher une tuile plus grossière le temps d'une image. Une altitude absolue ferait flotter ou enterrer chaque objet à la moindre variation. `dz = 0` veut dire « posé au sol », et ça reste vrai partout. **Test headless dédié** : la même scène rechargée sur le même endroit échantillonné à 2 m garde ses objets au sol au demi-centimètre près, et l'objet volontairement surélevé de 2,5 m garde ses 2,5 m. ### Ce que le format ne stocke pas * **Les identifiants d'objet** : ils sont attribués au chargement. C'est une identité de *session* (sélection, annulation), pas une propriété de la scène ; la stocker rendrait tout déplacement de ligne visible dans un diff sans rien apporter. * **La géométrie** : la scène ne contient que des références d'assets. Un fichier de scène fait quelques centaines d'octets et se relit à l'œil. ### Robustesse Une directive inconnue est **ignorée avec un avertissement** plutôt que fatale : un fichier plus récent restera partiellement lisible. Une ligne `object` mal formée est **comptée et sautée** — perdre un objet vaut mieux que perdre la scène. L'écriture passe par un fichier temporaire renommé à la fin : une coupure en pleine sauvegarde ne détruit pas ce qu'on était en train de sauvegarder. La lecture et l'écriture forcent la **locale C** — dans une locale française le séparateur décimal est la virgule, et `907512.250` se relirait comme `907512`. ### Où vivent les fichiers * **Scènes** : `assets/scenes/.vcsc`. Même convention que l'orthophoto et pour la même raison : 1 m et 2 m sont deux échantillonnages du *même endroit*, ils partagent leur scène. * **Modèles** : `assets/editor/`. Les deux sont sous `assets/`, donc **versionnés** (contrairement à `data/`, que le `.gitignore` exclut). Une scène composée à la main est du contenu : la perdre coûterait le temps de la refaire, alors qu'une heightmap se régénère en quatre secondes depuis le `.laz`. `assets/scenes/demo_phase15.vcsc` est **écrite à la main** — c'est ce qui prouve que le format est réellement éditable sans lancer le jeu. --- ## 5. Les touches Le mode éditeur est **exclusif** : tant qu'il est actif, aucune touche de jeu n'est lue, et réciproquement. C'est ce qui autorise l'éditeur à reprendre des lettres déjà prises (`E` abat un arbre en jeu, sélectionne un objet en édition). À chaque bascule, **tous** les fronts descendants sont resynchronisés (`syncAllKeyEdges`) : sans ça, entrer en édition avec `E` enfoncé sélectionnerait un objet, et en sortir avec `E` enfoncé abattrait un arbre. | touche | effet | |---|---| | `F2` | entrer / sortir du mode éditeur | | `ZQSD` + `espace` / `maj-gauche` | voler (caméra libre) | | molette | vitesse de vol, × ou ÷ 1,25 par cran (2 à 600 m/s) | | clic droit maintenu | regarder | | **clic gauche** ou `INSER` | poser au point visé / reposer l'objet en main | | `E` | sélectionner l'objet visé | | `G` | saisir / reposer la sélection | | `SUPPR` | supprimer la sélection | | `ECHAP` | abandonner la saisie, puis la sélection | | `TAB` ou `PAGE_SUIV` / `PAGE_PREC` | asset suivant / précédent (cyclique) | | `1`..`9` | rang direct dans la page courante du catalogue | | `←` `→` | tourner (90 °/s) | | `↑` `↓` | échelle (× 1,8 par seconde, **multiplicative**) | | `DEBUT` / `FIN` | monter / descendre par rapport au sol (0,6 m/s) | | `K` | solide ↔ traversable | | `CTRL gauche` | pas fin (divise les trois vitesses par 8) | | `RETOUR ARRIÈRE` | annuler | | `F5` | sauvegarder | | `F9` | recharger depuis le disque | | `L` | réafficher le catalogue | **Choix des touches.** GLFW raisonne en positions physiques façon QWERTY US (note clavier de `core/Camera.hpp`). Les touches de réglage sont donc prises parmi celles qui occupent la **même position physique** en AZERTY et en QWERTY : flèches, pavé de navigation, rangée de fonctions, `Tab`, `Retour arrière`, `Échap`, rangée des chiffres. Les seules lettres utilisées — `E`, `G`, `K` — sont à la même place sur les deux. **Pourquoi `INSER` en plus du clic** : à l'usage, on règle aux flèches puis on pose sans ramener la main sur la souris. Mais surtout, le harnais automatisé ne peut piloter que le clavier : sans cette touche, la pose serait la seule fonction de l'éditeur qu'aucun test ne pourrait exercer sous Vulkan. Les deux voies passent par le même `placePressed`, donc le chemin exercé est bien celui du clic. ### Options de ligne de commande ``` vercora.exe [scene] --editor démarre directement en mode édition vercora.exe [scene] --scene=chemin.vcsc fichier de scène explicite vercora.exe [scene] --no-scene ni catalogue, ni objets, ni éditeur vercora.exe [scene] --editor-assets=rep dossier de modèles à scanner ``` `--no-scene` reproduit **exactement** le comportement d'avant la Phase 15 : c'est le témoin de toute mesure avant/après. --- ## 6. Les assets de test Cinq modèles **générés en code**, même parti pris que l'arbre (Phase 5), la pierre (Phase 6) et l'herbe (Phase 11) : aucun fichier, aucun téléchargement, aucune licence à vérifier. | id | description | hauteur | rayon de collision | |---|---|---:|---:| | `rocher` | bloc arrondi facetté (octaèdre subdivisé, bruité par hachage) | 1,71 m | 1,47 m | | `bloc` | dalle basculée anguleuse, trois boîtes imbriquées | 2,97 m | 1,48 m | | `cairn` | quatre pierres empilées | 1,08 m | 0,64 m | | `abri` | abri de pierre à deux pentes, **avec porte** | 2,60 m | 2,35 m | | `poteau` | poteau de balisage avec plaque | 2,02 m | 0,52 m | Plus `assets/editor/octaedre.obj`, seul asset venant d'un **fichier** : c'est le seul qui prouve que ce chemin fonctionne dans une partie réelle. ### Le bruit est un hachage, pas un générateur à état Les déformations du rocher sont tirées d'un **hachage de l'indice de sommet** — la leçon de la Phase 11 sur le semis de végétation. Un `mt19937` rend une suite qui dépend de l'*ordre* des appels ; deux constructions du même mesh dans un ordre différent donneraient deux géométries. Ça compte ici parce que l'empreinte de **collision** est déduite de la boîte englobante du mesh : une géométrie qui varierait donnerait une collision qui varie, et une scène sauvegardée ne se rechargerait pas à l'identique. Figé par test (comparaison bit à bit). ### Ancrage n'est pas centrage Convention commune : dimensions **absolues** en mètres, **pied à `y = 0`**, ancrage horizontal à l'origine. Mais l'ancrage n'est pas forcément le centre de la boîte englobante, et c'est délibéré : le poteau de balisage a son **mât** à l'origine, sa plaque débordant vers +X. Planter un panneau, c'est planter le mât au point visé, pas y placer le milieu de l'ensemble mât + panneau, qui n'existe nulle part physiquement. Un asset **chargé depuis un fichier** ne dit rien de son intention : son origine est où l'auteur l'a laissée. Faute de mieux, `normalizeAssetMesh` le **recentre de force** sur sa boîte englobante et pose son point le plus bas à zéro. C'est le défaut le moins mauvais, pas une règle générale. La propriété que *tous* respectent, et que le test vérifie, est plus faible et plus utile : **l'ancrage tombe dans l'empreinte horizontale de l'objet**, et pas au bord. Un objet posé entoure donc toujours le point visé. *(Le test initial exigeait un centrage exact et a échoué sur trois assets sur cinq. C'est la convention qui était fausse, pas la géométrie.)* ### Ordre du catalogue Builtins d'abord, puis les fichiers **triés par nom**. Pas par goût de l'ordre : les touches `1`..`9` désignent des rangs dans cette liste, et `std::filesystem::directory_iterator` ne garantit aucun ordre — sans le tri, la même touche poserait un modèle différent d'une exécution à l'autre. Un fichier illisible est **signalé et sauté**, il n'interrompt pas le scan. Un modèle hors des bornes 5 cm – 200 m est signalé (première cause : un `.obj` exporté en centimètres) mais reste plaçable. --- ## 7. Ce qui a été vérifié ### Tests headless **650 assertions** (425 avant la Phase 15, **+225**), sans GPU ni Vulkan. `tools\run_logic_tests.bat`. Nouveaux blocs : * assets générés — convention d'ancrage, normales unitaires, déterminisme bit à bit ; * catalogue — builtins, doublons refusés, scan d'un dossier temporaire avec un `.obj` valide, un `.obj` cassé et un fichier d'extension inconnue, tri par nom, normalisation d'un modèle chargé, dossier absent non fatal ; * raycast terrain — distance exacte sur plan (14,142 m à 45°), regard vers le ciel, **hors emprise contre emprise non déclarée**, œil sous la surface, pente réelle, normale de surface ; * scène éditable — suppression au milieu puis annulation **reprenant son indice**, regroupement des retouches (20 rotations = 1 annulation), retouches espacées = 2 annulations, invariants de `transform()`, renumérotation par `replaceAll`, pile bornée qui jette la plus ancienne ; * collision — répoussement hors du cylindre, **position repoussée réellement libre**, recouvrement vertical, objet traversable, asset absent du catalogue, et le **solveur composite** (forêt + éditeur bloquent tous les deux, composite vide totalement transparent) ; * visée — le plus proche des deux, hors de portée, rayon passant au-dessus ; * format `.vcsc` — aller-retour exact, **indépendance vis-à-vis de la résolution**, fichier partiellement fautif, en-tête obligatoire, terrain non géoréférencé, objets hors emprise conservés mais comptés, convention de chemin, aller-retour `toProjected`/`fromProjected` ; * contrôleur — fantôme au point visé, viser le ciel ne pose rien, réglages du pinceau conservés entre deux poses, pas fin, **saisie n'écrivant pas dans la scène** et ne laissant qu'une annulation, sélection puis suppression puis annulation, parcours cyclique du catalogue, drapeaux d'E/S consommés une fois, `resetInteraction`. ### Sous Vulkan, couches de validation actives `tools\run_vulkan_check.ps1` — **scénario G ajouté**, en trois processus : * **G1** — édition : catalogue, trois poses d'assets différents, rotation du pinceau, sélection, agrandissement, suppression, annulation, `F5`, `F9`, sortie du mode, redimensionnements, fermeture propre. * **G2** — partie **normale** (aucun `--editor`) sur le fichier écrit par G1 : les objets doivent se charger seuls, être dessinés, et arrêter le joueur. * **G3** — **témoin** : exactement la même marche que G2, mais `--no-scene`. C'est l'écart entre G2 et G3 qui fait la preuve, pas la distance de G2 prise isolément — sinon « le joueur a avancé de 0,7 m » pourrait tout aussi bien vouloir dire qu'il s'est heurté au relief ou qu'il n'a jamais reçu la touche. ### L'indépendance vis-à-vis de l'emprise, sur la vraie zone de 25 km² La propriété centrale du format ne vaut que si elle tient sur les vrais fichiers, pas seulement sur un terrain de test. `assets/scenes/demo_zone25.vcsc` — six objets écrits à la main en Lambert 93 — a été chargée sur `vercora_zone_1m.vchm` **et** `vercora_zone_2m.vchm`, même point de vue : | | 1 m | 2 m | |---|---|---| | objets chargés | 6 (5 solides) | 6 (5 solides) | | hors emprise | 0 | 0 | | altitude du sol au point de départ | 1781,64 m | 1781,66 m | | `[Validation]` | 0 | 0 | Les deux captures (`build\p15_zone_1m.png`, `build\p15_zone_2m.png`) sont superposables : mêmes objets aux mêmes positions à l'écran, seul le relief fin diffère. Les 2 cm d'écart d'altitude du sol entre les deux échantillonnages sont exactement ce contre quoi le `dz` relatif protège — une altitude absolue aurait laissé les objets enterrés ou flottants d'autant. Cette scène ne porte **pas** le nom d'auto-chargement (`vercora_zone.vcsc`) : la zone de jeu par défaut reste vierge, la scène ne se charge qu'avec `--scene=`. ### La mesure de collision Sonde dédiée, trois processus, même binaire, même point de départ, même durée de touche maintenue — **seule la présence de la scène change** : | | distance parcourue vers le nord | |---|---:| | avec un rocher posé devant | **0,69 m** | | témoin, sans la scène | **21,17 m** | Et le chiffre est **prédit** : le rocher a été posé à 2,51 m devant le joueur, son rayon de collision vaut 1,47 m, celui du corps 0,35 m — donc l'arrêt attendu est à 2,51 − 1,82 = **0,69 m**. C'est ce qui distingue « ça a l'air de bloquer » de « ça bloque là où le modèle le dit ». ### Le défaut que seul le harnais complet a révélé **La première exécution complète du harnais a échoué**, et c'est le seul vrai défaut de la session. Le scénario G rapportait **9 objets posés pour 3 touches envoyées**, alors que le même scénario joué seul en posait 3, et que rejouer la séquence exacte à la main — même touches, même timing — en posait 3 aussi. Ni le code ni le rythme n'étaient en cause. **La cause** : la suite complète dure huit minutes, chaque scénario ouvre une fenêtre qui prend le focus, et **l'éditeur lit la souris *système***. Les clics réels de l'utilisateur, destinés à d'autres fenêtres, atterrissaient dans celle du jeu et posaient des objets. C'est *exactement* le problème de la Phase 11 — « le jeu lit le clavier et la souris SYSTÈME » — qui avait donné `--lock-input`. Sauf que ce verrou ne couvrait que la **caméra** : l'éditeur n'existait pas encore. **La nuance GLFW qui rendait le défaut invisible.** La position du curseur vient de `GetCursorPos()` : un `WM_MOUSEMOVE` posté n'a aucun effet, limite connue et documentée depuis la Phase 8. Mais **l'état des boutons, lui, est mis en cache depuis les messages de fenêtre**. Les boutons sont donc atteignables là où le curseur ne l'est pas. Raisonner « la souris ne passe pas » était vrai pour le curseur et faux pour les clics. **Reproduit à la demande, puis corrigé, avec contrôle négatif** — trois `WM_LBUTTONDOWN` postés dans une fenêtre lancée avec `--lock-input` : | | objets posés | |---|---:| | avant correction | **3** sur 3 clics | | après correction | **0** sur 3 clics | `--lock-input` coupe désormais la pose au clic. **Seulement la souris** : le clavier doit rester vivant pour qu'un scénario puisse piloter l'éditeur caméra figée — c'est la raison d'être de la touche `INSER`. *Limite qui subsiste* : une vraie frappe clavier de l'utilisateur peut toujours perturber un run, exactement comme pour les scénarios A à F. C'est la flakiness déjà documentée dans `MEMORY.md`, et elle n'a pas de remède simple tant que le jeu lit le clavier système. *Au passage* : le harnais a gagné un paramètre `-Only` (`-Only G`, `-Only A,B`). Mettre au point un scénario en payant les six autres à chaque essai décourage de le faire correctement. Un scénario non joué est **ignoré, pas validé** ; un run de référence se fait toujours sans `-Only`. ### Contrôle d'image Trois captures (`tools\shot_editor.ps1`, nouveau) : un journal ne peut pas dire si la teinte témoin s'applique — les trois états passent par le même mesh et le même pipeline. Il faut regarder l'image. Même raison qui avait motivé `screenshot_scene.ps1` en Phase 10. * `build\p15_avec_objets.png` — les huit objets de la scène de démonstration dessinés dans une partie **normale** (13,5 % de ciel contre 20,0 % pour le témoin `--no-scene` : ils occultent réellement). * `build\p15_editeur.png` — vol libre au-dessus de la scène, `[EDITEUR]` dans le titre de la fenêtre. * `build\p15_editeur_fantome.png` — le fantôme en **cyan**, posé au point exact où le regard rencontre le sol. * `build\p15_editeur_selection.png` — l'abri en **ambre** : la teinte de sélection s'applique bien, et se distingue sans ambiguïté de celle du fantôme. * `build\p15_zone_1m.png` / `build\p15_zone_2m.png` — la scène de contrôle sur la zone de 25 km², aux deux résolutions (voir juste au-dessus). ### Non-régression Voir §11 pour le relevé du run de référence et la liste des fichiers de phases précédentes touchés. --- ## 8. Ce qui reste à améliorer ### 1. glTF — **non fait**, et c'est la principale limite de la session `AssetCatalog::supportedExtensions()` ne connaît que `.obj`. **Pourquoi** : un loader glTF 2.0 honnête demande un analyseur JSON, la gestion du conteneur binaire `.glb` et des `.bin` externes, le décodage des accesseurs (types de composants, entrelacement, `byteStride`), les modes de primitive, et l'aplatissement de la hiérarchie de nœuds avec leurs transformations. C'est de l'ordre de 600 à 800 lignes neuves — une session à part entière, et une session dont le risque est réel alors que la consigne exigeait par ailleurs zéro erreur de validation et une non-régression complète. Le choix a été de livrer l'éditeur **complet** plutôt que l'éditeur et un loader à moitié. **Ce que ça coûte** : les bibliothèques d'assets libres de droits distribuent majoritairement du glTF. En pratique il faut aujourd'hui convertir en `.obj` (Blender, `assimp`) avant de déposer dans `assets/editor/`. **Où l'ajouter** : `supportedExtensions()` est le seul point d'extension. Le reste de la chaîne — normalisation d'ancrage, empreinte de collision, catalogue, placement, sérialisation — est déjà agnostique et n'aura pas une ligne à changer. C'est le premier chantier à reprendre. ### 2. Collision par cylindre englobant Exacte pour un rocher ou un cairn — ce que l'éditeur sert d'abord à poser — et **fausse pour tout objet à intérieur** : l'abri de pierre a une porte, mais son cylindre est plein, donc on ne peut pas y entrer. Le remède immédiat est le drapeau par objet (`K` : traversable). La vraie réponse — collision par volumes composés, ou par maillage — est un chantier à part. Le cylindre est **contenant** et non inscrit (rayon = demi-diagonale horizontale) : un obstacle un peu trop gros se contourne, un obstacle trop petit se traverse par les coins, et traverser un rocher est bien plus visible que le raser d'un demi-mètre. ### 3. Aucun frustum culling sur les objets posés Un `DrawItem` par objet, à chaque image, qu'il soit visible ou non. Le culling de la Phase 10 vit dans le quadtree du terrain, celui de la Phase 11 dans la végétation instanciée ; aucun des deux ne s'applique ici. Sans conséquence à l'échelle d'une scène d'éditeur (des dizaines d'objets), à reprendre le jour où une scène en comptera des milliers. Le `Frustum` existe déjà et se brancherait en quelques lignes. ### 4. Le catalogue est figé au démarrage Déposer un `.obj` dans `assets/editor/` demande de relancer le jeu. Un rescan à chaud serait facile côté catalogue, mais suppose de téléverser de nouvelles géométries en cours de partie. ### 5. Pas de sauvegarde automatique `F5` est explicite, et sortir du mode éditeur ne sauvegarde pas — le message de sortie le rappelle. C'est volontaire (rien n'est écrit sans qu'on le demande), mais un travail long peut être perdu à la fermeture. ### 6. Aucune aide au placement Ni grille, ni magnétisme, ni alignement sur la normale du terrain : un objet posé sur une forte pente reste vertical et flotte d'un côté. `terrainNormalAt()` est déjà écrit et testé dans `core/TerrainRay.hpp` — il ne manque qu'une décision de conception (un rocher épouse la pente, un poteau reste vertical), qui demande de porter cette information dans l'asset. ### 7. Pas de rotation libre ni d'échelle non uniforme Contrainte du contrat de `DrawItem` : le vertex shader utilise `mat3(model)` comme normal matrix, ce qui n'est exact que pour une rotation suivie d'une échelle **uniforme**. Autoriser plus imposerait de calculer et de pousser une vraie normal matrix — possible (il reste 48 octets de push constant), non fait. ### 8. Pas de sélection multiple, pas de copier-coller Une seule sélection à la fois. Poser dix rochers alignés se fait à la main. ### 9. Les objets posés n'interagissent avec rien Ils bloquent, et c'est tout : pas d'abattage, pas de ramassage, pas d'ombre portée (limite ouverte depuis la Phase 11), et l'éditeur ne peut ni déplacer ni supprimer les arbres de `Forest` ou les pierres de `Ground`, qui restent semés proceduralement. ### 10. Rien n'empêche d'empiler deux objets au même endroit Voulu (on peut vouloir un tas), mais aucun signal ne prévient qu'on vient de poser un rocher dans un autre. --- ## 9. Ce qu'il faudrait pour une version destinée aux joueurs Cette session a délibérément écarté l'ergonomie. Si l'éditeur devait un jour sortir du domaine du développeur, voici ce qui manque — classé par ce qui bloque le plus, pas par difficulté. 1. **Tout le retour d'information passe par le journal.** L'état de l'outil, le catalogue, les messages d'erreur : rien n'est à l'écran sauf `[EDITEUR]` dans le titre. Un joueur ne lit pas une console. Il faut au minimum un affichage tête haute : l'asset armé, ses réglages, la sélection, et le réticule — **il n'y a même pas de réticule dessiné aujourd'hui**, on vise le centre de l'écran sans repère. 2. **Le catalogue est une liste texte.** Il faudrait des vignettes, une recherche, et des catégories dès que le dossier dépasse une dizaine de modèles. Les touches `1`..`9` ne passent pas à l'échelle. 3. **Aucune confirmation, aucune protection.** `SUPPR` supprime sans demander (l'annulation existe, mais il faut savoir qu'elle existe), et quitter sans `F5` perd tout en silence. 4. **Les gizmos 3D manquent vraiment.** Régler au clavier convient à qui connaît les touches ; poser une passerelle entre deux rochers à la flèche et à l'œil est pénible. C'est le point où l'écart avec un vrai éditeur se creuse le plus. 5. **Rien n'est rebindable**, et la liste des touches n'est visible qu'une fois, au moment d'entrer dans le mode. 6. **Aucune notion de projet ni de calques** : une seule scène par terrain, pas de groupes, pas de nommage d'objets, pas de sélection multiple. 7. **Le format de scène n'a pas de garde-fou de version côté écriture** : un exécutable ancien relisant un fichier plus récent perd silencieusement les champs qu'il ne connaît pas dès la prochaine sauvegarde. Acceptable entre développeur et lui-même, pas pour du contenu de joueur. ## 10. Ce qui n'a pas pu être vérifié * **Le comportement de la souris en usage réel.** Le harnais ne peut pas piloter le curseur ; la pose au clic, la molette de vitesse de vol et la rotation au clic droit n'ont donc été exercées qu'à la main. Le *chemin de code* de la pose, lui, est couvert : le clic et la touche `INSER` aboutissent au même `placePressed`. * **Un vrai fichier glTF** — le loader n'existe pas. * **Un `.obj` volumineux ou exotique** : le catalogue n'a été scanné qu'avec des modèles minuscules (un tétraèdre en test, un octaèdre en jeu). Les avertissements d'unités suspectes ne sont exercés que par le test headless. * **Une scène de plusieurs centaines d'objets** : ni les performances de dessin (un `DrawItem` par objet), ni celles de la collision (balayage linéaire de tous les objets à chaque déplacement) n'ont été mesurées au-delà de la dizaine. Les deux sont linéaires et devront être indexées le jour où ça comptera. ## 11. Non-régression ### Run de référence, suite complète `tools\run_vulkan_check.ps1` sans `-Only`, sur le binaire livré : ``` Code de sortie A..G : 0 / 0 / 0 / 0 / 0 / 0 / 0/0/0 Lignes de log : 2472 Messages [Validation] : 0 Lignes [ERROR] : 0 Lignes [WARN] : 0 Fermeture propre A..G : True x9 ``` Les six scénarios antérieurs sont inchangés et verts : 2 arbres abattus, 3 débitages, 7 objets ramassés des quatre natures, 1 percussion, vol de parapente avec atterrissage naturel, sortie à vélo (50,0 km/h au pic en descente, 5,4 km/h de moyenne en montée sur 20 relevés en mouvement, 96,9 m de dénivelé suivi), escalade (sommet à 41,6 m avec 14 % de jauge, 75 relevés). **650 assertions headless** (425 avant, **+225**), zéro avertissement de compilation en `/W4`. ### Sur la flakiness Trois exécutions complètes ont été nécessaires. La première a échoué sur le défaut souris décrit en §7 — un vrai défaut, corrigé. La deuxième a échoué sur le **scénario F**, rejoué seul immédiatement après et vert (41,5 m, sommet atteint, 0 validation) : c'est la flakiness `PostMessage` déjà documentée dans `MEMORY.md`, et non une régression. La troisième est le run de référence ci-dessus. ### Fichiers de phases précédentes touchés, et pourquoi : | fichier | modification | |---|---| | `src/core/Camera.hpp/.cpp` | `setModeLocked()` (2 lignes dans `update`), `moveSpeed()` | | `src/core/Window.hpp/.cpp` | accumulateur de molette (`consumeScroll`) | | `src/assets/Heightmap.hpp/.cpp` | `fromProjected()`, l'inverse de `toProjected()` | | `src/renderer/DrawItem.hpp` | documentation de `params` par matériau | | `shaders/cube.vert/.frag` | teinte témoin — **inerte à force nulle** | | `src/main.cpp` | câblage du mode éditeur, solveur composite, position dans le journal | `Heightmap::fromProjected` mérite un mot : la formule **existait déjà**, recopiée à la main dans `main.cpp` pour l'option `--start` de la Phase 11, et l'éditeur en avait besoin une troisième fois. Deux copies d'une convention d'axes dont une seule serait corrigée le jour où elle changerait — exactement le piège que le commentaire de `toProjected` décrivait. La conversion vit désormais dans les deux sens au même endroit, et `main.cpp` l'utilise. Le changement de shader est le seul qui touche le rendu. Il est **inerte** pour tout `DrawItem` dont `params.x` vaut zéro, c'est-à-dire pour tout le jeu : la branche n'est même pas prise. --- ## 12. Suite de session (2026-08-23) : sélection au clavier sans viser (F3/F4) Reprise après vérification que la session initiale tenait toujours : build propre, **650/650** assertions headless, puis `run_vulkan_check.ps1` complet - zéro validation, six scénarios antérieurs verts, scénario G vert. Une seule anomalie, le **scénario F** en échec sur la fermeture propre ; rejoué seul immédiatement après (`-Only F`), il passe (sommet atteint, 41,1 m de dénivelé, 0 validation) - c'est la flakiness `PostMessage` déjà documentée dans `MEMORY.md` pour les scénarios A/B/F, pas une régression. ### Le choix : ergonomie clavier, pas glTF La consigne proposait trois pistes : l'annulation (déjà livrée en §1), le glTF, ou l'ergonomie clavier. Le glTF reste **la plus grosse limite documentée** (§8.1), mais c'est précisément pour ça qu'il a été écarté ici : la session initiale l'a chiffré à 600-800 lignes neuves (analyseur JSON, conteneur binaire `.glb`, décodage d'accesseurs, aplatissement de hiérarchie de nœuds) et a choisi explicitement de livrer un éditeur **complet** plutôt qu'un éditeur et un loader à moitié, alors que la consigne exige **zéro erreur de validation et une non-régression complète**. Retenter ce chantier dans une passe de suite de session, sans le temps d'un loader testé aussi rigoureusement que le reste de l'éditeur, aurait repris exactement le risque que ce choix initial évitait - sans même gagner en confort d'usage tant qu'aucune bibliothèque de modèles `.gltf` n'est effectivement déposée dans `assets/editor/`. L'ergonomie clavier, elle, correspond à une lacune concrète et déjà nommée en §9.4 : *"il n'y a même pas de réticule dessiné aujourd'hui"* et, plus large, l'absence de toute aide à la manipulation en dehors des flèches et de la visée. Un défaut precis et bien scope s'en degage : **`pickPressed` (touche E) exige que la visée touche l'objet.** Retrouver un objet posé loin du regard courant n'a donc qu'une voie - revenir dessus à la souris/au vol - ce qui va à l'encontre de l'esprit "outil clavier" documenté en §5. C'est un changement petit, testable intégralement en headless, et sans surface de régression sur le rendu ou la synchronisation GPU (aucun shader, aucun DrawItem touché). ### Ce qui a été ajouté `EditorInput::cycleNextPressed` / `cyclePrevPressed` (nouveaux champs, faux par défaut - **aucun code existant n'est affecté tant qu'ils ne sont pas levés**). `EditorController::update` les traite juste avant le bloc de saisie, avec la même garde que `pickPressed` : ignorés pendant qu'un objet est en main, sinon on changerait la cible des réglages **sous** l'objet suivi par la visée. - Rien sélectionné + "suivant" -> premier objet de la scène (ordre d'insertion, celui que `EditorScene::objects()` expose) ; "précédent" -> dernier. Même convention que `selectBrush(-1)` depuis le rang 0. - Un objet sélectionné + "suivant"/"précédent" -> avance/recule d'un rang, **cyclique** dans les deux sens (modulo positif, comme le parcours du catalogue). - Scène vide -> aucune sélection, message journalisé, pas d'erreur. Touches choisies : **F3** (suivant) / **F4** (précédent) - libres, adjacentes à F2 (bascule éditeur) et F5 (sauvegarde) déjà pris, et **physiquement identiques en AZERTY et QWERTY** (rangée de fonctions), donc conformes à la convention de touches posée en §5. Ligne d'aide (`kEditorHelp`, journalisée à l'entrée en mode éditeur) mise à jour en conséquence. ### Vérifié - **9 nouvelles assertions headless** (650 -> **659**) dans `tests/logic_tests.cpp`, section *"Cycle F3/F4 parmi les objets posés"* : parcours dans les deux sens, bouclage aux deux extrémités, scène vide, et surtout **le cas qui aurait pu casser silencieusement** - le cycle est bien ignoré pendant une saisie, et la saisie en cours n'est pas interrompue. - **Sous Vulkan réel**, `tools\run_vulkan_check.ps1` (scénario G1) envoie désormais deux `F3` puis un `F4` par `PostMessage` (le harnais ne pilote que le clavier, voir §5) avant de reviser l'objet **par la visée** pour ne pas changer quel objet la suite du scénario supprime. Une mesure dédiée compte les lignes de journal `[F3/F4]` et **exige exactement 3** (une par touche envoyée) dans le critère de réussite du scénario G - un défaut de front descendant (touche perdue, ou comptée deux fois) ferait donc échouer le run plutôt que de passer inaperçu. - Run cible (`-Only G`) : **`Cycle sans viser (F3/F4) : 3 selection(s)`**, 0 `[Validation]`, fermeture propre des trois processus G1/G2/G3, mêmes compte d'objets et même distance de collision (0,27-0,28 m) qu'avant ce changement - la modification du scénario ne perturbe pas les mesures qui suivent. - Run complet (`run_vulkan_check.ps1`, sans `-Only`) : voir le relevé de référence en tête de cette section. ### Fichiers touchés | fichier | modification | |---|---| | `src/editor/EditorController.hpp` | deux champs `EditorInput` | | `src/editor/EditorController.cpp` | bloc de cycle, avant la saisie | | `src/main.cpp` | deux touches F3/F4, deux `KeyEdge`, aide journalisée | | `tests/logic_tests.cpp` | 9 assertions nouvelles | | `tools/run_vulkan_check.ps1` | scénario G1 exerce F3/F4, mesure et gate dédiés | Aucun fichier de rendu (shaders, `Renderer`, `DrawItem`) n'est touché : ce changement ne modifie que la machine à états de l'éditeur et l'entrée clavier, jamais ce qui se dessine. ### Ce que ça ne résout pas Le réticule manquant (§9.1), les gizmos 3D (§9.4) et le glTF (§8.1) restent entiers. Cette passe referme UNE lacune d'ergonomie clavier précisément scopée ; les autres limites listées en §8 et §9 sont inchangées.