ConsolePanel.hpp

浏览该文件的文档.

#pragma once
 
#include "common/Export.h"
 
#include <cstdint>
#include <deque>
#include <mutex>
#include <string>
#include <vector>
 
struct SQVM;
typedef struct SQVM* HSQUIRRELVM;
 
namespace eve::dev {
 
struct EVENGINE_API ConsoleLine {
    std::string timestamp;  // HH:MM:SS
    std::string level;      // debug | info | warn | error | print | cmd | result
    std::string text;
};
 
class EVENGINE_API ConsolePanel {
public:
    static ConsolePanel& instance();
 
    ConsolePanel(const ConsolePanel&)            = delete;
    ConsolePanel& operator=(const ConsolePanel&) = delete;
 
    void setVisible(bool on);
    bool isVisible() const;
    void toggleVisible();
 
    void addLog(std::string level, std::string text);
    void addInfo(std::string text);
    void addWarn(std::string text);
    void addError(std::string text);
 
    void clear();
    void setMaxEntries(size_t n);
    std::vector<ConsoleLine> recent(size_t max = 128) const;
    std::string format(size_t max = 128) const;
 
    void attach(HSQUIRRELVM vm);
    void detach();
    bool isAttached() const { return vm_ != nullptr; }
 
    std::string eval(const std::string& expression);
 
    void drawImGui();
 
    using ImGuiDrawer = void (*)(ConsolePanel& panel);
    static void setImGuiDrawer(ImGuiDrawer fn);
 
private:
    // Immortal<ConsolePanel> constructs the singleton (devtools/Immortal.hpp).
    template <typename> friend struct Immortal;
    ConsolePanel() = default;
 
    static std::string nowStamp();
 
    mutable std::mutex mu_;
    bool               visible_    = true;
    size_t             maxEntries_ = 500;
    std::deque<ConsoleLine> log_;
    HSQUIRRELVM       vm_ = nullptr;
};
 
}  // namespace eve::dev