VehicleEffects.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/Result.h"
#include "common/SubjectRef.h"
#include "common/Time.h"
#include "effects/EffectContainer.h"
 
#include <cstdint>
#include <string>
#include <vector>
 
namespace eve::vehicle {
 
enum class VehicleEffectKind : std::uint8_t { Damage, Repair, Disable };
 
struct VehicleEffectTarget {
    double        hull                 = 100.0;
    double        maxHull              = 100.0;
    bool          disabled             = false;
    std::uint32_t criticalHits         = 0;
    double        frontArmorMultiplier = 0.75;
    double        sideArmorMultiplier  = 1.0;
    double        rearArmorMultiplier  = 1.25;
};
 
struct VehicleEffectDefinition {
    std::string              id;
    std::string              source;
    std::string              armorZone = "side";
    double                   duration  = 0.0;
    double                   period    = 0.0;
    double                   magnitude = 0.0;
    effects::EffectPolicy    policy;
    VehicleEffectKind        kind = VehicleEffectKind::Damage;
    std::vector<std::string> tags;
};
 
struct VehicleEffectUpdate {
    effects::EffectUpdateSummary lifecycle;
    std::uint32_t                settled      = 0;
    std::uint32_t                criticalHits = 0;
};
 
struct VehicleEffectSnapshot {
    effects::EffectContainer effects;
    VehicleEffectTarget      target;
};
 
class VehicleEffectExecutor {
public:
    [[nodiscard]] eve::Result<void> validate(const VehicleEffectTarget& target) const;
    [[nodiscard]] eve::Result<void> applyImmediate(VehicleEffectTarget&           target,
                                                   const effects::EffectInstance& effect) const;
    [[nodiscard]] eve::Result<VehicleEffectUpdate> settle(VehicleEffectTarget&         target,
                                                          effects::EffectUpdateSummary lifecycle) const;
};
 
class EVENGINE_API_DOMAINS VehicleEffectAdapter {
public:
    [[nodiscard]] eve::Result<effects::EffectHandle> apply(const VehicleEffectDefinition& definition,
                                                           eve::SubjectRef                subject);
    [[nodiscard]] eve::Result<void> remove(effects::EffectHandle handle);
    [[nodiscard]] eve::Result<VehicleEffectUpdate> advance(const eve::SimulationStep& step);
    [[nodiscard]] VehicleEffectSnapshot snapshot() const;
    [[nodiscard]] eve::Result<void> restore(const VehicleEffectSnapshot& snapshot);
    [[nodiscard]] eve::Result<const effects::EffectInstance*> resolve(effects::EffectHandle handle) const;
    [[nodiscard]] VehicleEffectTarget& target() noexcept { return target_; }
    [[nodiscard]] const VehicleEffectTarget& target() const noexcept { return target_; }
 
private:
    effects::EffectContainer container_;
    VehicleEffectExecutor    executor_;
    VehicleEffectTarget      target_;
};
 
}  // namespace eve::vehicle