EditorHost.h

浏览该文件的文档.

#pragma once
 
#include "common/Export.h"
 
#include <memory>
#include <string>
 
namespace ssq {
class VM;
}
 
namespace eve::ui {
 
class EVENGINE_API_WORLD EditorHost {
public:
    static EditorHost& instance();
 
    EditorHost(const EditorHost&)            = delete;
    EditorHost& operator=(const EditorHost&) = delete;
    ~EditorHost();
 
    void start(ssq::VM& vm, const std::string& gameRoot = {}, bool allowWindow = true);
    void stop();
    bool running() const { return running_; }
    bool windowAllowed() const { return allowWindow_; }
    const std::string& gameRoot() const { return gameRoot_; }
 
    // ---- OS window -------------------------------------------------------
    std::string openWindow(const std::string& title, int width, int height);
    std::string closeWindow();
    bool        isWindowOpen() const;
    std::string windowState() const;
 
    // ---- editors (View) --------------------------------------------------
    std::string applyEditor(const std::string& json);
    std::string removeEditor(const std::string& id);
    std::string listEditors() const;
    std::string editorState(const std::string& id) const;
    void syncBindings();
    std::string setEditorValue(const std::string& editorId, const std::string& widgetId,
                               const std::string& jsonValue);
    std::string restoreEditorValue(const std::string& editorId, const std::string& widgetId,
                                   const std::string& jsonValue);
    std::string consumeEvents(const std::string& editorId);
    std::string widgetRect(const std::string& editorId, const std::string& widgetId) const;
 
    // ---- ViewModel (Squirrel tables) --------------------------------------
    std::string registerVM(const std::string& name, const std::string& source,
                           const std::string& sourceName = {});
    std::string unregisterVM(const std::string& name);
 
    // ---- persistence -------------------------------------------------------
    std::string saveEditor(const std::string& id);
    std::string unloadEditor(const std::string& id);
    void loadEditorsFromDisk();
 
    // ---- misc --------------------------------------------------------------
    std::string runScript(const std::string& source, const std::string& sourceName = {});
    std::string capture(const std::string& path);
    std::string reloadResource(const std::string& path);
    std::string hotReloadStatus() const;
    void setHotReloadWatchCount(int count);
    std::string status() const;
    void        requestExit() { exitRequested_ = true; }
    bool        exitRequested() const { return exitRequested_; }
 
    void frame();
    void renderImGui();
    void exposeScriptApi(ssq::VM& vm);
 
    struct Impl;  // pimpl: full definition lives in EditorHost.cpp
 
private:
    EditorHost();
    std::unique_ptr<Impl> impl_;
    bool                  running_       = false;
    bool                  allowWindow_   = true;
    bool                  exitRequested_ = false;
    std::string           gameRoot_;
};
 
}  // namespace eve::ui