PixelWorldCatalogPanel.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/Result.h"
#include "pixelworld/PixelMaterial.h"
#include "pixelworld/PixelWorldControl.h"
#include "ui/Widget.h"
 
#include <cstddef>
#include <cstdint>
#include <optional>
#include <string>
#include <string_view>
#include <vector>
 
namespace eve::pixelworld_editor {
 
struct MaterialCard {
    eve::pixelworld::MaterialId id = eve::pixelworld::MaterialId::Air;
    std::string name;
    eve::pixelworld::MaterialState state = eve::pixelworld::MaterialState::Empty;
    std::uint32_t displayRgba = 0;
    bool selected = false;
    bool reacts = false;
    bool transitions = false;
};
 
struct CatalogDraftReceipt {
    std::uint64_t revisionBefore = 0;
    std::uint64_t revisionAfter = 0;
    std::uint64_t fingerprint = 0;
};
 
class EVENGINE_API_ORCHESTRATION PixelWorldCatalogPanel {
public:
    ~PixelWorldCatalogPanel();
    PixelWorldCatalogPanel(const PixelWorldCatalogPanel&) = delete;
    PixelWorldCatalogPanel& operator=(const PixelWorldCatalogPanel&) = delete;
    PixelWorldCatalogPanel(PixelWorldCatalogPanel&& other);
    PixelWorldCatalogPanel& operator=(PixelWorldCatalogPanel&& other);
 
    [[nodiscard]] static eve::Result<PixelWorldCatalogPanel> create(std::string_view catalogJson);
    static PixelWorldCatalogPanel builtIn();
 
    const eve::pixelworld::MaterialCatalog& draft() const noexcept { return draft_; }
    std::uint64_t revision() const noexcept { return revision_; }
    std::size_t selectedMaterialIndex() const noexcept { return selectedMaterial_; }
    std::optional<std::size_t> selectedReactionIndex() const noexcept { return selectedReaction_; }
    std::optional<std::size_t> selectedPhaseIndex() const noexcept { return selectedPhase_; }
 
    std::vector<MaterialCard> materialCards() const;
    [[nodiscard]] eve::Result<void> selectMaterial(std::size_t index);
    [[nodiscard]] eve::Result<void> selectReaction(std::size_t index);
    [[nodiscard]] eve::Result<void> selectPhase(std::size_t index);
 
    [[nodiscard]] eve::Result<CatalogDraftReceipt> replaceMaterial(
        eve::pixelworld::MaterialDefinition definition);
    [[nodiscard]] eve::Result<CatalogDraftReceipt> replaceReaction(
        std::size_t index, eve::pixelworld::MaterialReactionRule rule);
    [[nodiscard]] eve::Result<CatalogDraftReceipt> addReaction(
        eve::pixelworld::MaterialReactionRule rule);
    [[nodiscard]] eve::Result<CatalogDraftReceipt> removeReaction(std::size_t index);
    [[nodiscard]] eve::Result<CatalogDraftReceipt> replacePhase(
        std::size_t index, eve::pixelworld::MaterialPhaseRule rule);
    [[nodiscard]] eve::Result<CatalogDraftReceipt> addPhase(
        eve::pixelworld::MaterialPhaseRule rule);
    [[nodiscard]] eve::Result<CatalogDraftReceipt> removePhase(std::size_t index);
 
    [[nodiscard]] eve::Result<std::string> document() const;
    [[nodiscard]] eve::Result<CatalogDraftReceipt> loadDocument(std::string_view catalogJson);
    [[nodiscard]] eve::Result<eve::pixelworld::PixelCatalogReloadReceipt> apply(
        eve::pixelworld::PixelWorldControlService& control, std::uint64_t worldId,
        std::uint64_t expectedFingerprint) const;
 
    [[nodiscard]] eve::Result<eve::ui::UIHostHandle> open();
    void close();
    bool isOpen() const;
    [[nodiscard]] eve::Result<void> refresh();
    eve::ui::UIHostHandle host() const noexcept { return host_; }
 
    eve::ui::WidgetDesc buildWidgetTree();
    const std::string& statusText() const noexcept { return statusText_; }
 
private:
    explicit PixelWorldCatalogPanel(eve::pixelworld::MaterialCatalog catalog);
    [[nodiscard]] eve::Result<CatalogDraftReceipt> commitCandidate(
        std::vector<eve::pixelworld::MaterialDefinition> definitions,
        std::vector<eve::pixelworld::MaterialReactionRule> reactions,
        std::vector<eve::pixelworld::MaterialPhaseRule> phases);
    void observe(eve::Result<CatalogDraftReceipt> result);
    void observe(eve::Result<void> result);
 
    eve::pixelworld::MaterialCatalog draft_;
    std::uint64_t revision_ = 1;
    std::size_t selectedMaterial_ = 0;
    std::optional<std::size_t> selectedReaction_;
    std::optional<std::size_t> selectedPhase_;
    std::string statusText_ = "Catalog draft is valid";
    eve::ui::UIHostHandle host_{};
};
 
}  // namespace eve::pixelworld_editor