ofxAddons
← Back

ofxSurfingImGui

github.com/moebiussurfing/ofxSurfingImGui · @moebiussurfing
OF 0.12 Releases GUI

( WIP ) ImGui Toolkit for openFrameworks apps: ofParameters Widgets and Layout Helpers. Modules/Engines: Log, Debugger, Docking, Layout Presets and more. NEW: iOS

53 13 Last commit 7mo ago Created 5y ago

Forks

Forks pushed to more recently than moebiussurfing/ofxSurfingImGui itself, plus any admin-confirmed fork with commits of its own — worth checking if you're hitting issues with the original.

roymacdonald/ofxSurfingImGui by @roymacdonald · ★ 0 · pushed 17d ago
danoli3/ofxSurfingImGui by @danoli3 · ★ 0 · pushed 2mo ago

Branches ahead of develop

These branches have commits not yet on develop — could be unmerged fixes or work in progress worth a look.

dev2 9 commits ahead · last commit 7mo ago
Update-ImGui-1.92.5 1 commit ahead · last commit 8mo ago
master 4 commits ahead · last commit 1y ago
OF_0.11.2 2 commits ahead · last commit 2y ago

README


<h1>

ofxSurfingImGui.

A Dear ImGui Toolkit for openFrameworks desktop app projects.

</h1>

<h3> An extension for ofxImGui. </h3>




<h3> <em> WORK IN PROGRESS! </em> </h3>




OVERVIEW




FEATURES

MODULES / SYSTEMS

ENGINES




SCREENSHOTS



EXAMPLE: 00_HelloWorld

<details> <summary>CODE</summary>

ofApp.h



``.cpp

pragma once

include "ofMain.h"



include "ofxSurfingImGui.h"



class ofApp : public ofBaseApp { public: void draw();

ofParameter<bool> bEnable{ "Enable", true }; ofParameter<float> speed{ "Speed", .5f, 0.f, 1.f }; ofParameterGroup params{ "MyGroup", bEnable, speed };

ofParameter<bool> bGui{ "Show", true };

ofxSurfingGui ui; }; 


ofApp.cpp
.cpp

include "ofApp.h"



void ofApp::draw() { ui.Begin(); { / Put windows here / if (ui.BeginWindow(bGui)) { / Put widgets here / ui.AddLabelBig("00_HelloWorld"); ui.AddSpacing(); ui.Add(bEnable, OFX_IM_TOGGLE_BIG_BORDER_BLINK); ui.Add(speed, OFX_IM_HSLIDER); ui.AddSpacingSeparated(); ui.AddGroup(params, SurfingGuiGroupStyle_Collapsed);

ui.EndWindow(); } } ui.End(); } `

</details>




REQUERIMENTS



IMGUI OF BACKEND



Required: ofxImGui from @jvcleave's repository and develop branch. <details> <summary>WHY ANOTHER BACKEND FORK?</summary> <p>

Currently, this fork is linked to the original develop branch from @jvcleave. And will be probably merged into the master branch someday. </p> </details>

DATA ASSET FILES



 Recommended: Geist-Bold.ttf Optional: data.zip
  • More font files (non-monospaced alternative) from the same family.
  • Put into each OF project OF_APP/bin/data/.
 Extras: dataExtras.zip - More fonts, theme files...etc

<details> <summary>ABOUT THE FONTS</summary> The single font file for the currently used theme is Geist-Bold.ttf. If that font is not located, it will search for a legacy font called JetBrainsMono-Bold.ttf. If none of those fonts are located, it will work too, but using the default embedded ProggyClean.ttf font from ImGui. (So OF_APP/bin/data/` can also be completely empty too!)

</details>




<details> <summary>RELATED LINKS</summary> ofxSurfingImGuiExtra
  • _My Testing Sandbox with New WIP examples and new incoming widgets._
 imgui/wiki/Useful-Extensions imgui/labels/gallery
  • Inspiration Gallery from ImGui user's apps.
 ofxWindowApp ofxSurfingHelpers
  • _Not required. Only for some examples._
</details>




CURRENT SYSTEMS



  • Windows 11 / Visual Studio 2022. (Main develop)
 GitHub master branch. (Could break sometimes!) Last official release OF 0.12.1. Previous release OF 0.12.0 and OF 0.11.2 have they own branches. <details> <summary>Older</summary>

</details>




THANKS



_Thanks to Omar Cornut for the fantastic Dear ImGui._

_SUPER THANKS to @Daandelange for HIS AWESOME ofxImGui (maintained) FORK, and some macOS fixes._

_Thanks to @roymacdonald for iOS ofxImGui fixing._

_Thanks to @alptugan for macOS testing and some fixes._

_Thanks to @AndyJarosz for financing and using the lib for his Reality Field Virtual Production System project for LOLED VIRTUAL._

_All source snippets and widgets from other authors are linked into header files as credits. Thanks!_




AUTHOR



An addon by moebiusSurfing. ( ManuMolina ) 2021-2025




LICENSE



MIT LICENSE

Get this addon

HTTPS
SSH
View on GitHub · Open with Github Desktop · Download ZIP · All releases

Latest release

v0.7 published 1y ago
  • Added iOS support with some examples ( WIP ).
  • Tested in OF 0.12.1 last release.
  • Updated Dear imgui, v1.91.5 (from ofxImGui)
  • Tested platforms: Windows, macOS and iOS.
  • Updated default fonts GeistMono-Bold.ttf and Geist-Bold.ttf.