This project provides a single CMakeLists.txt for building the Dear ImGui as a static library. It supports optional integration with ImPlot for plotting capabilities and various rendering and platform backends (e.g., DirectX, Vulkan, OpenGL, GLFW, SDL, etc.).

Unlike other integrations, imgui-cmake focuses solely on building and does NOT manage source code (e.g., no submodules). This makes it easy to integrate into existing projects without altering repository structure.

The Example project can be found at imgui-cmake-examples.

    git clone https://github.com/WenchaoHuang/imgui-cmake.git

The CMakeLists.txt supports three ways to locate the ImGui source files:

1. Place at the same level as the ImGui directory (Recommended):

    <parent-directory>/
    ├── ...
    ├── glfw/                  # GLFW directory (optional)
    ├── imgui/                 # ImGui directory (contains imgui.h)
    ├── implot/                # ImPlot directory (contains implot.h)
    └── imgui-cmake/           # This project
        └── CMakeLists.txt
   

2. Copy CMakeLists.txt to ImGui Directory:

   <imgui-directory>/
   ├── ...
   ├── imgui.h               # ImGui source (required)
   ├── implot.h              # ImPlot source (optional)
   └── CMakeLists.txt        # This project
   

3. Manually Specify ImGui Directory:

   cmake -DIMGUI_SOURCE_DIR=/path/to/imgui
   

If ImPlot is enabled (IMGUI_EXT_IMPLOT=ON), the same approaches apply for locating ImPlot source files.

1. Add as a Subdirectory

   add_subdirectory(imgui-cmake)
   target_link_libraries(MyApp PRIVATE ImGui::ImGui)

2. Enable Backends

   cmake -DIMGUI_BACKEND_WIN32=ON
   cmake -DIMGUI_BACKEND_VULKAN=ON
   cmake -DIMGUI_BUILD_EXAMPLES=ON
   cmake --build .

3. Integrate in Code

   #include <imgui.h>
   
   #ifdef IMGUI_BACKEND_WIN32
       #include <backends/imgui_impl_win32.h>
   #endif
   
   #ifdef IMGUI_BACKEND_VULKAN
       #include <backends/imgui_impl_vulkan.h>
   #endif

Some platform backends rely on external libraries that are not bundled with Dear ImGui.
When these backends are enabled, you must manually specify the corresponding include directories.

This project is distributed under the terms of the MIT License.