• ImGuin
  • Usage: Sample program and run
  • Prerequisites
  • Install
  • Build examples
  • Screen shot (examples)
    • glfw_opengl3
    • glfw_opengl3_iconfont_viewer
    • glfw_opengl3_image_load
    • glfw_opengl3_image_save
    • glfw_opengl3_nimgl_imguin_jp
    • glfw_opengl3_implot
    • glfw_opengl3_imnodes
    • glfw_opengl3_imguizmo
    • My test app movie using imguin
  • Update / Downgrade Dear ImGui and CImGui
  • Prerequisite
  • Update / Downgrade ImGui/CImGui
  • Selection backend compiler
  • TODO
  • Compressing binary file
  • My tools version
  • Other link
  • Similar project

ImGuin

Updated to latest ImGui/CImGui version: : v1.91.4dock (2024/10)

This project is my experiment project to use Nim language, ImGui, ImPlot, futhark and etc.

• Notice
  It may be better to use the mainstream project nimgl/imgui (ImGui v1.85)
  ,updated project nimgl-imgui (ImGui v1.89.9) ,sub project nim_implot and test project nimgl_test.

Usage: Sample program and run

Prerequisites

• Nim-2.0.4 or later (Windows10 or later / Debian Linux)
• MSys2/MinGW command line tools (Unix tools), make, cp, rm, git, ...etc

• For Linux Debian 12 Bookworm, Linux Mint

  $ sudo apt install xorg-dev libopengl-dev libgl1-mesa-dev

  and for glfw3 and sdl2,

  $ sudo apt install libglfw3 libglfw3-dev
  $ sudo apt install libsdl2-dev

Install

nimble uninstall imguin  # Remove old versions if exist. 
nimble install https://github.com/dinau/imguin

Build examples

1. First clone this project,

   git clone https://github.com/dinau/imguin

2. Sample program is here, examples. For instance glfw_opengl3.nim,

   cd imguin/examples/glfw_opengl3
   make  # or make run

   After build, run ./glfw_opengl3(.exe)

3. For selecting static link or dynamic link ,read this examples/README.md.

Screen shot (examples)

These screen shots are on Windows10.

glfw_opengl3

glfw_opengl3_iconfont_viewer

glfw_opengl3_image_load

glfw_opengl3_image_save

glfw_opengl3_nimgl_imguin_jp

Showing UTF-8 label text and input text with my local country language.

glfw_opengl3_implot

Showing ImGui demo with ImPlot demo.

glfw_opengl3_imnodes

glfw_opengl3_imguizmo

My test app movie using imguin

Update / Downgrade Dear ImGui and CImGui

Prerequisite

1. Git installed.

2. Installed MSys2/MinGW command line tools (Unix tools), make, cp, rm, ...etc

3. Windows10 or later Clang/LLVM refer to Futhark installation.

   nimble install futhark

   It must exist libclang.a file in the library path (e.g. in c:\llvm\lib).

4. Linux Debian 12 Bookworm

   sudo apt install  clang-16
   nimble install --passL:"-L/usr/lib/llvm-16/lib" futhark

Important Notice: Confirm Futhark version is v0.13.6 at this time. (2024/09)

nimble dump futhark

name: "futhark"
version: "0.13.6"
author: "PMunch"
desc: "A package which uses libclang to parse C headers into Nim files for easy interop"
license: "MIT"
...

Update / Downgrade ImGui/CImGui

1. Compose development folders
   First move to your working folder you like, then

   mkdir imguin_dev
   cd imguin_dev
   git clone https://github.com/dinau/imguin
   cd imguin

2. Clone ImGui/CImGui etc. sources at once forever

   pwd
   imguin
   make clonelibs

   Cloned libraries are under ../libs/ folder

3. Recursively update the sources using git Pull or fetch command in the each library folder,
   ../libs/cimgui
   ../libs/cimguizmo
   ../libs/cimnodes
   ../libs/cimplot

4. Checkout arbitrary version with git command in the respective folder

5. Specify your Clang include path to ClangIncludePath in imguin/src/imguin/cimgui.nim.

6. Generate the definition file uisng Futhark,

   pwd
   imguin
   make gen

7. Install updated files
   Properly edit the version info etc in imguin.nimble file, then

   pwd
   imguin
   nimble uninstall imguin  # Remove old versions if it exist. 
   nimble install 

   That's all.
   Repeat from 3. if you'd like to update or downgrade to other version.

• Confirmed version

  ImGui/CImGui Ver.	ImGuin Ver.	Date	WindowsOS	Linux Mint	Debian Bookworm (1)
  1.91.4dock	1.91.4.0	2024/10	OK	OK	-
  1.91.3dock	1.91.3.1	2024/10	OK	(7)	-
  ↑	1.91.3.0	2024/10	OK	(7)	-
  1.91.2dock	1.91.2.0	2024/10	OK	(7)	-
  1.91.1dock	1.91.1.2	2024/09	OK	(6)	-
  1.91.1dock	1.91.1.1	2024/09	OK	-	-
  1.91.0dock	1.91.0.1	2024/08	OK	-	(7)
  ↑	1.91.0.0	2024/08	OK	-	(7)
  1.90.9dock	1.90.9.4	2024/07	OK	-	NG (5)
  ↑	1.90.9.3	2024/07	OK	-	NG (5)
  1.90.8dock	1.90.8.1	2024/06	OK	-	NG (5)
  ↑	1.90.8.0	2024/06	OK	-	NG (5)
  1.90.7dock	1.90.7.0	2024/05	OK	-	NG (5)
  1.90.6dock	1.90.6.1	2024/05	OK	-	NG (5)
  1.90.4dock	1.90.4.3	2024/04	OK	-	NG (5)
  -	-	-	-	-	-
  ↑	1.90.4.2	2024/02	OK	-	OK (4)
  1.90.1dock	1.90.1.0	2024/01	OK	-	NG/OK(1)(3)(4)
  1.89.9dock	1.89.9.8	2023/12	OK	-	NG/OK(1)(3)(4)

  (1): Except imnodes and SDL2 example.
  (2): Doesn't work well.
  (3): Works well only if it is compiled debug mode.
  (4): Use nim-2.0.2
  (5): I don't know why can't be compiled on Linux.
  (6): OK: Except ImNodes example (7): Not checked at this moment.

Selection backend compiler

You might be able to use another C/C++ compiler,
Clang, vcc(Visual Studio C/C++) , zig cc
by changing variable TC in examples/config.nims.common.

TODO

1. Whether can it use cimgui.dll ? (Now it can only be static link) Closed. Only be static link.
2. Easier compilation for SDL2 app. (2024/09) Done.
3. Added: ImNodes/CImNodes (2023/10) Done
4. Unfortunately ImGui 1.89.7 dosn't work well at this moment.(2023/07) Done. (2023/08)
5. Whether can it do nimble install imguin ? Done (2023/09) (#Issue 13)
6. Add Font Awesome (Icon Font) demo. Done (2023/04).
7. Can it compile with MSVC (--cc:vcc) ? Done. Except SDL2 demo. (2023/03), TODO (2024/09)
8. Can it compile with Clang (--cc:clang) ? Done. (2023/03)
9. Add SDL2 example. Done. examples/sdl2_opengl3 (2023/03)
   • First step is done. (2023/03)

Compressing binary file

Install UPX with MSys console on WindowsOS,

pacman -S mingw-w64-ucrt-x86_64-upx

For instance,

pwd
examples
cd glfw_opengl3_implot
make upx

                       Ultimate Packer for eXecutables
                          Copyright (C) 1996 - 2024
UPX 4.2.4       Markus Oberhumer, Laszlo Molnar & John Reiser    May 9th 2024

        File size         Ratio      Format      Name
   --------------------   ------   -----------   -----------
   7117824 ->   1217024   17.10%    win64/pe     glfw_opengl3_implot.exe      

Decompressing,

make dupx

Result in,

Gcc: v14.2.0, Clang: v18.1.8, MSVC: 2022

My tools version

Windows11 (main)

• Nim Compiler Version 2.2.0

• Gcc (Rev1, Built by MSYS2 project) 14.2.0

  pacman -S mingw-w64-ucrt-x86_64-gcc

• Clang version 18.1.8

  pacman -S mingw-w64-ucrt-x86_64-clang

• Visual Studio C++/C 2022

• git version 2.46.0.windows.1

• SDL2.dll: 2.30.7

• Make: GNU Make 4.4.1

• MSys2/MinGW tools

Lnux Mint 22

• Nim Compiler Version 2.2.0
• gcc 13.2.0
• SDL2: 2.30.0
• make: GNU Make 4.3
• git version 2.43.0

Other link

• File Dialog

  • Cross Platform File Dialog for Dear-ImGui
  • ImGui File Dialogs - CLI and Client Library
  • A Dear ImGui based File Dialog without any extra dependencies

• Other

  • Node Editor built using Dear ImGui

• GUI

  • nuklear-nim (Public archived)

• Graphical

  • Immediate Mode Plotting

Similar project

• Dear ImGui