axmol/extensions/ImGuiEXT
halx99 99cf51df55 Update imgui to 1.84 WIP [ci build] 2021-06-15 22:30:54 +08:00
..
imgui Update imgui to 1.84 WIP [ci build] 2021-06-15 22:30:54 +08:00
CCImGuiEXT.cpp Update imgui to 1.84 WIP [ci build] 2021-06-15 22:30:54 +08:00
CCImGuiEXT.h Add ImGuiEXT::end to end game 2020-09-10 17:53:17 +08:00
CMakeLists.txt Update imgui to 1.84 WIP [ci build] 2021-06-15 22:30:54 +08:00
LICENSE Refine extension ImGui, and rename director to ImGuiEXT 2020-09-05 17:10:09 +08:00
README.md Update README.md 2021-05-24 17:54:18 +08:00
imgui_impl_cocos2dx.cpp ImGui multi-viewports Compatible with desktop GLES 2020-09-16 20:16:32 +08:00
imgui_impl_cocos2dx.h Add ImGuiEXT test case for PC platforms 2020-09-08 13:38:16 +08:00

README.md

ImGuiEXT of adxe

Sync from https://github.com/Xrysnow/cocos2d-x-imgui and do a little changes

Improvements

  • Simplify API, use add/remove renderLoop present ImGui GUI widgets
  • Optimize call pipeline flow, support add/remove Node to Scene at ImGui render loop without container iterator damage
  • Calculate deltaTime at ImGui_ImplCocos2dx_NewFrame to avoid error when cc.Director paused
  • Refine Init/Shutdown, Restore all callbacks for glfw to solve recreate ImGuiEXT instance support
  • Use FOURCC for key of ImGui render loop
  • Add dpi scale support, use ImGuiEXT::getInstance()->scaleAllByDPI(1.0);
  • Easy font manager, stable API addFont,removeFont,clearFonts to manage ImGui fonts, with ImGui API, very hard to do correctly.

How to use

#include "ImGuiEXT/CCImGuiEXT.h"
USING_NS_CC;
USING_NS_CC_EXT;

class GameScene : public Scene {
public:
    void onEnter() override
    {
        Scene::onEnter();
        ImGuiEXT::getInstance()->addRenderLoop("#im01", CC_CALLBACK_0(GameScene::onImGuiDraw, this), this);
    }
    void onExit() override
    {
        Scene::onExit();
        ImGuiEXT::getInstance()->removeRenderLoop("#im01");
    }
    void onImGuiDraw()
    {
        ImGui::Begin("window");
        ImGui::Text("FPS=%.1f", 1.f / ImGui::GetIO().DeltaTime);
        ImGui::End();
    }
}

More about use imgui widgets, please see: https://github.com/ocornut/imgui

Tested devices

  • win32
  • macOS

Known issues

  • Can't enable muti-viewports on macOS, so we disable it for macOS

Other resources of ImGui