Presentation.h

浏览该文件的文档.

#pragma once
 
#include "common/Result.h"
#include "tactics/TacticsTypes.h"
 
#include <cstdint>
#include <map>
#include <string_view>
#include <vector>
 
namespace eve::tactics {
 
enum class UnitVisualState : std::uint8_t {
    Idle,
    Friendly,
    Selected,
    Finished,
    Targetable,
    Attacking,
    Defending,
    Moving,
    Destroyed,
};
 
enum class PresentationRevertTrigger : std::uint8_t {
    Never,
    OnExpiry,
    OnNextTurn,
    OnRoundStart,
};
 
[[nodiscard]] EVENGINE_API_DOMAINS std::string_view unitVisualStateName(UnitVisualState state) noexcept;
[[nodiscard]] EVENGINE_API_DOMAINS std::string_view presentationRevertTriggerName(
    PresentationRevertTrigger trigger) noexcept;
 
struct PresentationIntent {
    std::uint64_t sequence = 0;
    SubjectRef    subject;
    SubjectRef    other;
    UnitVisualState state = UnitVisualState::Idle;
    Cell          from;
    Cell          to;
    std::vector<Cell> path;
    Revision      revision;
    SimulationTick tick = SimulationTick::zero();
    SimulationTick expiresAtTick = SimulationTick::zero();
};
 
struct PresentationRevert {
    UnitVisualState          restingState = UnitVisualState::Idle;
    PresentationRevertTrigger trigger = PresentationRevertTrigger::Never;
    std::uint64_t            sequence = 0;
 
    [[nodiscard]] constexpr bool isRevertable() const noexcept {
        return trigger != PresentationRevertTrigger::Never;
    }
};
 
struct PresentationCommand {
    PresentationIntent intent;
    PresentationRevert revert;
};
 
struct PresentationFrame {
    Revision revision;
    std::map<std::string, UnitVisualState> restingState;
    std::uint64_t transientTicks = 20;
};
 
class EVENGINE_API_DOMAINS PresentationProjector final {
public:
    explicit PresentationProjector(std::uint64_t transientTicks = 20) : transientTicks_(transientTicks) {}
 
    [[nodiscard]] Result<std::vector<PresentationCommand>> project(const BattleEvent& event,
                                                                   const BattleCommand* command,
                                                                   const PresentationFrame& frame) const;
 
    [[nodiscard]] Result<PresentationIntent> revert(const PresentationIntent& intent,
                                                    const PresentationRevert& spec) const;
 
private:
    std::uint64_t transientTicks_ = 20;
};
 
}  // namespace eve::tactics