GroveEngine/CLAUDE_NEXT_SESSION.md

GroveEngine - Session Successor Prompt

Contexte Rapide

GroveEngine est un moteur de jeu C++17 avec hot-reload de modules. On développe actuellement le module BgfxRenderer pour le rendu 2D.

État Actuel (27 Nov 2025)

Portage Windows ✅

Le projet compile maintenant sur Windows (MinGW/Ninja) en plus de Linux :

• ModuleFactory.cpp et ModuleLoader.cpp : LoadLibrary/GetProcAddress
• SystemUtils.cpp : Windows process memory APIs
• FileWatcher.h : st_mtime au lieu de st_mtim
• IIO.h : ajout #include <cstdint>
• Tests integration (test_09, test_10, test_11) : wrappers grove_dlopen/grove_dlsym/grove_dlclose/grove_dlerror

Phases Complétées ✅

Phase 1 - Squelette du module

• libBgfxRenderer.so/.dll compilé et chargeable dynamiquement

Phase 2 - RHI Layer

• BgfxDevice : init/shutdown/frame, création textures/buffers/shaders
• RHICommandBuffer : recording de commandes GPU
• FrameAllocator : allocateur lock-free per-frame
• RenderGraph : tri topologique Kahn pour ordonnancement des passes
• Tests : test_20_bgfx_rhi (23 tests passent)

Phase 3 - Shaders & Triangle

• ShaderManager : chargement centralisé des shaders embedded
• Shaders pré-compilés : OpenGL, Vulkan, DX11, Metal
• Test visuel : test_21_bgfx_triangle - triangle RGB coloré (~567 FPS Vulkan)

Phase 4 - SceneCollector & IIO Integration ✅ (NOUVEAU)

• SceneCollector : collecte des messages IIO pour render:sprite, render:camera, etc.
• Calcul des matrices view/proj avec support zoom dans parseCamera()
• Test test_22_bgfx_sprites_headless : 23 assertions, 5 test cases passent
  • Validation structure sprite data
  • Routing IIO inter-modules (game → renderer pattern)
  • Structure camera/clear/debug messages

Fichiers Clés

modules/BgfxRenderer/
├── BgfxRendererModule.cpp   # Point d'entrée module + ShaderManager
├── RHI/
│   ├── RHIDevice.h          # Interface abstraite
│   ├── BgfxDevice.cpp       # Implémentation bgfx
│   ├── RHICommandBuffer.h   # Command buffer
│   └── RHITypes.h           # Handles, states
├── Shaders/
│   ├── ShaderManager.cpp    # Gestion shaders
│   ├── vs_color.bin.h       # Vertex shader embedded
│   └── fs_color.bin.h       # Fragment shader embedded
├── RenderGraph/
│   └── RenderGraph.cpp      # Tri topologique passes
├── Passes/
│   ├── ClearPass.cpp        # Clear screen
│   ├── SpritePass.cpp       # Rendu sprites instancié
│   └── DebugPass.cpp        # Debug shapes
├── Frame/
│   ├── FramePacket.h        # Données immutables par frame
│   └── FrameAllocator.cpp   # Allocateur bump
└── Scene/
    └── SceneCollector.cpp   # Collecte messages IIO + matrices view/proj

Prochaine Phase : Phase 5

Objectif

Test visuel complet avec sprites via IIO.

Tâches

1. Créer test_23_bgfx_sprites_visual.cpp :

   • Charger le module BgfxRenderer via ModuleLoader
   • Publier des sprites via IIO depuis un "game module" simulé
   • Valider le rendu visuel (sprites affichés à l'écran)

2. Compléter la boucle render :

   • Appeler SceneCollector::collect() pour récupérer les messages IIO
   • Passer le FramePacket finalisé aux passes
   • S'assurer que SpritePass::execute() dessine les sprites

3. Debug :

   • Ajouter les debug shapes (lignes, rectangles) si besoin

Build & Test

# Windows (MinGW + Ninja)
cmake -G Ninja -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++ -DGROVE_BUILD_BGFX_RENDERER=ON -B build-bgfx
cmake --build build-bgfx -j4

# IMPORTANT: Sur Windows, ajouter MinGW au PATH pour ctest:
PATH="/c/ProgramData/mingw64/mingw64/bin:$PATH" ctest -R Bgfx --output-on-failure

# Tests actuels
./build-bgfx/tests/test_20_bgfx_rhi         # 23 tests RHI
./build-bgfx/tests/test_21_bgfx_triangle    # Test visuel triangle
./build-bgfx/tests/test_22_bgfx_sprites_headless  # 5 tests IIO/structure

Notes Importantes

• Cross-Platform : Le projet compile sur Linux ET Windows
• Windows PATH : Les DLLs MinGW doivent être dans le PATH pour exécuter les tests via ctest
• WSL2 : Le rendu fonctionne via Vulkan (pas OpenGL)
• Shaders : Pré-compilés, pas besoin de shaderc à runtime
• Thread Safety : Voir docs/coding_guidelines.md pour les patterns mutex
• IIO Routing : Les messages ne sont pas routés vers l'instance émettrice, utiliser deux instances séparées (pattern game → renderer)