https://github.com/enkisoftware/rccpp-dearimgui-glfw-example
Add Runtime Compiled C++ to the Dear ImGui example using the GLFW and OpenGL backend - with power saving
https://github.com/enkisoftware/rccpp-dearimgui-glfw-example
c-plus-plus cmake compile cpp dear-imgui energy-efficiency gamedev glfw imgui linux live-coding macos opengl rccpp runtimecompiledcplusplus unix windows
Last synced: 20 days ago
JSON representation
Add Runtime Compiled C++ to the Dear ImGui example using the GLFW and OpenGL backend - with power saving
- Host: GitHub
- URL: https://github.com/enkisoftware/rccpp-dearimgui-glfw-example
- Owner: enkisoftware
- License: zlib
- Created: 2020-02-08T16:38:43.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-05-28T15:49:03.000Z (11 months ago)
- Last Synced: 2025-04-06T00:37:03.947Z (25 days ago)
- Topics: c-plus-plus, cmake, compile, cpp, dear-imgui, energy-efficiency, gamedev, glfw, imgui, linux, live-coding, macos, opengl, rccpp, runtimecompiledcplusplus, unix, windows
- Language: C++
- Homepage:
- Size: 25.4 KB
- Stars: 87
- Watchers: 4
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
Support our work through [GitHub Sponsors](https://github.com/sponsors/dougbinks) or [Patreon](https://www.patreon.com/enkisoftware)
[
](https://github.com/sponsors/dougbinks) [
](https://www.patreon.com/enkisoftware)
# RCC++ Dear ImGui GLFW example with Power Saving
This project adds Runtime Compiled C++ to the Dear ImGui example using the GLFW and OpenGL backend. This enables us to edit the code at runtime and see the results live, without recompiling and restarting the project.
This is a cross platform project using CMake.
Runtime-Compiled C++ (RCC++) is a way to reliably make major changes to C++ code at runtime and see the results immediately. It's aimed at games development but could be useful in any industry where turnaround times are a bottleneck.
[github.com/RuntimeCompiledCPlusPlus/RuntimeCompiledCPlusPlus](https://github.com/RuntimeCompiledCPlusPlus/RuntimeCompiledCPlusPlus)
RCC++ is primarily designed to shorten iteration times in development - developers can build their project, run it, make changes during runtime and see the results in a few seconds.
Note - you can also find a similar Windows-only example in the devlog post [Runtime Compiled C++ Dear ImGui and DirectX11 Tutorial](https://www.enkisoftware.com/devlogpost-20200202-1-Runtime-Compiled-C++-Dear-ImGui-and-DirectX11-Tutorial).
## Power Saving
To reduce the energy used by Dear Imgui, the application draws the user interface only when there is user input.
[Example power saving code in commit](https://github.com/juliettef/RCCpp-DearImGui-GLFW-example/commit/19a0d59551331f1d5d2e6ec6a077f92257af4354)
The implementation consists in switching the event handling from polling to waiting for events. A power save variable counts a predefined number of frames after the last input has been received. When the countdown ends the application waits for further events, therefore saving power. If input is received the countdown is reset. This allows the GUI to display input changes and for immediate mode states to propagate.
Though not shown in the example, any graphical application can also track when updates are in progress and temporarily disable power saving (for example by resetting the power save countdown). The example sets the swap interval to 1; if the application sets the swap interval to 0 (for example for low latency gaming), another power saving feature would be to set this to 1 when the user is interacting with the GUI.
## Getting the code
The easiest way to get hold of the starter code is to run the following command using a shell you can run git from:
```
git clone --recursive https://github.com/juliettef/RCCpp-DearImGui-GLFW-example
```
If you are on Windows you can download git from [git-scm.com/download/win](https://git-scm.com/download/win) and use the right click menu in Windows File Explorer to "Git Bash here" and then run git commands.
This will create the directory _RCCpp-DearImGui-GLFW-example_ and get the latest source code, using the ```--recursive``` option to download the RuntimeCompiledCPlusPlus, Dear ImGui and GLFW code, which have been included in the tutorial repository as submodules. If you want to run further git commands from the command line you'll need to cd into the directory:
```
cd RCCpp-DearImGui-GLFW-example
```
Alternatively you can use a git GUI program such as [Fork](https://git-fork.com/) to get the code. Most of these will automatically download the git submodules.
If you download the code from GitHub via the "Download ZIP" approach, you'll also need to download the RuntimeCompiledCPlusPlus, Dear ImGui and GLFW into the _RuntimeCompiledCPlusPlus_, _imgui_ and _glfw_ directories. The correct version can be found by clicking on the _RuntimeCompiledCPlusPlus_, _imgui_ and _glfw_ folders you see on the [front page of the _RCCpp-DearImGui-GLFW-example_ GitHub repository](https://github.com/juliettef/RCCpp-DearImGui-GLFW-example).
## Using CMake to create the project
From a command prompt in the `RCCpp-DearImGui-GLFW-example` directory:
1. `mkdir build`
1. `cd build`
1. `cmake ..`
1. Either run `make all` or for Visual Studio open `RCCpp-DearImGui-GLFW-example.sln`
The _RCCpp-DearImGui-GLFW-example_ Window should open.