GameEvents.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Valentin Eloy
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include <cstddef>
#include <optional>
#include <vector>
 
#include "Core/Gameplay/MechanismController.h"
#include "Core/Levels/LevelOutcome.h"

 
namespace hmi {

enum class GameEvent {
    // Personnage. **Sans producteur depuis le `LOT-06`** : ces quatre transitions étaient celles
    // d'un personnage de plateforme, et le déplacement en vue de dessus n'a ni saut, ni
    // atterrissage, ni glissade murale. Les valeurs restent déclarées — la table de sons
    // (`hmi::soundForEvent`) s'y accroche, et
    // c'est le combat (`LOT-21`) puis l'audio (`LOT-28`) qui diront ce que le RPG met à leur place.
    Jumped,
    Landed,
    Dashed,
    WallContactEnter,
    // Mécanismes (détecté par `detectMechanismEvents`).
    SwitchToggled,
    DoorOpened,
    DoorClosed,
    PressurePlatePressed,
    PressurePlateReleased,
    BlockPushed,
    // Issue du pas (détecté par `detectOutcomeEvent`, depuis `core::LevelOutcome`).
    Died,
    ExitReached,
    // Interface (`LOT-59`) : raisés directement aux points de signal Qt existants, pas par
    // diffusion d'état — la table de sons ci-dessous les couvre malgré tout, pour l'uniformité.
    MenuNavigate,
    MenuConfirm,
    MenuBack,
    PauseOpened,
};

inline constexpr int GAME_EVENT_COUNT = static_cast<int>(GameEvent::PauseOpened) + 1;

struct MechanismEventState {
    std::vector<bool> doorOpen;

    [[nodiscard]] static MechanismEventState capture(const core::MechanismController& mechanisms) {
        MechanismEventState state;
        state.doorOpen.reserve(mechanisms.mechanisms().size());
        for (std::size_t index = 0; index < mechanisms.mechanisms().size(); ++index) {
            state.doorOpen.push_back(mechanisms.isDoorOpen(index));
        }
        return state;
    }
};

[[nodiscard]] std::vector<GameEvent> detectMechanismEvents(const MechanismEventState& previous,
                                                           const MechanismEventState& current,
                                                           const std::vector<bool>& isContinuous);

[[nodiscard]] std::optional<GameEvent> detectOutcomeEvent(core::LevelOutcome outcome);
 
}  // namespace hmi