Documentation Technique

Plongez dans l'architecture et l'implémentation de R-Type.

🏗️

Architecture

Vision globale du système et design patterns.

🎨

Système Graphique

Architecture multi-backend SDL2/SFML.

🌐

Réseau

Protocole UDP et synchronisation.

📚

API Reference

Documentation des interfaces publiques.

---

Vue d'Ensemble

R-Type est conçu avec une architecture hexagonale (ports & adapters) permettant une séparation claire entre :

• Domaine : Logique de jeu pure
• Infrastructure : Implémentations concrètes (réseau, graphiques)
• Application : Orchestration des cas d'usage

graph TB
    subgraph "Client"
        A[Game Loop]
        B[Scene Manager]
        F[IWindow SFML/SDL2]
    end

    subgraph "Server (Hexagonal)"
        C[Domain - GameWorld]
        D[Application - UseCases]
        G[Infrastructure - UDPServer]
    end

    subgraph "Network"
        NET[UDP 4124 - Game]
        AUTH[TCP 4125 - Auth TLS]
        VOICE[UDP 4126 - Voice]
    end

    A --> B
    B --> F
    A <--> NET
    A <--> AUTH
    A <--> VOICE
    NET <--> G
    AUTH <--> G
    VOICE <--> G
    G --> D
    D --> C

    style C fill:#7c3aed,color:#fff
    style F fill:#f59e0b,color:#000
    style NET fill:#10b981,color:#fff

---

Technologies

Composant	Technologie	Raison
Langage	C++23	Performance, modernité
Build	CMake 3.30+, Ninja, vcpkg	Standard industrie
Réseau	Boost.ASIO	Asynchrone, cross-platform
Sécurité	OpenSSL (TLS 1.2+)	Auth TCP sécurisée
Graphiques	SDL2 / SFML	Multi-backend (statique)
Audio	PortAudio, Opus	Voice chat temps réel

---

Patterns Utilisés

Architecture Hexagonale (Serveur)

Le serveur utilise Ports & Adapters pour isoler le domaine :

// Domain (logique pure)
namespace domain {
    class Player { /* Position, Health, etc. */ };
    class GameRule { /* Collision, Score, etc. */ };
}

// Ports (interfaces)
namespace application::ports {
    class IUserRepository { /* Persist users */ };
    class ILogger { /* Logging */ };
}

// Adapters (implémentations)
namespace infrastructure::adapters {
    class MongoUserRepository : IUserRepository { };
    class UDPServer { /* Réseau UDP */ };
}

Plugin Architecture (Graphics)

Les backends graphiques sont chargés dynamiquement via dlopen/LoadLibrary :

// Interface plugin
class IGraphicPlugin {
public:
    virtual const char* getName() const = 0;
    virtual std::shared_ptr<IWindow> createWindow(Vec2u size, const std::string& name) = 0;
};

// Chargement dynamique cross-platform (DynamicLib.cpp)
#ifdef _WIN32
    _handle = LoadLibraryA("librtype_sfml.dll");
    _create_lib = (create_t)GetProcAddress(_handle, "create");
#else
    _handle = dlopen("librtype_sfml.so", RTLD_LAZY);
    _create_lib = (create_t)dlsym(_handle, "create");
#endif

---

Structure du Code

src/
├── client/
│   ├── main.cpp
│   ├── include/
│   │   ├── scenes/        # IScene, GameScene, MenuScene
│   │   ├── graphics/      # IWindow, IDrawable
│   │   ├── network/       # TCPClient, UDPClient
│   │   ├── audio/         # VoiceChatManager, OpusCodec
│   │   └── events/        # Event system (KeyPressed, etc.)
│   ├── src/               # Implémentations
│   └── lib/               # Backends graphiques
│       ├── sfml/          # SFMLWindow
│       └── sdl2/          # SDL2Window
├── server/
│   ├── main.cpp
│   ├── include/
│   │   ├── domain/        # Entités, Value Objects
│   │   ├── application/   # Use Cases, Ports
│   │   └── infrastructure/# Adapters réseau
│   └── infrastructure/
│       ├── adapters/in/network/  # UDPServer, TCPAuthServer
│       └── game/          # GameWorld
├── common/
│   ├── protocol/          # Protocol.hpp (sérialisation)
│   └── collision/         # AABB.hpp (hitboxes)
└── tests/

---

Performances

Objectifs

Métrique	Cible
FPS Client	60+ stable
Broadcast Serveur	20 Hz (50ms)
Latence Réseau	< 50ms
Timeout Joueur	2000ms

Optimisations

• Client-Side Prediction : Mouvement fluide malgré la latence
• Full State Snapshots : Robuste à la perte de paquets
• UDP Game / TCP Auth : Latence minimale pour le jeu
• Opus VoIP : Audio compressé 32kbps