LevelFormat.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/BorrowedRef.h"
#include "common/Result.h"
 
#include <memory>
#include <string>
#include <vector>
 
namespace eve::level_editing {
class LevelDocument;
 
class LevelFormat {
public:
    virtual ~LevelFormat()                                                  = default;
    virtual std::string              id() const                             = 0;
    virtual std::vector<std::string> extensions() const                     = 0;
    virtual bool                     canRead(const std::string& text) const = 0;
 
    [[nodiscard]] virtual eve::Result<std::unique_ptr<LevelDocument>> read(const std::string& text) const     = 0;
    [[nodiscard]] virtual eve::Result<std::string>                    write(const LevelDocument& level) const = 0;
};
 
class EVENGINE_API_DOMAINS LevelFormatRegistry {
public:
    LevelFormatRegistry();
 
    // std::vector<std::unique_ptr<LevelFormat>> makes the implicit copy operations
    // ill-formed (C2280) as soon as a class-level dllexport instantiates them;
    // spell the four out so the export surface stays defined. Semantics unchanged:
    // the registry was never copyable in practice.
    LevelFormatRegistry(const LevelFormatRegistry&)            = delete;
    LevelFormatRegistry& operator=(const LevelFormatRegistry&) = delete;
    LevelFormatRegistry(LevelFormatRegistry&&)                 = default;
    LevelFormatRegistry& operator=(LevelFormatRegistry&&)      = default;
 
    [[nodiscard]] eve::Result<void> registerFormat(std::unique_ptr<LevelFormat> format);
    int                             getFormatCount() const { return static_cast<int>(formats_.size()); }
    std::string                     getFormatId(int index) const;
    std::string                     detect(const std::string& path, const std::string& text) const;
 
    [[nodiscard]] eve::Result<std::unique_ptr<LevelDocument>> decode(const std::string& format,
                                                                     const std::string& text) const;
    [[nodiscard]] eve::Result<std::string> encode(const std::string& format, const LevelDocument& level) const;
 
    [[nodiscard]] eve::Result<std::unique_ptr<LevelDocument>> load(const std::string& path,
                                                                   const std::string& format = {}) const;
    [[nodiscard]] eve::Result<void>                           save(const std::string& path, const LevelDocument& level,
                                                                   const std::string& format = {}) const;
 
private:
    [[nodiscard]] eve::OptionalRef<const LevelFormat> find(const std::string& id) const;
    std::vector<std::unique_ptr<LevelFormat>>         formats_;
};
}  // namespace eve::level_editing