WeaponEffects.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::weapon {
 
enum class WeaponEffectKind : std::uint8_t { Heat, Jam, Recoil };
 
struct WeaponEffectTarget {
    double        heat         = 0.0;
    double        maxHeat      = 100.0;
    bool          jammed       = false;
    double        recoil       = 0.0;
    std::uint32_t blockedShots = 0;
};
 
struct WeaponEffectDefinition {
    std::string              id;
    std::string              source;
    double                   duration  = 0.0;
    double                   period    = 0.0;
    double                   magnitude = 0.0;
    effects::EffectPolicy    policy;
    WeaponEffectKind         kind = WeaponEffectKind::Heat;
    std::vector<std::string> tags;
};
 
struct WeaponEffectUpdate {
    effects::EffectUpdateSummary lifecycle;
    std::uint32_t                settled = 0;
    bool                         jammed  = false;
};
 
struct WeaponEffectSnapshot {
    effects::EffectContainer effects;
    WeaponEffectTarget       target;
};
 
class WeaponEffectExecutor {
public:
    [[nodiscard]] eve::Result<void> validate(const WeaponEffectTarget& target) const;
    [[nodiscard]] eve::Result<void> applyImmediate(WeaponEffectTarget&            target,
                                                   const effects::EffectInstance& effect) const;
    [[nodiscard]] eve::Result<WeaponEffectUpdate> settle(WeaponEffectTarget&          target,
                                                         effects::EffectUpdateSummary lifecycle) const;
};
 
class EVENGINE_API_WORLD WeaponEffectAdapter {
public:
    [[nodiscard]] eve::Result<effects::EffectHandle> apply(const WeaponEffectDefinition& definition,
                                                           eve::SubjectRef               subject);
    [[nodiscard]] eve::Result<void> remove(effects::EffectHandle handle);
    [[nodiscard]] eve::Result<WeaponEffectUpdate> advance(const eve::SimulationStep& step);
    [[nodiscard]] WeaponEffectSnapshot snapshot() const;
    [[nodiscard]] eve::Result<void> restore(const WeaponEffectSnapshot& snapshot);
    [[nodiscard]] eve::Result<const effects::EffectInstance*> resolve(effects::EffectHandle handle) const;
    [[nodiscard]] WeaponEffectTarget& target() noexcept { return target_; }
    [[nodiscard]] const WeaponEffectTarget& target() const noexcept { return target_; }
 
private:
    effects::EffectContainer container_;
    WeaponEffectExecutor     executor_;
    WeaponEffectTarget       target_;
};
 
}  // namespace eve::weapon