UISystem.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "common/BorrowedRef.h"
#include "ui/UIHost.h"
 
#include <functional>
#include <optional>
#include <string>
#include <vector>
 
namespace eve::graphics {
class Canvas;
}
 
namespace eve::ui {
class UIBackend;
}
 
namespace eve::ui {
 
struct UIEvent {
    UIHostHandle host{};
    std::string hostName;
    std::string nodeId;
    int nodeIndex = -1;
    std::string kind;  // "click" | "toggle" | "value" | "text"
    uint32_t handlerIndex = 0;
    bool toggleValue = false;
    float floatValue = 0.f;
    std::string textValue;
};
 
struct UIClick {
    std::string hostName;
    std::string nodeId;
};
 
struct UIChange {
    std::string hostName;
    std::string nodeId;
    std::string kind;
};
 
enum class DragDropOrigin : uint8_t { Internal = 0, OperatingSystemFile };
 
enum class DragDropSupport : uint8_t { Supported = 0, UnsupportedPlatform };
 
struct UIDrop {
    DragDropOrigin origin = DragDropOrigin::Internal;
    std::string sourceHostName;
    std::string sourceNodeId;
    std::string targetHostName;
    std::string targetNodeId;
    std::string payloadType;
    std::string payloadText;
};
 
struct UIStats {
    int hostCount = 0;
    int nodeCount = 0;
    double measureMs = 0.0;
    double walkMs = 0.0;
};
 
struct ViewportState {
    std::string key;                 // "hostName/nodeId"
    graphics::Canvas *canvas = nullptr;
    uint64_t textureId = 0;          // registered via UIBackend::registerTexture
    int width = 0;
    int height = 0;
    bool hovered = false;
    bool active = false;             // mouse button held inside the viewport
    float mouseX = 0.f;              // widget-local
    float mouseY = 0.f;
    float dragDX = 0.f;
    float dragDY = 0.f;
    float wheel = 0.f;
};
 
class EVENGINE_API_WORLD UISystem {
public:
    static void setBackend(UIBackend &backend);
    static void clearBackend() noexcept;
    [[nodiscard]] static eve::OptionalRef<UIBackend> backend();
    static const UIStats &stats();
    [[nodiscard]] static eve::OptionalRef<ViewportState> viewportState(const std::string &hostName,
                                                                       const std::string &nodeId);
    [[nodiscard]] static eve::ResultRef<ViewportState> ensureViewport(const std::string &key, int w, int h);
 
    static void render();
 
    static std::vector<UIEvent> &pendingEvents();
    static void dispatchEvents();
 
    [[nodiscard]] static UIHostHandle findHost(const std::string &name);
    [[nodiscard]] static UIHostHandle findHostByOwner(uint32_t ownerId);
 
    static std::vector<UIClick> &clickQueue();
    static std::vector<UIChange> &changeQueue();
    [[nodiscard]] static DragDropSupport dragDropSupport() noexcept;
    static void enqueuePlatformFileDrop(const std::string &path);
    static std::vector<UIDrop> &dropQueue();
    [[nodiscard]] static std::optional<UIDrop> consumeDrop();
    static std::string consumeClick();
    static std::string consumeClickFor(const std::string &hostName);
    static std::string consumeChange();
};
 
}  // namespace eve::ui