From 551e0bd0ad12f29ee7d46d34441c716641b942c8 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 14 Oct 2026 19:34:37 +0000 Subject: [PATCH] Documentation : README, etat de MEMORY.md, suite de l'audit - README.md (nouveau) : demarrage rapide - build Windows et Linux, donnees, lancement et options, tests, arborescence. - MEMORY.md : index des notes jusqu'a la Phase 30, bloc "Etat verifie" a jour (builds, tests, ressources journalisees, formats GPU, options, validation de synchronisation, mesure sans GPU), prochaines etapes 0bis et 4 mises a jour. - NOTES-AUDIT-GLOBAL.md : suite donnee par la Phase 30. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01MG5dK27RsN97DDm7CQRhx2 --- MEMORY.md | 43 +++++++++++++++++++-- NOTES-AUDIT-GLOBAL.md | 14 +++++++ README.md | 88 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 142 insertions(+), 3 deletions(-) create mode 100644 README.md diff --git a/MEMORY.md b/MEMORY.md index c3ba245..5ef4df4 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -5,8 +5,10 @@ voir `NOTES-PHASE6.md`, `NOTES-PHASE7.md`, `NOTES-PHASE9.md`, `NOTES-PHASE10.md` `NOTES-PHASE11.md`, `NOTES-PHASE12.md`, `NOTES-PHASE-VELO.md`, `NOTES-PHASE-ESCALADE.md`, `NOTES-PHASE15.md`, `NOTES-PHASE16.md`, `NOTES-PHASE17.md`, `NOTES-PHASE18.md`, `NOTES-PHASE19.md`, -`NOTES-PHASE20.md` et `NOTES-PHASE21.md` ; ce fichier est +`NOTES-PHASE20.md` a `NOTES-PHASE30.md` (plus `NOTES-PHASE28-DESIGN.md`, +`NOTES-PHASE29-DESIGN.md`) et l'audit `NOTES-AUDIT-GLOBAL.md` ; ce fichier est un resume vivant, mis a jour a la fin de chaque session, pas un journal complet. +Le `README.md` a la racine donne le demarrage rapide (build, lancement, tests). ## Ce qu'est Vercora @@ -22,6 +24,35 @@ MONDE - une partie normale les charge, les dessine et s'y cogne. Suite du 2026-08-23 : **F3/F4 selectionnent l'objet pose suivant/precedent SANS viser** (detail plus bas, section Phase 15). +## Etat verifie (2026-10-14, fin de Phase 30) + +Ce bloc complete celui de la Phase 20 ci-dessous, qui reste vrai sauf mention. + +- **Builds** : Windows inchange (`tools\build.bat`, `tools\run_logic_tests.bat`). + **Linux** depuis la Phase 30 : `cmake -S . -B build-rel -G Ninja + -DCMAKE_BUILD_TYPE=Release -DGLFW_BUILD_WAYLAND=OFF && ninja -C build-rel` + (GCC 13 / Clang 18). Les tests headless se compilent avec la meme liste de + sources que `run_logic_tests.bat`. +- **Tests headless** : 3 963 verifications sans les dalles LiDAR (25 de plus + avec elles). +20 en Phase 30 (formats GPU, allocateur, orthophoto par tranches). +- **Ressources** : chaque partie journalise `Ressources (PHASE 30)` au + chargement, toutes les 10 s et a la fermeture : RAM du processus, memoire GPU + exacte (toute allocation passe par `VulkanContext::allocateMemory`), blocs et + appels `vkAllocateMemory`, et occupation du pool de geometrie. +- **Format GPU** : `Vertex` (68 o) n'est plus que le format CPU ; le GPU lit + `ObjectVertex` (44 o) et `TerrainVertex` (16 o), dans les blocs de 4 Mo de + `GpuBufferPool`. Ecriture directe en memoire unifiee (UHD 770), staging sinon + (`--force-staging` pour l'eprouver). +- **Options ajoutees** : `--quit-after=S`, `--freeze-anim`, `--force-staging`, + `--vsync` (presentation FIFO, a prendre pour JOUER ; les mesures restent non + plafonnees). +- **Validation de synchronisation** : la variable qui fonctionne avec les couches + 1.3.275 est `VK_LAYER_ENABLES=VK_VALIDATION_FEATURE_ENABLE_SYNCHRONIZATION_VALIDATION_EXT`. +- **Sans GPU ni donnees** (session cloud) : lavapipe + Xvfb, zone proxy par + `tools/make_bench_zone.py`. Recette complete : NOTES-PHASE30.md section 9. +- **Comparaisons d'images** : ajouter `--no-wildlife` (la faune bouge en temps + reel) en plus de `--lock-input --look --time-scale=0 --freeze-anim`. + ## Etat verifie (2026-08-26, fin de Phase 20) - **GPU DE CETTE MACHINE : Intel UHD 770 integree.** Il n'y a plus de GTX 960 @@ -1675,7 +1706,10 @@ Deux points rouges, aucun imputable a la phase : collision, catalogue, placement et serialisation sont deja agnostiques du format. Compter un analyseur JSON, le conteneur `.glb`, les accesseurs et l'aplatissement de la hierarchie de noeuds. -0bis. **Paralleliser la construction des tuiles** (Phase 18) : c'est 83 % du +0bis. (Phase 30 : une tuile interieure se construit desormais sans relecture - + ~104 us en Release lavapipe - et s'ecrit directement en memoire GPU, sans + MeshData ni copie : le gain a attendre du parallelisme a encore baisse.) + **Paralleliser la construction des tuiles** (Phase 18) : c'est 83 % du cout d'une tuile apres les optimisations exactes de cette phase, et `terrainNodeMeshData` est deja PURE. Le seul obstacle est `Renderer::addMesh`, qui doit rester sur le thread de rendu. @@ -1686,7 +1720,10 @@ Deux points rouges, aucun imputable a la phase : 3. ~~Transfert asynchrone des tuiles de terrain.~~ **FAIT EN PHASE 12.** Le verrou suivant est le **maillage CPU d'une tuile**, toujours synchrone sur le thread de rendu : un thread de maillage dedie est la suite logique. -4. **Index buffer partage** entre toutes les tuiles, et **sommet allege** (delta +4. ~~**Index buffer partage** et **sommet allege**~~ **FAITS EN PHASE 30** + (topologie uint16 unique, TerrainVertex de 16 o). Suite possible : tirer + les altitudes d'un SSBO (16 -> ~4,5 o/sommet), voir NOTES-PHASE30.md. + Texte d'origine : **Index buffer partage** entre toutes les tuiles, et **sommet allege** (delta de morphing plutot que position complete) : deux economies faciles, chiffrees dans NOTES-PHASE10.md. Le partage de l'index buffer economiserait aussi 98 Ko par tuile epinglee. diff --git a/NOTES-AUDIT-GLOBAL.md b/NOTES-AUDIT-GLOBAL.md index 19837a0..5a944fd 100644 --- a/NOTES-AUDIT-GLOBAL.md +++ b/NOTES-AUDIT-GLOBAL.md @@ -116,3 +116,17 @@ Le projet Vercora est sur des fondations techniques saines, stables et vérifié 3. **Écosystème Faune & Flore :** - Comportements étendus de la faune (troupeaux, pâturage, cycles repos/déplacement selon l'heure météo). - Cueillette de baies / champignons selon l'humidité et le couvert forestier. + +--- + +## Suite donnee (Phase 30, 2026-10-13) + +L'optimisation des ressources de `NOTES-PHASE30.md` reprend ce rapport : +- **D6** (heightmap entiere en RAM) : examine et CONSERVE - c'est la verite + physique, et ses altitudes ne se codent pas sans perte sur 16 bits. +- Les postes que cet audit ne chiffrait pas (format de sommet de 68 o, + topologie recopiee par tuile, une allocation Vulkan par buffer, staging en + memoire unifiee) sont traites : pic GPU du survol 285 -> 87 Mo, + ~17 000 -> 22 `vkAllocateMemory` en 30 s. +- Le projet compile aussi sous Linux (GCC, Clang) et se mesure sans GPU + (lavapipe), voir `README.md`. diff --git a/README.md b/README.md new file mode 100644 index 0000000..7de579b --- /dev/null +++ b/README.md @@ -0,0 +1,88 @@ +# Vercora + +Jeu d'exploration de montagne solo (marche, abattage et taillage, velo, +parapente, escalade, faune, meteo, artisanat) sur une zone LiDAR reelle de +25 km2 du Vercors. Moteur maison C++20 / Vulkan, GLFW, CMake ; Windows et Linux. + +Ce fichier est le demarrage rapide. L'etat du projet est dans `MEMORY.md`, le +detail de chaque phase dans `NOTES-PHASE*.md` (la derniere : `NOTES-PHASE30.md`, +optimisation des ressources). + +## Construire + +Prerequis communs : CMake >= 3.20, Ninja, un compilateur C++20, le SDK Vulkan +(en-tetes, chargeur, `glslc`, couches de validation). GLFW, GLM et +tinyobjloader sont telecharges par CMake dans `external/`. + +**Windows** (machine de developpement) : + + tools\build.bat :: Debug, couches de validation actives + tools\build.bat Release + +**Linux** (Ubuntu 24.04) : + + sudo apt-get install libvulkan-dev glslc vulkan-validationlayers ninja-build \ + libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev libxkbcommon-dev + cmake -S . -B build-rel -G Ninja -DCMAKE_BUILD_TYPE=Release -DGLFW_BUILD_WAYLAND=OFF + ninja -C build-rel + +La configuration Debug definit `VERCORA_DEBUG`, seule a activer les couches de +validation Vulkan. + +## Donnees + +Les dalles LiDAR et les grilles `.vchm` ne sont pas versionnees ; seule +l'orthophoto `assets/terrain/vercora_zone_ortho.vcto` l'est. Les produire : +`tools/fetch_dalles.py`, `tools/lidar_to_heightmap.py`, +`tools/assemble_terrain.py`, `tools/lidar_to_canopy.py` (voir leurs en-tetes). +Sans elles, le jeu retombe sur un terrain synthetique. + +Pour MESURER sans les vraies donnees (session cloud, nouveau poste), +`python3 tools/make_bench_zone.py` ecrit une zone proxy a la vraie echelle +(relief synthetique, couvert tire de l'orthophoto). Il refuse d'ecraser des +fichiers existants sans `--force`. + +## Lancer + + vercora assets/terrain/vercora_zone_1m.vchm # zone 25 km2, jeu complet + vercora --demo # demo : marche et vol libre + vercora terrain # terrain synthetique + +Options utiles (liste complete en tete de `src/main.cpp`) : + +| option | effet | +|---|---| +| `--vsync` | presentation calee sur l'ecran : le reglage pour JOUER (consommation) | +| `--start=E,N --look=yaw,pitch --lock-input` | vue reproductible (Lambert 93) | +| `--hour=H --day=D --time-scale=0` | heure et meteo figees | +| `--freeze-anim` | animation des shaders figee (captures comparables au pixel) | +| `--quit-after=S` | fermeture propre apres S s, bilans de fin ecrits | +| `--flythrough=V[,H]` | survol scripte (stress du streaming) | +| `--no-lod`, `--no-vegetation`, `--no-wildlife`, ... | temoins de mesure | +| `--force-staging` | televersement par staging meme en memoire unifiee | + +Chaque partie journalise ses couts (`Cout par image`, `Cadence de boucle`, +`Construction de tuiles`) et ses ressources (`Ressources (PHASE 30)` : RAM, +memoire GPU exacte, allocations Vulkan, pool de geometrie). + +## Tester + +- **Logique, sans GPU** : `tools\run_logic_tests.bat` (Windows). Sous Linux, + compiler `tests/logic_tests.cpp` avec la liste de sources de ce script. +- **Vulkan reel** : `tools\run_vulkan_check.ps1` (scenarios A a J, `-Only` pour + un sous-ensemble). Contrat du projet : zero message `[Validation]`. +- **Synchronisation** : Debug avec + `VK_LAYER_ENABLES=VK_VALIDATION_FEATURE_ENABLE_SYNCHRONIZATION_VALIDATION_EXT`. +- **Sans GPU (Linux)** : lavapipe (`mesa-vulkan-drivers`) sous Xvfb ; le rendu y + est deterministe. Recette : `NOTES-PHASE30.md`, section 9. + +## Arborescence + + src/core fenetre, camera, collisions, chemins, memoire du processus + src/assets heightmap, formats .vchm / .vcto, chargeur .obj + src/renderer Vulkan : contexte, pool de geometrie, streaming du terrain, rendu + src/world terrain, vegetation, faune, meteo, activites, artisanat + src/editor editeur de niveau (F2) + shaders/ GLSL compiles en SPIR-V par CMake + tools/ build, tests, harnais Vulkan, preparation des donnees + tests/ tests headless de la logique de jeu