dl_ui_manager.h

浏览该文件的文档.

#pragma once
 
#ifndef DL_DISABLE_RENDER
#include "misc/dl_component_use.h"
#include "base/dl_type_def.h"
#include "misc/dl_locator.h"
#include "base/dl_tree.h"
#include "dl_ui_background.h"
#include "render/dl_factory.h"
#include "io/dl_json.h"
#include "ui/dl_ui_panel.h"
#include "ui/dl_ui_sprite.h"
#include "ui/dl_ui_text.h"
#include "ui/dl_ui_button_sprite.h"
#include "ui/dl_ui_button_sprite9.h"
#include "ui/dl_ui_button_text_color.h"
#include "ui/dl_ui_button_scale.h"
#include "ui/dl_ui_button_sprite_color.h"
#include "ui/dl_ui_list_box.h"
#include "ui/dl_ui_edit_box.h"
#include "ui/dl_ui_tree.h"
#include "ui/dl_ui_menu.h"
#include "ui/dl_ui_progress_bar.h"
#include "ui/dl_ui_window.h"
#include "ui/dl_ui_extend.h"

namespace dl::UI
{
    enum class SizeType
    {
        SMALL,
        NORMAL,
        LARGE,
        LONG,
        MAX_NUM
    };

    enum class ButtonStyle
    {
        SMALL,
        NORMAL,
        LARGE,
        LONG,
        CLOSE,
        SWITCH,
        BOX,
    };

    enum class WindowShowMode
    {
        SHOW,
        HIDE,
        TOGGLE
    };

class Manager
{
public:
    Manager() :
        _bHide{ false },
        _sizeStandard{},
        _edtFocus{ nullptr },
        _uiScale{ 1.0f },
        _orderMin{ Z_DEFAULT_WIDNOW_MIN },
        _orderMax{ Z_DEFAULT_WIDNOW_MAX }
    {
        _arrSizeType[SizeType::SMALL] = 32;
        _arrSizeType[SizeType::NORMAL] = 50;
        _arrSizeType[SizeType::LARGE] = 100;
        _arrSizeType[SizeType::LONG] = 120;
        //根面板
        _panelRoot = new Panel;
        _panelRoot->_node = _allPanel.AddRoot(_panelRoot);
    }

#ifdef NDEBUG
    Panel* CreatePanel(Panel* parent)
    {
        if (!parent)
            parent = _panelRoot;
 
        Panel* p = new Panel;
        p->_node = _allPanel.Add(p, parent);
        p->_coor->SetParent(parent->_coor);
        p->_refresh_order();
        return p;
    }
    Panel* CreatePanel()
    {
        return CreatePanel(nullptr);
    }
    Panel* lua_CreatePanel()
    {
        return CreatePanel(nullptr);
    }
#else
    Panel* CreatePanel(Panel* parent, DL_SOURCE_LOCATION)
    {
        DL_MAKE_SOURCE_LOCATION(loc);
 
        if (!parent)
            parent = _panelRoot;
 
        Panel* p = new Panel;
        p->_node = _allPanel.Add(p, parent);
        p->_coor->SetParent(parent->_coor);
        p->_refresh_order();
        p->_debugName = fmt::format("{}({},{}):",
            String::CvtPathSeparator(loc._file),
            loc._line, loc._column);
        return p;
    }
    Panel* CreatePanel(DL_SOURCE_LOCATION)
    {
        return CreatePanel(nullptr, DL_SOURCE_LOCATION_CALL);
    }
    Panel* lua_CreatePanel()
    {
        return CreatePanel(nullptr, DL_SOURCE_LOCATION_CALL);
    }
#endif
    void DeletePanel(Panel* panel, bool del_child = false)
    {
        if(del_child)
        {
            auto vec = panel->_node->GetChild();
            for(auto& iter : vec)
            {
                DeletePanel(iter->GetValue(), true);
            }
        }
        // 会导致父节点的子节点列表迭代器失效
        _allPanel.Del(panel->_node);
        delete panel;
    }

    void DeletePanelChild(Panel* panel, bool recursion = true)
    {
        auto vec = panel->_node->GetChild();
        for (auto& iter : vec)
        {
            DeletePanel(iter->GetValue(), recursion);
        }
    }

    void SetPanelParent(Panel* panel, Panel* parent)
    {
        _allPanel.SetParent(panel->_node, parent->_node);
        panel->_coor->SetParent(parent->_coor);
        panel->_refresh_order();
    }
    Panel* GetPanelRoot()
    {
        return _panelRoot;
    }
 
    //-----------------------------窗口管理器-----------------------------------------
    // 一般步骤为
    // 1.创建
    // auto win = UI::XXXX::Create()
    // win->ExFastSet();
    // g_ui->AddWindow("my_name", win);
    // 
    // 2.打开或关闭
    // g_ui->ShowWindow("my_name");
    // 
    // 3.释放
    // delete win，或程序结束时自动删除

    void AddWindow(std::string_view name, Window* win);
 
    Window* GetWindow(std::string_view name);
 
    void ShowWindow(Window* win, WindowShowMode mode = WindowShowMode::SHOW);
    void ShowWindow(std::string_view name, WindowShowMode mode = WindowShowMode::SHOW);
 
    void SetWindowOrder(float z_min, float z_max)
    {
        _orderMin = z_min;
        _orderMax = z_max;
        _refresh_window_order();
    }
public:
    void _on_window_show_change(Window* win, bool visible);
    void _update_window();
    void _refresh_window_order();
    void _release_window_all();
    void _release_window(Window* win);
public:
    //-----------------------------已注册元素创建（不会返回失败）-------------------------
    UI::Text* CreateText(std::string_view name);
    gcText CreateTextOnly(std::string_view name);
    ButtonSprite* CreateButtonSprite(std::string_view name);
    Background* CreateBackground(std::string_view name);  
    Locator::SL CreateLocator(std::string_view name);
    ListBox* CreateListBox(std::string_view name);
 
    //-------------------------------默认（创建失败时会使用）---------------------------
 
    UI::Text* CreateTextDefault();
    UI::ButtonSprite* CreateButtonSpriteDefault(ButtonStyle style = ButtonStyle::NORMAL);
    UI::Background* CreateBackgroundDefault();
    UI::ListBox* CreateListBoxDefault(bool add_text = false);
    UI::EditBox* CreateEditBoxDefault(bool single_line = true);
    UI::Tree* CreateTreeDefault();
    UI::Menu* CreateMenuDefault();
    UI::ProgressBar* CreateProgressBarDefault();

    void Register(std::string_view json_path);
    void RegisterEnd();

    void RegisterAll(std::string_view path);

    void SetScale (float s)
    { 
        _uiScale = s;
        _refresh_scale();
    }

    void SetStandardSize(const Size& size);
    Size GetStandardSize();
    float GetScale()
    {
        return _uiScale;
    }
 
    const NTree<Panel*>& GetPanelAll()
    {
        return _allPanel;
    }
 
    void RefreshLang()
    {
        for (auto& node : _allPanel)
        {
            node->GetValue()->_refresh_lang();
        }
    }

    /*Components* CloneCpt(Components* cpt)
    {
        if (auto p = cpt->Cast<UI::Text>())
            return p->Clone()->GetCpt();
        if (auto p = cpt->Cast<UI::ButtonSprite>())
            return p->Clone()->GetCpt();
        assert(0);
        return nullptr;
    }*/

    void SetHide(bool hide)
    {
        _bHide = hide;
    }

    bool IsHide()
    {
        return _bHide;
    }
 
    EditBox* GetFocusEditBox() { return _edtFocus; }

    void SetFocusEditBox(EditBox* edt, bool focus = true);

    void RenderDebug();
    void RenderDebugElementData(Coor* coor, const Cpt::ElementData& elem_data);
 
    ~Manager();

    void _update_pre();
    void _update();
    void _render();

    void _resize();
    void _resize_panel_root();

    void _on_char(char32_t ch);
    void _on_key(int action, bool ctrl);
private:
    NTree<Panel*> _allPanel;
    Panel* _panelRoot;

    Float _uiScale;
    Size _sizeStandard;// 标准大小
 
    bool _bDebug;// 调试绘图
    bool _bHide;// 隐藏ui界面
 
    EditBox* _edtFocus;// 焦点输入框
 
    // 默认ui大小
    ArrayEnum<Float, SizeType::MAX_NUM> _arrSizeType;
 
    //-------------------------Window-----------------------
    std::unordered_map<std::string, Window*> _allWindow;
    std::list<Window*> _listShowWindow; // 当前显示窗口，顺序决定order，尾部最小
    float _orderMin;
    float _orderMax;
 
    //-------------------------模板--------------------------
    std::unordered_map<std::string, Text*, string_hash, std::equal_to<>> _allText;
    std::unordered_map<std::string, ButtonSprite*, string_hash, std::equal_to<>> _allBtnSprite;
    std::unordered_map<std::string, Background*, string_hash, std::equal_to<>> _allBackground;
    std::unordered_map<std::string, Locator::SL, string_hash, std::equal_to<>> _allLocator;
    std::unordered_map<std::string, ListBox*, string_hash, std::equal_to<>> _allListBox;
 

    struct RegKey
    {
        ElementType _type;
        std::string _name;
        json _json;
 
        bool operator<(const RegKey& b) const
        {
            return _type < b._type;
        }
    };
    std::list<RegKey> _allReg;
 
    void _reg_text(json& j, const std::string& name);
    void _reg_msg_box(json& j, const std::string& name);
    void _reg_button(json& j, const std::string& name);
    void _reg_background(json& j, const std::string& name);
    void _reg_locator(json& j, std::string_view name);
    void _reg_list_box(json& j, std::string_view name);
 
    void _release()
    {
        _release_window_all();
 
        for (auto& iter : _allText)
            delete iter.second;
        for (auto& iter : _allBtnSprite)
            delete iter.second;
        for (auto& iter : _allBackground)
            delete iter.second;
        for (auto& iter : _allListBox)
            delete iter.second;
    }
 
    void _refresh_scale()
    {
        _panelRoot->_coor->SetScale(_uiScale);
        _resize_panel_root();
    }
    void _refresh_standard_size();
 
    void _debug_render();
};
 
 
}
 
namespace dl
{
// panel可能是全局的，注意生命周期
extern UI::Manager* g_ui;
}
 
 
#endif