Apps, CLI apps, graphic apps and IDE plugins are made in apps/<id>; bin/jumphp, the tools, the workflows, the IDE and the docs find a project in games/ or apps/. New projects get config/project.yaml (under project:); the engine, bin/jumphp, the tools and the IDE still read config/game.yaml (under game:). JUMPHP_APP is read before JUMPHP_GAME. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01X3cUrphmz1MoDiCrUbAHuo
70 lines
4.3 KiB
Markdown
70 lines
4.3 KiB
Markdown
# Architecture
|
||
|
||
## Vue d'ensemble
|
||
|
||
```
|
||
bureau navigateur
|
||
games/<jeu>/app.php page web (engine/web) : jumphp.js
|
||
│ │ télécharge php-web.wasm + php-web.data
|
||
▼ ▼ ccall('phpw_run', prélude + bootstrap/wasm.php)
|
||
Application::boot() ◄──────── même code ────────► Application::boot()
|
||
│ container Symfony (YAML, ou précompilé dans cache/container.php pour le navigateur)
|
||
▼
|
||
Engine::boot() : SDL, son, entrées, langue, options, première scène
|
||
│
|
||
desktop : Loop::addPeriodicTimer(1/max_fps, tick) puis Loop::run() (bloquant)
|
||
wasm : phpw.c -> emscripten_set_main_loop -> jumphp_frame() -> Engine::frame() = tick() + 1 tour de boucle
|
||
```
|
||
|
||
## Une frame (`Engine::tick()`)
|
||
|
||
1. `dt` = temps écoulé (borné à 0,1 s ; fixe 1/60 s en mode sans écran), × `timeScale`.
|
||
2. `InputManager::poll()` : vide la file SDL (clavier, souris, tactile, manettes, fenêtre).
|
||
3. `NetSession::poll()` si une session réseau est ouverte.
|
||
4. `SoundManager::update()` (enchaînement intro → boucle de la musique).
|
||
5. `SceneManager::update($dt)` : la scène du haut de la pile (et les fondus).
|
||
6. Événement `frame`, puis les états « appuyé cette frame » sont oubliés.
|
||
7. Rendu : `Renderer::beginFrame()` (dessin dans une texture à la résolution virtuelle), scènes (les
|
||
overlays au-dessus de la scène du dessous), overlay de debug (F3), `endFrame()` (mise à l'échelle avec
|
||
bandes noires, pixels nets, `SDL_RenderPresent`).
|
||
|
||
## Modules
|
||
|
||
| Namespace | Rôle | Classes clés |
|
||
|---|---|---|
|
||
| `Kernel` | démarrage, frame, configuration | `Application`, `Engine`, `GameConfig`, `Platform` |
|
||
| `Loop` | boucle ReactPHP, pas fixe | `GameLoop` (même API que dans ton jeu : `start(1)`, `addTimer`, `eachTick`), `FixedStep` |
|
||
| `Renderer` | fenêtre, dessin, textures, texte | `Sdl`, `Renderer`, `Window`, `BitmapFont`, `TtfFont`, `CrtFilter` |
|
||
| `Input` | entrées, actions nommées | `InputManager`, `ActionMap`, `Keyboard`, `Mouse`, `Touch`, `Gamepad` |
|
||
| `Scene` | écrans, caméra | `Scene`, `AbstractScene`, `SceneManager`, `Camera` |
|
||
| `Entity` | ce qui bouge | `Entity`, `GameObject`, `EntityManager`, traits `Sprite`, `Gravity` |
|
||
| `Physics` | collisions | `CollisionSystem`, `Aabb`, `TileCollision`, `CollisionResult` |
|
||
| `Tile` | cartes | `TileMap`, `TileSet`, `CollisionMask`, `TileMapRenderer`, loaders Tiled / tableau / binaire |
|
||
| `Audio` | son | `SoundManager`, `Synth` |
|
||
| `Ui` | menus, saisie | `Menu`, `MenuScene`, `TextInput`, `Hud` |
|
||
| `Net` | en ligne | `NetSession`, `LobbyScene`, `MessageCodec`, `SnapshotBuffer` |
|
||
| `Save` | fichiers du joueur | `Storage`, `Options` |
|
||
| `Bridge` | jeu → page web | `JsBridge` |
|
||
|
||
## Injection de dépendances
|
||
|
||
`Application::buildContainer()` enregistre les services du moteur (publics, autowirés), puis charge
|
||
`config/services.yaml` du jeu (`App\` → `src/`, sauf `src/Entity`). Toute classe qui implémente `Scene`
|
||
est publique et partagée automatiquement : `SceneManager` la récupère par son nom de classe, son
|
||
constructeur peut demander n'importe quel service. `CollisionSystem` et `EntityManager` ne sont pas
|
||
partagés (un par scène). Pour le navigateur, `tools/dump-container.php` précompile le container
|
||
(`cache/container.php`, ~0,5 s de démarrage en moins) ; `GameConfig` y est un service synthétique.
|
||
|
||
## Configuration et paramètres
|
||
|
||
`config/project.yaml` (`GameConfig::DEFAULTS` liste les clés). Le bureau lit aussi des variables
|
||
d'environnement, le navigateur des constantes définies par la page (`Platform::setting()`) :
|
||
`JUMPHP_WASM`, `JUMPHP_NET_URL` (`?net=`), `JUMPHP_ROOM` (`?room=`), `JUMPHP_LANG` (`?lang=`),
|
||
`JUMPHP_DEBUG` (`?debug=1`), `JUMPHP_MOBILE`, et pour les tests `JUMPHP_SMOKE`, `JUMPHP_SCREENSHOT`,
|
||
`JUMPHP_MAX_FRAMES`, `JUMPHP_INPUT`, `JUMPHP_SCENE`, `JUMPHP_SCENE_PARAMS`, `JUMPHP_REALTIME`.
|
||
|
||
## Modes sans écran
|
||
|
||
`JUMPHP_SMOKE` / `JUMPHP_SCREENSHOT` : pilote vidéo et son `dummy`, rendu logiciel dans une surface
|
||
(`SDL_CreateSoftwareRenderer`), frames de 1/60 s enchaînées au plus vite. Le test fumée transforme toute
|
||
alerte PHP en exception (code de sortie 1). La capture écrit la surface en BMP puis en PNG (GD).
|