42 KiB
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 :
- il ne dépend alors ni de GLFW ni de
Window; - les touches restent décrites en un seul endroit, à côté de celles du jeu ;
- 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::heightAtest totale par contrat — hors des données elle prolonge le bord. Sans le paramètrehalfExtent, 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 <n> |
obligatoire, en premier. 1 pour cette session. |
terrain <nom> |
informatif : ne sert jamais à refuser un chargement. |
crs <epsg> |
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/<terrain sans suffixe de résolution>.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
.objvalide, un.objcassé 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 parreplaceAll, 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-retourtoProjected/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é.
- 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. - 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..9ne passent pas à l'échelle. - Aucune confirmation, aucune protection.
SUPPRsupprime sans demander (l'annulation existe, mais il faut savoir qu'elle existe), et quitter sansF5perd tout en silence. - 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.
- Rien n'est rebindable, et la liste des touches n'est visible qu'une fois, au moment d'entrer dans le mode.
- 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.
- 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
INSERaboutissent au mêmeplacePressed. - Un vrai fichier glTF — le loader n'existe pas.
- Un
.objvolumineux 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
DrawItempar 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 queselectBrush(-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 deuxF3puis unF4parPostMessage(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.