imgui-bundle 0.7.1

ImGui Bundle: easily create ImGui applications in Python and C++. Batteries included!

ImGui Bundle

ImGui Bundle is a bundle for Dear ImGui, including various useful libraries from its ecosystem. It enables to easily create ImGui applications in C++, as well as in Python.

The python bindings were autogenerated from the original C++ code, so that they are easier to keep up to date, and the python API closely matches the C++ api, making it possible to easily port research code from Python to C++.

Python C++

Batteries included

ImGui Bundle includes:

• imgui : Dear ImGui: Bloat-free Graphical User interface for C++ with minimal dependencies
• implot: Immediate Mode Plotting
• Hello ImGui: cross-platform Gui apps with the simplicity of a "Hello World" app
• ImGuizmo: Immediate mode 3D gizmo for scene editing and other controls based on Dear Imgui
• ImGuiColorTextEdit: Colorizing text editor for ImGui
• imgui-node-editor: Node Editor built using Dear ImGui
• imgui-knobs: Knobs widgets for ImGui
• ImFileDialog: A file dialog library for Dear ImGui
• portable-file-dialogs Portable GUI dialogs library (C++11, single-header)
• imgui_md: Markdown renderer for Dear ImGui using MD4C parser
• imspinner: Set of nice spinners for imgui
• imgui_toggle: A toggle switch widget for Dear ImGui. Homepage
• ImmVision: immediate image debugger and insights
• imgui_tex_inspect: A texture inspector tool for Dear ImGui

Philosophy

• Closely mirrors the original API of ImGui and other libraries
• Original code documentation is meticulously kept inside the python stubs. See for example the documentation for:
  • imgui
  • implot
  • hello imgui
• Fully typed bindings, so that code completion works like a charm

ImGui Backend

ImGui Bundle uses Hello ImGui, which is configured to use GLFW + OpenGL3. Under C++, this is configurable (see Hello ImGui docs), with some adaptations inside on the cmake side.

Usage with Python

Install

# Install from pypi
pip install imgui-bundle

# or install from clone
git clone https://github.com/pthom/imgui_bundle.git
cd imgui_bundle
pip install -v .

Demo

# imgui_bundle_demo will run the full demo shown on this page. 
# It also acts as a manual for ImGui Bundle with lots of examples and related code source.
imgui_bundle_demo 

The source for the demos can be found inside bindings/imgui_bundle/demos_python.

Usage with C++

git clone https://github.com/pthom/imgui_bundle.git

Then, take inspiration from demos_cpp/demo_haiku_implot_heart, or demos_cpp/demo_widgets_docking