Decision.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/Module.h"
#include "common/Result.h"
#include "common/SquirrelOwnership.h"
 
#include <map>
#include <memory>
#include <string>
#include <vector>
 
namespace eve::decision {
 
struct DecisionContextHandleTag {};
 
using DecisionContextHandleRef = eve::script::RuntimeHandleRef<DecisionContextHandleTag>;
 
class EVENGINE_API_FOUNDATION DecisionContext {
public:
    [[nodiscard]] eve::Result<void> set(const std::string& board, const std::string& key, const std::string& valueJson);
    std::string get(const std::string& board, const std::string& key, const std::string& fallbackJson) const;
 
    [[nodiscard]] eve::Result<void> addTransition(const std::string& machine, const std::string& from,
                                                  const std::string& trigger, const std::string& to);
    [[nodiscard]] eve::Result<void> setState(const std::string& machine, const std::string& state);
    [[nodiscard]] eve::Result<bool> trigger(const std::string& machine, const std::string& trigger);
    std::string state(const std::string& machine) const;
 
    static float utility(const std::string& considerationsCsv);
 
    static std::string choose(const std::string& options);
 
    [[nodiscard]] eve::Result<void> newGrid(const std::string& name, int width, int height, float cellSize,
                                            float originX, float originY);
    [[nodiscard]] eve::Result<void> setCell(const std::string& name, int x, int y, float value);
    [[nodiscard]] eve::Result<void> addCell(const std::string& name, int x, int y, float delta);
    float sample(const std::string& name, float worldX, float worldY, float fallback) const;
 
    std::string snapshotJson() const;
 
    [[nodiscard]] eve::Result<void> restoreJson(const std::string& json);
 
private:
    struct Grid {
        int                width    = 0;
        int                height   = 0;
        float              cellSize = 1;
        float              originX  = 0;
        float              originY  = 0;
        std::vector<float> values;
    };
 
    std::map<std::string, std::map<std::string, std::string>>                         boards_;
    std::map<std::string, std::string>                                                states_;
    std::map<std::string, std::map<std::pair<std::string, std::string>, std::string>> transitions_;
    std::map<std::string, Grid>                                                       grids_;
};
 
class Decision : public Module {
public:
    Module_REG(Decision);
    [[nodiscard]] static eve::Result<DecisionContextHandleRef> newContext();
    [[nodiscard]] static eve::script::Borrowed<DecisionContext> resolve(DecisionContextHandleRef reference) noexcept;
    [[nodiscard]] static eve::Result<void> release(DecisionContextHandleRef reference);
    [[nodiscard]] static bool isStale(DecisionContextHandleRef reference) noexcept;
 
private:
    eve::script::RuntimeObjectRegistry<DecisionContext, DecisionContextHandleTag> contexts_;
};
 
}  // namespace eve::decision