Home

Welcome to the UImGui wiki!

Thanks for using the project.

How to update UImGui

If you have any suggestion or feedback, please feel free to comment on Issues

You can't build using Linux because the project use the UnityEngine.dll.

Setup

Install Unity

• The project is using the version 2020.3.29f1. If you want to change the version of the unity you need change every csproj file in ImGui.Net/src

Install LuaJIT

• Mac you could use https://formulae.brew.sh/formula/luajit
• Windows you could use binary
• Linux (not tested)

Install Visual Studio

• It's necessary only .NET Framework SDK. If you already have VS Studio installed, instsall .NET only
• It could be done using only NET.Core, but I didn't tested. If you could run without VS Studio, please leave a comment
• Install dotnet 2.0 https://dotnet.microsoft.com/en-us/download/dotnet/2.0

You’ll need GCC (or other as clang)

• https://gcc.gnu.org/install/binaries.html
• Mac you could use brew install gcc
• Windows you could use MinGW
  • Don’t forget to put MinGW\bin into your PATH

Install Freetype

• For mac users, you could use brew install freetype

Clone repos below recursively

• https://github.com/psydack/ImGui.NET
• https://github.com/psydack/ImGui.NET-nativebuild

Updating

• update submodules

  • imgui inside cimgui with docking (or any branch you want to)
    • probably you'll need to change some declarations

• Ensure -std=c++11 is on ImGui.Net-nativebuild/cimgui/makefile CXXFLAGS

• ImGui.Net-nativebuild/cimgui/imgui/misc/freetype/imgui_freetype.[cpp and h] change path imgui.h to ../../imgui.h, imgui_internal.h and imstb_rectpack.h

• Enable on ImGui.Net-nativebuild/cimgui/imgui/imguiconfig.h

  • #define IMGUI_USE_WCHAR32
  • #define IMGUI_ENABLE_FREETYPE
  • #define IMGUI_ENABLE_STB_TRUETYPE

Generating files and dlls

1. Generate definitions running ImGui.NET-nativebuild/generate-all.[sh or bat]
2. Copy new definitions to ImGui.NET project running ImGui.NET-nativebuild/copy-jsons-to-generatecode-csharp.[sh or bat]
3. Generate code from new definitions and add to the project
   • MAC: Run ImGui.NET/ci.sh
   • Windows run dotnet run inside ImGui.NET/src/CodeGenerator or open the .sln into Visual Studio and run the project CodeGenerator.
     • Something like: Outputting generated code files to ... must to appear
     • Copy generated code to each project src running CopyGenCodeToSrc.[sh or bat]