Fichiers
vercora/README.md
T
theoetClaude Opus 5.5 58f7da7a82 Fusion de la branche cloud (optimisation des ressources) en Phase 32
Fusionne github/ccr-8fe70239-2xoxym (session cloud du 13-14/10) dans les
phases 30-31 faites sur le PC (rochers visibles, builds separes, densite
des rochers, demo candidate).

La phase cloud, nommee "Phase 30" dans ses commits, devient la Phase 32 :
- NOTES-PHASE30.md (add/add) : la version du PC (rochers) est gardee ;
  celle du cloud devient NOTES-PHASE32.md.
- MEMORY.md : sections 30 (rochers), 31, puis 32 (optimisation) dans
  l'ordre chronologique ; etat verifie en tete renomme fin de Phase 32.
- References a l'optimisation renommees Phase 32 dans README.md,
  NOTES-AUDIT-GLOBAL.md, les commentaires du code et les libelles de tests.
  Les references aux rochers (Phase 30 PC) sont inchangees.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 15:11:22 +02:00

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-PHASE32.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 32) : 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-PHASE32.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